HPE Cray Supercomputing Programming Environment Installation Guide: HPE Cray XD2000 Systems (26.03) S-8012
Copyright and Version
© Copyright 2022-2026 Hewlett Packard Enterprise Development LP. All third-party marks are the property of their respective owners.
CPE: 26.03-LocalBuild
Doc git hash: 4ea96f38ce9da5ed25d9431aa314b356c4365077
Generated: Wed Apr 15 2026
About the HPE CPE installation guide: HPE Cray XD2000 systems
The HPE Cray Supercomputing Programming Environment (CPE) for HPE Cray XD2000 systems is distributed as a collection of RPM packages. This publication documents the installation of RPMs and related files on these systems.
This publication is intended for system administrators receiving their first release of this product or upgrading from a previous release. The information in this guide assumes that the administrator understands Linux system administration.
IMPORTANT: Be sure to always employ the latest installation instructions. To check for the latest version and revisions of this CPE guide, go to the HPE Support Center website, and perform a search on the part number of this document (S-8012).
For information on how to use CPE or details regarding CPE components and modules, see the CPE Online Documentation website web page. See also the Documentation and support chapter for additional CPE resources and information.
Release information
This publication supports the installation of the HPE CPE 26.03 release on XD2000 systems running:
Management Software & Version |
Operating System |
Architecture |
|---|---|---|
HPCM 1.15 |
RHEL 8.10 |
X86 |
This release also supports v21.0.0 of the HPE Cray Compiler Environment (CCE).
IMPORTANT: CPE versions 25.03 (and earlier) previously supported MOFED versions 5.8 (or earlier) as directed in installation instructions. However, with CPE 25.09 (and later)releases, HPE recommends that MOFED/DOCAFED-dependent users with HPE Slingshot 10 (SS10) refrain upgrading CPE beyond the 25.03 CPE release. HPE observed a system bug, the Extended Reliable Connection (XRC) bug in MOFED. This system bug adversely affects CPE and SS10 functionality. The bug was introduced by NVIDIA in early 2023, and HPE reported details of the bug to NIDIA in April 2023. The bug is currently unresolved and is not expected to be fixed during the transition from MOFED to DOCA OFED. Until a resolution or workaround is introduced, CPE users should not upgrade past the CPE 25.03 release.
See the CPE 26.03 Release Announcements on the CPE Online Documentation website for other supported dependencies.
Variable substitutions
Variable substitutions to be used throughout this guide include:
<CPE_RELEASE> = 26.03
<CPE_VERSION> = 26.03.X (where X is the third digit of the actual three-digit version number of an official and HPE-supported version number)
<AOCC_VERSION> = 5.0.0
<INTEL_VERSION> = 2025.2.1
<MOFED_VERSION> = Not Supported
<IMAGE_ROOT> = /opt/clmgr/image/images/<IMAGE_NAME>, where your site chooses the <IMAGE_NAME>
Record of revision
New in the CPE 26.03 publication
Updated the title of this guide to HPE Cray Supercomputing Programming Environment Installation Guide: HPE Cray XD2000 Systems.
Updated the Release information section.
Updated the Variable substitutions section.
Updated the Installing HPE CPE on HPE Cray XD2000 Systems with HPCM chapter, adding the Before you begin section and modifying the instructions in the Building the CPE image section.
Removed the Installing HPE CPE on HPE Cray XD2000 Systems without HPCM chapter.
Updated the Module Path Aliases and Current Compatibility Versions section.
Updated the Support matrices for previous releases
Added a link for a listing of CPE-related knowledge articles available on the HPE Support Center website in the Other documentation resources section of the Documentation and support chapter.
Added the HPE Slingshot SHMEM Software Installation Guide link in the Other documentation resources section of the Documentation and support chapter.
Incorporated minor updates.
New in the CPE 25.09 (Rev. A) publication
Updated the tables in Support matrices for previous releases chapter.
Incorporated minor updates.
New in the CPE 25.09 publication
Updated the title of this guide to HPE Cray Supercomputing Programming Environment Installation Guide: HPE Cray XD2000 Systems.
Updated the Release information section.
Updated the Variable substitutions section.
Updated the Module Path Aliases and Current Compatibility Versions section.
Added the Support matrices for previous releases chapter.
Added the Documentation and support chapter
Changed HPE Cray Programming Environment references to HPE Cray Supercomputing Programming Environment.
Incorporated minor updates.
New in the CPE 25.03 publication
Updated the Release information section.
Updated the Variable substitutions section.
With this release, the new HPE Cray Supercomputing Programming Environment Getting Started User Guide: HPE Cray Supercomputing EX Systems (25.03) guide has been published. Locate this guide on the HPE Support Center or CPE Online Documentation website web page.
Incorporated minor updates.
New in the CPE 24.11 publication
Updated the introduction of this chapter. The introduction now indicates where to locate information on how to use CPE for this release and future releases. Formerly-provided HPE Cray Supercomputing Programming Environment user guides will no longer be provided along with CPE installation guides from the My HPE Software Center web page or uploaded to the HPE Support Center web page.
Updated the Release information section.
Updated the Variable substitutions section.
Updated the compiler versions table in the Module Path Aliases and Current Compatibility Versions.
Updated references to the Apollo 2000 Gen10 Plus (x86) systems to HPE Cray XD2000 systems throughout this guide version.
Updated the procedure in the Installing HPE CPE on HPE Cray XD2000 Systems with HPCM section.
Updated the procedure in the Installing HPE CPE on HPE Cray XD2000 Systems without HPCM section.
New in the CPE 24.07 publication
Updated the Release information section.
Updated the Variable substitutions section.
Added the Downloading HPE Cray Supercomputing EX software section.
Publication Title |
Date |
|---|---|
HPE Cray Supercomputing Programming Environment for the HPE Cray XD2000 System Installation Guide (26.03) S-8012 |
March 2026 |
HPE Cray Supercomputing Programming Environment for the HPE Cray XD2000 System Installation Guide (25.09) S-8012 |
September 2025 |
HPE Cray Programming Environment for the HPE Cray XD2000 System Installation Guide (25.03) S-8012 |
March 2025 |
HPE Cray Programming Environment for the HPE Cray XD2000 System Installation Guide (24.11) S-8012 |
January 2025 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (24.07) S-8012 |
August 2024 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (24.03) S-8012 |
May 2024 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (23.12) S-8012 |
December 2023 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (23.09) S-8012 |
September 2023 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (23.05) S-8012 |
June 2023 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (23.02-Rev. A) S-8012 |
March 2023 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (23.02) S-8012 |
February 2023 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.12) S-8012 |
December 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.11) S-8012 |
November 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.10) S-8012 |
October 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.09) S-8012 |
September 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.08) S-8012 |
August 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.06) S-8012 |
June 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.05) S-8012 |
May 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.04) S-8012 |
April 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.03) S-8012 |
March 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (22.02) S-8012 |
February 2022 |
HPE Cray Programming Environment for the Apollo 2000 Gen10 Plus (x86) System Installation Guide (21.02 - 21.12) S-8012 |
Feb - Dec 2021 |
Document conventions
This section defines the documentation conventions used throughout the guide, including typographic styles for code, commands, paths, and the backslash as the shell line-continuation character. It explains command-prompt notation, showing how the host and account are indicated (root prompts end with #, non-root prompts use account@hostname>) and lists node abbreviations (CN, NCN, AN, UAN) with example prompts for specific node types and Kubernetes contexts. This section also provides a simple three-step workflow and a reminder to verify pasted commands.
Typographical and command prompt conventions
This section provides background information about typographical and command prompts used in this guide and describes how they are delineated throughout this guide.
Typographical conventions
Type |
Convention Description |
|---|---|
This style |
Indicates program code, reserved words, library functions, command-line prompts, screen output, file/path names, variables, and other software constructs. |
\ (backslash) |
When inserted at the end of a command line, indicates the Linux shell line continuation character (lines joined by a backslash are parsed as a single line). |
Command prompt conventions
Host name and account in command prompts: The host name in a command prompt indicates where the command must be run. The account that must run the command is also indicated in the prompt.
The root or super-user account always has the # character at the end of the prompt.
Any non-root account is indicated with account@hostname>. A user account that is not root or crayadm is seen as user.
Command Prompt |
Definition |
|---|---|
user@login> |
Run the command on any login node as any non-root user. |
hostname# |
Run the command on the specified system as root. |
user@hostname> |
Run the command on the specified system as any non-root user. |
Copying and pasting text from this document
Using the Copy and Paste functions from a PDF is unreliable. Although copying and pasting a command line typically works, copying and pasting formatted file content (for example, JSON, YAML) typically fails. To ensure that file content is copied and pasted correctly while performing the procedures in this guide:
Copy the content from the PDF.
Paste it to a neutral editing form and add the necessary formatting.
Copy the content from the neutral form and paste it into the console.
Tip: As a best practice, double-check copied/pasted commands for correctness, as some commands may not render correctly in the PDF.
Downloading HPE Cray Supercomputing EX software
To download HPE Cray Supercomputing EX software, refer to the HPE Support Center or download it directly from My HPE Software Center. The HPE Support Center contains a wealth of documentation, training videos, knowledge articles, and alerts for HPE Cray Supercomputing EX systems. It provides the most detailed information about a release as well as direct links to product firmware, software, and patches available through My HPE Software Center.
Downloading the software through the HPE Support Center
HPE recommends downloading software through the HPE Support Center because of the many other resources available on the website.
Visit the HPE Cray Supercomputing EX product page on the HPE Support Center.
Search for specific product info, such as the full software name or recipe name and version.
For example, search for “Slingshot 2.1” or “Cray System Software with CSM 24.3.0.”
Find the desired software in the search results and select it to review details.
Select Obtain Software and select Sign in Now when prompted.
If a customer’s Entitlement Order Number (EON) is tied to specific hardware rather than software, the software is available without providing account credentials. Access the software instead by selecting Download Software and skip the next step in this procedure.
Enter account credentials when prompted and accept the HPE License Terms.
To download software, customers must ensure their Entitlement Order Number (EON) is active under My Contracts & Warranties on My HPE Software Center. If customers have trouble with the EON or are not entitled to a product, they must contact their HPE contract administrator or sales representative for assistance.
Choose the needed software and documentation files to download and select curl Copy to access the files.
Just like the software files, the documentation files change with each release. In addition to the official documentation, valuable information for a release is often available in files that include the phrase README in their name. Be sure to select and review these files in detail.
HPE recommends the curl Copy option, which downloads a single text file with curl commands to use on the desired system. You must run the curl commands within 24 hours of downloading them or download new commands if more than 24 hours have passed.
To validate the security of the downloads, you can later compare the files on the desired system against the checksums provided by HPE underneath each selected download.
Save the text file to a central location.
On the system where the software will be downloaded, run a shell script to execute the text file that includes the curl commands.
For example:
ncn-m001# bash -x <TEXT_FILE_PATH>
The -x option in this example tracks the download progress of each curl command in the text file.
Downloading the software directly from the My HPE Software Center
Users already familiar with a release can save time by downloading software directly from My HPE Software Center.
Visit My HPE Software Center and select Sign in.
Enter account credentials when prompted and select Software in the left navigation bar.
Search for specific product info, such as the full software name or recipe name and version.
For example, search for “Slingshot 2.1” or “Cray System Software with CSM 24.3.0.”
Find the desired software in the search results and review details by selecting Product Details under the Action column.

Select Go To Downloads Page and accept the HPE License Terms.
To download software, customers must ensure their Entitlement Order Number (EON) is active under My Contracts & Warranties. If customers have trouble with the EON or are not entitled to a product, they must contact their HPE contract administrator or sales representative for assistance.
Choose the needed software and documentation files to download and select curl Copy to access the files.
Just like the software files, the documentation files change with each release. In addition to the official documentation, valuable information for a release is often available in files that include the phrase README in their name. Be sure to select and review these files in detail.
HPE recommends the curl Copy option, which downloads a single text file with curl commands to use on the desired system. You must run the curl commands within 24 hours of downloading them or download new commands if more than 24 hours have passed.
To validate the security of the downloads, you can later compare the files on the desired system against the checksums provided by HPE underneath each selected download
Save the text file to a central location.
On the system where the software will be downloaded, run a shell script to execute the text file that includes the curl commands.
For example:
ncn-m001# bash -x <TEXT_FILE_PATH>
The -x option in this example tracks the download progress of each curl command in the text file.
Installing HPE CPE on HPE Cray XD2000 Systems with HPCM
Use this procedure to install CPE into an image on the HPE Cray XD2000 system using HPCM.
Prerequisites
A cluster image for use with CPE must already be present on the system. You can optionally clone the current cluster image to a new one to be used by CPE or save a revision of the current cluster image before continuing with this procedure. Consult the HPE Performance Cluster Manager Administrator’s Guide for more information on HPCM management commands.
The glibc-devel package must be installed.
Mellanox OFED must be updated to <MOFED_VERSION> version. See Release Information for additional details.
If you are using Lua modulefiles, the RHEL CodeReady Builder repository must be enabled before installing cray-lmod.
Before you begin
Obtain the cpe-<CPE_ISO_VERSION>-<RHELX-X>-<ARCH>.iso ISO files. For example:
cpe-26.3.1-rhel-8-10-x86_64.iso
Download and enable required OS repositories (for the installation of cpe-support), including:
RHEL BaseOS
RHEL AppStream
EPEL
USS WLM Support
Note that to use UCX with HPE Cray-MPICH:
HPE Cray-MPICH using the UCX netmod is supported on RHEL 8.10 systems with the HPCM installer.
HPE does not distribute UCX directly.
Mellanox provides a UCX solution as a part of their HPC-X software toolkit. This solution is the recommended path. Open source and Linux distribution packages provide a functional, although not necessarily performant, alternative.
Building the CPE image
Add the CPE repository from the ISO media:
mgmt1# cm repo add <PATH_TO_ISO> --priority 99
Confirm the CPE repository is available, and note the name of the repository:
mgmt1# cm repo show | grep CPE CPE-<CPE_ISO_VERSION>-rhel-8-10-x86_64 : /opt/clmgr/repos/cm/CPE-<CPE_ISO_VERSION>-rhel-8-10-x86_64
Select the CPE repository using the name shown in the previous command:
mgmt1# cm repo select \ CPE-<CPE_ISO_VERSION>-rhel-8-10-x86_64
Create a copy of cpe.rpmlist located in the CPE repository:
admin# cp /opt/clmgr/repos/cm/CPE-<CPE_ISO_VERSION>-rhel-8-10-x86_64/cpe.rpmlist \ ${HOME}/cpe.rpmlist(Optional) Modify the rpmlist to include or exclude necessary components. Additional compiler programming environments can be added by un-commenting the existing subsections in the rpmlist:
admin# vim ${HOME}/cpe.rpmlistSubcomponents predefined in the provided rpmlist, include (but are not limited to):
# # --- Base --- cpe-gcc-native-12.2 cpe-gcc-native-13.1 ... # # --- CCE --- cce-19.0.0 cce-19.0.0-binutils ... # # --- CSML --- cray-fftw-3.3.10.9 cray-hdf5-1.14.3.3 ... # # --- MPT --- cray-dsmml-0.3.0 cray-mpich-8.1.31-cray180 ... # # --- TOOLS --- atp-3.15.5 cray-ccdb-5.0.5 ... # # --- PrgEnv-aocc --- #cpe-descriptive-manifest-aocc #cpe-prgenv-aocc ... # # --- PrgEnv-intel --- #cpe-descriptive-manifest-intel #cpe-prgenv-intel ...
Install CPE content into the desired image from the cpe.rpmlist:
mgmt1# cm image dnf -i <IMAGE_NAME> install cpe-profile \ $(cat ${HOME}/cpe.rpmlist | egrep -v "^#" | tr '\n' ' ')Update the cpe-profile configuration if a different CPU target is required in cray-pe-configuration.sh and cray-pe-configuration.csh (for example, craype-x86-milan):
mgmt1# chroot /opt/clmgr/image/images/<IMAGE_NAME> \ sed -i 's/craype-x86-rome/craype-x86-milan/' /etc/cpe-profile.d/cray-pe-configuration.*sh
(Optional) Generate the modulefiles for AOCC and Intel oneAPI compilers, as applicable. Note that CPE does not contain the AOCC or the Intel oneAPI compiler itself; the compiler must be installed separately.
mgmt1# chroot /opt/clmgr/image/images/<IMAGE_NAME> mgmt1(chroot)# . /opt/cray/pe/modules/default/init/bash mgmt1(chroot)# module load craypkg-gen mgmt1(chroot)# craypkg-gen -m /opt/AMD/aocc-compiler-<AOCC_VERSION> mgmt1(chroot)# craypkg-gen -m /opt/intel/oneapi/compiler/<INTEL_VERSION> mgmt1(chroot)# exit
(Optional) To use Lmod as the default module handling system instead of Environment modules, update the cpe-profile configuration:
mgmt1# chroot /opt/clmgr/image/images/<IMAGE_NAME> sed -i 's/"environment modules"/"lmod"/' \ /etc/cray-pe.d/cray-pe-configuration.*sh
Set the release default:
mgmt1# chroot <IMAGE_ROOT> /opt/cray/pe/cpe/<CPE_RELEASE>/set_default_cpe_<CPE_RELEASE>
Stage the image on the desired nodes:
mgmt1# cm node provision -i <IMAGE_NAME> --stage --nodes n0*
Reboot the nodes to use the image:
mgmt1# cm power reset -t node n0*
Creating Modulefiles for Third-Party Products
Use the procedures in this section to create modulefiles for third-party products. These instructions use craypkg-gen to create a modulefile for a specific version of a supported third-party product. This process allows a site to set a specific version as default. These tasks are necessary and can be embedded in a script where a third-party product is being installed.
Prerequisites
Third-party packages must be downloaded and installed.
Procedure
Load craypkg-gen module:
source /opt/cray/pe/modules/default/init/bash module use /opt/cray/pe/modulefiles module load craypkg-gen
Generate module and set default scripts for products:
AMD Optimizing C/C++ Compiler: (requires craypkg-gen >= 1.3.16)
craypkg-gen -m /opt/AMD/aocc-compiler-<AOCC_VERSION>/
Intel OneAPI
craypkg-gen -m /opt/intel/oneapi/compiler/<INTEL_VERSION>/
Run a set default script:
/opt/admin-pe/set_default_craypkg/set_default_<MODULE_NAME>_<MODULE_VERSION>
About the Lmod Custom Dynamic Hierarchy
Lmod enables a user to dynamically modify their user environment through Lua modules. CPE capitalizes on the Lmod hierarchical structure, including the Lmod module auto-swapping functionality. This functionality allows module dependencies to determine the branches of the tree-like hierarchy. Lmod allows static and dynamic hierarchical module paths. Lmod provides full support for static paths, which build the hierarchy based on the current set of modules loaded. Alongside static paths, CPE implements dynamic paths for a subset of the Lmod hierarchy (compilers, networks, CPUs, and MPIs). Dynamic paths give an advanced level of flexibility for detecting multiple dependency paths and allow custom paths to join the existing CPE Lmod hierarchy without modifying customer modulefiles.
Static Lmod hierarchy
Modules dependent on one or more modules being loaded are not visible to a user until their prerequisite modules are loaded. When the prerequisite modules are loaded, it adds the static paths of the dependent modules to the MODULEPATH environment variable, thereby exposing the dependent modules to the user. For more detailed information on Lmod static module hierarchies, please consult User Guide for Lmod.
Dynamic Lmod hierarchy
The CPE custom dynamic Lmod hierarchy abbreviates the overall Lmod hierarchy tree by relying on compatibility and not directly on a prerequisite version. Therefore, dependent modules do not need to exist in a new branch every time their prerequisite modules change versions. Instead, dynamic paths use a compatibility version that increases when a new prerequisite module version breaks compatibility in some way. The number following the module path alias (for example, 1.0 in x86-rome/1.0 and ofi/1.0) identifies the compatible version.
Module Path Aliases and Current Compatibility Versions
Compatible versions listed in the following tables include the minimum supported versions.
Compiler |
RHEL Module Alias/Compatible Version |
|---|---|
amd |
amd/7.0 |
cce |
crayclang/21.0 |
aocc |
aocc/4.1 |
intel |
intel/2023.2 |
gcc |
gnu/10.0 |
nvidia |
nvidia/20 |
Network |
Module Alias/Compatible Version |
|---|---|
craype-network-infiniband |
infiniband/1.0 |
craype-network-ofi |
ofi/1.0 |
craype-network-ucx |
ucx/1.0 |
CPU |
Module Alias/Compatible Version |
|---|---|
craype-broadwell |
broadwell/1.0 |
craype-x86-milan |
x86-milan/1.0 |
craype-x86-rome |
x86-rome/1.0 |
craype-x86-skylake |
x86-skylake/1.0 |
craype-x86-cascadelake |
x86-cascadelake/1.0 |
craype-x86-icelake |
x86-icelake/1.0 |
MPI |
Module Alias/Compatible Version |
|---|---|
cray-mpich |
cray-mpich/8.0 |
cray-mpich-abi |
cray-mpich/8.0 |
cray-mpich-abi-pre-intel-5.0 |
cray-mpich/8.0 |
cray-mpich-ucx |
cray-mpich/8.0 |
cray-mpich-ucx-abi |
cray-mpich/8.0 |
cray-mpich-ucx-abi-pre-intel-5.0 |
cray-mpich/8.0 |
Custom dynamic hierarchy
The CPE custom dynamic hierarchy extension allows custom module paths to join the existing CPE Lmod hierarchy implementation without modifying customer modulefiles. The custom dynamic module types that CPE supports include:
Compiler
Network
CPU
MPI
Compiler/Network
Compiler/CPU
Compiler/Network/CPU/MPI
As each custom dynamic module type loads, a handshake occurs using special pre-defined environment variables. When all hierarchical prerequisites are met, the paths of the dependent modulefiles are added to the MODULEPATH environment variable, thereby exposing the dependent modules to the user.
For Lmod to assist a user optimally, load the compiler, network, CPU, and MPI module. Lmod cannot detect modules hidden in dynamic paths without one of each type of module being loaded.
Creating a custom dynamic hierarchy
For the CPE custom dynamic hierarchy to detect the desired Lmod module path, one or more custom dynamic environment variables must be created according to the requirements defined within this procedure.
Prerequisites
Set Lmod as the default module handling system before initiating this procedure.
Procedure
To create a custom dynamic environment variable:
Begin the environment variable name with LMOD_CUSTOM_.
Append the descriptor of the module type that the environment variable will represent. The module types and descriptors are:
Module Type
Descriptor
Compiler
COMPILER_
Network
NETWORK_
CPU
CPU_
MPI
MPI_
Compiler/Network
COMNET_
Compiler/CPU
COMCPU_
Compiler/Network/CPU/MPI
CNCM_
Example: The custom dynamic environment variable for the combined compiler and CPU module begins with LMOD_CUSTOM_COMCPU_.
Following the descriptor, append all prerequisite module aliases along with their respective compatible versions. See the Module Path Aliases and Current Compatibility Versions section of this guide for more information. The format of the module path alias/compatible version string for each module type is shown below. Note that due to publishing issues, long module alias/compatible version strings are split across two lines as indicated below.
Module Type: Module Path Alias/Compatible Version String
Compiler: <compiler_name>/<compatible_version>
Network: <network_name>/<compatible_version>
CPU: <cpu_name>/<compatible_version>
MPI:
<compiler_name>/<compatible_version>/<network_name>/<compatible_version>/
<mpi_name>/<compatible_version>
Compiler/Network: <compiler_name>/<compatible_version/<network_name>/<compatible_version>
Compiler/CPU: <compiler_name>/<compatible_version>/<cpu_name>/<compatible_version>
Compiler/Network/CPU/MPI:
<compiler_name>/<compatible_version>/<network_name>/<compatible_version>/
<cpu_name>/<compatible_version>/<mpi_name>/<compatible_version>
To create an acceptably formatted environment variable name, replace all slashes and dots in the module alias/compatible version string with underscores. Also, all letters must be in uppercase format.
Example Module Path Alias/Compatible Version Strings:
Compiler = cce
The path alias/compatible version string (values found in Module Path Aliases and Current Compatibility Versions section of this guide) is crayclang/10.0; therefore, the text added to the environment variable name is:
CRAYCLANG_10_0
Network = craype-network-ofi
The path alias/compatible version string is ofi/1.0; therefore, the environment variable text is:
OFI_1_0
CPU = craype-x86-rome
The path alias/compatible version string is x86-rome/1.0; therefore, the environment variable text is:
X86_ROME_1_0
MPI = cray-mpich
cray-mpich has two prerequisite module types (compiler and network). Therefore, the environment variable must include the alias/compatible version for the desired compiler, network, and MPI. For a cray-mpich module dependent on cce and craype-network-ofi, the path alias/compatible version string is crayclang/10.0/ofi/1.0/cray_mpich/8.0; therefore, the environment variable text is:
CRAYCLANG_10_0_OFI_1_0_CRAY_MPICH_8_0.
Compiler/Network = cce with craype-network-ofi
The path alias/compatible version string is crayclang/10.0/ofi/1.0; therefore, the environment variable text is:
CRAYCLANG_10_0_OFI_1_0
Compiler/CPU = cce with craype-x86-rome
The path alias/compatible version string is crayclang/10.0/x86-rome/1.0; therefore, the environment variable text is:
CRAYCLANG_10_0_X86_ROME_1_0
Compiler/Network/CPU/MPI = cce, craype-network-ofi, craype-x86-rome, and cray-mpich
The path alias/compatible version string is crayclang/10.0/ofi/1.0/x86-rome/1.0/cray-mpich/8.0; therefore, the environment variable text is:
CRAYCLANG_10_0_OFI_1_0_X86_ROME_1_0_CRAY_MPICH_8_0
Append _PREFIX following the final module/compatibility text instance:
Example: Network = craype-network-ofi
The custom dynamic environment variable is LMOD_CUSTOM_NETWORK_OFI_1_0_PREFIX.
Creation of the custom dynamic environment variable is now complete.
Add the custom dynamic environment variable to the user environment by exporting it with its value set to the Lmod module path:
# export LMOD_CUSTOM_NETWORK_OFI_1_0_PREFIX=<lmod_module_path>
Example: Network = craype-network-ofi
All modulefiles in <lmod_module_path> are shown to users whenever craype-network-ofi is loaded.
Support matrices for previous releases
This chapter lists CPE-supported components, third-party software, and modules supported for applicable and previous releases of the CPE software. This information is provided for reference purposes.
CPE release matrices for XD2000 and Apollo 2000 HPC Cray Supercomputing systems
CPE is supported on HPE Cray Supercomputing EX XD2000 systems with HPCM. Below are product components, modules, third-party software versions supported with previous CPE releases with this configuration.
(D) represents the default version installed at installation.
Product / Release |
25.09 |
25.03 |
24.11 |
24.07 |
|---|---|---|---|---|
Product / Release |
XD2000 |
XD2000 |
XD2000 |
Apollo 2000 |
HPCM |
1.13 |
1.12 |
1.11 |
|
aocc |
5.0.0 |
4.2.0 |
4.2.0 |
|
atp |
3.15.7 (D) |
3.15.6 (D) |
3.15.5 (D) |
3.15.4 (D) |
cce |
20.0.0 |
19.0.0 (D) |
18.0.1 (D) |
18.0.0 (D) |
cpe-gcc-native |
10.3 |
10.3 |
10.3 |
10.3 |
cpe-gcc-native |
11.2 |
11.2 |
11.2 |
11.2 |
cpe-gcc-native |
12.2 |
12.2 |
12.2 |
12.2 |
cpe-gcc-native |
13.2 (D) |
13.2 (D) |
13.2 (D) |
13.2 (D) |
cpe-prgenv-aocc |
8.6.0 (D) |
8.6.0 (D) |
8.4.0 (D) |
8.4.0 (D) |
cpe-prgenv-cray |
8.6.0 (D) |
8.6.0 (D) |
8.4.0 (D) |
8.4.0 (D) |
cpe-prgenv-gnu |
8.6.0 (D) |
8.6.0 (D) |
8.4.0 (D) |
8.4.0 (D) |
cpe-prgenv-intel |
8.6.0 (D) |
8.6.0 (D) |
8.4.0 (D) |
8.4.0 (D) |
cray-R |
4.4.0 (D) |
4.4.0 (D) |
4.4.0 (D) |
4.4.0 (D) |
cray-ccdb |
5.0.7 (D) |
5.0.6 (D) |
5.0.5 (D) |
5.0.4 (D) |
cray-cdst-support |
2.14.6 (D) |
2.14.5 (D) |
2.14.3 (D) |
|
cray-cti |
2.20.0 (D) |
2.19.1 (D) |
2.19.0 (D) |
2.18.4 (D) |
cray-dsmml |
0.2.2 (D) |
0.2.2 (D) |
0.2.2 (D) |
0.2.2 (D) |
cray-dwarf |
2.0.0 (D) |
0.11.1 (D) |
0.11.0 (D) |
0.9.2 (D) |
cray-dyninst |
12.3.6 (D) |
12.3.5 (D) |
12.3.4 (D) |
12.3.2 (D) |
cray-fftw |
3.3.10.11 (D) |
3.3.10.10 (D) |
3.3.10.9 (D) |
3.3.10.8 (D) |
cray-hdf5 |
1.14.3.7 (D) |
1.14.3.5 (D) |
1.14.3.3 (D) |
1.14.3.1 (D) |
cray-libsci |
25.09.0 (D) |
25.03.0 (D) |
24.11.0 (D) |
24.07.0 (D) |
cray-lmod |
8.7.60 |
8.7.55 |
8.7.31 |
8.7.31 |
cray-modules |
3.2.11.7 (D) |
3.2.11.7 (D) |
3.2.11.5 (D) |
3.2.11.5 (D) |
cray-mpich |
8.1.33 |
8.1.32 (D) |
8.1.31 (D) |
8.1.30 (D) |
cray-mpich |
9.0.1 (D) |
|||
cray-mrnet |
5.1.6 (D) |
5.1.5 (D) |
5.1.4 (D) |
5.1.3 (D) |
cray-netcdf |
4.9.2.1 (D) |
4.9.0.17 (D) |
4.9.0.15 (D) |
4.9.0.13 (D) |
cray-openshmemx |
11.4.0.beta (D) |
11.4.0.beta (D) |
11.4.0.beta (D) |
11.4.0.beta (D) |
cray-pals |
1.3.2 (D) |
1.3.2 (D) |
1.3.2 (D) |
1.3.2 (D) |
cray-papi |
7.2.0.2 (D) |
7.2.0.1 (D) |
7.1.0.4 (D) |
7.1.0.2 (D) |
cray-parallel-netcdf |
1.12.3.19 (D) |
1.12.3.17 (D) |
1.12.3.15 (D) |
1.12.3.13 (D) |
cray-pe-profile-ofi-milan |
1.3 |
1.3 |
1.3 |
1.3 |
cray-pe-profile-ofi-rome |
1.3 |
1.3 |
1.3 |
1.3 |
cray-pe-profile-ofi-skylake |
1.3 |
1.3 |
1.3 |
1.3 |
cray-pe-set-default |
3.3 (D) |
3.3 (D) |
3.1 (D) |
3.1 (D) |
cray-pmi |
6.1.16 (D) |
6.1.15 (D) |
6.1.15 (D) |
6.1.15 (D) |
cray-pmi-devel |
6.1.16 (D) |
6.1.15 (D) |
6.1.15 (D) |
6.1.15 (D) |
cray-pmi-doc |
6.1.16 (D) |
6.1.15 (D) |
6.1.15 (D) |
6.1.15 (D) |
cray-python |
3.11.7 (D) |
3.11.7 (D) |
3.11.7 (D) |
3.11.7 (D) |
cray-stat |
4.12.6 (D) |
4.12.5 (D) |
4.12.4 (D) |
4.12.3 (D) |
cray-zmqnet |
1.3.2 (D) |
1.3.0 (D) |
1.0.0 (D) |
|
craype |
2.7.35 (D) |
2.7.34 (D) |
2.7.33 (D) |
2.7.32 (D) |
craype-dl-plugin-py3 |
21.02.1.3 (D) |
21.02.1.3 (D) |
21.02.1.3 (D) |
|
craype-targets |
1.7.0 (D) |
1.6.0 (D) |
1.5.0 (D) |
1.4.0 (D) |
craypkg-gen |
1.3.36 (D) |
1.3.35 (D) |
1.3.34 (D) |
1.3.33 (D) |
gdb4hpc |
4.16.5 (D) |
4.16.4 (D) |
4.16.3 (D) |
4.16.2 (D) |
intel |
2025.0.0 |
2024.2.0 |
2024.0.1 |
|
libfabric |
1.13.1 (D) |
1.13.1 (D) |
1.13.1 (D) |
1.13.1 (D) |
libzmq5 |
4.3.3 (D) |
4.3.3 (D) |
4.3.3 (D) |
4.3.3 (D) |
lmod_scripts |
3.2.1 (D) |
3.2.1 (D) |
3.2.0 (D) |
3.2.0 (D) |
Mellanox OFED |
5.8 (or later) |
5.8 |
5.8 |
|
perftools |
25.09.0 (D) |
25.03.0 (D) |
24.11.0 (D) |
24.07.0 (D) |
sanitizers4hpc |
1.1.6 (D) |
1.1.5 (D) |
1.1.4 (D) |
1.1.3 (D) |
totalviewsup |
2024.4.0 |
2024.1.21 |
2024.1.21 |
|
valgrind4hpc |
2.13.6 (D) |
2.13.5 (D) |
2.13.4 (D) |
2.13.3 (D) |
Documentation and support
Documentation is available as a resource for using and managing CPE. This chapter provides details for obtaining CPE support and accessing available resources.
CPE installation and getting started guides
HPE CPE documentation comprises user and installation guides:
Title |
Document Part Number |
|---|---|
HPE Cray Supercomputing Programming Environment Installation Guide: CSM on HPE Cray Supercomputing EX Systems |
S-8003 |
HPE Cray Supercomputing Programming Environment Installation Guide: HPCM on HPE Cray Supercomputing EX and HPE Cray Supercomputing Systems |
S-8022 |
HPE Cray Supercomputing Programming Environment Installation Guide: HPE Cray XD2000 Systems |
S-8012 |
HPE Cray Supercomputing Programming Environment Getting Started User Guide: HPE Cray Supercomputing EX Systems |
S-9934 |
HPE Cray Supercomputing Programming Environment Getting Started Administrator Guide: HPE Cray Supercomputing EX Systems |
S-9935 |
Other documentation resources
HPE provides CPE documentation and support through various online sources:
Retrieve a range of HPE resources through the HPE Support Center, including access to support issues; the latest guides (as listed in CPE installation and getting started guides), including guide revisions; software download information; the HPE knowledge base; product information; and other resources.
To help you to get the most out of the CPE online, access the CPE Online Documentation website to obtain initially released installation and Getting Started guides, in addition to general user procedures, release announcements, and best practice manuals.
Important: Be sure to regularly check for guide revisions on the HPE Support Center. Revisions of installation and Getting Started guides that are posted to the HPE Support Center are presumed more current than those posted on the CPE Online Documentation website.
To search CPE articles, see the HPE Support Center listing of CPE-related Knowledge Articles.
For HPE Slingshot SHMEM download and installation information, refer to the HPE Slingshot SHMEM Software Installation Guide.
Join the CPE #hpe-cray-programming-environment Slack channel through the HPE Developer Community Slack web page for interactive and collaborative CPE interactions.
Access CCE help using CCE module commands:
man craycc or man crayCC - Returns HPE Cray C and C++ compiler man pages. (Alias for man clang.)
craycc –help - Returns a summary of the command line options and arguments.
man crayftn - Returns HPE Cray Fortran compiler man pages.
crayftn –help - Returns a summary of the command line options and arguments.
The complete Clang reference manual is included in HTML format in the /opt/cray/pe/cce/<version>.0.0/doc/html/index.html file system location. Note that the man page is presumed to be more current if content differences exist.
For CPE and software installation and update information, see My HPE Software Center for general CPE information.
Access the HPE Cray Supercomputing Programming Environment Software QuickSpecs online.
Access third-party documentation resources online, including:
Published: April 2026