Skip to content

Commit 113574a

Browse files
authored
Add note about trying to mount a uenv with a uenv already mounted (#78)
1 parent dbb877a commit 113574a

File tree

1 file changed

+20
-0
lines changed

1 file changed

+20
-0
lines changed

docs/software/uenv.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -279,6 +279,26 @@ This is very useful for interactive sessions, for example if you want to work in
279279

280280
If your are one of the handful of users using `tcsh` (C shell) and you want to use uenv, we strongly recommend creating a request at the [CSCS service desk](https://jira.cscs.ch/plugins/servlet/desk) to change to either bash or zsh as your default.
281281

282+
!!! warning "Failed to unshare the mount namespace"
283+
284+
If you get the following error message when starting a uenv:
285+
```console
286+
$ uenv start linalg/24.11:v1
287+
squashfs-mount: Failed to unshare the mount namespace: Operation not permitted
288+
```
289+
you most likely already have a uenv mounted.
290+
The `uenv status` command will report that you have a uenv loaded if that is the case:
291+
```console
292+
$ uenv status
293+
prgenv-gnu:/user-environment
294+
GNU Compiler toolchain with cray-mpich, Python, CMake and other development tools.
295+
views:
296+
spack: configure spack upstream
297+
modules: activate modules
298+
default:
299+
```
300+
Unload the active uenv by exiting the current shell before loading the new uenv.
301+
282302
The basic syntax of uenv start is `uenv start image` where `image` is the uenv to start.
283303
The image can be a label, the hash/id of the uenv, or a file:
284304

0 commit comments

Comments
 (0)