Copyright and Version
© Copyright 2022-2025 Hewlett Packard Enterprise Development LP. All third-party marks are the property of their respective owners.
CPE: 25.09-LocalBuild
Doc git hash: 9bc237b81fef60fa958b671c3018c2a3bfd223f0
Generated: Mon Sep 29 2025
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 25.09 release on XD2000 systems running:
Management Software & Version |
Operating System |
Architecture |
|---|---|---|
HPCM 1.14 |
RHEL 8.10 |
X86 |
This release also supports v20.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 the CPE 25.09 release, 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 25.09 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> =
25.09<CPE_VERSION> =
25.09.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.1.0<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 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.
New in the CPE 24.03 publication
Updated the Release information section.
Updated the Variable substitutions section.
New in the CPE 23.12 publication
Updated the Release information section.
Updated the Variable substitutions section.
Updated compiler versions in the Module Path Aliases and Current Compatibility Versions section.
New in the CPE 23.09 publication
Added a note in the Release information section.
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 23.05 publication
Changed the
gcc(GNU Compiler Collection) compatible compiler version from 8.0 to 10.0 andccecompatible compiler version from 10.0 to 16.0 in the Module Path Aliases and Current Compatibility Versions section.Updated procedures in the Installing HPE CPE on HPE Cray XD2000 Systems with HPCM and Installing HPE CPE on HPE Cray XD2000 Systems without HPCM sections.
Incorporated editorial updates.
Updated the steps under Procedure in the Installing HPE CPE on HPE Cray XD2000 Systems with HPCM section.
Publication Title |
Date |
|---|---|
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 |
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
rootor super-user account always has the#character at the end of the prompt.Any non-
rootaccount is indicated withaccount@hostname>. A user account that is notrootorcrayadmis seen asuser.
Command Prompt |
Definition |
|---|---|
|
Run the command on any login node as any non- |
|
Run the command on the specified system as |
|
Run the command on the specified system as any non- |
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
-xoption 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
-xoption 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
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-develpackage 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.
OBJECTIVE
Use this procedure to install CPE into an image on the HPE Cray XD2000 system using HPCM.
PROCEDURE
Add the CPE repository from the ISO media:
mgmt1# cm repo add <PATH_TO_ISO>
Confirm the CPE repository is available, and note the name of the repository:
mgmt1# cm repo show | grep Cray Cray-Programming-Environment-for-HPE-Cray-XD2000-<CPE_RELEASE>-rhel8-x86_64 : \ /opt/clmgr/repos/cm/Cray-Programming-Environment-for-HPE-Cray-XD2000-<CPE_RELEASE>-rhel8-x86_64
Select the CPE repository using the name shown in the previous command:
mgmt1# cm repo select \ Cray-Programming-Environment-for-HPE-Cray-XD2000-<CPE_RELEASE>-rhel8-x86_64
Install CPE base content into the desired image.
mgmt1# cm image dnf -i <IMAGE_NAME> install cpe-hpe-cray-xd2000-base-content-<CPE_RELEASE>
Install the appropriate package for the system CPU target (
romeormilan):mgmt1# cm image dnf -i <IMAGE_NAME> install cray-pe-profile-ofi-<CPU_TARGET>
(Optional) Set CrayPE as default on the system:
mgmt1# chroot <IMAGE_ROOT> sed -i '/^#.*enabled_by_default/s/^#//' \ /etc/cray-pe.d/cray-pe-configuration.*sh
(Optional) Install GCC version 12 support if your operating system is RHEL 8.7:
mgmt1# cm image dnf -i <IMAGE_NAME> install gcc-native-12.1
(Optional) Install the CPE AOCC support content.
Note: CPE does not contain the AOCC compiler itself; the compiler must be installed separately.
mgmt1# cm image dnf -i <IMAGE_NAME> install cpe-hpe-cray-xd2000-aocc-content-<CPE_RELEASE>
(Optional) Install the CPE Intel oneAPI support content and generate the modulefiles.
Note: CPE does not contain the Intel oneAPI compiler itself; the compiler must be installed separately.
mgmt1# cm image dnf -i <IMAGE_NAME> install cpe-hpe-cray-xd2000-intel-content-<CPE_RELEASE> mgmt1# chroot <IMAGE_ROOT> mgmt1(chroot)# . /opt/cray/pe/modules/default/init/bash mgmt1(chroot)# module load craypkg-gen mgmt1(chroot)# craypkg-gen -m /opt/intel/oneapi/compiler/<INTEL_VERSION> mgmt1(chroot)# exit
(Optional) If you are using Lua modulefiles, install
cray-lmod:mgmt1# cm image dnf -i <IMAGE_NAME> install cray-lmod lua-posix lua-filesystem mgmt1# chroot <IMAGE_ROOT> 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*
Installing HPE CPE on HPE Cray XD2000 Systems without HPCM
PREREQUISITES
Python 3.6.0 must be installed. The
cpe-installerrequires Python 3.6.0.A cluster image for use with CPE must 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.
The
glibc-develpackage 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.
OBJECTIVE
This procedure provides instructions for installing CPE into an image root on the HPE Cray XD2000 system.
PROCEDURE
Create the directory to mount the ISO file:
mgmt1# mkdir CPE-HPE-CRAY-XD2000-<CPE_RELEASE>
Mount the ISO file:
mgmt1# mount -r -o loop <PATH_TO_ISO> CPE-HPE-CRAY-XD2000-<CPE_RELEASE>
Change directory to the ISO mount directory:
mgmt1# cd CPE-HPE-CRAY-XD2000-<CPE_RELEASE>
Run the installer with the
--cpu-target(a supported CPU target architecture) and--image-rootparameters, with a full path to the image root:mgmt1# ./cpe-installer.py --cpu-target {x86-rome, x86-milan} --image-root <IMAGE_ROOT>Example:
Add the
--include-env aoccparameter to install the CPE AOCC support content.Note: CPE does not contain the AOCC Compiler; the compiler must be installed separately.
mgmt1# ./cpe-installer.py --cpu-target {x86-rome, x86-milan} \ --image-root <IMAGE_ROOT> --include-env aoccExample:
Add the
--include-env intelparameter to install the CPE Intel oneAPI support content.Note: CPE does not contain the Intel oneAPI compiler; the compiler must be installed separately.
mgmt1# ./cpe-installer.py --cpu-target {x86-rome, x86-milan} \ --image-root <IMAGE_ROOT> --include-env intel(Optional) Install GCC version 12 support if your operating system is RHEL 8.7:
mgmt1# dnf install --installroot <IMAGE_ROOT> gcc-native-12.1
(Optional) Generate the modulefiles for Intel if you are installing the CPE Intel oneAPI support content:
mgmt1# chroot <IMAGE_ROOT> mgmt1(chroot)# . /opt/cray/pe/modules/default/init/bash mgmt1(chroot)# module load craypkg-gen mgmt1(chroot)# craypkg-gen -m /opt/intel/oneapi/compiler/<INTEL_VERSION> mgmt1(chroot)# exit
(Optional) Set CrayPE as default on the system:
mgmt1# chroot <IMAGE_ROOT> sed -i '/^#.*enabled_by_default/s/^#//' cray-pe-configuration.*sh
(Optional) If you are using Lua modulefiles, get the
CPE-HPE-CRAY-XD2000-<CPE_RELEASE>repo ID, and then installcray-lmod:mgmt1# dnf repolist mgmt1# dnf install --config /etc/yum.repos.d/<REPO_ID>.repo \ --installroot <IMAGE_ROOT> cray-lmod lua-posix lua-filesystem
mgmt1# chroot <IMAGE_ROOT> 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>
Unmount the ISO:
mgmt1# cd .. && umount CPE-HPE-CRAY-XD2000-<CPE_RELEASE>
Reboot the compute nodes using the image with CPE installed.
Creating Modulefiles for Third-Party Products
PREREQUISITES
Third-party packages must be downloaded and installed.
OBJECTIVE
These procedures provide instructions for creating modulefiles for
third-party products. The instructions use craypkg-gen to create a
modulefile for a specific version of a supported third-party product.
This allows a site to set a specific version as default.
The following tasks are necessary and can be embedded in a script where a third-party product is being installed.
PROCEDURE
Load
craypkg-genmodule: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 defaultscript:/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 the Lmod static module hierarchy, please consult User
Guide for
Lmod.
Dynamic Lmod Hierarchy
The custom dynamic Lmod hierarchy of CPE abbreviates the overall Lmod
hierarchy tree by relying on compatibility and not directly on a
prerequisite’s 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/4.0 |
|
crayclang/20.0 |
|
aocc/4.1 |
|
intel/2023.2 |
|
gnu/10.0 |
|
nvidia/20 |
Network |
Module Alias/Compatible Version |
|---|---|
|
infiniband/1.0 |
|
ofi/1.0 |
|
ucx/1.0 |
CPU |
Module Alias/Compatible Version |
|---|---|
|
broadwell/1.0 |
|
x86-milan/1.0 |
|
x86-rome/1.0 |
|
x86-skylake/1.0 |
|
x86-cascadelake/1.0 |
|
x86-icelake/1.0 |
MPI |
Module Alias/Compatible Version |
|---|---|
|
cray-mpich/8.0 |
|
cray-mpich/8.0 |
|
cray-mpich/8.0 |
|
cray-mpich/8.0 |
|
cray-mpich/8.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. CPE supported custom dynamic module types 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 a compiler, network, CPU, and MPI module. Lmod cannot detect modules hidden in dynamic paths without one of each type of module being loaded.
Create a custom dynamic hierarchy
PREREQUISITES
Set Lmod as the default module handling system before initiating this procedure.
OBJECTIVE
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.
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 Module Path Aliases and Current Compatibility Versions 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 =
cceThe path alias/compatible version string (values found in Module Path Aliases and Current Compatibility Versions) is
crayclang/10.0; therefore, the text added to the environment variable name is:CRAYCLANG_10_0Network =
craype-network-ofiThe path alias/compatible version string is
ofi/1.0; therefore, the environment variable text is:OFI_1_0CPU =
craype-x86-romeThe path alias/compatible version string is
x86-rome/1.0; therefore, the environment variable text is:X86_ROME_1_0MPI =
cray-mpichcray-mpichhas 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 acray-mpichmodule dependent oncceandcraype-network-ofi, the path alias/compatible version string iscrayclang/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 =
ccewithcraype-network-ofiThe path alias/compatible version string is
crayclang/10.0/ofi/1.0; therefore, the environment variable text is:CRAYCLANG_10_0_OFI_1_0Compiler/CPU =
ccewithcraype-x86-romeThe 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_0Compiler/Network/CPU/MPI =
cce,craype-network-ofi,craype-x86-rome, andcray-mpichThe 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
_PREFIXfollowing the final module/compatibility text instance:Example: Network =
craype-network-ofiThe 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-ofiAll modulefiles in
<lmod_module_path>are shown to users whenevercraype-network-ofiis 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.03 |
24.11 |
24.07 |
|---|---|---|---|
Product / Release |
XD2000 |
XD2000 |
Apollo 2000 |
——————————— |
—————– |
—————– |
—————– |
HPCM |
1.13 |
1.12 |
1.11 |
——————————— |
—————– |
—————– |
—————– |
aocc |
5.0.0 |
4.2.0 |
4.2.0 |
——————————— |
—————– |
—————– |
—————– |
atp |
3.15.6 (D) |
3.15.5 (D) |
3.15.4 (D) |
——————————— |
—————– |
—————– |
—————– |
cce |
19.0.0 (D) |
18.0.1 (D) |
18.0.0 (D) |
——————————— |
—————– |
—————– |
—————– |
cpe-gcc-native |
10.3 |
10.3 |
10.3 |
——————————— |
—————– |
—————– |
—————– |
cpe-gcc-native |
11.2 |
11.2 |
11.2 |
——————————— |
—————– |
—————– |
—————– |
cpe-gcc-native |
12.2 |
12.2 |
12.2 |
——————————— |
—————– |
—————– |
—————– |
cpe-gcc-native |
13.2 (D) |
13.2 (D) |
13.2 (D) |
——————————— |
—————– |
—————– |
—————– |
cpe-prgenv-aocc |
8.6.0 (D) |
8.4.0 (D) |
8.4.0 (D) |
——————————— |
—————– |
—————– |
—————– |
cpe-prgenv-cray |
8.6.0 (D) |
8.4.0 (D) |
8.4.0 (D) |
——————————— |
—————– |
—————– |
—————– |
cpe-prgenv-gnu |
8.6.0 (D) |
8.4.0 (D) |
8.4.0 (D) |
——————————— |
—————– |
—————– |
—————– |
cpe-prgenv-intel |
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) |
——————————— |
—————– |
—————– |
—————– |
cray-ccdb |
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.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) |
——————————— |
—————– |
—————– |
—————– |
cray-dwarf |
0.11.1 (D) |
0.11.0 (D) |
0.9.2 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-dyninst |
12.3.5 (D) |
12.3.4 (D) |
12.3.2 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-fftw |
3.3.10.10 (D) |
3.3.10.9 (D) |
3.3.10.8 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-hdf5 |
1.14.3.5 (D) |
1.14.3.3 (D) |
1.14.3.1 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-libsci |
25.03.0 (D) |
24.11.0 (D) |
24.07.0 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-lmod |
8.7.55 |
8.7.31 |
8.7.31 |
——————————— |
—————– |
—————– |
—————– |
cray-modules |
3.2.11.7 (D) |
3.2.11.5 (D) |
3.2.11.5 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-mpich |
8.1.32 (D) |
8.1.31 (D) |
8.1.30 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-mrnet |
5.1.5 (D) |
5.1.4 (D) |
5.1.3 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-netcdf |
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) |
——————————— |
—————– |
—————– |
—————– |
cray-pals |
1.3.2 (D) |
1.3.2 (D) |
1.3.2 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-papi |
7.2.0.1 (D) |
7.1.0.4 (D) |
7.1.0.2 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-parallel-netcdf |
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 |
——————————— |
—————– |
—————– |
—————– |
cray-pe-profile-ofi-rome |
1.3 |
1.3 |
1.3 |
——————————— |
—————– |
—————– |
—————– |
cray-pe-profile-ofi-skylake |
1.3 |
1.3 |
1.3 |
——————————— |
—————– |
—————– |
—————– |
cray-pe-set-default |
3.3 (D) |
3.1 (D) |
3.1 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-pmi |
6.1.15 (D) |
6.1.15 (D) |
6.1.15 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-pmi-devel |
6.1.15 (D) |
6.1.15 (D) |
6.1.15 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-pmi-doc |
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) |
——————————— |
—————– |
—————– |
—————– |
cray-stat |
4.12.5 (D) |
4.12.4 (D) |
4.12.3 (D) |
——————————— |
—————– |
—————– |
—————– |
cray-zmqnet |
1.3.0 (D) |
1.0.0 (D) |
|
——————————— |
—————– |
—————– |
—————– |
craype |
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.6.0 (D) |
1.5.0 (D) |
1.4.0 (D) |
——————————— |
—————– |
—————– |
—————– |
craypkg-gen |
1.3.35 (D) |
1.3.34 (D) |
1.3.33 (D) |
——————————— |
—————– |
—————– |
—————– |
gdb4hpc |
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) |
——————————— |
—————– |
—————– |
—————– |
libzmq5 |
4.3.3 (D) |
4.3.3 (D) |
4.3.3 (D) |
——————————— |
—————– |
—————– |
—————– |
lmod_scripts |
3.2.1 (D) |
3.2.0 (D) |
3.2.0 (D) |
——————————— |
—————– |
—————– |
—————– |
Mellanox OFED |
5.8 (or later) |
5.8 |
5.8 |
——————————— |
—————– |
—————– |
—————– |
perftools |
25.03.0 (D) |
24.11.0 (D) |
24.07.0 (D) |
——————————— |
—————– |
—————– |
—————– |
sanitizers4hpc |
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.5 (D) |
2.13.4 (D) |
2.13.3 (D) |
Documentation and support
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 resources
HPE additionally 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.
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 crayccorman 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.htmlfile 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: