install activate
To add software functionality to the active software set, use the install activate command in EXEC or System Admin EXEC mode or XR EXEC mode.
EXEC Mode:
install activate {device:package | id add-id} [auto-abort-timer time] [location node-id] [asynchronous | synchronous] [parallel-reload] [prompt-level {default | none}] [test] [pause sw-change]
Administration EXEC Mode:
install activate {package | id add-id}
Syntax Description
package |
Enter the package name(s) separated by space. Example: ncs6k.iso ncs6k_upgrade.iso
|
||
id add-id |
Specifies the ID number of an install add operation. The command activates all packages that were added in the specified install add operation. The ID number of an install add operation is indicated in the syslog displayed during the operation and in the output of the show install log command. Up to 64 install add operations can be specified. |
Command Default
The install activate command can be executed without any keywords if the install prepare is already executed.
EXEC Mode- Package is activated on all supported nodes for the SDR.
- Operation is performed in asynchronous mode: The install activate command runs in the background, and the EXEC prompt is returned as soon as possible.
Command Modes
EXEC
System Admin EXEC mode
XR EXEC mode
Command History
Release |
Modification |
---|---|
Release 5.0.0 |
This command was introduced. |
Usage Guidelines
Use the install activate command to activate ISO images, software packages or SMUs for all valid cards. Information within the package is used to verify compatibility with the target cards and with the other active software. Actual activation is performed only after the package compatibility and application program interface (API) compatibility checks have passed.
Specifying Packages to Activate
You can either use the id add-id keyword and argument to activate all packages that were added in one or more specific install add operations, or specify packages by name. The operation ID of an install add operation is indicated in the syslog displayed during the operation and in the output of the show install log command. If you specify packages according to operation ID, all the packages that were added by the specified operation must still be on the router.
Note |
Activating a Software Maintenance Update (SMU) does not cause any earlier SMUs, or the package to which the SMU applies, to be automatically deactivated. |
Activating a Package for a Specific SDR
- To activate a package for a specific SDR from administration EXEC mode, use the install activate command with the sdr sdr-name keyword and argument.
- To activate a package when logged into an SDR, use the install activate command in EXEC mode.
Note |
Some packages do not support SDR-specific activation and can only be activated for all SDRs simultaneously from administration EXEC mode. For detailed instructions, see the Managing Cisco IOS XR Software Packages module of System Management Configuration Guide for Cisco NCS 6000 Series Routers. |
Examples
In this example, an SMU file, ncs6k-sysadmin-5.0.0.40I.CSCui84128-0.0.9.i.smu, is activated to the active software set.
sysadmin-vm:0_RP0# install activate ncs6k-sysadmin-5.0.0.40I.CSCui84128-0.0.9.i.smu
result Wed Sep 18 05:35:06 2013 Install operation 8 (install activate) started by user 'root' will continue asynchronously.
sysadmin-vm:0_RP0# 0/3:Sep 18 00:35:09.189 : pm[1736]: %INFRA-Process_Manager-3-PROCESS_RESTART : Process slice_manager restarted
LC/0/3/CPU0:Sep 18 00:37:39.942 : npu_driver[122]: %PLATFORM-NPU-3-SW_ERROR : Slice Manager disconnect notification received, Success
sysadmin-vm:0_RP0# Wed Sep 18 05:36:10 2013 Install operation 8 completed successfully.
sysadmin-vm:0_RP0# 0/RP0:Sep 18 00:36:10.075 : inst_mgr[3768]: %INFRA-INSTMGR-6-OPERATION_SUCCESS : Install operation 8 completed successfully
sysadmin-vm:0_RP0# install commit