From 4a16aa69d799f65c85cc0ab2d3b8758b229d4cef Mon Sep 17 00:00:00 2001 From: Jason Sollom Date: Tue, 27 Aug 2024 14:47:30 -0500 Subject: [PATCH] CASMCMS-9112: Added two SBPS parameters Added information about two parameters that are needed for the Scalable Boot Projection Service (SBPS). --- operations/iuf/workflows/configuration.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/operations/iuf/workflows/configuration.md b/operations/iuf/workflows/configuration.md index 99cd10749d93..3341ea1bcf89 100644 --- a/operations/iuf/workflows/configuration.md +++ b/operations/iuf/workflows/configuration.md @@ -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 @@ -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. @@ -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.