Skip to content

Latest commit

 

History

History
165 lines (84 loc) · 4.46 KB

generate_network_config.md

File metadata and controls

165 lines (84 loc) · 4.46 KB

Generate Network Config

canu generate network config

Generate the config of all switches (Aruba, Dell, or Mellanox) on the network using the SHCD.

In order to generate network switch config, a valid SHCD must be passed in and system variables must be read in from either an SLS output file or the SLS API.

CSI Input

  • In order to parse network data using SLS, pass in the file containing SLS JSON data (normally sls_file.json) using the ‘–sls-file’ flag

  • If used, CSI-generated sls_input_file.json file is generally stored in one of two places depending on how far the system is in the install process.

  • Early in the install process, when running off of the LiveCD the sls_input_file.json file is normally found in the the directory ‘/var/www/ephemeral/prep/SYSTEMNAME/’

  • Later in the install process, the sls_file.json file is generally in ‘/mnt/pitdata/prep/SYSTEMNAME/’

SLS API Input

  • To parse the Shasta SLS API for IP addresses, ensure that you have a valid token.

  • The token file can either be passed in with the ‘–auth-token TOKEN_FILE’ flag, or it can be automatically read if the environmental variable ‘SLS_TOKEN’ is set.

  • The SLS address is default set to ‘api-gw-service-nmn.local’.

  • if you are operating on a system with a different address, you can set it with the ‘–sls-address SLS_ADDRESS’ flag.

SHCD Input

  • Use the ‘–tabs’ flag to select which tabs on the spreadsheet will be included.

  • The ‘–corners’ flag is used to input the upper left and lower right corners of the table on each tab of the worksheet. If the corners are not specified, you will be prompted to enter them for each tab.

  • The table should contain the 11 headers: Source, Rack, Location, Slot, (Blank), Port, Destination, Rack, Location, (Blank), Port.

Use the ‘–folder FOLDERNAME’ flag to output all the switch configs to a folder.

canu generate network config [OPTIONS]

Options

--csm( )

Required CSM network version

  • Options

    1.0 | 1.2

-a(, --architecture( )

Required CSM architecture

  • Options

    Full | TDS | V1

--shcd( )

Required SHCD file

--tabs( )

The tabs on the SHCD file to check, e.g. 10G_25G_40G_100G,NMN,HMN.

--corners( )

The corners on each tab, comma separated e.g. ‘J37,U227,J15,T47,J20,U167’.

--sls-file( <sls_file>)

File containing system SLS JSON data.

--auth-token( <auth_token>)

Token for SLS authentication

--sls-address( <sls_address>)

  • Default

    api-gw-service-nmn.local

--folder( )

Required Folder to store config files

--override( )

Switch configuration override

Environment variables

SLS_TOKEN()

Provide a default for --auth-token

Examples

1. Generate network config from SLS API

To generate network config run: canu generate network config --csm 1.2 -a full --shcd FILENAME.xlsx --tabs 'INTER_SWITCH_LINKS,NON_COMPUTE_NODES,HARDWARE_MANAGEMENT,COMPUTE_NODES' --corners 'J14,T44,J14,T48,J14,T24,J14,T23' --auth_token TOKEN_FILE --folder SWITCH_CONFIG

$ canu generate network config --csm 1.2 -a full --shcd FILENAME.xlsx --tabs INTER_SWITCH_LINKS,NON_COMPUTE_NODES,HARDWARE_MANAGEMENT,COMPUTE_NODES --corners J14,T44,J14,T48,J14,T24,J14,T23 --auth_token TOKEN_FILE --folder SWITCH_CONFIG

sw-spine-001 Config Generated
sw-spine-002 Config Generated
sw-leaf-001 Config Generated
sw-leaf-002 Config Generated
sw-leaf-003 Config Generated
sw-leaf-004 Config Generated
sw-cdu-001 Config Generated
sw-cdu-002 Config Generated
sw-leaf-bmc-001 Config Generated

2. Generate network config from CSI

To generate network config run: canu generate network config --csm 1.2 -a full --shcd FILENAME.xlsx --tabs 'INTER_SWITCH_LINKS,NON_COMPUTE_NODES,HARDWARE_MANAGEMENT,COMPUTE_NODES' --corners 'J14,T44,J14,T48,J14,T24,J14,T23' --sls-file SLS_FILE --folder SWITCH_CONFIG

$ canu generate network config --csm 1.2 -a full --shcd FILENAME.xlsx --tabs INTER_SWITCH_LINKS,NON_COMPUTE_NODES,HARDWARE_MANAGEMENT,COMPUTE_NODES --corners J14,T44,J14,T48,J14,T24,J14,T23 --sls-file SLS_FILE --folder SWITCH_CONFIG

sw-spine-001 Config Generated
sw-spine-002 Config Generated
sw-leaf-001 Config Generated
sw-leaf-002 Config Generated
sw-leaf-003 Config Generated
sw-leaf-004 Config Generated
sw-cdu-001 Config Generated
sw-cdu-002 Config Generated
sw-leaf-bmc-001 Config Generated

Back To Readme