Skip to content

Commit 34fee1c

Browse files
committed
updated docs
1 parent d5e8d9a commit 34fee1c

File tree

1 file changed

+16
-5
lines changed

1 file changed

+16
-5
lines changed

docs/operations.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -63,17 +63,28 @@ This is a usually a two-step process:
6363
Deploying the additional nodes and applying these changes requires rerunning both Terraform and the Ansible site.yml playbook - follow [Deploying a Cluster](#Deploying-a-Cluster).
6464

6565
# Adding Additional Packages
66-
Packages from any enabled DNF repositories (which always includes EPEL, PowerTools and OpenHPC) can be added to all nodes by defining a list `openhpc_packages_extra` (defaulted to the empty list in the common environment) in e.g. `environments/$SITE_ENV/inventory/group_vars/all/openhpc.yml`. For example:
67-
68-
# environments/foo-base/inventory/group_vars/all/openhpc.yml:
69-
openhpc_packages_extra:
66+
By default, the following utility packages are installed during build:
67+
- htop
68+
- nano
69+
- screen
70+
- tmux
71+
- wget
72+
- bind-utils
73+
- net-tools
74+
- postfix
75+
- git
76+
- latest python version for system (3.6 for for Rocky 8.9 and 3.12 for Rocky 9.4)
77+
Additional packages from any DNF repositories which are enabled during build (which always includes EPEL, PowerTools and OpenHPC) can be added to the image by defining a list `appliances_other_extra_package` (defaulted to the empty list in the common environment) in e.g. `environments/$SITE_ENV/inventory/group_vars/all/defaults.yml`. For example:
78+
79+
# environments/foo-base/inventory/group_vars/all/defaults.yml:
80+
appliances_other_extra_package:
7081
- somepackage
7182
- anotherpackage
7283

7384

7485
The packages available from the OpenHPC repos are described in Appendix E of the OpenHPC installation guide (linked from the [OpenHPC releases page](https://github.com/openhpc/ohpc/releases/)). Note "user-facing" OpenHPC packages such as compilers, mpi libraries etc. include corresponding `lmod` modules.
7586

76-
To add these packages to the current cluster, run the same command as for [Reconfiguring Slurm](#Reconfiguring-Slurm). TODO: describe what's required to add these to site-specific images.
87+
If you wish to install packages during runtime, the `site.yml` playbook should be run `appliances_packages_during_configure` overriden to `true` and `cluster` should be added as a child of the `dnf_repos` group in order to temporarily re-enabled DNF repositories during runtime (WARNING: this should only be done if using an unauthenticated local Pulp server. If using StackHPC Ark directly, doing this WILL leak credentials to users).
7788

7889
If additional repositories are required, these could be added/enabled as necessary in a play added to `environments/$SITE_ENV/hooks/{pre,post}.yml` as appropriate. Note such a plat should NOT exclude the builder group, so that the repositories are also added to built images. There are various Ansible modules which might be useful for this:
7990
- `ansible.builtin.yum_repository`: Add a repo from an URL providing a 'repodata' directory.

0 commit comments

Comments
 (0)