System Setup and Software Installation Guide for Cisco NCS 1010, IOS XR Releases

PDF

System Setup and Software Installation Guide for Cisco NCS 1010, IOS XR Releases

Install additional RPMs and bug fixes

Updated: September 11, 2026

Want to summarize with AI?

Use this procedure to install additional RPMs and bug fixes. It supports IOS XR software maintenance by outlining the required actions, inputs, or verification points for the activity.

Use this task to install additional RPMs and bug fixes.

You can install individual optional packages when new features are added or software problems are fixed.

Before you begin

When you upgrade the Cisco IOS XR software, you can also install or remove optional feature packages (RPMs or bug fixes) before applying the changes in the NCS 1010. You can perform this operation while an atomic change is already in progress. However, all packaging operations before this command are discarded.

You can install the packages from a remote repository or copy the files to the NCS 1010. If you are using a remote repository, ensure you have created and configured an external repository to store the packages.

Download the specific additional RPMs and latest bug fix RPMs as tarballs to the repository. If the bug fix has dependencies, we recommend that you create a bug fix tarball that contains all dependencies.The README file in the tarball provides relevant information about the bug fix and identifies any dependencies – for example, whether other bug fix RPMs may be required for a complete fix.

Follow these steps to install additional RPMs and bug fixes.

Procedure

Complete the install RPMs using command line interface task.

For details, see install RPMs using command line interface.
Complete the install RPMs using YANG data model task.

For details, see install RPMs using YANG data model.

Install RPMs using command line interface

Use this task to install RPMs using command line interface.

Optional RPMs and bug fixes are available as TAR files on the

Software Download

page. Starting with Cisco IOS XR Release 24.3.1, you are no longer required to manually extract the RPMs from the TAR file; you can install the bug fix RPM directly from the TAR file.

Before you begin

Follow these steps to install RPMs using command line interface.

Procedure

Check the available packages in the repository.

Example:

RP/0/RP0/CPU0:ios#show install available

Trying to access repositories...
Package        Architecture        Version            Repository
xr-8000-core    x86_64             7.8.1              remote-repo
xr-core         x86_64             7.8.1              remote-repo

Install the packages (additional RPMs or bug fixes).
Example:
```
RP/0/RP0/CPU0:ios#install source full-path-to-rpm [all]
          
```
```
RP/0/RP0/CPU0:ios#install source full-path-to-rpm all sync
          
```
```
RP/0/RP0/CPU0:ios#install source http://203.0.113.1;vrf1/repoinfra/install_RPMs.tar
          
```
```
RP/0/RP0/CPU0:ios#install package add <pkg1>
              <pkg2>
              <pkgn>
            
          
```
```
RP/0/RP0/CPU0:ios#install package upgrade <pkg1>
              <pkg2>
              <pkgn>
            
          
```
```
RP/0/RP0/CPU0:ios#install apply [reload | restart]
          
```
```
RP/0/RP0/CPU0:ios#show install history last transaction verbose
2023-01-25 05:45:37 UTC    Transaction 87 started
2023-01-25 05:45:37 UTC      Atomic change 87.1 started
2023-01-25 05:45:37 UTC      Packaging operation 87.1.1 started
2023-01-25 05:45:37 UTC    Transaction 87 complete

Least impactful apply method: process restart
          
```
- Option 1: Install RPMs without control over reload operation.
  Note
  
  This option is not applicable when you downgrade or remove RPMs.
  
  You can either specify a tarfile (with bug fixes or optional packages), or a repository containing the RPMs. Use this command:
  
  Specify the all keyword if you want to install optional packages. Exclude the all keyword if you want to upgrade the packages that are currently installed on the system.
  The full-path-to-rpm can be one of the following locations based on where you have saved the files.
  - Local path—files located in or under /var/xr/disk1/, /harddisk:/ or /misc/disk1/
  - Remote repository or tar file—ftp://<server>[;<named-vrf>]/<remote_path>, https://<server>[;<named-vrf>]/<remote_path> or http://<server>[;<named-vrf>]/<remote_path>
    
    If you want to add new packages from this source, you must use the all keyword:
    
    Note
    
    If the remote repository is reachable through a named VRF, you must mention the named VRF in the above commands. For example,
    
    where vrf1 is the named VRF through which the remote repository is accessible.
  The operation adds the RPMs and applies the change via reload or restart operation, whichever is least impactful based on the update.
- Option 2: Install RPMs with control over reload operation.
  Note
  
  This option is applicable when you downgrade, remove or rollback RPMs.
  1. Install RPMs by providing the RPM name, Cisco bug fix ID (example, CSCab12345) or add packages from a specified source. Use the install package add command if you want to add new optional packages, else use the install package upgrade command.
    
    Or
  2. Apply the changes.
    
    You can use the reload or restart options based on the change that is installed. To determine whether a reload or restart is required, check the output of show install request or show install history last transaction verbose command. The output indicates the required actions.

Check the status of the install operation.

Example:

RP/0/RP0/CPU0:ios#show install request
User request: No user requests found
State:        Success
Current activity:    No install operation in progress

The following actions are available:

    install package add
    install package remove
    install package upgrade
    install package downgrade
    install package replace
    install package rollback
    install replace
    install rollback
    install source

Note

Include the keyword
noprompt
in the commands to enable the system to bypass your permission to reload the NCS 1010.

Verify the image and packages are activated successfully.

Example:

RP/0/RP0/CPU0:ios# show install request
User request: install package add xr-mcast
Operation ID: 87.1.1
State: Success

Commit the transaction.
Example:
```
RP/0/RP0/CPU0:ios#install commit
          
```
Note

The install commit command must be executed immediately after software upgrades or SMU installations and before applying any new configuration changes or powering off the device to prevent loss of changes upon reboot.

Install RPMs using YANG data model

Use this task to install RPMs using YANG data model.

Use

Cisco-IOS-XR-install-augmented-act.yang

data model to install the RPMs or bug fixes.

Before you begin

Follow these steps to install RPMs using YANG data model.

Procedure

Invoke the install-package-replace RPC on the data model.

Example:


<install-package-replace>
  <source-type>remote</source-type>
  <source>remote-repo</source>
  <file>rpm-file-name</file>
</install-package-replace>


<install-package-upgrade xmlns=http://cisco.com/ns/yang/Cisco-IOS-XR-install-augmented-act>
  <source-type>ftp</source-type>
  <source>203.0.113.1;vrf1/repoinfra/install_RPMs.tar</source>
</install-package-upgrade>

If the install operation lists the repository reachable through a VRF, you must add the VRF name for the operation to be successful.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.