diff --git a/docs/blog/assets/avatar/default.png b/docs/blog/assets/avatar/default.png new file mode 100644 index 000000000..e4f32b0d3 Binary files /dev/null and b/docs/blog/assets/avatar/default.png differ diff --git a/docs/blog/authors.yml b/docs/blog/authors.yml new file mode 100644 index 000000000..fbaea7bc0 --- /dev/null +++ b/docs/blog/authors.yml @@ -0,0 +1,21 @@ +authors: + ethanyoung: + name: Ethan Young + description: Author + avatar: http://nrel.github.io/HPC/blog/assets/avatar/default.png + pauldiaz: + name: Paul Diaz + description: Author + avatar: http://nrel.github.io/HPC/blog/assets/avatar/default.png + timkaiser: + name: Tim Kaiser + description: Author + avatar: http://nrel.github.io/HPC/blog/assets/avatar/default.png + aco: + name: Advanced Computing Operations + description: Author + avatar: http://nrel.github.io/HPC/blog/assets/avatar/default.png + hpcas: + name: HPC Applications Support + description: Author + avatar: http://nrel.github.io/HPC/blog/assets/avatar/default.png diff --git a/docs/blog/index.md b/docs/blog/index.md new file mode 100644 index 000000000..c58f16c50 --- /dev/null +++ b/docs/blog/index.md @@ -0,0 +1,2 @@ +# Blog + diff --git a/docs/blog/2020-12-01-numba.md b/docs/blog/posts/2020-12-01-numba.md similarity index 74% rename from docs/blog/2020-12-01-numba.md rename to docs/blog/posts/2020-12-01-numba.md index 6b3050fcb..456c11336 100644 --- a/docs/blog/2020-12-01-numba.md +++ b/docs/blog/posts/2020-12-01-numba.md @@ -1,13 +1,15 @@ --- -title: Speeding up Python Code with Numba -postdate: December 01, 2020 -layout: post -author: Ethan Young -description: Numba is a just in time (JIT) compiler for Python and NumPy code. From the official website, "Numba-compiled numerical algorithms in Python can approach the speeds of C or FORTRAN." +date: 2020-12-01 +authors: + - ethanyoung --- +# Speeding up python Code with Numba + Numba is a just in time (JIT) compiler for Python and NumPy code. From their official website, "Numba translates Python functions to optimized machine code at runtime using the industry-standard LLVM compiler library. Numba-compiled numerical algorithms in Python can approach the speeds of C or FORTRAN." + + ```python @jit(nopython=True) def function_to_be_compiled(): diff --git a/docs/blog/2021-05-06-tf.md b/docs/blog/posts/2021-05-06-tf.md similarity index 85% rename from docs/blog/2021-05-06-tf.md rename to docs/blog/posts/2021-05-06-tf.md index 5aed1ca45..16a6a71c3 100644 --- a/docs/blog/2021-05-06-tf.md +++ b/docs/blog/posts/2021-05-06-tf.md @@ -1,13 +1,15 @@ --- -title: Faster Machine Learning with Custom Built TensorFlow on Eagle -postdate: May 6, 2021 -layout: post -author: Paul Diaz -description: Customized python installations of TensorFlow specifically optimized for the Eagle hardware (CPUs & GPUs) are now available to all Eagle users. +date: 2021-05-06 +authors: + - pauldiaz --- +# Faster Machine Learning with Custom Built TensorFlow on Eagle + TensorFlow is a widely used and powerful symbolic math library commonly used for a variety of machine learning techniques. TensorFlow has built in API support for regression, clustering, classification, hidden Markov models, neural networks, reinforcement learning, as well as, a variety of activation functions, loss function, and optimizers. TensorFlow has received growing adoption among scientists, researchers, and industry professionals for its broad applicability and flexibility. + + TensorFlow versions obtained from `pip` or `conda` installs may not be optimized for the CPU and GPU architectures found on Eagle. To address this, pre-compiled versions which are optimized both for the CPU and GPU architectures have been created and offer computational benefits compared to other installation approaches. These versions can easily be installed from the `wheels` provided in `/nopt/nrel/apps/wheels/` which contains different TensorFlow versions. Here is an example of how you can install an optimized version of TensorFlow to your environment. diff --git a/docs/blog/2021-06-18-srun.md b/docs/blog/posts/2021-06-18-srun.md similarity index 99% rename from docs/blog/2021-06-18-srun.md rename to docs/blog/posts/2021-06-18-srun.md index c2c291186..ee673fb50 100644 --- a/docs/blog/2021-06-18-srun.md +++ b/docs/blog/posts/2021-06-18-srun.md @@ -1,11 +1,14 @@ --- -title: Using srun to Launch Applications Under Slurm -postdate: June 18, 2021 -layout: post -author: Tim Kaiser -description: Describes options to get the desired layout of tasks to nodes/cores using srun. +date: 2021-06-18 +authors: + - timkaiser --- +# Using srun to Launch Applications Under Slurm + +This article describes options to get the desired layout of tasks to nodes/cores using srun. + + ## Subjects covered 1. Basics diff --git a/docs/blog/2022-10-04-python2to3.md b/docs/blog/posts/2022-10-04-python2to3.md similarity index 98% rename from docs/blog/2022-10-04-python2to3.md rename to docs/blog/posts/2022-10-04-python2to3.md index 22f9a6a85..d7fd4c56b 100644 --- a/docs/blog/2022-10-04-python2to3.md +++ b/docs/blog/posts/2022-10-04-python2to3.md @@ -1,9 +1,17 @@ +--- +date: 2022-10-04 +authors: + - hpcas +--- + # Running Legacy Python 2 Code on Eagle ## What is Legacy Code? One definition of "legacy" code or software is code was written in the past using currently outdated, obsolete, or otherwise deprecated, compilers, functions, methods, or methodology. + + While [Python 2 was sunset on January 1, 2020](https://www.python.org/doc/sunset-python-2/) in favor of Python 3, there is still "legacy" Python 2 software that may need to be run on Eagle. We always encourage Eagle users to upgrade their code to Python 3.x to continue receiving official updates, bug fixes, and security patches. But we do understand that there will always be code that is not worth porting to Python 3. diff --git a/docs/blog/2022-12-19-windows_ssh.md b/docs/blog/posts/2022-12-19-windows_ssh.md similarity index 91% rename from docs/blog/2022-12-19-windows_ssh.md rename to docs/blog/posts/2022-12-19-windows_ssh.md index f7f7e5df8..5b4da7c08 100644 --- a/docs/blog/2022-12-19-windows_ssh.md +++ b/docs/blog/posts/2022-12-19-windows_ssh.md @@ -1,8 +1,15 @@ --- -title: Workaround for Windows SSH "Corrupted MAC on input" Error +date: 2022-12-19 +authors: + - aco --- + +# Workaround for Windows SSH "Corrupted MAC on input" Error + Some people who use Windows 10/11 computers to ssh to Eagle from a Windows command prompt, powershell, or via Visual Studio Code's SSH extension might receive an error message about a "Corrupted MAC on input" or "message authentication code incorrect." This error is due to an outdated OpenSSL library included in Windows and a security-mandated change to ssh on Eagle. However, there is a functional workaround for this issue. (Note: If you are not experiencing the above error, you do not need and should not use the following workaround.) + + For command-line and Powershell ssh users, adding `-m hmac-sha2-512` to your ssh command will resolve the issue. For example: `ssh -m hmac-sha2-512 @eagle.hpc.nrel.gov`. For VS Code SSH extension users, you will need to create an ssh config file on your local computer (~/.ssh/config), with a host entry for Eagle that specifies a new message authentication code: diff --git a/mkdocs.yml b/mkdocs.yml index 62fda75ae..9e2bc573b 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1,11 +1,7 @@ nav: - Home: index.md - - Blog: - - blog/2020-12-01-numba.md - - blog/2021-05-06-tf.md - - blog/2021-06-18-srun.md - - blog/2022-10-04-python2to3.md - - blog/2022-12-19-windows_ssh.md + - Blog: + - index: blog/index.md - Documentation: - Documentation Home: Documentation/index.md - Getting Started: Documentation/getting_started.md @@ -188,3 +184,11 @@ extra_css: site_name: NREL HPC repo_url: https://github.com/NREL/HPC/tree/gh-pages repo_name: NREL/HPC +plugins: + - blog: + authors_file: blog/authors.yml + enabled: true + blog_dir: blog + post_dir: blog/posts + post_readtime: false + categories: false