Skip to content

Commit

Permalink
Add additional changes to Config Tutorial (#82)
Browse files Browse the repository at this point in the history
  • Loading branch information
adamjstewart committed Nov 9, 2020
1 parent 40a6d76 commit c6eb911
Showing 1 changed file with 17 additions and 5 deletions.
22 changes: 17 additions & 5 deletions tutorial_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -732,7 +732,7 @@ node with 16 cores, this will look like:

.. code-block:: console
$ spack install --no-cache --verbose --overwrite zlib
$ spack install --no-cache --verbose --overwrite --yes-to-all zlib
==> Installing zlib
==> Executing phase: 'install'
==> './configure' '--prefix=/home/user/spack/opt/spack/linux-ubuntu18.04-x86_64/gcc-7.5.0/zlib-1.2.11-smoyzzo2qhzpn6mg6rd3l2p7b23enshg'
Expand All @@ -750,6 +750,11 @@ you have a strict ulimit or restriction on the number of available licenses,
you may not be able to build at all with this many cores. To limit the
number of cores our build uses, set ``build_jobs`` like so:

.. code-block:: console
$ spack config edit config
.. code-block:: yaml
config:
Expand All @@ -760,7 +765,7 @@ If we uninstall and reinstall zlib, we see that it now uses only 2 cores:

.. code-block:: console
$ spack install --no-cache --verbose --overwrite zlib
$ spack install --no-cache --verbose --overwrite --yes-to-all zlib
==> Installing zlib
==> Executing phase: 'install'
==> './configure' '--prefix=/home/user/spack/opt/spack/linux-ubuntu18.04-x86_64/gcc-7.5.0/zlib-1.2.11-smoyzzo2qhzpn6mg6rd3l2p7b23enshg'
Expand All @@ -775,9 +780,16 @@ If we uninstall and reinstall zlib, we see that it now uses only 2 cores:
Obviously, if you want to build everything in serial for whatever reason,
you would set ``build_jobs`` to 1.

--------
Examples
--------
----------
Conclusion
----------

In this tutorial, we covered basic Spack configuration using ``compilers.yaml``,
``packages.yaml``, and ``config.yaml``. Spack has many more configuration files,
including ``modules.yaml``, which will be covered in the :ref:`modules-tutorial`.
For more detailed documentation on Spack's many configuration settings, see
`the configuration section <https://spack.readthedocs.io/en/latest/configuration.html>`_
of Spack's main documentation.

For examples of how other sites configure Spack, see
https://github.com/spack/spack-configs. If you use Spack at your site
Expand Down

0 comments on commit c6eb911

Please sign in to comment.