Skip to content

RHEL9 upgrade: first commit includes - #879

Merged
yandthj merged 2 commits into
NatLabRockies:gh-pagesfrom
arswalid:gh-pages
Jul 23, 2026
Merged

yandthj merged 2 commits into
NatLabRockies:gh-pagesfrom
arswalid:gh-pages

Conversation

@arswalid

Copy link
Copy Markdown
Collaborator
  • Main changes OS CPE SLURM etc...
  • access information
  • module structure
    • envs
    • toolchains
    • CPE
  • known issues and FAQs

- Main changes OS CPE SLURM etc...
- access information
- module structure
	- envs
	- toolchains
	- CPE
- known issues and FAQs
@mselensky

Copy link
Copy Markdown
Collaborator

This PR looks good to me - no specific comments. This will be a helpful starting point for users as they onboard onto the RHEL9 nodes.

@yandthj yandthj left a comment •

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@arswalid and @mselensky I didn't go through all of this but noticing a lot of formatting issues, etc. Can you please go through and verify that the heading capitalization, code highlighting, other formatting is consistent, that it's using NLR instead of NREL, and proofread?

Comment thread docs/RHEL9_upgrade/index.md Outdated

- On RHEL 8, applications were installed under `/nopt/nrel/apps/`. A new directory, `/nopt/nlr/apps`, has been created for this transition.
- Slurm for RHEL 9 is installed under `/nopt/slurm/latest` instead of `/nopt/slurm/current`.
- The latest FastX server is running on `kd7.hpc.nrel.gov` and can be accessed with the FastX client or at <https://kd7.hpc.nrel.gov>.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- The latest FastX server is running on `kd7.hpc.nrel.gov` and can be accessed with the FastX client or at <https://kd7.hpc.nrel.gov>.
- The latest FastX server is running on `kd7.hpc.nlr.gov` and can be accessed with the FastX client or at <https://kd7.hpc.nlr.gov>.

Comment thread docs/RHEL9_upgrade/index.md Outdated
- On RHEL 8, applications were installed under `/nopt/nrel/apps/`. A new directory, `/nopt/nlr/apps`, has been created for this transition.
- Slurm for RHEL 9 is installed under `/nopt/slurm/latest` instead of `/nopt/slurm/current`.
- The latest FastX server is running on `kd7.hpc.nrel.gov` and can be accessed with the FastX client or at <https://kd7.hpc.nrel.gov>.
- Access to RHEL 9 login and compute nodes is restricted. Reach out to `hpc-help@nlr.gov` to get started on the newer software stack.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Access to RHEL 9 login and compute nodes is restricted. Reach out to `hpc-help@nlr.gov` to get started on the newer software stack.
- Access to RHEL 9 login and compute nodes is restricted. Reach out to [hpc-help@nlr.gov](mailto:hpc-help@nlr.gov) to get started on the newer software stack.

Comment thread docs/RHEL9_upgrade/access.md Outdated
@@ -0,0 +1,68 @@
# Accessing Kestrel RHEL9

## login Nodes

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## login Nodes
## Login Nodes


## login Nodes
Use the following login nodes to access upgraded RHEL 9 resources:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

hostnames all need to use nlr instead of nrel

Comment thread docs/RHEL9_upgrade/access.md Outdated
- GPU login node: `kl5.hpc.nrel.gov`
- DAV node: `kd7.hpc.nrel.gov`

## ssh steps

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## ssh steps
## SSH Steps

Comment thread docs/RHEL9_upgrade/access.md Outdated
- DAV node: `kd7.hpc.nrel.gov`

## ssh steps
1. SSH to one of the login nodes listed above.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The numbers aren't rendering correctly in markdown, they are all showing as "1."

Comment thread docs/RHEL9_upgrade/knownissues.md Outdated

## Known Issues

- `openmpi` 5 works only with `mpirun` because Slurm is configured without PMIx.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- `openmpi` 5 works only with `mpirun` because Slurm is configured without PMIx.
- `openmpi5` works only with `mpirun` because Slurm is configured without PMIx.

Comment thread docs/RHEL9_upgrade/knownissues.md Outdated
## Known Issues

- `openmpi` 5 works only with `mpirun` because Slurm is configured without PMIx.
- `mpiifx` previously failed because of missing path definitions. This should be fixed; report if it still fails.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

how should users report this?

Comment thread docs/RHEL9_upgrade/knownissues.md Outdated

### I cannot find the module I need.

Use `module spider ModuleName` first to verify availability. If it still cannot be found, email `hpc-ticket` and the Apps team will follow up.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Use `module spider ModuleName` first to verify availability. If it still cannot be found, email `hpc-ticket` and the Apps team will follow up.
Use `module spider <ModuleName>` first to verify availability. If it still cannot be found, email `hpc-ticket` and the Apps team will follow up.

Comment thread docs/RHEL9_upgrade/knownissues.md Outdated

### I need to mix and match compilers and libraries/MPI. How can I do that?

Modules do not support arbitrary mix-and-match combinations. For example, if `oneapi` is loaded, only software compiled with oneAPI is shown. For custom stacks, use Spack and contact `hpc-ticket` to be matched with a Spack expert.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please fix the email and use mailto like the rest of the codebase

@@ -0,0 +1,26 @@
# Getting Started

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since this the section heading page it might be nice to have a little intro/summary about the upgrade and why were are doing that. Could you write that @mselensky ?

@mselensky

Copy link
Copy Markdown
Collaborator

@yandthj thanks for catching those typos + good idea on the intro - let me know what you think!

@yandthj
yandthj merged commit a723d96 into NatLabRockies:gh-pages Jul 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants