Skip to content

canu validate

CANU validate commands.

canu validate [OPTIONS] COMMAND [ARGS]...

network

Commands that validate the network.

canu validate network [OPTIONS] COMMAND [ARGS]...

bgp

Validate BGP neighbors.

This command will check the BGP neighbors for the switch IP addresses entered. All of the neighbors of a switch must be ‘Established’, or the verification will fail.

If a switch that is not a spine switch is tested, it will show in the results table as ‘SKIP’.

  • Enter a comma separated list of IP addresses with the ‘—ips’ flag.
  • Or read the IP addresses from a file, one IP address per line, using ‘–ips-file FILENAME’ flag.

If you want to see the individual status of all the neighbors of a switch, use the ‘–verbose’ flag.

noqa: D301

Args: : ctx: CANU context settings username: Switch username password: Switch password verbose: Bool indicating verbose output network: The network that BGP neighbors are checked

canu validate network bgp [OPTIONS]

Options

--username

Switch username

  • Default: 'admin'

--password

Switch password

--network

The network that BGP neighbors are checked.

  • Default: 'ALL'
  • Options: ALL | NMN | CMN

--verbose

Verbose mode

cabling

Validate network cabling.

CANU can be used to validate that network cabling passes basic validation checks.

This command will use LLDP to determine if the network is properly connected architecturally.

The validation will ensure that spine switches, leaf switches, edge switches, and nodes all are connected properly.

noqa: D301, B950

Args: : ctx: CANU context settings architecture: CSM architecture ips: Comma separated list of IPv4 addresses of switches ips_file: File with one IPv4 address per line username: Switch username password: Switch password
log_
: Level of logging. out: Name of the output file

canu validate network cabling [OPTIONS]

Options

-a, --architecture

Required CSM architecture

  • Options: Full | TDS | v1

--ips

Comma separated list of IPv4 addresses of switches

--ips-file

File with one IPv4 address per line

--username

Switch username

  • Default: 'admin'

--password

Switch password

--log

Level of logging.

  • Options: DEBUG | INFO | WARNING | ERROR

--out

Output results to a file

paddle

Validate a CCJ file.

Pass in a CCJ file to validate that it works architecturally. The validation will ensure that spine switches, leaf switches, edge switches, and nodes all are connected properly.

noqa: D301

Args: : ctx: CANU context settings ccj: Paddle CCJ file out: Filename for the JSON Topology if requested.
log_
: Level of logging.

canu validate paddle [OPTIONS]

Options

--ccj

CCJ (CSM Cabling JSON) File containing system topology.

--out

Output results to a file

--log

Level of logging.

  • Options: DEBUG | INFO | WARNING | ERROR

paddle-cabling

Validate a CCJ file against the current network cabling.

Pass in a CCJ file to validate that it works architecturally.

This command will also use LLDP to determine the neighbors of the IP addresses passed in to validate that the network is properly connected architecturally.

The validation will ensure that spine switches, leaf switches, edge switches, and nodes all are connected properly.

noqa: D301

Args: : ctx: CANU context settings csm: csm version ccj: Paddle CCJ file ips: Comma separated list of IPv4 addresses of switches ips_file: File with one IPv4 address per line username: Switch username password: Switch password
log_
: Level of logging out: Name of the output file

canu validate paddle-cabling [OPTIONS]

Options

--csm

Required CSM network version

  • Options: 1.0 | 1.2 | 1.3 | 1.4 | 1.5 | 1.6

--ccj

Required CCJ (CSM Cabling JSON) File containing system topology.

--ips

Comma separated list of IPv4 addresses of switches

--ips-file

File with one IPv4 address per line

--username

Switch username

  • Default: 'admin'

--password

Switch password

--log

Level of logging.

  • Options: DEBUG | INFO | WARNING | ERROR

--out

Output results to a file

shcd

Validate a SHCD file.

CANU can be used to validate that an SHCD (SHasta Cabling Diagram) passes basic validation checks.

  • 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.

noqa: D301, B950

Args: : ctx: CANU context settings architecture: CSM architecture shcd: 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’. edge: Vendor of the edge router out: Filename for the JSON Topology if requested.
json_
: Bool indicating json output
log_
: Level of logging.

canu validate shcd [OPTIONS]

Options

-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’.

--edge

Required Vendor of Edge router

  • Options: Aruba | Arista

--out

Output results to a file

--json

Output JSON model to a file

--log

Level of logging.

  • Options: DEBUG | INFO | WARNING | ERROR

shcd-cabling

Validate a SHCD file against the current network cabling.

Pass in a SHCD file and a list of IP address to compair the connections.

The output of the validate shcd-cabling command will show a port by port comparison between the devices found in the SHCD and devices found on the network. If there is a difference in what is found connected to a devices port in SHCD and Cabling, the line will be highlighted in ‘red’.

noqa: D301, B950

Args: : ctx: CANU context settings csm: csm version architecture: CSM architecture shcd: 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’. ips: Comma separated list of IPv4 addresses of switches ips_file: File with one IPv4 address per line macs: Print NCN MAC addresses username: Switch username password: Switch password
log_
: Level of logging out: Name of the output file

canu validate shcd-cabling [OPTIONS]

Options

--csm

Required CSM network version

  • Options: 1.0 | 1.2 | 1.3 | 1.4 | 1.5 | 1.6

-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’.

--ips

Comma separated list of IPv4 addresses of switches

--ips-file

File with one IPv4 address per line

--username

Switch username

  • Default: 'admin'

--password

Switch password

--log

Level of logging.

  • Options: DEBUG | INFO | WARNING | ERROR

--out

Output results to a file

--macs

Print NCN MAC addresses

switch

Commands that validate a switch.

canu validate switch [OPTIONS] COMMAND [ARGS]...

config

Validate switch config.

After config has been generated, CANU can validate the generated config against running switch config. The running config can be from either an IP address, or a config file.

  • To get running config from an IP address, use the flags ‘–ip 192.168.1.1 –username USERNAME –password PASSWORD’.
  • To get running config from a file, use the flag ‘–running RUNNING_CONFIG.cfg’ instead.

After running the ‘validate switch config’ command, you will be shown a line by line comparison of the currently running switch config against the config file that was passed in. You will also be given a list of remediation commands that can be typed into the switch to get the running config to match the config file. There will be a summary table at the end highlighting the most important differences between the configs.

  • Lines that are red and start with a ‘-’ are in the running config, but not in the config file
  • Lines that are green and start with a ‘+’ are not in the running config, but are in the config file
  • Lines that are blue and start with a ‘?’ are attempting to point out specific line differences

noqa: D301, B950

Args: : ctx: CANU context settings ip: The IP address of the switch running: The running switch config file username: Switch username password: Switch password generated_config: Generated config file out: Name of the output file vendor: Switch vendor. Aruba, Dell, or Mellanox remediation: output remediation config

canu validate switch config [OPTIONS]

Options

--ip

The IP address of the switch with running config

--running

The running switch config file

--vendor

The vendor is needed if passing in the running config from a file

  • Options: Aruba | Dell | Mellanox

--username

Switch username

  • Default: 'admin'

--password

Switch password

--generated

Generated config file

--out

Output results to a file

--remediation

Outputs commands to get from the running-config to generated config, Mellanox not supported