Skip to main content
Cluster and storage switches

Install the NX-OS software

Contributors netapp-jolieg netapp-yvonneo

Follow this procedure to install the NX-OS software on the Nexus 9336C-FX2 shared switch.

Before you begin, complete the procedure in Prepare to install NX-OS and RCF.

Review requirements

What you'll need
  • A current backup of the switch configuration.

  • A fully functioning cluster (no errors in the logs or similar issues).

  • Cisco Ethernet switch page. Consult the switch compatibility table for the supported ONTAP and NX-OS versions.

  • Appropriate software and upgrade guides available on the Cisco web site for the Cisco switch upgrade and downgrade procedures. See Cisco Nexus 9000 Series Switches.

About the examples

The examples in this procedure use the following switch and node nomenclature:

  • The names of the two Cisco switches are cs1 and cs2.

  • The node names are cluster1-01, cluster1-02, cluster1-03, and cluster1-04.

  • The cluster LIF names are cluster1-01_clus1, cluster1-01_clus2, cluster1-02_clus1, cluster1-02_clus2 , cluster1-03_clus1, cluster1-03_clus2, cluster1-04_clus1, and cluster1-04_clus2.

  • The cluster1::*> prompt indicates the name of the cluster.

Install the software

The procedure requires the use of both ONTAP commands and Cisco Nexus 9000 Series Switches commands; ONTAP commands are used unless otherwise indicated.

Steps
  1. Connect the cluster switch to the management network.

  2. Use the ping command to verify connectivity to the server hosting the NX-OS software and the RCF.

    Show example

    This example verifies that the switch can reach the server at IP address 172.19.2.1:

    cs2# ping 172.19.2.1
    Pinging 172.19.2.1 with 0 bytes of data:
    
    Reply From 172.19.2.1: icmp_seq = 0. time= 5910 usec.
  3. Copy the NX-OS software and EPLD images to the Nexus 9336C-FX2 switch.

    Show example
    cs2# copy sftp: bootflash: vrf management
    Enter source filename: /code/nxos.9.3.5.bin
    Enter hostname for the sftp server: 172.19.2.1
    Enter username: user1
    
    Outbound-ReKey for 172.19.2.1:22
    Inbound-ReKey for 172.19.2.1:22
    user1@172.19.2.1's password:
    sftp> progress
    Progress meter enabled
    sftp> get   /code/nxos.9.3.5.bin  /bootflash/nxos.9.3.5.bin
    /code/nxos.9.3.5.bin  100% 1261MB   9.3MB/s   02:15
    sftp> exit
    Copy complete, now saving to disk (please wait)...
    Copy complete.
    
    
    cs2# copy sftp: bootflash: vrf management
    
    Enter source filename: /code/n9000-epld.9.3.5.img
    Enter hostname for the sftp server: 172.19.2.1
    Enter username: user1
    
    Outbound-ReKey for 172.19.2.1:22
    Inbound-ReKey for 172.19.2.1:22
    user1@172.19.2.1's password:
    sftp> progress
    Progress meter enabled
    sftp> get   /code/n9000-epld.9.3.5.img  /bootflash/n9000-epld.9.3.5.img
    /code/n9000-epld.9.3.5.img  100%  161MB   9.5MB/s   00:16
    sftp> exit
    Copy complete, now saving to disk (please wait)...
    Copy complete.
  4. Verify the running version of the NX-OS software:

    show version

    Show example
    cs2# show version
    Cisco Nexus Operating System (NX-OS) Software
    TAC support: http://www.cisco.com/tac
    Copyright (C) 2002-2020, Cisco and/or its affiliates.
    All rights reserved.
    The copyrights to certain works contained in this software are
    owned by other third parties and used and distributed under their own
    licenses, such as open source.  This software is provided "as is," and unless
    otherwise stated, there is no warranty, express or implied, including but not
    limited to warranties of merchantability and fitness for a particular purpose.
    Certain components of this software are licensed under
    the GNU General Public License (GPL) version 2.0 or
    GNU General Public License (GPL) version 3.0  or the GNU
    Lesser General Public License (LGPL) Version 2.1 or
    Lesser General Public License (LGPL) Version 2.0.
    A copy of each such license is available at
    http://www.opensource.org/licenses/gpl-2.0.php and
    http://opensource.org/licenses/gpl-3.0.html and
    http://www.opensource.org/licenses/lgpl-2.1.php and
    http://www.gnu.org/licenses/old-licenses/library.txt.
    
    Software
      BIOS: version 08.38
      NXOS: version 9.3(4)
      BIOS compile time:  05/29/2020
      NXOS image file is: bootflash:///nxos.9.3.4.bin
      NXOS compile time:  4/28/2020 21:00:00 [04/29/2020 02:28:31]
    
    
    Hardware
      cisco Nexus9000 C9336C-FX2 Chassis
      Intel(R) Xeon(R) CPU E5-2403 v2 @ 1.80GHz with 8154432 kB of memory.
      Processor Board ID FOC20291J6K
    
      Device name: cs2
      bootflash:   53298520 kB
    Kernel uptime is 0 day(s), 0 hour(s), 3 minute(s), 42 second(s)
    
    
    Last reset at 157524 usecs after Mon Nov  2 18:32:06 2020
      Reason: Reset Requested by CLI command reload
      System version: 9.3(4)
      Service:
    
    plugin
      Core Plugin, Ethernet Plugin
    
    Active Package(s):
    
    
    cs2#
  5. Install the NX-OS image.

    Installing the image file causes it to be loaded every time the switch is rebooted.

    Show example
    cs2# install all nxos bootflash:nxos.9.3.5.bin
    
    Installer will perform compatibility check first. Please wait.
    Installer is forced disruptive
    
    Verifying image bootflash:/nxos.9.3.5.bin for boot variable "nxos".
    [####################] 100% -- SUCCESS
    
    Verifying image type.
    [####################] 100% -- SUCCESS
    
    Preparing "nxos" version info using image bootflash:/nxos.9.3.5.bin.
    [####################] 100% -- SUCCESS
    
    Preparing "bios" version info using image bootflash:/nxos.9.3.5.bin.
    [####################] 100% -- SUCCESS
    
    Performing module support checks.
    [####################] 100% -- SUCCESS
    
    Notifying services about system upgrade.
    [####################] 100% -- SUCCESS
    
    
    
    Compatibility check is done:
    Module  bootable       Impact     Install-type  Reason
    ------  --------  --------------- ------------  ------
      1       yes      disruptive         reset     default upgrade is not hitless
    
    
    
    Images will be upgraded according to following table:
    
    Module   Image    Running-Version(pri:alt                  New-Version         Upg-Required
    ------- --------- ---------------------------------------- ------------------- ------------
      1      nxos     9.3(4)                                   9.3(5)                  yes
      1      bios     v08.37(01/28/2020):v08.23(09/23/2015)    v08.38(05/29/2020)      yes
    
    
    Switch will be reloaded for disruptive upgrade.
    
    Do you want to continue with the installation (y/n)? [n] y
    
    Install is in progress, please wait.
    
    Performing runtime checks.
    [####################] 100% -- SUCCESS
    
    Setting boot variables.
    [####################] 100% -- SUCCESS
    
    Performing configuration copy.
    [####################] 100% -- SUCCESS
    
    Module 1: Refreshing compact flash and upgrading bios/loader/bootrom.
    Warning: please do not remove or power off the module at this time.
    [####################] 100% -- SUCCESS
    
    Finishing the upgrade, switch will reboot in 10 seconds.
  6. Verify the new version of NX-OS software after the switch has rebooted:

    show version

    Show example
    cs2# show version
    
    Cisco Nexus Operating System (NX-OS) Software
    TAC support: http://www.cisco.com/tac
    Copyright (C) 2002-2020, Cisco and/or its affiliates.
    All rights reserved.
    The copyrights to certain works contained in this software are
    owned by other third parties and used and distributed under their own
    licenses, such as open source.  This software is provided "as is," and unless
    otherwise stated, there is no warranty, express or implied, including but not
    limited to warranties of merchantability and fitness for a particular purpose.
    Certain components of this software are licensed under
    the GNU General Public License (GPL) version 2.0 or
    GNU General Public License (GPL) version 3.0  or the GNU
    Lesser General Public License (LGPL) Version 2.1 or
    Lesser General Public License (LGPL) Version 2.0.
    A copy of each such license is available at
    http://www.opensource.org/licenses/gpl-2.0.php and
    http://opensource.org/licenses/gpl-3.0.html and
    http://www.opensource.org/licenses/lgpl-2.1.php and
    http://www.gnu.org/licenses/old-licenses/library.txt.
    
    Software
      BIOS: version 05.33
      NXOS: version 9.3(5)
      BIOS compile time:  09/08/2018
      NXOS image file is: bootflash:///nxos.9.3.5.bin
      NXOS compile time:  11/4/2018 21:00:00 [11/05/2018 06:11:06]
    
    
    Hardware
      cisco Nexus9000 C9336C-FX2 Chassis
      Intel(R) Xeon(R) CPU E5-2403 v2 @ 1.80GHz with 8154432 kB of memory.
      Processor Board ID FOC20291J6K
    
      Device name: cs2
      bootflash:   53298520 kB
    Kernel uptime is 0 day(s), 0 hour(s), 3 minute(s), 42 second(s)
    
    Last reset at 277524 usecs after Mon Nov  2 22:45:12 2020
      Reason: Reset due to upgrade
      System version: 9.3(4)
      Service:
    
    plugin
      Core Plugin, Ethernet Plugin
    
    Active Package(s):
  7. Upgrade the EPLD image and reboot the switch.

    Show example
    cs2# show version module 1 epld
    
    EPLD Device                     Version
    ---------------------------------------
    MI   FPGA                        0x7
    IO   FPGA                        0x17
    MI   FPGA2                       0x2
    GEM  FPGA                        0x2
    GEM  FPGA                        0x2
    GEM  FPGA                        0x2
    GEM  FPGA                        0x2
    
    cs2# install epld bootflash:n9000-epld.9.3.5.img module 1
    Compatibility check:
    Module        Type         Upgradable        Impact   Reason
    ------  ------------------ ----------------- --------- -----
         1         SUP         Yes       disruptive  Module Upgradable
    
    Retrieving EPLD versions.... Please wait.
    Images will be upgraded according to following table:
    Module  Type   EPLD              Running-Version   New-Version  Upg-Required
    ------- ------ ----------------- ----------------- ------------ ------------
         1  SUP    MI FPGA           0x07              0x07         No
         1  SUP    IO FPGA           0x17              0x19         Yes
         1  SUP    MI FPGA2          0x02              0x02         No
    The above modules require upgrade.
    The switch will be reloaded at the end of the upgrade
    Do you want to continue (y/n) ?  [n] y
    
    Proceeding to upgrade Modules.
    
    Starting Module 1 EPLD Upgrade
    
    Module 1 : IO FPGA [Programming] : 100.00% (     64 of      64 sectors)
    Module 1 EPLD upgrade is successful.
    Module   Type  Upgrade-Result
    -------- ----- --------------
         1   SUP   Success
    
    EPLDs upgraded.
    
    Module 1 EPLD upgrade is successful.
  8. After the switch reboot, log in again and verify that the new version of EPLD loaded successfully.

    Show example
    cs2# show version module 1 epld
    
    EPLD Device                     Version
    ---------------------------------------
    MI   FPGA                        0x7
    IO   FPGA                        0x19
    MI   FPGA2                       0x2
    GEM  FPGA                        0x2
    GEM  FPGA                        0x2
    GEM  FPGA                        0x2
    GEM  FPGA                        0x2
  9. Repeat steps 1 to 8 to install the NX-OS software on switch cs1.