Management Network Upgrade CSM 1.2 to 1.3

Prerequisites

  • System is currently running CANU-generated CSM 1.2 configurations.
  • Switch configurations have been generated for CSM 1.3.
  • CANU is installed with version 1.6.7 or greater.

For this procedure, log in to ncn-m001 as an administrative user. The log in should be over the site connection (lan0), not the CMN, to prevent loss of connectivity to the system.

Backup switch configurations

  1. (ncn-m001#) Use CANU to backup the switch running configurations.

    Enter the switch administrative password when prompted.

    mkdir switch-upgrades-csm-1.3
cd switch-upgrades-csm-1.3
canu backup network --folder 1.2

  2. (ncn-m001#) Stage the CANU-generated CSM 1.3 switch configurations in the switch-upgrades-csm-1.3/1.3 directory.

Warnings

Understanding the switch configuration changes is critical. The following configurations risk a network outage, if not applied correctly:

  • Generating switch configuration without preserving site-specific values (by using the --custom-configuration flag).
  • Changes to ISL (MAGP, VSX, etc.) configurations.
  • Changes to Spanning Tree.
  • Changes to ACLs or ACL ordering.
  • Changes to VRFs.
  • Changes to default route.
  • Changes to MLAG/LACP.

Mellanox

  1. (ncn-m001#) Use CANU to see the differences between the 1.2 and 1.3 switch configurations.

    canu validate switch config --running ./1.2/sw-spine-002.cfg --generated ./1.3/sw-spine-002.cfg --vendor mellanox

  2. Apply the changed switch configurations.

    CANU remediation configurations are not supported on Mellanox. Switch changes must be manually applied on the switch based on the configuration differences.

  3. (switch#) Enter configuration mode and show the banner.

    enable
configure terminal
show banner

    Example output of the show banner command:

    Banners:
  Message of the Day (MOTD):

    ###############################################################################
    # CSM version:  1.3
    # CANU version: 1.6.7
    ###############################################################################

  Login:
    NVIDIA Onyx Switch Management

  Logout:

  4. (switch#) Save the configuration based on the banner output.

    configuration write to csm1.3-canu1.6.5

Dell

  1. (ncn-m001#) Use CANU to see the differences between the 1.2 and 1.3 switch configurations.

    canu validate switch config --running 1.2/sw-leaf-bmc-001.cfg --generated 1.3/sw-leaf-bmc-001.cfg --vendor dell --remediation

  2. Apply the remediation switch configurations.

  3. (switch#) Save the configuration.

    copy config://startup.xml config://csm1.2-canu1.6.5

    Example output:

    Copy completed

Aruba Spine

  1. (ncn-m001#) Use CANU to see the differences between the 1.2 and 1.3 switch configurations.

    canu validate switch config --running ./1.2/sw-spine-002.cfg --generated ./1.3/sw-spine-002.cfg --vendor aruba --remediation

  2. Apply the remediation switch configurations.

    Do this in two stages:

    1. Apply just the prefix-list and route-maps.

    2. Apply the remaining configuration.

  3. (switch#) Show the configuration version.

    configure terminal
show banner motd

    Example output of the show banner motd command:

    ###############################################################################
# CSM version:  1.3
# CANU version: 1.6.7
###############################################################################

  4. (switch#) Save the configuration.

    write memory
copy running-config checkpoint CSM1_3_CANU_1_6_7

Aruba Leaf and Leaf BMC

  1. (ncn-m001#) Use CANU to see the differences between the 1.2 and 1.3 switch configurations.

    canu validate switch config --running surtur/1.2/sw-leaf-bmc-001.cfg --generated surtur/1.3/sw-leaf-bmc-001.cfg --vendor aruba --remediation

  2. Apply the remediation switch configurations.

    Do this in two stages:

    1. Apply just the prefix-list and route-maps.

    2. Apply the remaining configuration.

  3. (switch#) Show the configuration version.

    configure terminal
show banner motd

    Example output of the show banner motd command:

    ###############################################################################
# CSM version:  1.3
# CANU version: 1.6.7
###############################################################################

  4. (switch#) Save the the configuration.

    write memory
copy running-config checkpoint CSM1_3_CANU_1_6_7

Run network tests

  1. (ncn-m001#) Use CANU to test the network.

    canu test --csm 1.3