Quick start guide to CANU

Usage

Running canu with no arguments displays high level help. To see a list of commands and arguments, append --help. For example:

canu --help

To get help for a specific command (in this example, validating network cabling):

canu validate network cabling --help

When running CANU, the CSM version is required; it is specified with --csm. For example:

canu --csm 1.5

Validate a fresh system using CSI and CANU

1. Preparation

  1. Make a new directory to save switch IP addresses.

    mkdir ips_folder
    cd ips_folder
    
  2. Parse the CSI generated sls_input_file.json and save switch IP addresses.

    canu init --sls-file sls_input_file.json --out ips.txt
    

2. Check network firmware

canu report network firmware --csm 1.5 --ips-file ips.txt

3. Check network cabling

canu report network cabling --ips-file ips.txt

4. Validate cabling

canu validate network cabling --ips-file ips.txt

5. Validation using the system’s SHCD

With the system’s SHCD, CANU can also validate the configuration and cabling.

Validate the SHCD

canu validate shcd --shcd SHCD.xlsx

Validate the SHCD against network cabling

canu validate shcd-cabling --shcd SHCD.xlsx --ips-file ips.txt

Generate switch configuration for the network

canu generate network config --ccj ccj.json --sls-file sls_input_file.json  --folder configs