C i s c o C o n f i d e n t i a l - B e t a R e v i e w R 3 . 7. 1
Software Package Management Commands on Cisco IOS XR Software
install activate
SMR-342
Cisco ASR 14000 Series Router System Management Command Reference
OL-17231-01
Defaults
Administration EXEC Mode
•
The package is activated for all supported nodes on all SDRs in the system.
•
The operation is performed in asynchronous mode: The
install
activate
command runs in the
background, and the EXEC prompt is returned as soon as possible.
EXEC Mode
•
The package is activated on all supported nodes for the SDR.
•
The operation is performed in asynchronous mode: The
install
activate
command runs in the
background, and the EXEC prompt is returned as soon as possible.
location
node-id
(Optional) Activates a package on the designated node. The
node-id
argument is expressed in
rack/slot/module
notation.
Note
A package cannot be activated on a single node unless some
version of the package being activated is already active on all
nodes. For example, a Multiprotocol Label Switching (MPLS)
package cannot be active on only one node. If a version of the
MPLS package is already active on all nodes, an MPLS package
then could be upgraded or downgraded on a single node.
Note
To activate a package on all supported nodes, do not specify a
location.
admin-profile
(Optional. Administration EXEC mode only.) Activates the package only
for the admin-plane nodes. Admin plane nodes provide system-wide
functionality and do not belong to a specific SDR. Examples of
admin-plane nodes are fabric cards and service processor modules (SPs).
The
admin-profile
keyword is used to update admin-plane resources
without impacting the routing nodes in any SDRs.
if-active
(Optional. Administration EXEC mode only) Activates an optional
package or SMU for an optional package only if a previous version of the
package is already active. Use the
if-active
keywords when SDRs have
different sets of active software packages.
asynchronous
(Optional) Performs the command in asynchronous mode. In
asynchronous mode, the command runs in the background, and the EXEC
prompt is returned as soon as possible. This is the default mode.
synchronous
(Optional) Performs the command in synchronous mode. This mode
allows the installation process to finish before the prompt is returned.
parallel-reload
(Optional) Forces all cards on the router to reload at the same time and
then come up with the new software, rather than proceeding according to
the option encoded in the install package.
prompt-level
{
default
|
none
}
(Optional) Specifies when you are prompted for input during the
procedure.
•
default
—You are prompted only when input is required by the
operation.
•
none
—You are never prompted.
test
(Optional) Verifies the effects of proposed operations without making
changes to the Cisco IOS XR software.