Install a Cisco IOS XR software image or SMU package from /harddisk:/ by using the install source command.
Use install source for the Installing Software image from harddisk workflow. Use this method when you want fewer commands and do not need control over the timing of the reload or restart. This method automatically applies changes, including reload or restart actions as required, without changing the entire image.
If you install SMUs individually, repeat this procedure for each SMU. Each individually installed SMU is treated as a separate transaction.
Before you begin
-
Obtain the required software image or SMU package for the device platform and Cisco IOS XR release.
-
Obtain the expected checksum for the software image or SMU package.
-
Ensure that the device is reachable from the server that stores the software image or SMU package.
-
Schedule a maintenance window if the installation requires a reload or process restart.
Procedure
|
1. |
Copy the software image or SMU package to the device harddisk and verify the checksum of the copied file.
Example:
server$ scp <smu-package>.tgz <username>@<device-ip>:/harddisk:/
[node0_RP0_CPU0:/harddisk:]$ md5sum <smu-package>.tgz
Confirm that the checksum matches the expected checksum before installing the file.
Example from the OAS guide:
server$ scp ncs1010-x86_64-25.1.1-CSCwp05477-swtools-2025-10-08-2334.tgz <username>@<device-ip>:/harddisk:/
[node0_RP0_CPU0:/harddisk:]$ md5sum ncs1010-x86_64-25.1.1-CSCwp05477-swtools-2025-10-08-2334.tgz
4e156140f4481452599c44afbdadd13d ncs1010-x86_64-25.1.1-CSCwp05477-swtools-2025-10-08-2334.tgz
|
|
2. |
Install the software image or SMU package from /harddisk:/.
Example:
RP/0/RP0/CPU0:router#install source /harddisk:/<smu-package>.tgz
Example from the OAS guide:
RP/0/RP0/CPU0:router#install source /harddisk:/ncs1010-x86_64-25.1.1-CSCwp05477-swtools-2025-10-08-2334.tgz
|
|
3. |
Wait for the install request state to change to Success, and then commit the installed SMU.
Example:
RP/0/RP0/CPU0:router#show install request
RP/0/RP0/CPU0:router#install commit
If the request shows Current activity: Await user input and install commit is available, run install commit.
Example from the OAS guide:
RP/0/RP0/CPU0:router#show install request
Mon Oct 13 07:40:19.516 UTC
User request: install source /harddisk:/ncs1010-x86_64-25.1.1-CSCwp05477-swtools-2025-10-08-2334.tgz
Operation ID: 26.1
State: Success since 2025-10-13 07:38:28 UTC
Current activity: Await user input
Time started: 2025-10-13 07:38:28 UTC
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
install commit
install replace reimage
RP/0/RP0/CPU0:router#install commit
|
|
4. |
Repeat the copy, checksum, install, status, and commit actions for each SMU that must be installed individually.
Each individually installed SMU is treated as a separate transaction.
|