Skip to content

Update prgenv-gnu/25.6 documentation #254

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Sep 4, 2025
Merged

Update prgenv-gnu/25.6 documentation #254

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4de307d
Update prgenv-gnu/25.6 documentation
msimberg Sep 4, 2025
acd6231
Update note about xcb workaround for nvidia profilers
msimberg Sep 4, 2025
a28e6ae
Add workarounds and UIs to spell checker whitelist
msimberg Sep 4, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion .github/actions/spelling/allow.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,7 @@ Scopi
Signalkuppe
TOTP
UANs
UIs
UserLab
Wannier
XDG
Expand Down Expand Up @@ -212,6 +213,7 @@ netlib
netrc
nql
nsight
nsys
numa
nvcr
nvdashboard
Expand Down Expand Up @@ -341,6 +343,7 @@ wikipedia
wikitext
wlcg
workaround
workarounds
workflows
wrf
xattr
Expand All @@ -357,4 +360,4 @@ jobscript
Scalasca
tracefile
Vampir
XAmz
XAmz
4 changes: 4 additions & 0 deletions docs/software/devtools/nvidia-nsight.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,10 @@ As a sampling profiler, it can be easily used to profile applications written in
### Known Issues and Common Problems

??? warning "CrashReporter: Qt initialization failed, Failed to load Qt platform plugin: xcb"
!!! info "This workaround is not needed for uenvs that provide `xcb-util-cursor`"
Uenvs that provide the `xcb-util-cursor` package don't require this workaround anymore.
Starting with 25.6, the [`prgenv-gnu`][ref-uenv-prgenv-gnu] provides `xcb-util-cursor`.

While we recommend using `ncu` instead of `ncu-ui`, it is possible to use X11 to launch ncu-ui.
However, this will fail with the following error message: `Failed to load Qt platform plugin: "xcb"`.

Expand Down
104 changes: 65 additions & 39 deletions docs/software/prgenv/prgenv-gnu.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ The release schedule is not fixed, with new versions will be released roughly ev

| version | node types | system |
|--------------------|-------------------|-----------------------------------------|
| 25.06 (prerelease) | gh200 | daint |
| 25.6 | gh200 | daint, eiger, santis, clariden |
| 24.11 | a100, gh200, zen2 | daint, eiger, santis, clariden, bristen |
| 24.7 | gh200, zen2 | daint, eiger, todi |

Expand All @@ -32,6 +32,49 @@ We will provide full support for 12 months after the uenv image is released, and

### Versions

=== "25.6"

The key updates in version 25.6 compared to 24.11 are:

* upgrading GCC to version 14 and CUDA to version 12.9
* upgrading cray-mpich to version 8.1.32
* adding xcb-util-cursor to the default view to allow the [NVIDIA Nsight UIs][ref-devtools-nsight] to be used without manual workarounds

The spack version used to build the packages was also upgraded to 1.0.

??? info "all packages exposed via the `default` and `modules` views in `v1`"
* [[email protected]](https://packages.spack.io/package.html?name=aws-ofi-nccl)
* [[email protected]](https://packages.spack.io/package.html?name=boost)
* [[email protected]](https://packages.spack.io/package.html?name=cmake)
* [[email protected]](https://packages.spack.io/package.html?name=cray-mpich)
* [[email protected]](https://packages.spack.io/package.html?name=cuda)
* [[email protected]](https://packages.spack.io/package.html?name=fftw)
* [[email protected]](https://packages.spack.io/package.html?name=fmt)
* [[email protected]](https://packages.spack.io/package.html?name=gcc)
* [[email protected]](https://packages.spack.io/package.html?name=gsl)
* [[email protected]](https://packages.spack.io/package.html?name=hdf5)
* [[email protected]](https://packages.spack.io/package.html?name=kokkos)
* [[email protected]](https://packages.spack.io/package.html?name=kokkos-kernels)
* [kokkos-tools@develop](https://packages.spack.io/package.html?name=kokkos-tools)
* [[email protected]](https://packages.spack.io/package.html?name=libtree)
* [[email protected]](https://packages.spack.io/package.html?name=lua)
* [[email protected]](https://packages.spack.io/package.html?name=lz4)
* [[email protected]](https://packages.spack.io/package.html?name=meson)
* [[email protected]](https://packages.spack.io/package.html?name=nccl)
* [[email protected]](https://packages.spack.io/package.html?name=nccl-tests)
* [[email protected]](https://packages.spack.io/package.html?name=netcdf-c)
* [[email protected]](https://packages.spack.io/package.html?name=netcdf-cxx)
* [[email protected]](https://packages.spack.io/package.html?name=netcdf-fortran)
* [[email protected]](https://packages.spack.io/package.html?name=netlib-scalapack)
* [[email protected]](https://packages.spack.io/package.html?name=ninja)
* [[email protected]](https://packages.spack.io/package.html?name=openblas)
* [[email protected]](https://packages.spack.io/package.html?name=osu-micro-benchmarks)
* [[email protected]](https://packages.spack.io/package.html?name=papi)
* [[email protected]](https://packages.spack.io/package.html?name=python)
* [[email protected]](https://packages.spack.io/package.html?name=superlu)
* [[email protected]](https://packages.spack.io/package.html?name=xcb-util-cursor)
* [[email protected]](https://packages.spack.io/package.html?name=zlib-ng)

=== "24.11"

The key updates in version 24.11:v1 from the 24.7 version were:
Expand Down Expand Up @@ -79,25 +122,6 @@ We will provide full support for 12 months after the uenv image is released, and
* [[email protected]](https://packages.spack.io/package.html?name=netcdf-cxx)
* [[email protected]](https://packages.spack.io/package.html?name=netcdf-fortran)

=== "25.06"

!!! warning "Prerelease"
The `prgenv-gnu/25.06` uenv is currently available as a prerelease on [daint][ref-cluster-daint], and is subject to change before the final release.
Prereleases are tagged with `rcN` tags.
[Let us know][ref-get-in-touch] if you find issues with the uenv.

!!! warning "Unstable Spack version used for the uenv"
If you are [building software through spack on top of a uenv][ref-building-uenv-spack], be aware that the 25.06 uenv is based on a prerelease version of Spack that contains [many breaking changes](https://github.com/spack/spack/discussions/30634).
Using a commit other than the one used to build the uenv will likely result in issues.

The key updates in version 25.06 compared to 24.11 are:

* upgrading GCC to version 14 and CUDA to version 12.9
* upgrading cray-mpich to version 8.1.32

??? info "all packages exposed via the `default` and `modules` views in `v1`"
!!! todo "The list of 25.06 package versions is yet to be finalized"

[](){#ref-uenv-prgenv-gnu-how-to-use}
## How to use

Expand All @@ -112,21 +136,21 @@ There are three ways to access the software provided by prgenv-gnu, once it has
!!! example "test mpi compilers and python provided by prgenv-gnu/24.11"
```console
# start using the default view
$ uenv start --view=default prgenv-gnu/24.11:v1
$ uenv start --view=default prgenv-gnu/25.6:v1

# the python executable provided by the uenv is the default, and is a recent version
$ which python
/user-environment/env/default/bin/python
$ python --version
Python 3.12.5
Python 3.13.5

# the mpi compiler wrappers are also available
$ which mpicc
/user-environment/env/default/bin/mpicc
$ mpicc --version
gcc (Spack GCC) 13.3.0
gcc (Spack GCC) 14.2.0
$ gcc --version # the compiler wrapper uses the gcc provided by the uenv
gcc (Spack GCC) 13.3.0
gcc (Spack GCC) 14.2.0
```

=== "modules"
Expand All @@ -136,23 +160,25 @@ There are three ways to access the software provided by prgenv-gnu, once it has

!!! example "starting prgenv-gnu and listing the provided modules"
```console
$ uenv start prgenv-gnu/24.11:v1 --view=modules
$ uenv start prgenv-gnu/25.6:v1 --view=modules
$ module avail
---------------------------- /user-environment/modules ----------------------------
aws-ofi-nccl/git.v1.9.2-aws_1.9.2 lua/5.4.6
boost/1.86.0 lz4/1.10.0
cmake/3.30.5 meson/1.5.1
cray-mpich/8.1.30 nccl-tests/2.13.6
cuda/12.6.2 nccl/2.22.3-1
fftw/3.3.10 netlib-scalapack/2.2.0
fmt/11.0.2 ninja/1.12.1
gcc/13.3.0 openblas/0.3.28
gsl/2.8 osu-micro-benchmarks/5.9
hdf5/1.14.5 papi/7.1.0
kokkos-kernels/4.4.01 python/3.12.5
kokkos-tools/develop superlu/5.3.0
kokkos/4.4.01 zlib-ng/2.2.1
libtree/3.1.1
aws-ofi-nccl/1.16.0 meson/1.7.0
boost/1.88.0 nccl-tests/2.16.3
cmake/3.31.8 nccl/2.27.5-1
cray-mpich/8.1.32 netcdf-c/4.9.2
cuda/12.9.0 netcdf-cxx/4.2
fftw/3.3.10 netcdf-fortran/4.6.1
fmt/11.2.0 netlib-scalapack/2.2.2
gsl/2.8 ninja/1.12.1
hdf5/1.14.6 openblas/0.3.29
kokkos-kernels/4.6.01 osu-micro-benchmarks/7.5
kokkos-tools/develop papi/7.1.0
kokkos/4.6.01 python/3.13.5
libfabric/1.22.0 squashfs/4.6.1
libtree/3.1.1 superlu/7.0.0
lua/5.4.6 xcb-util-cursor/0.1.5
lz4/1.10.0 zlib-ng/2.2.4
```

=== "Spack"
Expand Down