Upgrading Cisco MDS NX-OS Release 9.x

This section provides information on upgrading your Cisco MDS NX-OS software to Cisco MDS NX-OS Release 9.x. It includes the following topics:

Cisco MDS NX-OS Software Upgrade Guidelines for All Switch Types

The following upgrade guidelines are applicable for all switches.

  • If Fibre Channel ports on the switches are connected to non-Cisco products, ensure that these are operating as individual Fibre Channel links and are not aggregated into a port channel. Fibre Channel port channels are not compatible with non-Cisco technology.

  • When you upgrade to Cisco MDS NX-OS 9.4(2) ensure that you apply the workaround provided in CSCwk14579 before upgrading to Cisco MDS NX-OS 9.4(2a). We recommend that you upgrade to Cisco MDS NX-OS 9.4(2a) directly from all the releases before Cisco MDS NX-OS 9.4(2).

  • We recommend that you do not perform an In-Service Software Upgrade (ISSU) concurrently on switches that are connected via FCIP ISLs. Rather perform the ISSU on one switch and after the ISSU is complete perform the ISSU on the adjacent switch. However, you can perform ISSUs concurrently on switches that are connected via Fibre Channel ISLs.

  • To upgrade or downgrade to a Cisco MDS NX-OS release version, the same release version of the kickstart and system images in the install all command must be used.

  • If you copy firmware using the SFTP or SCP clients after enabling the feature scp-server or feature sftp-server command on your switch, ensure that you close the SFTP or SCP connection using the no feature scp-server or no feature sftp-server command before performing ISSU. Otherwise, ISSU will be disruptive. To avoid this issue, we recommend that you transfer files to the switch using the copy command instead or using the DCNM client.

  • If you are upgrading from a release prior to Cisco MDS NX-OS Release 9.2(1), ensure that you use the clear logging onboard txwait command after upgrading. Otherwise, the file will be automatically deleted and recreated at the new file size when the file size exceeds 512 KB. For more information, see the Cisco MDS 9000 Series Interfaces Configuration Guide, Release 9.x.

  • If you are upgrading from Cisco MDS NX-OS Release 8.5(1) to Release 9.2(1) or later, ensure that you disable the Fabric Performance Monitor (FPM) feature using the no feature fpm command before upgrading. After the switch is upgraded to Release 9.2(1) or later, FPM can be enabled again via the feature fpm command.

  • FCIP traffic will be affected when you upgrade Cisco MDS 24/10-Port SAN Extension Module from Cisco MDS NX-OS Release 8.5(1) to Release 9.2(1). To recover from this situation, reload the module.

  • You will be unable to upgrade to Cisco MDS NX-OS Release 9.2(2) or later releases if you have configured any device-alias names using 64 alphanumeric characters. The following system message will be displayed:
    ISSU blocked because device-alias names > 63 characters exist.They
    can be displayed using 'show file upg_blocking_dev_al_cfg.txt'. Reduce  the size of the
    device-alias names to 63 characters or less and try  again.
  • As part of the fix for CSCvz09012, the cardclient service is deliberately stopped during the upgrade and the following syslog message is displayed. No action is required.
    %SYSMGR-2-SERVICE_CRASHED: Service "cardclient" (PID 4941) hasn't
    caught signal 9 (no core)
  • We recommend that if all of the following conditions are true that the Cisco MDS 48-Port 64-Gbps Fibre Channel Switching Module (DS-X9748-3072K9) NOT be inserted in the chassis:

    • Cisco MDS 9706, MDS 9710, or MDS 9718

    • Cisco MDS NX-OS Release 9.2(1)

    • Non-default FCoE FCMAP is configured. This can be checked by issuing the show fcoe | i FC-MAP command. The default value of FCMAP is 0x0e:fc:00.

  • For the switches running Cisco MDS NX-OS Release 9.2(1) and equipped with Cisco MDS 48-Port 64-Gbps Fibre Channel Switching Module (DS-X9748-3072K9), the FCMAP should NOT be changed to non-default value. However, after the switch has been upgraded to Cisco MDS NX-OS Release 9.2(2) or later, the FCoE FCMAP can be configured to a non-default value. For more information, see CSCwa34016.

  • Follow the recommended steps to upgrade your software from Cisco MDS NX-OS Release 9.4(2a) to 9.4(3)

    • Disable the Transceiver Power-Control feature: If the Transceiver Power-Control feature is enabled, you must disable it before starting the upgrade. Use the command: switch(config)# no system transceiver power-control to disable the feature.

    • Verify if the Transceiver Power-Control feature is disabled using the command switch(config)# show system transceiver power-control.

    • After the upgrade is complete, you can re-enable the feature with the command: switch(config)# system transceiver power-control.

    • Affected Switches:

      • Cisco MDS 9124V

      • Cisco MDS 9148V

      • Cisco MDS 9396V

Preventing SAN Analytics Corruption during ISSU

Beginning with MDS 9000 Release 8.5(1), a change in the internal ACL programming format will lead to SAN analytics ACL entry corruption if the feature remains enabled during upgrade from Release 8.x to Release 8.5(1) or Release 9.x. This issue arises from a mix of old and new hardware entry formats, causing a silent corruption that may not be immediately apparent and cannot be reliably detected by the ACL consistency checker in the affected releases.

To prevent this analytics ACL corruption during an ISSU, SAN Analytics must be disabled prior to the upgrade. It can safely be reconfigured after the upgrade is completed. For more information, see CSCwo03706.


Note


Beginning with Release 9.4(3a), if an ISSU is performed with analytics enabled, the ISSU will fail unless the analytics feature is disabled beforehand.


This procedure should be performed if all of the following are true:

  • if feature analytics is configured.

  • if an In Service Software Upgrade (ISSU) is being performed.

  • if the current release is prior to Release 8.5(1) and the target release is Release 8.5(1) or 9.2(1) or later.

  • is one of the following products:

    Cisco Product Name IBM Product Name
    MDS 9148T Fabric Switch SAN48C-6
    MDS 9396T Fabric Switch SAN96C-6
    MDS 9132T Fabric Switch SAN32C-6
    MDS 9220i Fabric Switch SAN16C-R
    32Gb Module (DS-X9648-1536K9) 32Gb Module (01FT644)

If an ISSU has already been done with analytics enabled that met the previous conditions, analytics ACL corruption occurs. Perform a disruptive reload of the fabric switch or 32Gb module.

  • For MDS 9000 Series Fabric Switches, perform the disruptive reload using the reload system command.


    Note


    Do not specify the non-disruptive parameter

    .
  • For MDS 9000 Series Director Switches with 32Gb modules, perform the disruptive reload using the reload module x command.


    Note


    Execute this command for modules that have interfaces with SAN Analytics configured.



Note


Analytics data will not be collected or transported via telemetry when analytics is disabled. This will not affect NDFC SAN Insights.


To prevent the issue, perform the following procedure:

Procedure


Step 1

Log in to the switch with network-admin user privileges.

Step 2

Save the current SAN Analytics configuration to a backup file on bootflash.

switch# echo "configure terminal" > bootflash:before_issu_analytics.cfg
switch# show running-config analytics >> bootflash:before_issu_analytics.cfg
               

Step 3

Verify the analytics interface configuration as a backup on bootflash.

switch# show file bootflash:before_issu_analytics.cfg
               

Step 4

Save the entire switch configuration as a backup on bootflash.

switch# copy running-config bootflash:backup_config.txt
               

For more information, see Using the Cisco NX-OS Setup Utility chapter in the Cisco MDS 9000 Series NX-OS Fundamentals Configuration Guide.

Step 5

In the Global Configuration mode, disable the SAN Analytics feature.

switch# configure terminal
switch(config)# no feature analytics
               

Validate that the SAN Analytics is disabled.

switch# show feature | include analytics
analytics            1        disabled

Step 6

Upgrade the Cisco MDS switch to the target Release 9.x.

For upgrade instructions, see Upgrading Cisco MDS NX-OS Release 9.x.

Step 7

After successful upgrade, restore the SAN Analytics running configuration in the Global Configuration mode.

switch(config)# copy bootflash:before_issu_analytics.cfg running-config
Copy complete.

Step 8

Verify SAN analytics feature is now enabled.

switch# show feature | include analytics
analytics            1        enabled

Step 9

Verify analytics is enabled on the same set of interfaces as in Step 3.

switch# show running-config analytics
               

Step 10

Save the updated running configuration to startup configuration.

switch# copy running-config startup-config
               

Step 11

Remove the backup configuration files to free up space.

switch# delete bootflash:backup_config.txt
Do you want to delete "/backup_config.txt"? (yes/no/abort) [y] y

switch# delete bootflash:before_issu_analytics.cfg
Do you want to delete "/before_issu_analytics.cfg"? (yes/no/abort) [y] y
               

This process ensures that SAN Analytics entries do not become corrupted during the upgrade. For further details, refer to CSCwo03706.

Upgrading MDS NX-OS in Cisco MDS 9700 Series Multilayer Director Switches

On a Cisco MDS 9700 Series Multilayer Director, the high-level process to upgrade to Cisco MDS NX-OS Release 9.x is as follows:

Procedure


Step 1

Upgrade to Cisco MDS NX-OS Release 9.x, as described in Upgrading to Cisco MDS NX-OS Release 9.x on a Cisco MDS 9700 Series Multilayer Director.

Step 2

Install the Cisco MDS 48-port 16-Gbps Fibre Channel Switching module in the Cisco MDS 9700 chassis or install the Cisco MDS 48-port 10-Gigabit Ethernet module in the Cisco MDS 9700 chassis.

For additional information, see the Cisco MDS 9700 Series Hardware Installation Guide.

Step 3

If needed, reload the switch.


Upgrading to Cisco MDS NX-OS Release 9.x on a Cisco MDS 9700 Series Multilayer Director


Note


You can use both console connections or telnet/SSH connections via management interfaces for firmware upgrades.

Ensure that there is a working connection to both supervisors if you are upgrading through the console interfaces. As this process causes a switchover and the current standby supervisor becomes active after the upgrade.

Ensure that both mgmt0 interfaces are up if you are upgrading via telnet/SSH through the management interfaces, . To determine the status of the mgmt0 interface on the active supervisor use the show interface mgmt0 command. To determine the status of the mgmt0 interface on the standby supervisor use the show interface mgmt0 standby command. Once the switchover has occurred the telnet/SSH session must be reestablished.



Note


When the system auto-collect tech-support command is enabled, there is a delay of 600 seconds for the standby switch to reload and become HA-Standby in Cisco MDS 9700 Series Multilayer Directors.


To upgrade a Cisco MDS 9700 Series Multilayer Director from an earlier NX-OS release to an NX-OS 9.x release perform the following steps:

Procedure


Step 1

Go to http://www.cisco.com/ and click Log In at the top of the page. Enter your Cisco Systems username and password.

Note

 

Unregistered Cisco.com users cannot access secure links that are provided in this document.

Step 2

Verify the following physical connections for the new Cisco MDS 9700 Series Multilayer switch:

If upgrading via the console interfaces:

  • Both console ports are physically connected to a computer terminal (or terminal server). If upgrading via telnet/SSH.

  • Both management 10/100/1000 Ethernet port (mgmt0) interfaces are connected to an external hub, switch, or router. Verify both connections via the show interface mgmt0 and show interface mgmt0 standby commands.

To verify the physical connections, see the hardware installation guide for your product. For more information, see the Cisco MDS 9700 Director Hardware Installation Guide.

Step 3

Log in to the switch.

Step 4

Run the copy running-config startup-config command to store your current running configuration.

You can also create a backup of your existing configuration in a file by running the copy running-config bootflash:backup_config.txt command. See the Using the Cisco NX-OS Setup Utility chapter in the Cisco MDS 9000 Series NX-OS Fundamentals Configuration Guide.

Step 5

Step 5 Save a copy of the show tech-support details command output of the switch.

For more information, see the Collecting Logs from Cisco MDS 9000 Switches and DCNM.

Step 6

Verify that the requested license files installed in the switch are displayed, using the show license usage command.

Note

 

The switch is initially shipped with the required licenses installed in the system. However, the initial license file does not cover the unlicensed features that may be used during the grace period. See the Cisco MDS 9000 Series NX-OS Licensing Guide.

If no license is displayed at this point, go to Step 7 and Step 8 to install the required licenses.

If the required licenses are displayed at this point, skip Step 7 and Step 8. Go to Step 9.

The following is a sample CLI output for a valid license:

switch# show license usage
Feature            Ins       Lic       Status       Expiry Date    Comments
FM_SERVER_PKG       No        -        Unused        -                -
MAINFRAME_PKG       No        -        Unused        -                -
ENTERPRISE_PKG      Yes       -        Unused        Never            -
 

Step 7

Install licenses, if necessary, to ensure that the required features are available on the switch.

Perform the following steps:

  1. Use the show license host-id command to obtain the serial number of your switch. The host ID is also referred to as the switch serial number.

    switch# show license host-id
    License hostid: VDH=JAF1721AEQG 

    Tip

     

    Use the entire ID that appears after the colon (:). In this example, the host ID is VDH=JAF1721AEQG.

  2. Obtain your Claim Certificate or Proof of Purchase document. This document accompanies every Cisco MDS switch.

  3. Locate the Product Authorization Key (PAK) from the Claim Certificate or Proof of Purchase document.

  4. A URL is provided in the Claim Certificate or Proof of Purchase document for your product.

  5. Locate and access the specified URL that applies to your switch’s and enter the switch serial number and PAK.

    The license key file is sent to you by email. The license key file is digitally signed to be used only on the switch for which it was requested. The requested features are also enabled after the Cisco MDS NX-OS software on the specified switch accesses the license key file.

Note

 

Install the license file in the specified Cisco MDS 9000 Series Multilayer switch without modifying the key.

For more information on licensing, see the Cisco MDS 9000 Series NX-OS Licensing Guide.

Step 8

Install the license key file when you receive it by email.

Perform the following steps:

  1. Copy the license file to bootflash using TFTP or SCP.

  2. Install the license file by running the install license command on the active supervisor module, from the switch console.

    switch# install license bootflash:license_file.lic
    Installing license..done 

    Note

     

    If you provide a target name for the license key file, the file is installed with the specified name. Otherwise, the filename specified in the license key file is used to install the license.

  3. Exit the switch console.

For more information on licensing, see the Cisco MDS 9000 Series NX-OS Licensing Guide.

Step 9

Ensure that the required space is available in the bootflash: directory for the image files to be copied using the dir bootflash: command.

Use the delete bootflash:filename command to remove unnecessary files.

switch# dir bootflash:
 
4096 Nov 23 10:47:46 2018.patch/
68230 Dec 10 11:27:20 2018 backup_10_12_2018
4096 Dec 12 10:23:54 2018 bootflash/
52692992 Aug 24 06:18:35 2018 diag-bz-npu-F26
82725888 Aug 24 06:18:24 2018 diag-sup3dc3-bz-F26.bin
1048576 Aug 24 05:47:10 2018 diag_test_file
34646 Jan 28 14:45:50 2019 ethpm_act_logs.log
270463 Jan 28 14:47:51 2019 ethpm_im_tech.log
30627 Jan 28 14:46:50 2019 ethpm_mts_details.log
73 Jan 28 14:46:50 2019 ethpm_syslogs.log
1935271 Jan 28 14:47:50 2019 ethpm_tech.log
12831 Dec 07 15:57:20 2018 log1
4096 Feb 07 13:13:47 2019 lost+found/
4421896 May 02 19:32:22 2019 m9700-sf4ek9-dplug-mz.9.2.1.bin
4421857 May 07 12:18:16 2019 m9700-sf4ek9-dplug-mz.9.2.1.bin
60380672 Apr 29 16:15:25 2019 m9700-sf4ek9-kickstart-mz.9.2.1.bin
60380672 May 02 19:32:34 2019 m9700-sf4ek9-kickstart-mz.9.2.1.bin
60380672 May 07 12:19:05 2019 m9700-sf4ek9-kickstart-mz.9.2.1.bin
433279746 Apr 29 16:32:42 2019 m9700-sf4ek9-mz.9.2.1.bin
433304076 May 02 19:47:52 2019 m9700-sf4ek9-mz.9.2.1.bin
1548886 May 02 19:47:58 2019 m9700-sf4ek9-mz.9.2.1.tar.gz
433423429 May 07 12:33:27 2019 m9700-sf4ek9-mz.9.2.1.bin
1548937 May 07 12:33:35 2019 m9700-sf4ek9-mz.9.2.1.tar.gz
4096 Mar 26 09:54:14 2019 scripts/
1286622 Mar 21 15:53:25 2019 sysmgrconfig
11082 Aug 24 06:14:41 2018 temp.log
Usage for bootflash://sup-local
3213733888 bytes used
500277248 bytes free
3714011136 bytes total 

Note

 

Before downloading and installing Cisco MDS NX-OS software, verify that the release is supported by your Cisco MDS reseller. If you purchased support from a Cisco reseller, contact them directly for more information. Otherwise, contact Cisco Technical support.

Step 10

If you need more space on the active supervisor module bootflash, delete the files that are not required to make space available:

switch# delete bootflash:m9700-sf3ek9-kickstart-mz.8.3.1.bin
switch# delete bootflash:m9700-sf3ek9-mz.8.3.1.bin

Step 11

Verify that there is space available on the standby supervisor module bootflash on a Cisco MDS 9700 Series Multilayer switch:


switch# dir bootflash://sup-standby/
       4096    Jan 06 05:17:36 2020  .patch/
       4096    Sep 21 23:50:31 2023  .rpmstore/
          0    Oct 26 10:04:12 2023  F241-15-09-9710-1_show_tech_det_9_4_1.log
       4096    Jan 09 12:45:21 2025  intersight/
       4096    Mar 05 13:52:27 2025  lost+found/
    4857978    Jan 20 12:07:30 2025  m9700-sf4ek9-dplug-mzg.9.4.3.bin
   60695552    Mar 05 16:38:23 2025  m9700-sf4ek9-kickstart-mz.8.4.2f.bin
   63588352    Mar 12 09:21:59 2025  m9700-sf4ek9-kickstart-mz.9.2.1a.bin
   79246336    Aug 20 07:52:04 2024  m9700-sf4ek9-kickstart-mz.9.4.2a.bin
   79637504    Dec 10 16:42:04 2024  m9700-sf4ek9-kickstart-mz.9.4.3.bin
  480722931    Feb 11 13:26:55 2025  m9700-sf4ek9-mz.8.4.2f.bin
  579615401    Mar 12 09:20:53 2025  m9700-sf4ek9-mz.9.2.1a.bin
  539330088    Aug 20 07:52:38 2024  m9700-sf4ek9-mz.9.4.2a.bin
  540745273    Dec 11 14:39:59 2024  m9700-sf4ek9-mz.9.4.3.bin
    5854582    Sep 11 14:49:52 2023  m9700-sf4ek9-udplug-811941.bin
      42859    Feb 26 18:27:19 2025  show_int_tabular.py

Usage for bootflash://sup-standby
 2684067840 bytes used
 1112522752 bytes free
 3796590592 bytes total
switch#

Step 12

If you need more space on the standby supervisor module bootflash on a Cisco MDS 9700 Series Multilayer switch, delete the files that are not required to make space available:

switch# delete bootflash://sup-standby/m9700-sf4ek9-kickstart-mz.9.2.1a.bin
switch# delete bootflash://sup-standby/m9700-sf4ek9-mz.9.2.1a.bin 

Step 13

Access the Software Download Center using this URL: http://www.cisco.com/cisco/software/navigator.html

You are prompted to log in, use your Cisco username and password.

Step 14

Select the required Cisco MDS NX-OS Release 9.x image, depending on the release you are installing.

The Technical Support Encryption Software Export Distribution Authorization form is displayed.

Step 15

Enter the relevant details in this form, to obtain authorization.

Step 16

After obtaining the authorization, download the files to an FTP or TFTP server.

Note

 

Ensure that you have configured an FTP or TFTP server where the files can be downloaded.

Step 17

Copy the Cisco MDS NX-OS kickstart and system images from the FTP or TFTP server to the active supervisor module bootflash.

When you download an image file, change your TFTP environment’s IP address or Domain Name System (DNS) name to the path where the files are located.

switch# copy tftp://tftpserver.cisco.com/MDS/m9700-sf4ek9-kickstart-mz.9.2.1.bin bootflash:m9700-sf4ek9-kickstart-mz.9.2.1.bin
switch# copy tftp://tftpserver.cisco.com/MDS/m9700-sf4ek9-mz.9.2.1.bin bootflash:m9700-sf4ek9-mz.9.2.1.bin 

Step 18

To verify the current software version that the switch is running, using the show version command:

The following example displays the current version of the software running:

switch# show version
 
Cisco Nexus Operating System (NX-OS) Software
TAC support: http://www.cisco.com/tac
Documents: http://www.cisco.com/en/US/products/ps9372/tsd_products_support_serie
s_home.html
Copyright (c) 2002-2018, Cisco Systems, Inc. All rights reserved.
The copyrights to certain works contained in this software are
owned by other third parties and used and distributed under
license. Certain components of this software are licensed under
the GNU General Public License (GPL) version 2.0 or the GNU
Lesser General Public License (LGPL) Version 2.1. A copy of each
such license is available at
http://www.opensource.org/licenses/gpl-2.0.php and
http://www.opensource.org/licenses/lgpl-2.1.php
Software
BIOS: version 3.2.0
kickstart: version 9.2(1)
system: version 9.2(1)
BIOS compile time: 08/9/2021
kickstart image file is: bootflash:///m9700-sf3ek9-kickstart-mz.9.2.1.bin
kickstart compile time: 11/30/2018 12:00:00 [11/30/2018 23:18:49]
system image file is: bootflash:///m9700-sf3ek9-mz.9.2.1.bin
system compile time: 11/30/2018 12:00:00 [12/01/2018 00:45:13]
Hardware
cisco MDS 9706 (6 Slot) Chassis ("Supervisor Module-3")
Intel(R) Xeon(R) CPU with 8167760 kB of memory.
Processor Board ID JAE17440HVW
Device name: sw-9706-213
bootflash: 3915776 kB
slot0: 0 kB (expansion flash)
Kernel uptime is 0 day(s), 0 hour(s), 57 minute(s), 19 second(s)
Last reset at 818200 usecs after Mon Aug 9 13:49:17 2021
Reason: Reset triggered due to Switchover
************************************************************** 

Step 19

Verify that your switch is running compatible hardware. For more information, see the corresponding version of the Cisco MDS 9000 Series Release Notes.

Step 20

Use the show interface mgmt0 standby command to verify that the standby supervisor's mgmt0 link is up.

Step 21

Check for incompatibilities between NX-OS releases using the show incompatibility system <target system image name> command.

This command checks for incompatibilities between NX-OS releases, and any switch events that would interrupt the upgrade process. This will also ensure the /var/volatile/tmp file system has sufficient space to continue.

switch# show incompatibility system m9124v-s8ek9-mz.9.4.3a.bin
Checking incompatible configuration(s):
No incompatible configurations

Checking dynamic incompatibilities:
No incompatible configurations
switch#

Step 22

Verify if the /var/volatile/tmp file system has no more than 9% in use: using the show system internal flash command.

switch# show  system internal flash  | inc Mount|/var/volatile/tmp
Mount-on                  1K-blocks      Used   Available   Use%  Filesystem
/var/volatile/tmp            614400       104      614296      1   none

switch#

Note

 

The above example shows that the filesystem is used 1% only. Therefore, it is safe to proceed further. If the /var/volatile/tmp file system is utilized more than 9% , do not continue with the upgrade procedure. Contact Cisco TAC.

Step 23

Perform the upgrade by running the install all command.

The following example displays the result of the install all command if the system and kickstart files are specified locally. The example shows the command issued on a Cisco MDS 9700 Series Multilayer switch.

switch# install all kickstart m9700-sf4ek9-kickstart-mz.9.2.1.bin system m9700-sf4ek9-mz.9.2.1.bin
Installer will perform compatibility check first. Please wait.
Verifying image bootflash:/m9700-sf4ek9-kickstart-mz.9.2.1.bin for boot variable "kickstart".
[####################] 100% -- SUCCESS
Verifying image bootflash:/m9700-sf4ek9-mz.9.2.1.bin for boot variable "system".
[####################] 100% -- SUCCESS
Performing module support checks.
[####################] 100% -- SUCCESS
Verifying image type.
[####################] 100% -- SUCCESS
Extracting "lctsh" version from image bootflash:/m9700-sf4ek9-mz.9.2.1.bin
[####################] 100% -- SUCCESS
Extracting "bios" version from image bootflash:/m9700-sf4ek9-mz.9.2.1.bin
[####################] 100% -- SUCCESS
Extracting "lc2dce-mds" version from image bootflash:/m9700-sf4ek9-mz.9.2.1.bin
[####################] 100% -- SUCCESS
Extracting "slc4xb" version from image bootflash:/m9700-sf4ek9-mz.9.2.1.bin
[####################] 100% -- SUCCESS
Extracting "system" version from image bootflash:/m9700-sf4ek9-mz.9.2.1.bin
[####################] 100% -- SUCCESS
Extracting "kickstart" version from image bootflash:/m9700-sf4ek9-kickstart-mz.9.2.1.bin
[####################] 100% -- SUCCESS
Extracting "slcf32" version from image bootflash:/m9700-sf4ek9-mz.9.2.1.bin
[####################] 100% -- SUCCESS
Notifying services about system upgrade.
[####################] 100% -- SUCCESS
Compatibility check is done:
Module bootable Impact Install-type Reason
------ -------- -------------- ------------ ------
2 yes non-disruptive rolling
3 yes non-disruptive rolling
4 yes non-disruptive rolling
5 yes non-disruptive reset
6 yes non-disruptive reset
10 yes non-disruptive rolling
Other miscellaneous information for installation:
Module info
------ ----------------------------------
2 FC ports 1-24 are hitless, IPS 1-8 are hitful, and Intelligent Applications running are hitful
Images will be upgraded according to following table:
Module Image Running-Version (pri:alt) New-Version Upg-Required
------ ---------- ---------------------------------------- --------------------
2 lctsh 8.3(2) 8.4(1) yes
2 bios v4.2.14(03/30/2018):v4.2.14(03/30/2018) no
3 lc2dce-mds 8.3(2) 8.4(1) yes
3 bios v2.0.32(12/16/13) v2.0.32(12/16/13) no
4 slc4xb 8.3(2) 8.4(1) yes
4 bios v1.10.21(11/26/12) v1.10.21(11/26/12) no
5 system 8.3(2) 8.4(1) yes
5 kickstart 8.3(2) 8.4(1) yes
5 bios v3.1.0(02/27/2013) v3.2.0(09/27/2018) yes
6 system 8.3(2) 8.4(1) yes
6 kickstart 8.3(2) 8.4(1) yes
6 bios v3.1.0(02/27/2013) v3.2.0(09/27/2018) yes
10 slcf32 8.3(2) 8.4(1) yes
10 bios v4.1.49(01/29/2017)v4.1.49(01/29/2017) no
 
Do you want to continue with the installation (y/n)? [n] y
Install is in progress, please wait.
Performing runtime checks.
[####################] 100% -- SUCCESS
Syncing image bootflash:/m9700-sf4ek9-kickstart-mz.9.2.1.bin to standby.
[####################] 100% -- SUCCESS
Syncing image bootflash:/m9700-sf4ek9-mz.9.2.1.bin to standby.
[####################] 100% -- SUCCESS
Setting boot variables.
[####################] 100% -- SUCCESS
Performing configuration copy.
[####################] 100% -- SUCCESS
Module 2: Upgrading bios/loader/bootrom/power-seq.
Warning: please do not remove or power off the module at this time.
[####################] 100% -- SUCCESS
Module 3: Upgrading bios/loader/bootrom/power-seq.
Warning: please do not remove or power off the module at this time.
[####################] 100% -- SUCCESS
Module 4: Upgrading bios/loader/bootrom/power-seq.
Warning: please do not remove or power off the module at this time.
[####################] 100% -- SUCCESS
Module 5: Upgrading bios/loader/bootrom/power-seq.
Warning: please do not remove or power off the module at this time.
[####################] 100% -- SUCCESS
Module 6: Upgrading bios/loader/bootrom/power-seq.
Warning: please do not remove or power off the module at this time.
[####################] 100% -- SUCCESS
Module 10: Upgrading bios/loader/bootrom/power-seq.
Warning: please do not remove or power off the module at this time.
[####################] 100% -- SUCCESS
2019 Mar 23 15:38:37 switch %PLATFORM-2-MOD_REMOVE: Module 6 removed (Serial number JAE17480AL1)
2019 Mar 23 15:40:58 switch %USBHSD-STANDBY-2-MOUNT: logflash: online
2019 Mar 23 15:42:06 switch %PLATFORM-1-PFM_ALERT: Disabling ejector based shutdown on sup in slot 6
Module 6: Waiting for module online.
-- SUCCESS
2019 Mar 23 15:42:30 switch %PLATFORM-1-PFM_ALERT: Enabling ejector based shutdown on sup in slot 5
Notifying services about the switchover.
[####################] 100% -- SUCCESS
"Switching over onto standby".
>>>
>>>
>>>
NX7k SUP BIOS version ( 3.02) : Build - 03/23/2019 02:38:22
PM FPGA Version : 0x00000014
Power sequence microcode revision - 0x00000001 : card type - f10156EEA0
Booting Spi Flash : Primary
CPU Signature - 0x000106e4: Version - 0x000106e0
CPU - 1 : Cores - 4 : HTEn - 1 : HT - 2 : Features - 0xbfebfbff
FSB Clk - 532 Mhz : Freq - 2152 Mhz - 2128 Mhz
MicroCode Version : 0x00000005
Memory - 8192 MB : Frequency - 1067 MHZ
Loading Bootloader: Done
IO FPGA Version : 0x10001
PLX Version : 861910b5
Bios digital signature verification - Passed
Reset Reason Registers: 0x1 0x0
Filesystem type is ext2fs, partition type 0x83
GNU GRUB version 0.97
Autobooting bootflash:/m9700-sf4ek9-kickstart-mz.9.2.1.bin bootflash:/m9700-
sf4ek9-mz.9.2.1.bin..
Filesystem type is ext2fs, partition type 0x83
Booting kickstart image: bootflash:/m9700-sf4ek9-kickstart-mz.9.2.1.bin...
...............................................................................
...............................................................................
...................................................................
Kickstart digital signature verification Successful
Image verification OK
INIT: version 2
boot device node /dev/sda
obfl flash device node /dev/sdb
USB log flash device not found...
Checking obfl filesystem.
Checking all filesystems..r.r.r.R. done.
fdisk: cannot open /dev/hd-log: No such file or directory
No partition found for LOG
LOG partition is less than 1G, size found = 0
mounting Log 1
Starting mcelog daemon
cat: /var/log/log_flash_node: No such file or directory
Initializing the LOG flash
LOG Partitioning result code = 0
rrCreating logflash directories
Loading system software
/bootflash//m9700-sf3ek9-mz.9.2.1.bin read done
System image digital signature verification successful.
Uncompressing system image: bootflash:/m9700-sf4ek9-mz.9.2.1.bin Fri Mar 23 15:46:29 IST 2019
blogger: nothing to do.
C
..done Fri Mar 23 15:46:34 IST 2019
INIT: Entering runlevel: 3
Starting portmap daemon...
starting statd: done
starting 8 nfsd kernel threads: done
starting mountd: done
System is coming up... Please wait...
2019 Mar 23 15:48:10 switch %LICMGR-2-LOG_LIC_NO_LIC: No license(s) present for feature ENTERPRISE_PKG. Application(s) shut down in 96 days.
>>>
>>>
NX7k SUP BIOS version ( 3.02) : Build - 03/23/2019 02:38:22
PM FPGA Version : 0x00000014
Power sequence microcode revision - 0x00000001 : card type - f10156EEA0
Booting Spi Flash : Primary
CPU Signature - 0x000106e4: Version - 0x000106e0
CPU - 1 : Cores - 4 : HTEn - 1 : HT - 2 : Features - 0xbfebfbff
FSB Clk - 532 Mhz : Freq - 2153 Mhz - 2128 Mhz
MicroCode Version : 0x00000005
Memory - 8192 MB : Frequency - 1067 MHZ
Loading Bootloader: Done
IO FPGA Version : 0x10001
PLX Version : 861910b5
Bios digital signature verification - Passed
Reset Reason Registers: 0x0 0x8
Filesystem type is ext2fs, partition type 0x83
GNU GRUB version 0.97
Autobooting bootflash:/m9700-sf4ek9-kickstart-mz.9.2.1.bin bootflash:/m9700-
sf3ek9-mz.9.2.1.bin..
Filesystem type is ext2fs, partition type 0x83
Booting kickstart image: bootflash:/m9700-sf4ek9-kickstart-mz.9.2.1.bin...
...............................................................................
...............................................................................
...................................................................
Kickstart digital signature verification Successful
Image verification OK
INIT: version 2
boot device node /dev/sda
obfl flash device node /dev/sdb
log flash device node /dev/sdc
Checking obfl filesystem.
Checking all filesystems..r.r.r..r done.
Mounting Log Dir /logflash
mounting Log 0
Starting mcelog daemon
reCreating logflash directories
Loading system software
/bootflash//m9700-sf4ek9-mz.9.2.1.bin read done
System image digital signature verification successful.
Uncompressing system image: bootflash:/m9700-sf4ek9-mz.9.2.1.bin Fri Mar 23 15:40:22 IST 2019
blogger: nothing to do.
C
..done Fri Mar 23 15:40:27 IST 2019
INIT: Entering runlevel: 3
Starting portmap daemon...
starting statd: done
starting 8 nfsd kernel threads: done
starting mountd: done
2019 Mar 23 15:40:58 switch %USBHSD-2-MOUNT: logflash: online
2019 Mar 23 15:41:12 switch %LICMGR-2-LOG_LIC_NO_LIC: No license(s) present for feature ENTERPRISE_PKG. Application(s) shut down in 96 days.
Continuing with installation, please wait
Module 6: Waiting for module online.
-- SUCCESS
2019 Mar 23 15:42:35 switch %KERN-2-SYSTEM_MSG: [ 203.622504] Switchover started by redundancy driver - kernel
2019 Mar 23 15:42:36 switch %SYSMGR-2-HASWITCHOVER_PRE_START: This supervisor is becoming active (pre-start phase).
2019 Mar 23 15:42:36 switch %SYSMGR-2-HASWITCHOVER_START: Supervisor 6 is becoming active.
2019 Mar 23 15:42:36 switch %SYSMGR-2-SWITCHOVER_OVER: Switchover completed.
2019 Mar 23 15:42:37 switch %PLATFORM-1-PFM_ALERT: Disabling ejector based shutdown on sup in slot 6
2019 Mar 23 15:42:41 switch %LICMGR-2-LOG_LIC_NO_LIC: No license(s) present for feature ENTERPRISE_PKG. Application(s) shut down in 96 days.
2019 Mar 23 15:42:41 switch %LICMGR-2-LOG_LIC_NO_LIC: No license(s) present for feature MAINFRAME_PKG. Application(s) shut down in 120 days.
2019 Mar 23 15:42:41 switch %LICMGR-2-LOG_LICAPP_NO_LIC: Application Fabric Binding running without MAINFRAME_PKG license, shutdown in 120 days
2019 Mar 23 15:42:42 switch %CALLHOME-2-EVENT: LICENSE_ALERT
Module 2: Non-disruptive upgrading.
[# ] 0%2019 Mar 23 15:49:27 switch %PLATFORM-1-PFM_ALERT: Enabling ejector based shutdown on sup in slot 6
2019 Mar 23 15:52:05 switch %PMON-SLOT2-2-PMON_CRIT_INFO: Port Monitor Critical Information: Config download success.
[####################] 100% -- SUCCESS
Module 3: Non-disruptive upgrading.
[####################] 100% -- SUCCESS
Module 4: Non-disruptive upgrading.
[# ] 0%2019 Mar 23 15:57:44 switch %PMON-SLOT4-2-PMON_CRIT_INFO: Port Monitor Critical Information: Config download success.
[####################] 100% -- SUCCESS
Module 10: Non-disruptive upgrading.
[# ] 0%2019 Mar 23 16:00:00 switch %PMON-SLOT10-2-PMON_CRIT_INFO: Port Monitor Critical Information: Config download success.
[####################] 100% -- SUCCESS
Install has been successful.
You have now upgraded the Cisco NX-OS software in your switch. 
switch#

Upgrading Cisco MDS NX-OS on Cisco MDS Fabric Switches

This section describes how to perform nondisruptive upgrades on the following Cisco MDS fabric switches:

  • Cisco MDS 9124V Fibre Channel Switch

  • Cisco MDS 9132T Multilayer Fabric Switch

  • Cisco MDS 9148T Multilayer Fabric Switch

  • Cisco MDS 9148S Multilayer Fabric Switch

  • Cisco MDS 9148V Fibre Channel Switch

  • Cisco MDS 9220i Multilayer Fabric Switch

  • Cisco MDS 9250i Multiservice Fabric Switch

  • Cisco MDS 9396S Multilayer Fabric Switch

  • Cisco MDS 9396T Multilayer Fabric Switch

  • Cisco MDS 9396V Fibre Channel Switch

This section contains the following topics:

Guidelines and Limitations for a Nondisruptive Software Upgrade

Before attempting to upgrade software images, follow these guidelines:

  • During the upgrade, the fabric must be stable. That is, no devices should be logging in and an out of the fabric during the time of the NX-OS upgrade.

  • Do not perform any configuration activities during an upgrade.

  • Configure the Fabric Shortest Path First (FSPF) hello-interval timers to the default value of 20 seconds.

  • Configure the Fabric Shortest Path First (FSPF) dead-interval timers to the default value of 80 seconds.

  • If Cisco Fabric Services commits are pending in the fabric, the upgrade is aborted. Issue show cfs lock to see if there are any pending commits.

  • If a zone server merge is in progress, the upgrade is aborted.

  • If the upgrade is aborted due to a service not being ready for an upgrade, you are prompted to enter the show install all failure-reason command to identify the reason.

  • Prior to upgrade or downgrade, reset the switch's logging levels to the system defaults via the no logging level all configuration command. If this is not done, the upgrade or downgrade may be disruptive due to excessive logging causing control plane downtime exceeding 80 seconds.

    Before entering the no logging level all command, ensure that the switch's current logging configuration is saved. This will need to restored after the upgrade or downgrade.

    Follow these steps:

    1. Enter the show running-config | i “logging level” command and save the output. These are the switch's current settings.

    2. Enter the no logging level all command in configuration mode.

    3. Perform upgrade or downgrade.

    4. Restore logging level configuration using the output that was saved from Step 1.

  • When the installation is completed, the supervisor kickstart image, supervisor system image, module image, and the system BIOS are all updated.

  • Nondisruptive upgrades on fabric switches disrupt the control plane for about 80 seconds. The software upgrade can be disruptive if the upgrade process exceeds the designated period or if a failure occurs, at which point it can be halted without disruption.

  • Upgrades may be performed from the console port or via telnet/SSH. Performing the upgrade process by using the console port allows logging of the entire upgrade and bootup process. This may be useful for later troubleshooting. When upgrading on MDS 9700 directors there should be connections to both supervisors to get a complete log of the upgrade. Telnet/SSH sessions are lost when the switch or supervisor is rebooted and must be reestablished.

  • Before performing an upgrade, use the show install all impact system target system image name command to view the effect of updating the system from the running image to another specified image.

You can find the latest non-disruptive upgrade path in the Release Notes for the target NX-OS version. For more information see MDS Release Notes

Upgrading to Cisco MDS NX-OS Release 9.x on a Cisco MDS Fabric Switch

To upgrade a Cisco MDS fabric switch from an earlier NX-OS release to an NX-OS 9.x release perform the following steps:

Procedure


Step 1

Verify that the system image files for the upgrade are present on the active supervisor module bootflash:

switch# dir bootflash:
 
25863680 Sep 23 12:02:16 2021 m9250-s5ek9-kickstart-mz.9.2.1.bin
25864704 Jan 05 12:21:26 2022 m9250-s5ek9-kickstart-mz.9.2.2.bin
 
Usage for bootflash://sup-local
 
2838728704 bytes used
520916992 bytes free
3359645696 bytes total 

Step 2

If the software image file is not present, download it from an FTP or TFTP server to bootflash.

You can obtain the software image file from the Cisco.com Software Download Center at http://www.cisco.com/cisco/software/navigator.html.

switch# copy tftp://tftpserver.cisco.com/MDS/m9250-s5ek9-kickstart-mz.9.2.2.bin bootflash:m9250-s5ek9-kickstart-mz.9.2.2.bin
switch# copy tftp://tftpserver.cisco.com/MDS/m9250-s5ek9-mz.9.2.2.bin bootflash:m9250-s5ek9-mz.9.2.2.bin 

Step 3

Ensure that the required space is available on the switch:

switch# dir bootflash:
25863680 Sep 23 12:02:16 2017 m9250-s5ek9-kickstart-mz.9.2.1.bin
25864704 Sep 05 12:21:26 2018 m9250-s5ek9-kickstart-mz.9.2.2.bin
25864704 Sep 05 12:21:50 2018 m9250-s5ek9-mz.9.2.2.bin
 
Usage for bootflash://sup-local
120695976 bytes used
63863640 bytes free
184559616 bytes total 

Step 4

If you need more space on the switch, delete the files that are not required:

 switch# delete bootflash:m9250-s5ek9-kickstart-mz.9.2.1.bin 

Step 5

Save the configuration using the copy running-config startup-config command:

 switch# copy running-config startup-config 

You can also back up your existing configuration to a file, using the copy running-config bootflash:backup_config.txt command. You can add a date reference to the.txt filename to identify the file later.

Step 6

Save a copy of the show tech-support command output of the switch. For more information, see https://www.cisco.com/c/en/us/td/docs/dcn/whitepapers/how-to-collect-logs-cisco-mds.html#Theshowtechsupportcommand.

Step 7

Check for incompatibilities between NX-OS releases using the show incompatibility system <target system image name> command.

This command checks for incompatibilities between NX-OS releases, and any switch events that would interrupt the upgrade process. This will also ensure the /var/volatile/tmp file system has sufficient space to continue.

switch# show incompatibility system m9124v-s8ek9-mz.9.4.3a.bin
Checking incompatible configuration(s):
No incompatible configurations

Checking dynamic incompatibilities:
No incompatible configurations
switch#

Step 8

Verify if the /var/volatile/tmp file system has no more than 9% in use: using the show system internal flash command.

switch# show  system internal flash  | inc Mount|/var/volatile/tmp
Mount-on                  1K-blocks      Used   Available   Use%  Filesystem
/var/volatile/tmp            614400       104      614296      1   none

switch#

Note

 

The above example shows that the filesystem is used 1% only. Therefore, it is safe to proceed further. If the /var/volatile/tmp file system is utilized more than 9% , do not continue with the upgrade procedure. Contact Cisco TAC.

Step 9

Perform the upgrade by running the install all command:

switch# install all kickstart m9250-s5ek9-kickstart-mz.9.2.2.bin system m9250-s5ek9-mz.9.2.2.bin
Installer will perform compatibility check first. Please wait.
y
Verifying image bootflash:/m9250-s5ek9-kickstart-mz.9.2.2.bin for boot variable "kickstart".
[# ] 0%
[####################] 100% -- SUCCESS
Verifying image bootflash:/m9250-s5ek9-mz.9.2.2.bin for boot variable "system".
[####################] 100% -- SUCCESS
Performing module support checks.
[####################] 100% -- SUCCESS
Verifying image type.
[####################] 100% -- SUCCESS
Extracting "system" version from image bootflash:/m9250-s5ek9-mz.9.2.2.bin
[####################] 100% -- SUCCESS
Extracting "kickstart" version from image bootflash:/m9250-s5ek9-kickstart-mz.9.2.2.bin
[####################] 100% -- SUCCESS
Extracting "bios" version from image bootflash:/m9250-s5ek9-mz.9.2.2.bin
[####################] 100% -- SUCCESS
Performing Compact Flash and TCAM sanity test.
[####################] 100% -- SUCCESS
Notifying services about system upgrade.
[####################] 100% -- SUCCESS
Compatibility check is done:
Module bootable Impact Install-type Reason
------ -------- -------------- ------------ ------
1 yes non-disruptive reset
Other miscellaneous information for installation:
Module info
------ ----------------------------------
1 FC ports 1-40 and FCoE ports 1-8 are hitless, IPS 1-2 are hitful, and Intelligent Applications running are hitful
Images will be upgraded according to following table:
Module Image Running-Version New-Version Upg-Required
------ ---------- ---------------------------------------- -------------------- -----
1 system 9.2(1) 9.2(2) yes
1 kickstart 9.2(1) 9.2(2) yes
1 bios v2.1.17(01/08/14):v2.1.17(01/08/14) v2.1.17(01/08/14) no
Do you want to continue with the installation (y/n)? [n] y
Install is in progress, please wait.
Performing runtime checks.
[####################] 100% -- SUCCESS
Notifying services about the upgrade.
[####################] 100% -- SUCCESS
Setting boot variables.
[####################] 100% -- SUCCESS
Performing configuration copy.
[####################] 100% -- SUCCESS
Module 1: Refreshing compact flash and Upgrading bios/loader/bootrom/power-seq.
Warning: please do not remove or power off the module at this time.
[####################] 100% -- SUCCESS
Upgrade can no longer be aborted, any failure will result in a disruptive upgrade.
Freeing memory in the file system.
[####################] 100% -- SUCCESS
Loading images into memory.
[####################] 100% -- SUCCESS
Saving linecard runtime state.
[####################] 100% -- SUCCESS
Saving supervisor runtime state.
[####################] 100% -- SUCCESS
Saving mts state.
[####################] 100% -- SUCCESS
Reloading the kernel to proceed with the upgrade.
All telnet and ssh connections will now be temporarily terminated.
>> NX7--LC-loader-02.01.17 (June 8 2019 - 16:30:41), Build: 02.01.17
CPU0: 8572E, Version: 2.2, (0x80e80022)
Core: E500, Version: 3.0, (0x80210030)
Clock Configuration:
CPU:1066.672 MHz, CCB:533.336 MHz,
DDR:266.668 MHz (533.336 MT/s data rate), LBC:33.334 MHz
L1: D-cache 32 kB enabled
I-cache 32 kB enabled
Board: 9044, IOFPGA: 0x0000001A, SPROM: 0xAB
Boot flash : Primary
I2C: ready
DRAM: Initializing
DDR: dimm type 10, registered 1
DDR: dimm type 10, registered 1
DDR: 4 GB
L2: 1024 KB enabled
Using default environment
In: serial
Out: serial
Err: serial
Net: INFO: Net boot mode = 1
INFO: Net boot mode = 1
INFO: Board will come up MGMT interface
INFO: MAC address is: b8:38:61:4a:24:40
eTSEC2 board phy 3
INFO: Net boot mode = 1
eTSEC2
IDE: Bus 0: OK
Device 0: Model: UGB30STC4000Z4-EBY-ASD Firm: FW100511 Ser#: UNIGEN3 30021309
Type: Hard Disk
Capacity: 3907.9 MB = 3.8 GB (8003520 x 512)
Booting image bootflash://m9250-s5ek9-kickstart-mz.9.2.2.bin
25968640 bytes read
NBI at 08000000 size 134217728
Booting image at addr 0x00800000...
Memory <- <0x0 0x0 0x1 0x0> (4096MB)
ethernet0: local-mac-address <- b8:38:61:4a:24:40
ethernet1: local-mac-address <- 00:e0:0c:00:01:fd
ethernet2: local-mac-address <- 00:e0:0c:00:02:fd
CPU clock-frequency <- 0x3f941f80 (1067MHz)
CPU timebase-frequency <- 0x3f941f8 (67MHz)
CPU bus-frequency <- 0x1fca0fc0 (533MHz)
Image starting: loaded at 0x00800000 (sp: 0x7fedc4c0)
Allocating 0x620d88 bytes for kernel...
unzipping (0x00000000 <- 0x00817000:0x00de3838)...done 0x5bc060 bytes
Using loader supplied ramdisk at 0x2800000-0x3ddaa00
initrd head: 0x1f8b0808
Linux/PowerPC load: rw root=/dev/ram0 rdbase=0x7000000 card_index=9044 maxcpus=2 ip=off ramdisk_size=262144 noquiet obfl_type_ide=1 kgdboc=ttyS0,9600,B isanimg_loc=0x6000000 isanimg_size=0x400 console=ttyS0,9600n8nn loader_ver="02.01.17" card_index=9044 quiet bootdev=ide0 server_ip=171.69.21.28 ksimg=/m9250-s5ek9-kickstart-mz.9.2.2.bin isanimg=/m9700-sf4ek9-mz.9.2.1.bin Finalizing device tree... flat tree at 0xdf0140
�setup_arch: bootmem
mpc85xx_ds_setup_arch()
arch: exit
[ 0.060041] Host controller irq 26
[ 0.134631] Assign root port irq 26
[ 0.755227] physmap-flash physmap-flash.0: Could not reserve memory region
[ 1.032812] Enabling all PCI devices
INIT: Checking all filesystems.....retval=[0]
done.
Loading system software
Uncompressing system image: bootflash:///m9250-s5ek9-kickstart-mz.9.2.2.bin
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
Load plugins that defined in image conf: /isan/plugin_img/img.conf
No Patching support on this platform
Loading plugin 0: core_plugin...
No Patching support on this platform
Enter pboot_chk_compatibility
num srgs 1
0: swid-core-s5ek9, swid-core-s5ek9
num srgs 1
0: swid-sup-ali-ks, swid-sup-ali-ks
INIT: Entering runlevel: 3
[ 127.215099] clpk_hw_init_1:Post ISSU instance 0 status 0x00000736 GOOD
[ 127.293946] clpk_hw_init_1:Post ISSU instance 1 status 0x00000536 GOOD
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
System is coming up... Please wait...
Continuing with installation process, please wait.
The login will be disabled until the installation is completed.
Status for linecard upgrade.
[####################] 100% -- SUCCESS
Performing supervisor state verification.
[####################] 100% -- SUCCESS
Supervisor non-disruptive upgrade successful.
Install has been successful. 

Step 10

Log in to the switch:

MDS Switch
x.x.x.x login: admin
Cisco Nexus Operating System (NX-OS) Software
TAC support: http://www.cisco.com/tac
Copyright (c) 2002-2014, Cisco Systems, Inc. All rights reserved.
The copyrights to certain works contained in this software are
owned by other third parties and used and distributed under
license. Certain components of this software are licensed under
the GNU General Public License (GPL) version 2.0 or the GNU
Lesser General Public License (LGPL) Version 2.1. A copy of each
such license is available at
http://www.opensource.org/licenses/gpl-2.0.php and
http://www.opensource.org/licenses/lgpl-2.1.php 

Step 11

Run the show version command:

switch# show version
 
Cisco Nexus Operating System (NX-OS) Software
TAC support: http://www.cisco.com/tac
Documents: http://www.cisco.com/en/US/products/ps9372/tsd_products_support_serie
s_home.html
Copyright (c) 2002-2019, Cisco Systems, Inc. All rights reserved.
The copyrights to certain works contained herein are owned by
other third parties and are used and distributed under license.
Some parts of this software are covered under the GNU Public
License. A copy of the license is available at
http://www.gnu.org/licenses/gpl.html.
Software
BIOS: version 2.1.17
loader: version N/A
kickstart: version 9.2(2) [build 9.2(2)]
system: version 9.2(2) [build 9.2(2)]
BIOS compile time: 01/08/14
kickstart image file is: bootflash:///m9250-s5ek9-kickstart-mz.9.2.2.bin
kickstart compile time: 8/9/2021 23:00:00 [08/09/2021 04:18:10]
system image file is: bootflash:///m9250-s5ek9-kickstart-mz.9.2.2.bin
system compile time: 8/9/2019 23:00:00 [08/09/2021 07:09:57]
Hardware
cisco MDS 9250i 40 FC 2 IPS 8 FCoE (2 RU) Chassis ("40FC+8FCoE+2IPS Supervisor
")
Motorola, e500v2 with 4088636 kB of memory.
Processor Board ID JAF1804AAFG
Device name: MDS9250i
bootflash: 4001760 kB
Kernel uptime is 0 day(s), 0 hour(s), 7 minute(s), 42 second(s)
Last reset at 288238 usecs after Mon Aug 9 11:40:56 2021
Reason: Reset due to upgrade
System version: 9.2(1)
Service:
plugin
Core Plugin 

Step 12

Verify the status of the modules on the switch, using the show module command:

switch# show module
Mod  Ports  Module-Type             Model                            Status
---  -----  -------------------     ---------------------------      ------
1    50     40FC+8FCoE+2IPS         Supervisor DS-C9250I-K9-SUP      active*


Mod  Sw              Hw            World-Wide-Name(s) (WWN)
---  --------------  ------        -------------------
1    8.4(1)          1.0           20:01:00:2a:6a:1b:64:d0 to 20:28:00:2a:6a:1b:64:d0


Mod  MAC-Address(es)                         Serial-Num
---  --------------------------------------  ----------
1    b8-38-61-4a-25-c0 to b8-38-61-4a-25-cf  JAF1804AAFG

Step 13

To display the status of a nondisruptive upgrade on a fabric switch, use the show install all status command.

The command output displays the status only after the switch has rebooted with the new image. All the actions preceding the reboot are not captured in this output because when you enter the install all command using a Telnet session, the session is disconnected when the switch reboots. When you reconnect to the switch through a Telnet session, the upgrade may already be complete, in which case, the output displays the status of the upgrade.

switch# show install all status
 
This is the log of last installation.
 
Continuing with installation process, please wait.
The login will be disabled until the installation is completed.
 
Status for linecard upgrade.
-- SUCCESS
 
Performing supervisor state verification.
-- SUCCESS
 
Install has been successful 

Troubleshooting a Nondisruptive Upgrade on a Fabric Switch

When a nondisruptive upgrade begins, the system notifies all the services that an upgrade is about to start, and finds out whether the upgrade can proceed. If a service cannot allow the upgrade to proceed immediately, for example, if Fabric Shortest Path First (FSPF) timers are not configured to the default value, or a Cisco Fabric Services operation is in progress, the service terminates the upgrade. If such a situation occurs, you are prompted to enter the show install all failure-reason command to determine the reason why the upgrade cannot proceed.

Do you want to continue with the installation (y/n)? [n] y
 
Install is in progress, please wait.
 
Notifying services about the upgrade.
[# ] 0% -- FAIL. Return code 0x401E0066 (request timed out).
 
Please issue "show install all failure-reason" to find the cause of the failure.<---system prompt to enter the show all failure-reason command.
 
Install has failed. Return code 0x401E0066 (request timed out).
Please identify the cause of the failure, and try 'install all' again.
 
switch# show install all failure-reason
Service: "cfs" failed to respond within the given time period. 

When the upgrade is in progress, if any failures occur, for example, if a save runtime state failure or module upgrade failure occurs, the switch is rebooted disruptively because the changes cannot be rolled back. In this case, the upgrade fails, but you are not prompted to enter the show install all failure-reason command because the command does not yield any useful information.

If you need additional information to determine why an upgrade is unsuccessful, you can obtain the details by using the show tech-support command output, and from the console output from the installation, if available.

Moving From an NPE Image to a non-NPE Image and Vice Versa

The following section describes how to upgrade from a no payload encryption (NPE) image to a non-NPE image and vice versa.


Note


  • If the image file name includes npe text, the image is an NPE image. If the image file name does not include npe text, the image is a non-NPE image.

  • To move from using an NPE image to a non-NPE image or from a non-NPE image to an NPE image, Cisco recommends that NX-OS version of the new image should be the same as the NX-OS version currently running on the switch. To upgrade from one release of Cisco MDS NX-OS to a newer release, Cisco recommends that the switch is first changed from an NPE image to a non-NPE image or from a non-NPE image to an NPE image at the same NX-OS version and then upgraded to the desired NX-OS version.

  • Use the console connection for firmware upgrades. Be aware that if you are upgrading through the management interface, you must have a working connection to both supervisors, as this process causes a switchover and the current standby supervisor will be active after the upgrade. To check the status of the mgmt0 interface on the standby supervisor, use the command:
    show interface mgmt0 standby
    .

Procedure


Step 1

Log in to Cisco.com to access the links provided in this document. To log in to Cisco.com, go to the URL http://www.cisco.com/ and click Log In at the top of the page. Enter your Cisco Systems user name and password.

Note

 
Unregistered Cisco.com users cannot access the links provided in this document.

Step 2

Verify the following physical connections for the switch:

  • The console port is physically connected to a computer terminal (or terminal server).

  • The management 10/100/1000 Ethernet port (mgmt0) is connected to an external hub, switch, or router.

  • On switches with dual supervisor modules, both supervisor modules must have the management 10/100/1000 Ethernet ports (mgmt0) connected to an external hub, switch, or router.

These procedures are specified in the hardware installation guide for the required product.

Step 3

Log in to the switch.

Step 4

Issue the copy running-config startup-config command to store your current running configuration.

You can also create a backup of your existing configuration to a file by issuing the copy running-config bootflash:backup_config.txt command.

Step 5

Verify that the requested license files installed in the switch are displayed in response to the show license usage command.

Note

 
The switch is initially shipped with the required licenses installed in the system; however, the initial license file will not cover unlicensed features that may be used during the grace period. If no license is displayed at this point, perform Step 6 and Step 7 to install the required licenses. If the required licenses are displayed at this point, skip Step 6 and Step 7 and move to Step 8.

The example CLI output for a valid license follows:

switch# show license usage
Feature            Ins       Lic       Status       Expiry Date    Comments
FM_SERVER_PKG       No        -        Unused        -                -
MAINFRAME_PKG       No        -        Unused        -                -
ENTERPRISE_PKG      Yes       -        Unused        Never            -
 

Step 6

Install licenses (if necessary) to ensure that the required features are available on the switch.

Perform the following steps:

  1. Use the show license host-id command to obtain the serial number for your switch. The host ID is also referred to as the switch serial number.

    switch# show license host-id
    License hostid: VDH=JAF1721AEQG 

    Tip

     
    Use the entire ID that appears after the colon (:) sign. In this example, the host ID is VDH=JAF1721AEQG.
  2. Obtain your Claim Certificate or the Proof of Purchase document. This document accompanies every Cisco MDS switch.

  3. Locate the Product Authorization Key (PAK) from the Claim Certificate or Proof of Purchase document.

  4. Locate the website URL from the Claim Certificate or Proof of Purchase document.

  5. Access the specified URL that applies to your switch and enter the switch serial number and the PAK.

    The license key file is sent to you by email. The license key file is digitally signed to authorize its use only on the switch for which it was requested. The requested features are also enabled once the NX-OS software on the specified switch accesses the license key file.

    Caution

     
    Install the license file in the specified Cisco MDS 9000 Family switch without making any modifications.

Step 7

Verify the validity if the license.

the following example shows the validity of the license:
 switch# show license usage

If the required licenses are displayed, skip steps 8 and 9 and Go to Step 10

Step 8

Install the license key file when you receive it by email.

Perform the following steps:

  1. Install the license key file when you receive it by email.

  2. Perform the installation by issuing the install license command on the active supervisor module from the switch console.

    switch# install license bootflash:license_file.lic
    Installing license..done 

    Note

     
    If you provide a target name for the license key file, the file is installed with the specified name. Otherwise, the file name specified in the license key file is used to install the license.
  3. Exit the switch console.

Step 9

Ensure that the required space is available in the bootflash: directory for the image file(s) to be copied using the dir bootflash: command.

Use the delete bootflash:filename command to remove unnecessary files.

Note

 
Before downloading and installing Cisco NX-OS software, verify that the release is supported by your Cisco System MDS reseller. If you purchased support through a Cisco Systems reseller, contact them directly for more information. Otherwise, contact Cisco Technical support.
switch# dir bootflash:
37011968 Apr 30 16:10:28 2014 m9700-sf4ek9-kickstart-mz-npe.8.4.2a.bin
195875124 Apr 30 12:55:14 2014 m9700-sf4ek9-mz-npe.8.4.2a.bin
Usage for bootflash://sup-local
819736576 bytes used
75313152 bytes free
895049728 bytes total 

Step 10

If you need more space on the active supervisor module bootflash, delete unnecessary files to make space available.

switch# delete m9700-sf4ek9-kickstart-mz-npe.8.4.2a.bin
switch# delete m9700-sf4ek9-mz-npe.8.4.2a.bin

Step 11

For switches with dual supervisor modules, verify that there is space available on the standby supervisor module bootflash on a switch.

switch# attach module x /*where x is the module number of the standby supervisor*/
switch(standby)# dir bootflash:
12288 Aug 26 19:06:14 2011 lost+found/
16206848 Jul 01 10:54:49 2011 m9700-sf4ek9-kickstart-mz-npe.8.4.2a.bin
78337129 Jul 01 10:33:52 2011 m9700-sf4ek9-mz-npe.8.4.2a.bin
 
Usage for bootflash://sup-local
122811392 bytes used
61748224 bytes free
184559616 bytes total
 
switch(standby)# exit /*to return to the active supervisor*/

Step 12

For switches with dual supervisor modules, if you need more space on the standby supervisor module bootflash on a switch, delete unnecessary files to make space available.

switch(standby)# delete bootflash:m9700-sf4ek9-kickstart-mz-npe.8.4.2a.bin
switch(standby)# delete m9700-sf4ek9-mz-npe.8.4.2a.bin 

Step 13

Access the Software Download Center using this URL: http://www.cisco.com/cisco/software/navigator.html.

If prompted to log in, use your Cisco system user ID and password.

Step 14

Select the same version of the NPE image file or non-NPE image file that the switch is currently running.

You see the Technical Support Encryption Software Export Distribution Authorization form.

Step 15

Complete the required forms to obtain authorization.

Step 16

Download the files to an FTP or TFTP server.

Step 17

Copy the Cisco MDS NX-OS kickstart and system images to the active supervisor module bootflash using FTP or TFTP.

Note

 
When you download an image file, change to your FTP environment IP address or DNS name and the path where the files are located.
switch# copy tftp://tftpserver.cisco.com/MDS/m9700-sf4ek9-kickstart-mz.9.2.1.bin bootflash:m9700-sf4ek9-kickstart-mz.9.2.1.bin
switch# copy tftp://tftpserver.cisco.com/MDS/m9700-sf4ek9-mz-npe.9.2.1.bin bootflash:m9700-sf4ek9-mz-npe.9.2.1.bin 

Step 18

Issue the boot kickstart bootflash : filename and boot system bootflash : filename commands to change the boot variables to point to the new image.

switch# configure terminal
switch(config)# boot kickstart bootflash:m9700-sf4ek9-kickstart-mz.9.2.1.bin
Performing image verification and compatibility check, please wait....
switch(config)# boot system bootflash:m9700-sf4ek9-mz-npe.9.2.1.bin
Performing image verification and compatibility check, please wait.... 

Step 19

Issue the show incompatibility-all system filename command to verify any incompatible hardware.

switch(config-if)# show incompatibility-all system m9700-sf4ek9-mz-npe.9.2.1.bin
Checking incompatible configuration(s)
No incompatible configurations
 
Checking dynamic incompatibilities:
-----------------------------------
No incompatible configurations 

Step 20

Save the current running configuration to the startup configuration by issuing the copy running-config startup-config command.

switch(config)# copy running-config startup-config
[########################################] 100%
Copy complete. 

Step 21

Issue the show boot command to check the current boot variable.

switch(config)# show boot
 
Current Boot Variables:
 
sup-1
kickstart variable = bootflash:/ m9700-sf4ek9-kickstart-mz.9.2.1.bin
system variable = bootflash:/ m9700-sf4ek9-mz-npe.9.2.1.bin
sup-2
kickstart variable = bootflash:/ m9700-sf4ek9-kickstart-mz.9.2.1.bin
system variable = bootflash:/ m9700-sf4ek9-mz-npe.9.2.1.bin
No module boot variable set
 
Boot Variables on next reload:
 
sup-1
kickstart variable = bootflash:/ m9700-sf4ek9-kickstart-mz.9.2.1.bin
system variable = bootflash:/ m9700-sf4ek9-mz-npe.9.2.1.bin
sup-2
kickstart variable = bootflash:/ m9700-sf4ek9-kickstart-mz.9.2.1.bin
system variable = bootflash:/ m9700-sf4ek9-mz-npe.9.2.1.bin
No module boot variable set 

Step 22

Reload the switch by issuing the reload command.

switch(config)# reload
This command will reboot the system. (y/n)? [n] 

You have now upgraded the Cisco MDS NX-OS software in your existing switch.