Initialize the CSM Automatic Network Utility (CANU) in order to help create the switch configurations. CANU can automatically parse CSI output or the Shasta System Layout Service (SLS) API for switch IPv4 addresses. Using the SLS API is only possible after the CSM install has been completed at least to the point where CSM Services have been deployed. Prior to that, parsing CSI output is the only option.
The output file for the canu init
command is set with the --out FILENAME
argument.
In order to parse CSI output, use the --csi-folder FOLDER
flag to pass in the folder where the sls_input_file.json
file is located.
The sls_input_file.json
file is generally stored in one of two places, depending on how far the system is in the install process.
When running off of the LiveCD, the sls_input_file.json
file is normally found in the /var/www/ephemeral/prep/SYSTEMNAME/
directory on the PIT node.
After the PIT node has been redeployed, the sls_input_file.json
file may be found in the /metal/bootstrap/prep/SYSTEMNAME/
directory on ncn-m001
or ncn-m003
.
To get the switch IP addresses from CSI output, run the following command:
canu -s 1.4 init --csi-folder /CSI/OUTPUT/FOLDER/ADDRESS --out output.txt
Eight IP addresses are saved to output.txt
.
Parsing the SLS API for IP addresses requires a valid API token. Either the token file can be passed in with the
--auth-token TOKEN_FILE
flag, or the token can be read from the SLS_TOKEN
environment variable, if it is exported.
The SLS address is by default set to api-gw-service-nmn.local
. If needed, a different address can be specified using the --sls-address SLS_ADDRESS
flag.
To get the switch IP addresses from the Shasta SLS API, run the following command:
canu -s 1.4 init --auth-token ~./config/cray/tokens/ --sls-address 1.2.3.4 --out output.txt