Skip to content

Commit

Permalink
CASMCMS-9112: Added two SBPS parameters
Browse files Browse the repository at this point in the history
Added information about two parameters that are needed for the
Scalable Boot Projection Service (SBPS).
  • Loading branch information
jsollom-hpe committed Aug 30, 2024
1 parent 1ab0462 commit 4a16aa6
Showing 1 changed file with 14 additions and 1 deletion.
15 changes: 14 additions & 1 deletion operations/iuf/workflows/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ the HPC CSM Software Recipe with the existing content in `${ADMIN_DIR}`.

1. Edit the `compute-and-uan-bootprep.yaml` and `management-bootprep.yaml` files to account for any site deviations from the default values. For example:
- Comment out the `slurm-site` CFS configuration layer and uncomment the `pbs-site` CFS configuration layer in `compute-and-uan-bootprep.yaml` if PBS is the preferred workload manager
- Comment out the SBPS `rootfs_provider` and `rootfs_provider_passthrough` parameters and uncomment the CPS `rootfs_provider` and `rootfs_provider_passthrough` parameters, if DVS with CPS is the preferred method to project content.
- Uncomment the `gpu-{{recipe.version}}` CFS configuration layer and `gpu-image` image definition in `compute-and-uan-bootprep.yaml` if the system has GPU hardware
- Comment out any CFS configuration layers in `compute-and-uan-bootprep.yaml` and `management-bootprep.yaml` files for products that are not needed on the system
- Any other changes needed to reflect site preferences
Expand All @@ -59,7 +60,17 @@ the HPC CSM Software Recipe with the existing content in `${ADMIN_DIR}`.
There are comments at the top of the `product_vars.yaml` file that describe the variables and related details. The following are a few examples of `site_vars.yaml` changes:
- Add a `default` section containing a `network_type: "cassini"` entry to designate that Cassini is the desired Slingshot network type to be used when executing CFS configurations later in the workflow
- Add a `suffix` entry to the `default` section to append a string to the names of CFS configuration, image, and BOS session template artifacts created during the workflow to make them easy to identify

- Add a 'system-name' entry to the `default` section. The Scalable Boot Projection Service (SBPS) uses this system name as the first part of the domain name. Do not add if not using SBPS.
- See the following page in the CSM documentation: 'operations/boot_orchestration/Create_a_Session_Template_to_Boot_Compute_Nodes_with_SBPS.md'
- If the 'docs-csm' RPM is installed on a node, then this page can be found under '/usr/share/doc/csm/'.
- Otherwise, it can be found under the appropriate release branch in 'https://github.com/Cray-HPE/docs-csm'
- This documentation indicates how to find the system-name.
- Add a 'site-domain' entry to the `default` section. The Scalable Boot Projection Service (SBPS) uses this domain name as the second part of the domain name. Do not add if not using SBPS.
- See the following page in the CSM documentation: 'operations/boot_orchestration/Create_a_Session_Template_to_Boot_Compute_Nodes_with_SBPS.md'
- If the 'docs-csm' RPM is installed on a node, then this page can be found under '/usr/share/doc/csm/'.
- Otherwise, it can be found under the appropriate release branch in 'https://github.com/Cray-HPE/docs-csm'
- This documentation indicates how to find the site-domain.

Additional information on `site_vars.yaml` files can be found in the [Site and recipe variables](../IUF.md#site-and-recipe-variables) and [`update-vcs-config`](../stages/update_vcs_config.md) sections.

1. <create a `site_vars.yaml` file with desired key/value pairs >
Expand All @@ -78,6 +89,8 @@ the HPC CSM Software Recipe with the existing content in `${ADMIN_DIR}`.
default:
network_type: "cassini"
suffix: "-test01"
system-name: "my-system"
site-domain: "my-site-domain.net"
```

3. Ensure the expected files are present in the admin directory after performing the steps in this section.
Expand Down

0 comments on commit 4a16aa6

Please sign in to comment.