summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGreg Becker <becker33@llnl.gov>2018-10-02 14:58:40 -0700
committerGitHub <noreply@github.com>2018-10-02 14:58:40 -0700
commit97d0dd239036e78e0810274c703cb85ad030b05c (patch)
tree42490d7dd18de702dfecc4ca098b696dd1c1eb94
parentf6fb176d10f67b9ab2edafe859416d9f4ed9c2ce (diff)
downloadspack-97d0dd239036e78e0810274c703cb85ad030b05c.tar.gz
spack-97d0dd239036e78e0810274c703cb85ad030b05c.tar.bz2
spack-97d0dd239036e78e0810274c703cb85ad030b05c.tar.xz
spack-97d0dd239036e78e0810274c703cb85ad030b05c.zip
Update Spack on Cray docs for singularity platform=linux workaround (#9398)
-rw-r--r--lib/spack/docs/getting_started.rst14
1 files changed, 14 insertions, 0 deletions
diff --git a/lib/spack/docs/getting_started.rst b/lib/spack/docs/getting_started.rst
index aaaeb9dec7..97b9a3a235 100644
--- a/lib/spack/docs/getting_started.rst
+++ b/lib/spack/docs/getting_started.rst
@@ -1266,3 +1266,17 @@ for each compiler type for each cray modules. This ensures that for each
compiler on our system we can use that external module.
For more on external packages check out the section :ref:`sec-external-packages`.
+
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Using Linux containers on Cray machines
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Spack uses environment variables particular to the Cray programming
+environment to determine which systems are Cray platforms. These
+environment variables may be propagated into containers that are not
+using the Cray programming environment.
+
+To ensure that Spack does not autodetect the Cray programming
+environment, unset the environment variable ``CRAYPE_VERSION``. This
+will cause Spack to treat a linux container on a Cray system as a base
+linux distro.