Install additional RPMs and bug fixes

Updated: June 17, 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

	1.	Complete the install RPMs using command line interface task. For details, see install RPMs using command line interface.
	2.	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

	1.	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`
	2.	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. 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 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.
	3.	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.
	4.	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`
	5.	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.