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 -s 1.5 init --csi-folder /var/www/prep/SYSTEMNAME/ --out ips.txt

2. Check network firmware

canu -s 1.5 network firmware --ips-file ips.txt

3. Check network cabling

canu -s 1.5 network cabling --ips-file ips.txt

4. Validate BGP status

canu -s 1.5 validate bgp --ips-file ips.txt –verbose

5. Validate cabling

canu -s 1.5 validate cabling --ips-file ips.txt

6. Validation using the system’s SHCD

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

Validate the SHCD

canu -s 1.5 validate shcd --shcd SHCD.xlsx

Validate the SHCD against network cabling

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

Generate switch configuration for the network

canu -s 1.5 network config --shcd SHCD.xlsx --csi-folder /var/www/prep/SYSTEMNAME/ --folder configs