To install Software Maintenance Upgrade (SMU) packages, use the install command in privileged EXEC mode.
install {activate | | file {bootflash: | flash: | webui:} [prompt-level {all | none}] | add file {bootflash: | flash: | ftp: | http: | https: | rcp: | scp: | tftp: | webui:} [activate [prompt-level {all | none}]] | | commit | | deactivate file {bootflash: | flash: | webui:} [prompt-level {all | none}] | | remove {file {bootflash: | flash: | ftp: | http: | https: | rcp: | scp: | tftp: | webui:} | inactive } | | rollback to {base | committed | id {install-ID }}}
Syntax Description
activate
|
Validates whether the SMU is added through the install add command, and restarts the Netconf processes.
This keyword runs a compatibility check, updates package status, and if the package can be restarted, it triggers post-install
scripts to restart the necessary processes, or triggers a reload for non-restartable packages.
|
file
|
Specifies the package to be activated.
|
{bootflash: | flash: | http: | https: | rcp: | scp: | tftp:webui:}
|
Specifies the location of the installed package.
|
prompt-level {all | none}
|
(Optional) Prompts the user about installation activities.
For example, the activate keyword, automatically triggers a reload for packages that require a reload. Before activating the packag, a message will
prompt users as to whether they want to continue.
The all keyword allows you to enable prompts. The none keyword diables prompts.
|
add
|
Copies files from a remote location (via FTP, TFTP) to a device and performs Software Maintenance Upgrade (SMU) compatibility
check for the platform and image versions.
This keyword runs base compatibility checks to ensure that a specified package is supported on a platform. It also adds an
entry in the package file, so that the status can be monitored and maintained.
|
{http: | https: | rcp: | scp: | tftp:} |
Specifies the package to be added.
|
commit
|
Makes SMU changes persistent over reloads.
You can do a commit after activating a package, 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.
|
deactivate
|
Deactivates an installed package.
Deactivating a package also updates the package status and triggers a process restart or a reload.
|
remove |
Remove installed packages.
The package file is removed from the file system. The remove keyword can only be used on packages that are currently inactive.
|
inactive |
Removes all inactive packages from the device.
|
rollback |
Rollbacks the SMU package to the base version, the last committed version, or a known commit ID, and restarts Netconf processes.
|
to
base |
Returns to the base image.
|
committed |
Returns to the installation state when the last commit operation was performed.
|
id install-ID |
Returns to the specific install point ID.
Valid values are from 1 to 4294967295.
|
Command Default
Packages are not installed.
Command Modes
Privileged EXEC (#)
Command History
Release |
Modification |
Cisco IOS XE Everest 16.5.1
|
This command was introduced.
|
Usage Guidelines
An SMU is a package that can be installed on a system to provide a patch fix or security resolution to a released image. This
package contain a minimal set of files for patching the release along with some metadata that describes the contents of the
package.
Packages msut be added prior to activating the SMU.
A package must be deactivated, before it is removed from the bootflash. A removed packaged must be added again.
Examples
The following example shows how to add an install package on a device:
Device# install add file tftp://172.16.0.1//tftpboot/folder1/
isr4300-universalk9.16.05.01.CSCxxxxxxx.dmp.bin
install_add: START Sun Feb 26 05:57:04 UTC 2017
Downloading file
tftp://172.16.0.1//tftpboot/folder1/isr4300-universalk9.16.05.01.CSCxxxxxxx.dmp.bin
Finished downloading file
tftp://172.16.0.1//tftpboot/folder1/isr4300-universalk9.16.05.01.CSCxxxxxxx.dmp.bin
to bootflash:isr4300-universalk9.16.05.01.CSCxxxxxxx.dmp.bin
SUCCESS: install_add /bootflash/isr4300-universalk9.16.05.01.CSCxxxxxxx.dmp.bin
Sun Feb 26 05:57:22 UTC 2017
Device#
The following example shows how to activate an install package:
Device# install activate file bootflash:isr4300-universalk9.16.05.01.CSCxxxxxxx.dmp.bin
install_activate: START Sun Feb 26 05:58:41 UTC 2017
DMP package.
Netconf processes stopped
SUCCESS: install_activate /bootflash/isr4300-universalk9.16.05.01.CSCxxxxxxx.dmp.bin
Sun Feb 26 05:58:58 UTC 2017*Feb 26 05:58:47.655: %DMI-4-CONTROL_SOCKET_CLOSED:
SIP0: nesd: Confd control socket closed Lost connection to ConfD (45): EOF on socket to ConfD.
*Feb 26 05:58:47.661: %DMI-4-SUB_READ_FAIL: SIP0: vtyserverutild:
Confd subscription socket read failed Lost connection to ConfD (45):
EOF on socket to ConfD.
*Feb 26 05:58:47.667: %DMI-4-CONTROL_SOCKET_CLOSED: SIP0: syncfd:
Confd control socket closed Lost connection to ConfD (45): EOF on socket to ConfD.
*Feb 26 05:59:43.269: %DMI-5-SYNC_START: SIP0: syncfd:
External change to running configuration detected.
The running configuration will be synchronized to the NETCONF running data store.
*Feb 26 05:59:44.624: %DMI-5-SYNC_COMPLETE: SIP0: syncfd:
The running configuration has been synchronized to the NETCONF running data store.
Device#
The following example shows how to commit an installed package:
Device# install commit
install_commit: START Sun Feb 26 06:46:48 UTC 2017
SUCCESS: install_commit Sun Feb 26 06:46:52 UTC 2017
The following example shows how to rollback to the base SMU package:
Device# install rollback to base
install_rollback: START Sun Feb 26 06:50:29 UTC 2017
7 install_rollback: Restarting impacted processes to take effect
7 install_rollback: restarting confd
*Feb 26 06:50:34.957: %DMI-4-CONTROL_SOCKET_CLOSED: SIP0: syncfd:
Confd control socket closed Lost connection to ConfD (45): EOF on socket to ConfD.
*Feb 26 06:50:34.962: %DMI-4-CONTROL_SOCKET_CLOSED: SIP0: nesd:
Confd control socket closed Lost connection to ConfD (45): EOF on socket to ConfD.
*Feb 26 06:50:34.963: %DMI-4-SUB_READ_FAIL: SIP0: vtyserverutild:
Confd subscription socket read failed Lost connection to ConfD (45):
EOF on socket to ConfD.Netconf processes stopped
7 install_rollback: DMP activate complete
SUCCESS: install_rollback Sun Feb 26 06:50:41 UTC 2017
*Feb 26 06:51:28.901: %DMI-5-SYNC_START: SIP0: syncfd:
External change to running configuration detected.
The running configuration will be synchronized to the NETCONF running data store.
*Feb 26 06:51:30.339: %DMI-5-SYNC_COMPLETE: SIP0: syncfd:
The running configuration has been synchronized to the NETCONF running data store.