Software Maintenance Upgrade

The Software Maintenance Upgrade (SMU) is a package that can be installed on a system to provide a fix or a security resolution to a released image.

Restrictions for Software Maintenance Upgrade

  • Hot patching is not supported on Cisco Catalyst 9200 Series Switches.

  • SMU supports cold patching using install mode only.

Information About Software Maintenance Upgrade

The following sections provide detailed information about Software Maintenance Upgrade (SMU).

SMU Overview

The SMU is a package that can be installed on a system to provide a fix or a security resolution to a released image. An SMU package is provided on a per release and per component basis.

An SMU provides a significant benefit over classic Cisco IOS software because it allows you to address network issues quickly while reducing the time and scope of the testing required. The Cisco IOS XE platform internally validates SMU compatibility and does not allow you to install noncompatible SMUs.

All the SMUs are integrated into the subsequent Cisco IOS XE software maintenance releases. An SMU is an independent and self-sufficient package and it does not have any prerequisites or dependencies. You can choose which SMUs to install or uninstall in any order.

SMUs are supported only on Extended Maintenance releases and for the full lifecycle of the underlying software release.

Perform these basic steps to install an SMU:

  1. Add the SMU to the filesystem.

  2. Activate the SMU on the system.

  3. Commit the SMU changes so that it is persistent across reloads.

SMU Workflow

The SMU process is initiated with a request to the Cisco Customer Support. Contact your customer support to raise an SMU request.

At release time, the SMU package is posted to the Cisco Software Download page and can be downloaded and installed.

SMU Package

The SMU package contains a small set of files for patching the release along with metadata that describes the contents of the package, and fix for the reported issue that the SMU is requested for.

SMU Reload

All SMUs require a cold reload of the system during activation. A cold reload is the complete reload of the operating system. This action affects the traffic flow for the duration of the reload. This reload ensures that all processes are started with the correct libraries and files that are installed as part of the SMU.

How to Manage Software Maintenance Updates

You can install, activate, and commit an SMU package using a single command (1-step process) or using separate commands (3-step process).


Tip


Use the 1-step process when you have to install just one SMU package file and use the 3-step process when you have to install multiple SMUs. The 3-step process minimises the number of reloads required when you have more than one SMU package file to install.

Installing an SMU Package: 1-Step Process

This task shows how to use the single install add file activate commit command for installing an SMU package.

Before you begin

Check that the SMU you are about to install corresponds to the software image installed on your device. For example, SMU cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin is compatible with software image cat9k_lite_iosxe.16.09.04.SPA.bin.

SUMMARY STEPS

  1. enable
  2. install add file flash: filename [activate commit]
  3. exit

DETAILED STEPS

  Command or Action Purpose

Step 1

enable

Example:

Device> enable

Enables privileged EXEC mode. Enter your password, if prompted.

Step 2

install add file flash: filename [activate commit]

Example:

Device# install add file flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin activate commit

Copies the maintenance update package from flash to the device, performs a compatibility check for the platform and image versions, activates the SMU package, and makes the package persistent across reloads. This command extracts the individual components of the .bin file into the subpackages and packages.conf files.

You can also copy the SMU package from from a remote location (through FTP, HTTP, HTTPS, or TFTP).

Note

 

If the SMU file is copied using TFTP, use bootflash to activate the SMU.

Step 3

exit

Example:

Device# exit

Exits privileged EXEC mode and returns to user EXEC mode.

Installing an SMU Package: 3-Step Process

This task shows you the 3-step process for installing an SMU package. Use this method to install multiple SMUs and avoid multiple reloads.

Before you begin

Check that the SMU you are about to install corresponds to the software image installed on your device. For example, SMU cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin is compatible with software image cat9k_lite_iosxe.16.09.04.SPA.bin.

SUMMARY STEPS

  1. enable
  2. install add file location filename
  3. install activate file location filename
  4. install commit

DETAILED STEPS

  Command or Action Purpose

Step 1

enable

Example:

Device> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2

install add file location filename

Example:

Device# install add file flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin
Device# install add file flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin

Copies the maintenance update package from flash to the device, and then performs a compatibility check for the platform and image versions, and adds the SMU package on all member nodes or FRUs, as applicable. This command also runs base compatibility checks on a file to ensure that the SMU package is supported on the platform. It also adds an entry in the package/SMU.sta file, so that its status can be monitored and maintained.

You can also copy the SMU package from a remote location (through FTP, HTTP, HTTPS, or TFTP).

Step 3

install activate file location filename

Example:

Device# install activate file flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin,
cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin

Activates the SMU package file that was added and updates the package status details. You will be promped to reload the system in order to complete the activation process.

When entering multiple SMUs, use a comma (without a space before or after), to separate file names. Also ensure that total number of characters does not exceed 128. This step involves a reload.

Step 4

install commit

Example:

Device# install commit

Commits the activation changes to be persistent across reloads.

The commit can be done after activation while the system is up, or after the first reload. If a package is activated but not committed, it remains active after the first reload, but not after the second reload.

Managing an SMU

This task shows how to rollback the installation state, deactivate, and remove a previously installed SMU package from the device. This can be used for a SMU that has been installed with the 1-step and 3-step process.

SUMMARY STEPS

  1. enable
  2. install rollback to {base | committed | id commit-ID}
  3. install deactivate file location filename
  4. install remove {file location filename | inactive}
  5. show version
  6. show install summary

DETAILED STEPS

  Command or Action Purpose

Step 1

enable

Example:

Device> enable

Enables privileged EXEC mode. Enter your password if prompted.

Step 2

install rollback to {base | committed | id commit-ID}

Example:

Device# install rollback to committed 

Returns the device to the previous installation state. After the rollback, a reload is required.

Step 3

install deactivate file location filename

Example:

Device# install deactivate file flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin

Deactivates an active package, updates the package status, and triggers a process to restart or reload.

Step 4

install remove {file location filename | inactive}

Example:

Device# install remove file flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin

Checks if the specified SMU is inactive and if it is, deletes it from the file system. The inactive option deletes all the inactive packages from the file system.

Step 5

show version

Example:

Device# show version

Displays the image version on the device.

Step 6

show install summary

Example:

Device# show install summary

Displays information about the active package.

The output of this command varies according to the install commands that are configured.

Configuration Examples for Software Maintenance Upgrade

The following is a list of SMU configuration examples.

Example: Installing an SMU (3-Step Process, Using flash:)

The following example shows how to install a SMU package by using the 3-step process. Here the SMU package file is saved in the device's flash.
  1. Copying the SMU package file from flash and installing it.

    Device# install add file flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    install_add: START Wed Jun 10 14:17:45 IST 2020
    install_add: Adding SMU
    
    --- Starting initial file syncing ---
    Info: Finished copying flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin to the selected switch(es)
    Finished initial file syncing
    
    
    *Jun 10 14:17:48.128 IST: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install add flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.binExecuting pre scripts....
    Executing pre sripts done.
    --- Starting SMU Add operation ---
    Performing SMU_ADD on all members
      [1] SMU_ADD package(s) on switch 1
      [1] Finished SMU_ADD on switch 1
    Checking status of SMU_ADD on [1]
    SMU_ADD: Passed on [1]
    Finished SMU Add operation
    
    SUCCESS: install_add /flash/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin Wed Jun 10 14:18:00 IST 2020
    
    

    Verifying the addition and installation of the SMU package file by using the show install summary command. The status of the SMU package file is I, because it has not been activated and committed yet.

    Device# show install summary
    
    [ Switch 1 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version    
    --------------------------------------------------------------------------------
    SMU   I    flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin              
    IMG   C    16.9.4.0.3431                                                       
    
    --------------------------------------------------------------------------------
    Auto abort timer: inactive
    --------------------------------------------------------------------------------
    
    
  2. Activating the SMU package file.

    Device# install activate file flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin      
    install_activate: START Wed Jun 10 14:19:59 IST 2020
    install_activate: Activating SMU
    
    *Jun 10 14:20:01.513 IST: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install activate flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    
    This operation requires a reload of the system. Do you want to proceed? [y/n]y
    Executing pre scripts....
    Executing pre sripts done.
    
    --- Starting SMU Activate operation ---
    Performing SMU_ACTIVATE on all members
      [1] SMU_ACTIVATE package(s) on switch 1
      [1] Finished SMU_ACTIVATE on switch 1
    Checking status of SMU_ACTIVATE on [1]
    SMU_ACTIVATE: Passed on [1]
    Finished SMU Activate operation
    
    install_activate: Reloading the box to complete activation of the SMU...
    install_activate will reload the system now!
    
    *Jun 10 14:20:22.258 IST: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: Switch 1 R0/0: rollback_timer: Install auto abort timer will expire in 7200 seconds
         Chassis 1 reloading, reason - Reload command
    Jun 10 14:20:28.291: %PMAN-5-EXITACTION: F0/0: pvp: Process manager is exiting: reload fp action requested
    Jun 10 14:20:30.718: %PMAN-5-EXITACTION: R0/0: pvp: Proce
    Jun 10 14:20:34.834: %PMAN-5-EXITACTION: C0/0: pvp: Process manager is exiting: 
    Jun 10 14:20:36.053: %INSTALL-5-INSTALL_COMPLETED_INFO: R0/0: install_engine: Completed install activate SMU flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    watchdog watchdog0: watchdog did not stop!
    reboot: Restarting system
    
    Initializing Hardware...
    <output truncated>
    
    ###########
    Jun 10 08:52:01.806: %BOOT-5-BOOTTIME_SMU_TEMP_ACTIVE_DETECTED: R0/0: install_engine: SMU file /flash/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin active temporary...
    SMU commit is pending
    
    Cisco IOS Software [Fuji], Catalyst L3 Switch Software (CAT9K_LITE_IOSXE), Version 16.9.4, RELEASE SOFTWARE (fc2)
    Technical Support: http://www.cisco.com/techsupport
    Copyright (c) 1986-2019 by Cisco Systems, Inc.
    Compiled Thu 22-Aug-19 17:30 by mcpre
    
    <output truncated>

    Verifying activation of the SMU package file by using the show install summary command. The status of the SMU package file is U, because it has not been committed yet.

    [ Switch 1 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version    
    --------------------------------------------------------------------------------
    SMU   U    flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin              
    IMG   C    16.9.4.0.3431                                                       
    
    --------------------------------------------------------------------------------
    Auto abort timer: active on install_activate, time before rollback - 01:41:52
    --------------------------------------------------------------------------------
    
  3. Committing the SMU package file

    Device# install commit 
    install_commit: START Wed Jun 10 14:38:42 IST 2020
    install_commit: Committing SMU
    
    *Jun 10 14:38:44.906 IST: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install commitExecuting pre scripts....
    Executing pre sripts done.
    --- Starting SMU Commit operation ---
    Performing SMU_COMMIT on all members
      [1] SMU_COMMIT package(s) on switch 1
      [1] Finished SMU_COMMIT on switch 1
    Checking status of SMU_COMMIT on [1]
    SMU_COMMIT: Passed on [1]
    Finished SMU Commit operation
    
    SUCCESS: install_commit /flash/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin Wed Jun 10 14:38:58 IST 2020
    *Jun 10 14:38:59.385 IST: %INSTALL-5-INSTALL_COMPLETED_INFO: Switch 1 R0/0: install_engine: Completed install commit SMU                                                 
    
    

    Verifying the commit by using the show install summary command. The SMU package file has been installed, activated and committed and the status is C.

    Device# show install summary 
    [ Switch 1 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version    
    --------------------------------------------------------------------------------
    SMU   C    flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin              
    IMG   C    16.9.4.0.3431                                                       
    
    --------------------------------------------------------------------------------
    Auto abort timer: inactive
    --------------------------------------------------------------------------------
    

    Verifying active packages by using the show install active command

    Device# show install active 
    [ Switch 1 ] Active Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version    
    --------------------------------------------------------------------------------
    SMU   C    flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin              
    IMG   C    16.9.4.0.3431  

    Checking the version, by using the show version command:

    Device# show version
    Cisco IOS XE Software, Version 16.09.04
    Cisco IOS Software [Fuji], Catalyst L3 Switch Software (CAT9K_LITE_IOSXE), Version 16.9.4, RELEASE SOFTWARE (fc2)
    Technical Support: http://www.cisco.com/techsupport
    Copyright (c) 1986-2019 by Cisco Systems, Inc.
    Compiled Thu 22-Aug-19 17:30 by mcpre
    ...
    
    

Example: Installing Multiple SMUs (3-Step Process, Using flash:)

The following example shows how to install multiple SMU package files by using the 3-step process. Here the SMU package files are saved in the device's flash.

The SMU files being installed on the switch stack are: cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin and cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin

  1. (Optional) Checking that the switch stack is ready and that the SMU package files are in the device's flash.

    Device# show switch
    Switch/Stack Mac Address : 08ec.f586.aa80 - Local Mac Address
    Mac persistency wait time: Indefinite
                                                 H/W   Current
    Switch#   Role    Mac Address     Priority Version  State
    -------------------------------------------------------------------------------------
    *1       Active   08ec.f586.aa80     1      V01     Ready               
     2       Member   7488.bb3c.f600     1      V01     Ready               
     3       Member   7488.bb3f.9c00     1      V01     Ready                
     4       Member   08ec.f5ee.1080     1      V01     Ready               
     5       Standby  08ec.f589.7c80     1      V01     Ready   
    Device# dir flash: | i smu
    
    89075  -rw-  79256 Oct 26 2035 07:07:42 +00:00 cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin
    89082  -rw-  9656  Oct 26 2035 07:08:08 +00:00 cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin
    
    
  2. Copying the SMU package files from flash and adding them.

    Only one SMU package file is added at a time; no reload is required between the addition of the SMU package files.

    Device# install add file flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin  
    install_add: START Fri Oct 26 07:10:59 UTC 2035
    Oct 26 07:11:01.695 %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install add flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin
    install_add: Adding SMU
    install_add: Checking whether new add is allowed ....
     
    --- Starting initial file syncing ---
     
    *Oct 26 07:11:01.643: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install add flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin[1]: Copying flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin from switch 1 to switch 2 3 4 5
    [2 3 4 5]: Finished copying to switch 2 switch 3 switch 4 switch 5 
    Info: Finished copying flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin to the selected switch(es)
    Finished initial file syncing
     
    --- Starting SMU Add operation ---
    Performing SMU_ADD on all members
      [1] SMU_ADD package(s) on switch 1
      [1] Finished SMU_ADD on switch 1
      [2] SMU_ADD package(s) on switch 2
      [2] Finished SMU_ADD on switch 2
      [3] SMU_ADD package(s) on switch 3
      [3] Finished SMU_ADD on switch 3
      [4] SMU_ADD package(s) on switch 4
      [4] Finished SMU_ADD on switch 4
      [5] SMU_ADD package(s) on switch 5
      [5] Finished SMU_ADD on switch 5
    Checking status of SMU_ADD on [1 2 3 4 5]
    SMU_ADD: Passed on [1 2 3 4 5]
    Finished SMU Add operation
     
    SUCCESS: install_add  Fri Oct 26 07:11:45 UTC 2035
    Oct 26 07:11:46.695 %INSTALL-5-INSTALL_COMPLETED_INFO: R0/0: install_engine: Completed install add SMU flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin
    Device#
    *Oct 26 07:11:46.656: %INSTALL-5-INSTALL_COMPLETED_INFO: Switch 1 R0/0: install_engine: Completed install add SMU flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin 
    

    Verifying the additiong of the first SMU package file by using the show install summary command.

    Device# show install summary
    [ Switch 1 2 3 4 5 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version   
    --------------------------------------------------------------------------------
    SMU   I    flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin             
    IMG   C    16.12.3.0.3752                                                     
     
    --------------------------------------------------------------------------------
    Auto abort timer: inactive
    --------------------------------------------------------------------------------
     
    

    Adding the second SMU package file.

    Device# install add file flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin 
     
    install_add: START Fri Oct 26 07:12:38 UTC 2035
    Oct 26 07:12:40.782 %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install add flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin
    install_add: Adding SMU
    install_add: Checking whether new add is allowed ....
     
    --- Starting initial file syncing ---
     
    *Oct 26 07:12:40.743: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install add flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin[1]: Copying flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin from switch 1 to switch 2 3 4 5
    [2 3 4 5]: Finished copying to switch 2 switch 3 switch 4 switch 5 
    Info: Finished copying flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin to the selected switch(es)
    Finished initial file syncing
     
    --- Starting SMU Add operation ---
    Performing SMU_ADD on all members
      [1] SMU_ADD package(s) on switch 1
      [1] Finished SMU_ADD on switch 1
      [2] SMU_ADD package(s) on switch 2
      [2] Finished SMU_ADD on switch 2
      [3] SMU_ADD package(s) on switch 3
      [3] Finished SMU_ADD on switch 3
      [4] SMU_ADD package(s) on switch 4
      [4] Finished SMU_ADD on switch 4
      [5] SMU_ADD package(s) on switch 5
      [5] Finished SMU_ADD on switch 5
    Checking status of SMU_ADD on [1 2 3 4 5]
    SMU_ADD: Passed on [1 2 3 4 5]
    Finished SMU Add operation
     
    SUCCESS: install_add  Fri Oct 26 07:13:24 UTC 2035
    Oct 26 07:13:25.656 %INSTALL-5-INSTALL_COMPLETED_INFO: R0/0: install_engine: Completed install add SMU flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin
     Decive#
    *Oct 26 07:13:25.616: %INSTALL-5-INSTALL_COMPLETED_INFO: Switch 1 R0/0: install_engine: Completed install add SMU flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin
    

    Verifying the addition and installation of both the SMU package files by using the show install summary command. The status of both package files is I, because they have not been activated and committed yet.

    Device# show install summary                           
    
    [ Switch 1 2 3 4 5 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version   
    --------------------------------------------------------------------------------
    SMU   I    flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin             
    SMU   I    flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin             
    IMG   C    16.12.3.0.3752                                                     
     
    --------------------------------------------------------------------------------
    Auto abort timer: inactive
    --------------------------------------------------------------------------------
  3. Activating the SMU package files.

    When entering multiple SMUs, use a comma (without a space before or after), to separate file names. Also ensure that total number of characters does not exceed 128. This step involves a reload.

    Device# install activate file flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin,cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin   
    
    install_activate: START Sun Oct 28 13:23:42 UTC 2035
    Oct 28 13:23:44.620 %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install activate flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin,cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin
    install_activate: Activating SMU
    
    *Oct 28 13:23:44.581: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install activate flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin,cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin
    
    This operation may require a reload of the system. Do you want to proceed? [y/n]y
    Executing pre scripts....
     
    Executing pre sripts done.
     
    --- Starting SMU Activate operation ---
    Performing SMU_ACTIVATE on all members
     
    *Oct 28 13:24:41.563: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: Switch 1 R0/0: rollback_timer: Install auto abort timer will expire in 7200 secondsOct 28 13:24:43.259: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: R0/0: rollback_timer: Install auto abort timer will expire in 7200 seconds
    *Oct 28 13:24:43.222: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: Switch 4 R0/0: rollback_timer: Install auto abort timer will expire in 7200 seconds
    *Oct 28 13:24:43.192: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: Switch 3 R0/0: rollback_timer: Install auto abort timer will expire in 7200 seconds
    *Oct 28 13:24:43.134: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: Switch 2 R0/0: rollback_timer: Install auto abort timer will expire in 7200 seconds
    *Oct 28 13:24:43.825: %INSTALL-5-INSTALL_AUTO_ABORT_TIMER_PROGRESS: Switch 5 R0/0: rollback_timer: Install auto abort timer will expire in 7200 seconds  [1] SMU_ACTIVATE package(s) on switch 1
      [1] Finished SMU_ACTIVATE on switch 1
      [2] SMU_ACTIVATE package(s) on switch 2
      [2] Finished SMU_ACTIVATE on switch 2
      [3] SMU_ACTIVATE package(s) on switch 3
      [3] Finished SMU_ACTIVATE on switch 3
      [4] SMU_ACTIVATE package(s) on switch 4
      [4] Finished SMU_ACTIVATE on switch 4
      [5] SMU_ACTIVATE package(s) on switch 5
      [5] Finished SMU_ACTIVATE on switch 5
    Checking status of SMU_ACTIVATE on [1 2 3 4 5]
    SMU_ACTIVATE: Passed on [1 2 3 4 5]
    Finished SMU Activate operation
     
    install_activate: Reloading the box to complete activation of the SMU...
    install_activate will reload the system now!
     
    Chassis 4 reloading, reason - Reload command
    reload fp action requested
    rp processes exit with reload switch code
     
     
     
    watchdog watchdog0: watchdog did not stop!
    reboot: Restarting system
     
    Initializing Hardware...
     
    System Bootstrap, Version 16.12.1r [FC6], RELEASE SOFTWARE (P)
    Compiled Thu 02/13/2020 12:36:08 by rel
     
    Current ROMMON image : Primary
    C9200L-24T-4G platform with 2097152 Kbytes of main memory
     
    boot: attempting to boot from [flash:packages.conf]
    boot: reading file packages.conf
     
    #############
    Oct 28 13:26:55.653: %BOOT-5-BOOTTIME_SMU_TEMP_ACTIVE_DETECTED: R0/0: install_engine: SMU file /flash/cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin active temporary... SMU commit is pending
    Oct 28 13:26:55.912: %BOOT-5-BOOTTIME_SMU_TEMP_ACTIVE_DETECTED: R0/0: install_engine: SMU file /flash/cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin active temporary... SMU commit is pending
     
    Waiting for 120 seconds for other switches to boot
    ##########
    Switch number is 4
    All switches in the stack have been discovered. Accelerating discovery
     
     

    Verifying activation of the SMU package files by using the show install summary command. The status of both files is U, because they have not been committed yet.

    Device# show install summary
    [ Switch 1 2 3 4 5 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version   
    --------------------------------------------------------------------------------
    SMU   U    flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin             
    SMU   U    flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin             
    IMG   C    16.12.3.0.3752                                                     
     
    --------------------------------------------------------------------------------
    Auto abort timer: active on install_activate, time before rollback - 01:50:16
    --------------------------------------------------------------------------------
    
  4. Committing the SMU package file

    Device# install commit 
    install_commit: START Sun Oct 28 13:34:42 UTC 2035
    Oct 28 13:34:45.202 %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install commit
     
    *Oct 28 13:34:45.146: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install commitinstall_commit: Committing SMU
    Executing pre scripts....
    Executing pre sripts done.
    --- Starting SMU Commit operation ---
    Performing SMU_COMMIT on all members
     
    *Oct 28 13:35:24.436: %PLATFORM-4-ELEMENT_WARNING: Switch 1 R0/0: smand: 5/RP/0: limited space - copy files out of flash: directory. flash: value 84% (1599 MB) exceeds warning level 70% (1337 MB).
    *Oct 28 13:35:30.587: %PLATFORM-4-ELEMENT_WARNING: Switch 1 R0/0: smand: 2/RP/0: limited space - copy files out of flash: directory. flash: value 74% (1412 MB) exceeds warning level 70% (1337 MB).  [1] SMU_COMMIT package(s) on switch 1
      [1] Finished SMU_COMMIT on switch 1
      [2] SMU_COMMIT package(s) on switch 2
      [2] Finished SMU_COMMIT on switch 2
      [3] SMU_COMMIT package(s) on switch 3
      [3] Finished SMU_COMMIT on switch 3
      [4] SMU_COMMIT package(s) on switch 4
      [4] Finished SMU_COMMIT on switch 4
      [5] SMU_COMMIT package(s) on switch 5
      [5] Finished SMU_COMMIT on switch 5
    Checking status of SMU_COMMIT on [1 2 3 4 5]
    SMU_COMMIT: Passed on [1 2 3 4 5]
    Finished SMU Commit operation
     
    SUCCESS: install_commit /flash/cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin /flash/cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin 
    Sun Oct 28 13:35:52 UTC 2035
    Oct 28 13:35:53.789 %INSTALL-5-INSTALL_COMPLETED_INFO: R0/0: install_engine: Completed install commit SMU
     
    JJ22-Vore_stack-24TE#
    *Oct 28 13:35:53.749: %INSTALL-5-INSTALL_COMPLETED_INFO: Switch 1 R0/0: install_engine: Completed install commit SMU

    Verifying the commit by using the show install summary command. The SMU package files have been installed, activated and committed, and the status is C.

    Device# show install summary 
    [ Switch 1 2 3 4 5 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
                C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type  St   Filename/Version   
    --------------------------------------------------------------------------------
    SMU   C    flash:cat9k_lite_iosxe.16.12.03.CSCvt22238.SPA.smu.bin             
    SMU   C    flash:cat9k_lite_iosxe.16.12.03.CSCvt72427.SPA.smu.bin             
    IMG   C    16.12.3.0.3752                                                     
     
    --------------------------------------------------------------------------------
    Auto abort timer: inactive
    --------------------------------------------------------------------------------
     
    

Example: Installing an SMU (3-Step Process, Using TFTP)

The following example shows how to install a SMU package by using the 3-step process. Here the SMU package file is saved in a remote (TFTP) location.

  1. Adding the SMU package file.

    Device# install add file tftp://172.16.0.1//tftpboot/folder1/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    
    Jun 22 11:32:27.035: %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install add tftp://172.16.0.1//tftpboot/folder1/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    Jun 22 11:32:27.035 %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install add tftp://172.16.0.1//tftpboot/folder1/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    Downloading file tftp://172.16.0.1//tftpboot/folder1/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    Finished downloading file tftp://172.16.0.1//tftpboot/folder1/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin to flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    install_add: Adding SMU
    install_add: Checking whether new add is allowed ....
    
    --- Starting initial file syncing ---
    
    025335: *Jun 22 2020 11:32:26 UTC: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install add tftp://172.16.0.1//tftpboot/folder1/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin[1]: Copying flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin from switch 1 to switch 2
    [2]: Finished copying to switch 2 
    Info: Finished copying flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin to the selected switch(es)
    Finished initial file syncing
    
    --- Starting SMU Add operation ---
    Performing SMU_ADD on all members
    [1] SMU_ADD package(s) on switch 1
    [1] Finished SMU_ADD on switch 1
    [2] SMU_ADD package(s) on switch 2
    [2] Finished SMU_ADD on switch 2
    Checking status of SMU_ADD on [1 2]
    SMU_ADD: Passed on [1 2]
    Finished SMU Add operation
    
    SUCCESS: install_add Mon Jun 22 11:32:56 UTC 2020
    Jun 22 11:32:57.598: %INSTALL-5-INSTALL_COMPLETED_INFO: R0/0: install_engine: Completed install add SMU flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    Jun 22 11:32:57.598 %INSTALL-5-INSTALL_COMPLETED_INFO: R0/0: install_engine: Completed install add SMU flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    
    ECSG-SEC-C9200-24P#
    025336: *Jun 22 2020 11:32:57 UTC: %INSTALL-5-INSTALL_COMPLETED_INFO: Switch 1 R0/0: install_engine: Completed install add SMU flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    
    
    

    Verifying addition by using the show install summary command.

    Device# show install summary 
    [ Switch 1 2 ] Installed Package(s) Information:
    State (St): I - Inactive, U - Activated & Uncommitted,
    C - Activated & Committed, D - Deactivated & Uncommitted
    --------------------------------------------------------------------------------
    Type St Filename/Version 
    --------------------------------------------------------------------------------
    SMU I flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin 
    IMG C 16.12.02.0.6 
    
    --------------------------------------------------------------------------------
    Auto abort timer: inactive
    --------------------------------------------------------------------------------
    
    
  2. Activating the SMU package file.


    Note


    You use TFTP to add the SMU package file (in the previous step) and flash , to activate - not TFTP.
    Device# install activate file flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    
    install_activate: START Mon Jun 22 11:37:17 UTC 2020
    
    Jun 22 11:37:37.582: %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install activate flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    Jun 22 11:37:37.582 %INSTALL-5-INSTALL_START_INFO: R0/0: install_engine: Started install activate flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    install_activate: Activating SMU
    
    025337: *Jun 22 2020 11:37:37 UTC: %INSTALL-5-INSTALL_START_INFO: Switch 1 R0/0: install_engine: Started install activate flash:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    This operation may require a reload of the system. Do you want to proceed? [y/n]n
    

    Checking the version, by using the show version command:

    Device# show version
    Cisco IOS XE Software, Version 16.09.04
    Cisco IOS Software [Fuji], Catalyst L3 Switch Software (CAT9K_LITE_IOSXE), Version 16.9.4, RELEASE SOFTWARE (fc2)
    Technical Support: http://www.cisco.com/techsupport
    Copyright (c) 1986-2019 by Cisco Systems, Inc.
    Compiled Thu 22-Aug-19 17:30 by mcpre
    <output truncated>
    
    
  3. Committing the SMU package file.

    Device# install commit
    
    install_commit: START Mon Jun 22 11:38:48 UTC 2020
    SUCCESS: install_commit Mon Jun 22 11:38:52 UTC 2020
    Device#
    
    

    Verifying that the update package is now committed, and that it will be persistent across reloads:

    Device# show install summary
    
    Active Packages:
    tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    Inactive Packages:
    No packages
    Committed Packages:
    tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
    Uncommitted Packages:
    No packages
    Device#
    
    

Example: Managing a SMU Package (Additional show commands, Rollback, Deactivation)

The following sample output displays information about active, inactive, committed, and uncommitted packages by using the show install summary command. Here SMU package file cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin is active and committed:

Device# show install summary

Active Packages:
    tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
Inactive Packages:
   No packages
Committed Packages:
    tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
Uncommitted Packages:
   No packages
Device#

The following is sample output from the show install active command:

Device# show install active

Active Packages:
tftp:cat3k-universalk9.2017-01-10_13.15.1.CSCxxx.SSA.dmp.bin

The following example shows how to rollback an update package to the committed package:

Device# install rollback to base

install_rollback: START Wed Jun 10 11:27:41 IST 2020
This rollback would require a reload. Do you want to proceed? [y/n]y
2 install_rollback: Reloading the box to take effect

Initializing Hardware ...
<after reload>
Device#

The following is sample output from the show install summary command:

Device# show install summary

Active Packages:
tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
Inactive Packages:
No packages
Committed Packages:
tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
Uncommitted Packages:
No packages
Device#

The following is sample output from the show install log command:


Device# show install log

[0|install_op_boot]: START Wed Jun 10 19:31:50 Universal 2020
[0|install_op_boot]: END SUCCESS Wed Jun 10 19:31:56 Universal 2020

The following example shows how to deactivate an SMU package file:

Device# install deactivate file tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
 
install_deactivate: START Wed Jun 10 10:49:07 IST 2020
The activation step would require a reload. Do you want to proceed? [y/n]y
Regular SMU. Reloading the box to complete activation of the SMU...

Initializing Hardware...
...
<after reload>
Device#

The following is sample output from the show install summary command:

Device# show install summary

Active Packages:
No packages
Inactive Packages:tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin
Committed Packages:
No packages
Uncommitted Packages:
No packages
Device#

The following example shows how to remove an SMU from the device:

Device# install remove file tftp:cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin

install_remove: START Wed Jun 10 12:09:43 IST 2020
SUCCESS: install_remove /tftp/cat9k_lite_iosxe.16.09.04.CSCvk70181.SPA.smu.bin Wed Jun 10 12:09:49 IST 2020
Device#

The following is sample output from the show install summary command:


Device# show install summary

Active Packages:
No packages
Inactive Packages:
No packages
Committed Packages:
No packages
Uncommitted Packages:
No packages

Additional References for Software Maintenance Upgrade

Related Documents

Related Topic Document Title

For complete syntax and usage information for the commands used in this chapter.

Command Reference (Catalyst 9200 Series Switches)

Feature History for Software Maintenance Upgrade

This table provides release and related information for features explained in this module.

These features are available on all releases subsequent to the one they were introduced in, unless noted otherwise.

Release

Feature

Feature Information

Cisco IOS XE Fuji 16.9.4

Software Maintenance Upgrade (SMU)

An SMU is a package that can be installed on a system to provide a fix or a security resolution to a released image.

On this platform, SMUs require a cold (complete) reload of the operating system; hot patching is not supported.

Use Cisco Feature Navigator to find information about platform and software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn.