Warning

The spack-stack documentation moved from readthedocs to the JCSDA spack-stack Wiki (https://github.com/jcsda/spack-stack/wiki) with release 2.0.0.

The latest documentation here is for spack-stack-1.9.3.

Table of contents

• 1. Overview
  • 1.1. Getting started
• 2. Using spack-stack environments
  • 2.1. Load the spack-stack environment
  • 2.2. Create and activate a python virtual environment
  • 2.3. Configure build system to utilize the python virtual environment
• 3. Pre-configured sites
  • 3.1. Environment naming conventions
  • 3.2. Pre-configured sites (tier 1)
    • 3.2.1. MSU Orion
    • 3.2.2. MSU Hercules
    • 3.2.3. NASA Discover SCU17
    • 3.2.4. NASA NAS
    • 3.2.5. NAVY HPCMP Narwhal
    • 3.2.6. NAVY HPCMP Nautilus
    • 3.2.7. NAVY HPCMP Blueback
    • 3.2.8. NCAR-Wyoming Derecho
    • 3.2.9. NOAA Acorn (WCOSS2 test system)
    • 3.2.10. NOAA Parallel Works (AWS, Azure, Gcloud)
    • 3.2.11. U.S. Navy Parallel Works (AWS)
    • 3.2.12. NOAA RDHPCS Gaea C5
    • 3.2.13. NOAA RDHPCS Gaea C6
    • 3.2.14. NOAA RDHPCS Hera
    • 3.2.15. NOAA RDHPCS Ursa
    • 3.2.16. NOAA RDHPCS Jet
    • 3.2.17. UW (Univ. of Wisconsin) S4
    • 3.2.18. Amazon Web Services Parallelcluster Ubuntu 20.04
    • 3.2.19. Amazon Web Services Single Node Red Hat 8
  • 3.3. Pre-configured sites (tier 2)
    • 3.3.1. Blackpearl
    • 3.3.2. NCAR-Wyoming Casper
    • 3.3.3. EMC RedHat Enterprise Linux 8
    • 3.3.4. ??? Frontera
    • 3.3.5. Linux/macOS default configs
    • 3.3.6. AWS Ubuntu 24.04
    • 3.3.7. AWS Rocky8
    • 3.3.8. Azure Ubuntu 24.04 with Nvidia compilers
  • 3.4. Create local environment
  • 3.5. Extending environments
• 4. Creating and installing new environments
• 5. Adding test packages (chaining environments)
• 6. Generating new site configs
  • 6.1. macOS
    • 6.1.1. Mac native architectures
    • 6.1.2. Homebrew notes
    • 6.1.3. Prerequisites (one-off)
    • 6.1.4. Creating a new environment
  • 6.2. Linux
    • 6.2.1. Prerequisites: Red Hat/CentOS 8 (one-off)
    • 6.2.2. Prerequisites: Ubuntu (one-off)
    • 6.2.3. Creating a new environment
• 7. Creating Containers
  • 7.1. Container recipes
    • 7.1.1. Container build example
• 8. Constructing Environments
  • 8.1. Additional packages
  • 8.2. Virtual packages
  • 8.3. Templates
• 9. Extension of spack command in spack-stack
• 10. Miscellaneous utilities
  • 10.1. show_duplicate_packages.py
  • 10.2. check_permissions.sh
  • 10.3. ldd_check.py (Linux only)
  • 10.4. parallel_install.sh
  • 10.5. Acorn utilities
• 11. Known Issues
  • 11.1. General
  • 11.2. NASA Discover
  • 11.3. NOAA Parallel Works
  • 11.4. UW (Univ. of Wisconsin) S4
  • 11.5. NAVY HPCMP Narwhal
  • 11.6. macOS
  • 11.7. Ubuntu
• 12. Maintainers/Developers Section
  • 12.1. Manual software installations
    • 12.1.1. git-lfs
    • 12.1.2. qt (qt@5)
    • 12.1.3. MySQL (server and client; optional)
    • 12.1.4. Texlive (TeX/LaTeX; optional)
  • 12.2. Optional step for sites with a preconfigured spack mirror
  • 12.3. Pre-configuring sites
    • 12.3.1. Preface/general instructions
    • 12.3.2. NASA Discover SCU16
    • 12.3.3. NASA Discover SCU17
    • 12.3.4. NAVY HPCMP Narwhal
    • 12.3.5. NCAR-Wyoming Derecho
    • 12.3.6. NOAA Parallel Works (AWS, Azure, Gcloud)
    • 12.3.7. NOAA RDHPCS Gaea C5
    • 12.3.8. NOAA RDHPCS Hera
    • 12.3.9. NOAA RDHPCS Jet
    • 12.3.10. Amazon Web Services Parallelcluster Ubuntu 20.04
  • 12.4. Creating/maintaining spack mirrors
    • 12.4.1. Spack mirrors for local reuse
    • 12.4.2. Spack mirrors for air-gapped systems
    • 12.4.3. Bootstrap mirrors for air-gapped systems
  • 12.5. Testing new packages
    • 12.5.1. Using spack to test/add packages
    • 12.5.2. Testing/adding packages outside of spack
• 13. Automated builds
  • 13.1. Workflow
  • 13.2. Overview of implementing on a new platform
    • 13.2.1. Platform-specific configuration
    • 13.2.2. Setting up weekly builds: cron
• 14. Generating Sphinx Documentation
• 15. Acronyms
• 16. Glossary