- Table of Contents
-
- 01-Fundamentals Configuration Guide
- 00-Preface
- 01-CLI configuration
- 02-FTP and TFTP configuration
- 03-Target configuration management configuration
- 04-RBAC configuration
- 05-File system management configuration
- 06-Login management configuration
- 07-Automatic configuration
- 08-Software upgrade configuration
- 09-Configuration file management configuration
- 10-ISSU configuration
- Related Documents
-
Title | Size | Download |
---|---|---|
10-ISSU configuration | 342.81 KB |
Restrictions and guidelines: ISSU
Logging in to the device through the console port
Identifying availability of ISSU and licensing requirements
Verifying the device operating status
Determining the upgrade procedure
Adjusting and saving the running configuration
Performing an ISSU in one step
Performing an ISSU step by step by using issu commands
Performing a compatible upgrade on a dual-MPU device
Performing an incompatible upgrade on a dual-MPU device
Performing an incremental upgrade on a single-MPU device
Performing a reboot, ISSU reboot, or incompatible upgrade on a single-MPU device
Performing an ISSU by using install commands
Installing and upgrading software images
Rolling back the running software images
Aborting a software activate or deactivate operation
Deleting inactive software images
Verifying and maintaining ISSU
Displaying software image information
Displaying the recommended ISSU methods
Displaying ISSU operation information
Displaying and clearing rollback points
Displaying and clearing ISSU log entries
Examples of using issu commands for ISSU
Example: Upgrading the system software to a compatible version
Example: Upgrading the system software to an incompatible version
Example: Rolling back the system software
Examples of using install commands for ISSU
Example: Upgrading the system software
Example: Rolling back a feature
Performing an ISSU
About ISSU
The In-Service Software Upgrade (ISSU) feature upgrades the Comware software with a minimum amount of downtime.
Unless otherwise stated, the term "upgrade" refers to both software upgrade and downgrade in ISSU.
ISSU advantages
The Comware software includes the boot image, the system image, and feature images. ISSU supports upgrading the images individually.
When you use ISSU to upgrade a feature, only the related feature images are affected. Other features can continue to provide services.
ISSU supports installing patch images to fix system bugs without a system reboot.
ISSU methods
ISSU methods are determined at software release depending on the compatibility between software versions.
ISSU supports the following upgrade types:
· Compatible upgrade—The new software version is compatible with the running software version. This upgrade type supports the ISSU methods in Table 1.
· Incompatible upgrade—The new software version is incompatible with the running software version. The two versions cannot run concurrently.
This upgrade type supports only one upgrade method (also called incompatible upgrade). This method requires a cold reboot to upgrade both control and data planes. Incompatible upgrade disrupts service if hardware redundancy is not available.
For information about identifying the ISSU method, see "Identifying the ISSU methods."
Table 1 ISSU methods for compatible upgrade
ISSU method |
Description |
Incremental upgrade: · Service Upgrade · File Upgrade |
Upgrades only user mode processes that have differences between the new and old software versions. Backup processes and a main/backup process switchover are required for service continuity. · Service upgrade—Upgrades service features. The upgrade does not affect the operation of the features that are not being upgraded. · File upgrade—Upgrades hidden system program files. The system can provide services during the upgrade. |
Reboot |
The Reboot method disrupts service if hardware redundancy is not available. As a best practice, schedule the downtime carefully to minimize the upgrade impact on the services. Reboots MPUs to complete the software upgrade. While one MPU is rebooting, the other MPU can provide services. Reboots MPUs to complete the software upgrade. While one MPU is rebooting, the other MPUs can provide services. |
ISSU commands
ISSU includes the install and issu command sets. After you identify the recommended ISSU method, use Table 2 to choose the command set you want to use.
You can use the issu one-step command to perform an ISSU in one step, or use other ISSU commands to perform an ISSU step by step.
· During a one-step ISSU, you cannot perform a rollback.
· During a multi-step ISSU, you can display the device status, abort the ISSU, or perform a rollback.
Table 2 Command set comparison
Item |
issu commands |
install commands |
Compatibility between the old version and the new version |
· Compatible. · Incompatible. |
Compatible. |
Impact on the system |
Large. |
Small. |
Technical skill requirements |
Low. As a best practice, use this command set. |
High. Administrators must have extensive system knowledge and understand the impact of each upgrade task on the network. |
Incremental upgrade |
Supported. |
Supported. |
Reboot upgrade |
Supported. |
Supported. |
Incompatible upgrade |
Supported. |
Not supported. |
One-step ISSU |
Supported. |
Not supported. |
Step-by-step ISSU |
Supported. |
Supported. |
Operating mechanism
Performing an incremental upgrade on a single-MPU device
As shown in Figure 1, the upgrade operates as follows:
1. The device is in Init state before the upgrade and enters Loading state when the issu load command is executed to upgrade the MPU. When the MPU upgrade completes, the device enters Loaded state.
2. The device enters Accepted state when the issu accept command is executed successfully to accept the upgrade to a compatible version and delete the automatic rollback timer.
3. The device enters Committing state when the issu commit command is executed to upgrade the LPUs, and it enters Init state when the LPU upgrade completes.
IMPORTANT: If a rollback is performed during the upgrade process, the system will roll back to the version before the upgrade. |
Performing a reboot, ISSU reboot, or incompatible upgrade on a single-MPU device
As shown in Figure 2, the device is in Init state before the upgrade and enters Loading state when the issu load command is executed to upgrade the MPU and LPUs. When the upgrade completes, the device enters Init state.
Performing an upgrade on a dual-MPU device (distributed devices in standalone mode) or a dual-MPU single-chassis IRF fabric (distributed devices in IRF mode)
As shown in Figure 3, the upgrade operates as follows:
1. The device is in Init state before the upgrade and enters Loading state when the issu load command is executed to upgrade the standby MPU. When the upgrade completes, the device enters Loaded state.
2. The device enters Switching state when the issu run switchover command is executed to perform an ISSU switchover. When the switchover completes, the device enters Switchover state.
3. The device enters Accepted state when the issu accept command is executed successfully to accept the upgrade to a compatible version and delete the automatic rollback timer.
4. The device enters Committing state when the issu commit command is executed to upgrade the original active MPU, and it enters Init state when the upgrade completes.
IMPORTANT: If a rollback is performed during the upgrade process, the system will roll back to the version before the upgrade. |
Figure 3 Performing an upgrade on a dual-MPU device or a dual-MPU single-chassis IRF fabric
Performing an incompatible upgrade on a dual-MPU device (distributed devices in standalone mode) or a dual-MPU single-chassis IRF fabric (distributed devices in IRF mode)
As shown in Figure 4, the upgrade operates as follows:
1. The device is in Init state before the upgrade and enters Loading state when the issu load command is executed to upgrade the standby MPU. When the upgrade completes, the device enters Loaded state.
2. The device enters Switching state when the issu run switchover command is executed to perform an ISSU switchover. All the other cards will be upgraded. When the switchover completes, the device enters Init state.
IMPORTANT: If a rollback is performed during the upgrade process, the system will roll back to the version before the upgrade. |
Application scenarios
Traditional software upgrade methods require a device reboot, which will affect the services running on the system and communication service quality. To address this issue, you can use ISSU to upgrade the software to ensure uninterrupted services or a short service interruption period during the upgrade process.
Restrictions and guidelines: ISSU
IMPORTANT: · For a successful ISSU, you must remove all commands that the new version does not support and save the running configuration. To identify the feature changes between the current version and the new version, read the release notes for the device. · To ensure correct system operation, you must remove the commands configured for features to be uninstalled and save the running configuration before uninstalling the features. |
During an ISSU, follow these restrictions and guidelines:
· Do not execute the install, issu, or boot-loader command before the current upgrade action completes.
· Do not perform any of the following tasks:
¡ Reboot, add, or remove cards.
¡ Perform tasks that are irrelevant to the ISSU, such as modifying the configuration and displaying information.
¡ Modify, delete, or rename image files.
· You cannot use both install and issu commands for the same ISSU.
· For better service continuity, strictly follow the recommended ISSU procedure unless you are performing an ISSU in one step. Make sure a step is completed before you proceed to the next step.
· Before executing the issu load command for the first time, use the display system stable state command to verify that the system is stable. If the System State field displays Stable, the system is stable.
· Before executing the following commands, use the display system stable state command to verify that the system is stable:
¡ issu commands—issu one-step, issu load, issu run switchover, and issu commit.
¡ install commands—install activate and install deactivate.
If the System State field displays Stable, the system is stable.
· You may use issu commands to upgrade all or some of the software images. If you are upgrading only some of the images, make sure the new images are compatible with the images that are not to be upgraded. The upgrade will fail if a conflict exists.
· You can install up to 32 .bin files on the device, including one boot image file, one system image file, and up to 30 feature and patch image files.
· A patch image file can be incremental or non-incremental. You can install up to 30 incremental patch image files by using a single command. Because each boot, system, or feature image can have one non-incremental patch image file, you can install up to 16 non-incremental patch image files by using a single command. For more information about incremental and non-incremental patch image files, see "Upgrading software."
After an ISSU, you must log in to the device again before you can use the changed or added commands.
After an ISSU, use the display boot-loader command to verify that the new software images have been successfully loaded. The startup software images must always be in the flash memory and cannot be deleted. If you delete them, the device cannot restart after being rebooted.
Prerequisites for ISSU
To perform a successful ISSU, make sure all the preparation requirements are met.
Logging in to the device through the console port
Log in to the device through the console port. If you use Telnet or SSH, you might be disconnected from the device before the ISSU is completed.
In a multiuser environment, make sure no other administrators access the device while you are performing the ISSU.
Identifying availability of ISSU and licensing requirements
Read the software release notes to identify the following items:
· Support of the device for ISSU between the current software version and the new software version.
· Licensing requirements for the upgrade software images. If the upgrade software images require licenses, make sure the device has the required licenses. For more information about license installation, see "Managing licenses."
Verifying the device operating status
Verify the following items:
Use the display device command to verify that all components are operating correctly.
· Use the display cpu-usage command to verify that no CPU usage alarm exists on the device. As a best practice, verify that the CPU usage is lower than the CPU usage recovery threshold on each component.
· Use the display memory and display memory-threshold commands to verify that no memory alarm exists on the device. As a best practice, verify that the free memory is greater than the normal state threshold on each component.
· Use the display fan command to verify that all fans are in Normal state.
· Use the display power command to verify that all power supplies are in Normal state.
· Use the display environment command to verify that the temperature of each component is lower than the high-temperature warning threshold.
· Use the display counters rate inbound interface command to verify that all interfaces are forwarding packets correctly.
· Use the display interface | include CRC command to verify that all interfaces are forwarding packets correctly.
Preparing the upgrade images
1. Use the dir command to verify that every file system has sufficient free storage space for the upgrade images. If the storage space is not sufficient, delete unused files by using the delete /unreserved file-url command. If the files to be deleted will be used, back up the files before deleting them. You will be unable to restore a deleted file if the /unreserved keyword is used. For more information, see "Managing file systems."
2. Use FTP or TFTP to transfer upgrade image files (in .bin or .ipe) to the root directory of a file system on the active MPU.
Identifying the ISSU methods
1. Execute the display version comp-matrix file command to identify the recommended ISSU methods.
¡ For a compatible upgrade, check the Upgrade Way field to identify the recommended ISSU methods.
¡ For an incompatible upgrade, check the end of command output for the Incompatible upgrade string.
For more information about ISSU methods, see Table 1.
Verifying feature status
For service continuity during an ISSU, configure the following feature settings:
Feature |
Setting requirements |
GR and NSR |
Enable GR or NSR for protocols including LDP, RSVP, OSPF, ISIS, BGP, and FSPF. |
BFD |
Disable BFD for protocols including LDP, RSVP, OSPF, ISIS, RIP, BGP, VRRP, and NQA. |
Ethernet link aggregation |
Use the long LACP timeout interval (the lacp period short command is not configured) on all member ports in dynamic aggregation groups. Make sure all member ports are Selected ports. |
Determining the upgrade procedure
1. Use Table 2 to choose an upgrade command set, depending on the ISSU method.
2. Identify the hardware redundancy condition.
ISSU can maintain service continuity only when the following conditions are met:
¡ The device has two MPUs that are operating correctly.
IMPORTANT: If hardware redundancy is not available, service discontinuity is not avoidable during a reboot upgrade or an incompatible upgrade. Make sure you understand the impact of the upgrade on the network. |
3. Perform one of the following tasks:
¡ Choose one-step ISSU to start and finish an ISSU by using a single command, as described in "Performing an ISSU in one step."
¡ Choose the correct procedure from the procedures described in "Performing an ISSU step by step by using issu commands" or "Performing an ISSU by using install commands."
Adjusting and saving the running configuration
1. Remove all commands that the new software version does not support from the running configuration. To identify all feature changes between the current version and the new version, read the release notes for the device.
2. To uninstall a feature image, remove the commands configured for the feature.
3. Use the save command to save the running configuration.
Performing an ISSU in one step
Restrictions and guidelines
During a one-step upgrade, you cannot perform a rollback or any other tasks.
If the device has two MPUs, make sure both the current software version and the new software version support one-step ISSU. Specify the slot number of the standby MPU for the command.
Procedure
To perform an ISSU in one step, execute one of the following commands in user view:
· Use .bin files:
issu one-step file { boot filename | system filename | feature filename&<1-30> } * [ slot slot-number ] [ reboot ]
· Use an .ipe file:
issu one-step file ipe ipe-filename [ slot slot-number ] [ reboot ]
Performing an ISSU step by step by using issu commands
Performing a compatible upgrade on a dual-MPU device
1. (Optional.) Configure automatic rollback:
a. Enter system view.
system-view
b. Set the automatic rollback timer.
issu rollback-timer minutes
By default, the automatic rollback timer is set to 45 minutes.
The automatic rollback timer starts when you execute the issu run switchover command.
c. Return to user view.
quit
2. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step.
3. Load the MPU software images as main startup software images on the standby MPU.
¡ Use .bin files:
issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number [ reboot ]
¡ Use an .ipe file:
issu load file ipe ipe-filename slot slot-number [ reboot ]
|
NOTE: The software images for the device are digitally signed. The system verifies the digital signatures of the specified software images for authenticity and integrity before it sets or loads them as main startup images. If the digital signature verification fails, the system will not set or load the specified images as main startup images and you will receive a digital signature verification failure message. |
4. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step. If the system reported an error in the previous step, verify that the system is stable and then use the issu rollback command to roll back the upgrade.
5. Perform an ISSU switchover.
issu run switchover
This command also upgrades the security engines, It also starts the automatic rollback timer. When the timer expires, the system automatically rolls back to the original software images.
6. (Optional.) Accept the upgrade and delete the automatic rollback timer.
issu accept
Execute this command before the automatic rollback timer expires.
7. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step. If the system reported an error in the previous two steps, verify that the system is stable and then use the issu rollback command to roll back the upgrade.
8. Upgrade the original active MPU to complete the ISSU process.
issu commit slot slot-number
Execute this command before the automatic rollback timer expires.
CAUTION: When this command is completed, the ISSU status changes to Init and the ISSU process cannot be rolled back. |
9. Verify that the ISSU is finished.
display issu state
If the ISSU state field displays Init, the ISSU is finished.
Performing an incompatible upgrade on a dual-MPU device
To perform an incompatible upgrade on a dual-MPU device, execute the following commands in user view:
1. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step.
2. Load the MPU software images as main startup software images on the standby MPU to upgrade the standby MPU.
¡ Use .bin files:
issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number [ reboot ]
¡ Use an .ipe file:
issu load file ipe ipe-filename slot slot-number [ reboot ]
|
NOTE: The software images for the device are digitally signed. The system verifies the digital signatures of the specified software images for authenticity and integrity before it sets or loads them as main startup images. If the digital signature verification fails, the system will not set or load the specified images as main startup images and you will receive a digital signature verification failure message. |
3. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step. If the system reported an error in the previous step, verify that the system is stable and then use the issu rollback command to roll back the upgrade.
4. Perform an ISSU switchover to upgrade the remaining cards.
issu run switchover
5. Verify that the ISSU is finished.
display issu state
If the ISSU state field displays Init, the ISSU is finished.
Performing an incremental upgrade on a single-MPU device
To perform an incremental upgrade on a single-MPU device, execute the following commands in user view:
1. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step.
2. Load the MPU upgrade software images as main startup software images to upgrade the MPU.
¡ Use .bin files:
issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number [ reboot ]
¡ Use an .ipe file:
issu load file ipe ipe-filename slot slot-number [ reboot ]
|
NOTE: The software images for the device are digitally signed. The system verifies the digital signatures of the specified software images for authenticity and integrity before it sets or loads them as main startup images. If the digital signature verification fails, the system will not set or load the specified images as main startup images and you will receive a digital signature verification failure message. |
3. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step. If the system reported an error in the previous step, verify that the system is stable and then use the issu rollback command to roll back the upgrade.
4. Complete the ISSU process.
issu commit slot slot-number
CAUTION: When this command is completed, the ISSU status changes to Init and the ISSU process cannot be rolled back. |
5. Verify that the ISSU is finished.
display issu state
If the ISSU state field displays Init, the ISSU is finished.
Performing a reboot, ISSU reboot, or incompatible upgrade on a single-MPU device
Execute the following commands in user view:
1. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step.
2. Load the MPU upgrade software images as main startup software images to upgrade the MPU.
¡ Use .bin files:
issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number [ reboot ]
¡ Use an .ipe file:
issu load file ipe ipe-filename slot slot-number [ reboot ]
|
NOTE: The software images for the device are digitally signed. The system verifies the digital signatures of the specified software images for authenticity and integrity before it sets or loads them as main startup images. If the digital signature verification fails, the system will not set or load the specified images as main startup images and you will receive a digital signature verification failure message. |
3. Verify that the ISSU is finished.
display issu state
If the ISSU state field displays Init, the ISSU is finished.
Performing an ISSU by using install commands
ISSU tasks at a glance
1. (Optional.) Decompressing an .ipe file
2. Installing and upgrading software images
3. (Optional.) Deactivating software images
4. (Optional.) Rolling back the running software images
5. (Optional.) Aborting a software activate or deactivate operation
6. (Optional.) Verifying software images
7. Committing software changes
8. (Optional.) Deleting inactive software images
Decompressing an .ipe file
1. (Optional.) Identify images that are included in the .ipe file.
display install ipe-info
2. Decompress the .ipe file.
install add ipe-filename filesystem
Installing and upgrading software images
About this task
Use this task to install new feature and patch images or upgrade the boot, system, or feature images.
Software image installation and upgrade methods
Use one of the following methods to install or upgrade software images:
· Slot by slot—Activate all the images on one slot, and then move to the next slot.
· Image by image—Activate one image on all slots before moving to another image. Before using this method, read the release notes to make sure the upgrade images are compatible with the current images. If the upgrade images are not compatible with the current images, the upgrade might fail.
Restrictions and guidelines
· To install an image, you must begin with the active MPU.
· To upgrade an image, you must begin with the standby MPU.
Installing or upgrading boot, system, and feature images
To install or upgrade boot, system, or feature images, execute the following commands in user view:
1. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful ISSU, you must make sure the system is stable before you proceed to the next step.
2. (Optional.) Identify the recommended ISSU method and the possible impact of the upgrade.
install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number test
3. Activate images.
install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number
|
NOTE: The software images for the device are digitally signed. The system will verify the digital signatures of the specified software images for authenticity and integrity before it activates them. If the digital signature verification fails, the system will not activate the specified images and you will receive a digital signature verification failure message. |
Installing patch images
To install patch images, execute the following commands in user view:
1. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful installation, you must make sure the system is stable before you proceed to the next step.
2. Install patch images.
install activate patch filename { all | slot slot-number }
You can specify only one patch image file for this command at a time. However, you can execute this command multiple times to install multiple patch image files.
The install activate patch filename all command installs the specified patch images on all hardware and the images can survive a reboot. You do not need to execute the install commit command for the installation.
Deactivating software images
Restrictions and guidelines
You can deactivate only feature and patch images.
The deactivate operation only removes images from the current software image list. For the image changes to take effect after a reboot, you must perform a commit operation to remove the images from the main startup image list.
Deactivated images are still stored on the storage medium. To permanently delete the images, execute the install remove command. For more information, see "Deleting inactive software images."
Deactivating feature images
To deactivate feature images, execute the following commands in user view:
1. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful deactivate operation, you must make sure the system is stable before you proceed to the next step.
2. Deactivate feature images.
install deactivate feature filename&<1-30> slot slot-number
Deactivating patch images
To deactivate patch images, execute the following commands in user view:
1. Verify that the system is stable.
display system stable state
The system is stable if the System State field displays Stable. For a successful deactivate operation, you must make sure the system is stable before you proceed to the next step.
2. Deactivate patch images.
install deactivate patch filename { all | slot slot-number }
You can specify only one patch image file for this command at a time. However, you can execute this command multiple times to deactivate multiple patch image files.
The install deactivate patch filename all command deactivates the specified patch images on all hardware and the image changes can survive a reboot. You do not need to execute the install commit command for the deactivation.
Rolling back the running software images
About software image rollback
During an incremental upgrade, the system creates a rollback point for each activate or deactivate operation of a boot, system, or feature image. The system can maintain a maximum of 50 rollback points. If this limit has been reached when a rollback point is created, the system removes the earliest rollback point. You can roll back the software to any of the rollback points.
During a reboot or ISSU reboot upgrade, the system does not create rollback points. After an ISSU reboot or reboot upgrade, you can roll back the software only to the status before any activate or deactivate operations were performed.
Restrictions and guidelines
You can perform this task only before committing software changes. A commit operation deletes all rollback points.
For an incremental upgrade rollback to take effect after a reboot, you must perform a commit operation to update the main startup image list.
Procedure
To roll back the running software images, execute the following commands in user view:
1. (Optional.) Display available rollback points.
display install rollback
2. Roll back the software.
install rollback to original
Aborting a software activate or deactivate operation
About aborting a software activate or deactivate operation
While the system is activating or deactivating a software image for a service upgrade or file upgrade, you can abort the activate or deactivate operation. After an operation is aborted, the system runs with the software images that it was running with before the operation.
Procedure
To abort a software activate or deactivate operation, use one of the following methods:
· Execute the install abort command in user view.
· Press Ctrl+C.
Committing software changes
About committing software changes
When you activate or deactivate images for an incremental upgrade, or activate or deactivate patch images, the main startup image list does not update with the changes. The software changes are lost at reboot. For the changes to take effect after a reboot, you must commit the changes.
Procedure
To commit software changes, execute the following command in user view:
install commit
Verifying software images
About software image verification
Perform this task to verify the following items:
· Integrity—Verify that the boot, system, and feature images are integral.
· Consistency—Verify that the same active images are running across the entire system.
· Software commit status—Verify that the active images are committed as needed.
Procedure
To verify software images, execute the following commands in user view:
1. Verify software images.
install verify
2. Activate or deactivate images as required.
install { activate | deactivate }
3. Commit the software changes.
install commit
Deleting inactive software images
About deleting inactive software images
After completing an ISSU, you can use this task to delete old image files permanently.
Restrictions and guidelines
This task deletes image files permanently. You cannot use the install rollback to command to revert the operation, or use the install abort command to abort the operation.
Procedure
To delete inactive software image files, execute the following command in user view:
install remove [ slot slot-number ] { filename | inactive }
Verifying and maintaining ISSU
Unless otherwise stated, the display and reset commands can be used during an ISSU, regardless of whether the install or issu commands are used.
Displaying software image information
Perform display tasks in any view.
· Display active software images.
display install active [ slot slot-number ] [ verbose ]
· Display backup startup software images.
display install backup [ slot slot-number ] [ verbose ]
· Display main startup software images.
display install committed [ slot slot-number ] [ verbose ]
· Display inactive software images in the root directories of file systems.
display install inactive [ slot slot-number ] [ verbose ]
· Display the software image file that includes a specific component or file.
display install which { component name | file filename } [ slot slot-number ]
· Display the software images included in an .ipe file.
display install ipe-info ipe-filename
· Display software image file information.
display install package { filename | all } [ verbose ]
Displaying the recommended ISSU methods
To display the recommended ISSU methods, execute one of the following commands in any view:
display version comp-matrix file { boot filename | system filename | feature filename&<1-30> } *
display version comp-matrix file ipe ipe-filename
Displaying ISSU operation information
Perform display tasks in any view.
· Display ongoing ISSU activate, deactivate, and rollback operations.
display install job
· Display automatic rollback timer information.
display issu rollback-timer
· Display ISSU status information.
display issu state
This command applies only to an ISSU that uses issu commands.
Displaying and clearing rollback points
CAUTION: Use caution when you use the reset install rollback oldest command. This command clears the specified rollback point and all rollback points earlier than the specified rollback point. You will be unable to roll back the configuration to the status when any of these rollback points was created. |
To display rollback points, execute the following command in any view:
display install rollback
To clear ISSU rollback points, execute the following command in user view:
reset install rollback oldest point-id
Displaying and clearing ISSU log entries
To display ISSU log entries, execute the following command in any view:
display install log [ log-id ] [ verbose ]
To clear ISSU log entries, execute the following command in user view:
reset install log-history oldest log-number
Examples of using issu commands for ISSU
Example: Upgrading the system software to a compatible version
Network configuration
As shown in Figure 5, the device has one active MPU (slot 0) and one standby MPU (slot 1).
Upgrade the boot, system, and feature images from T0001015 to T0001016. The two versions are compatible.
Procedure
# Download the upgrade image files from the TFTP server.
<Sysname> tftp 2.2.2.2 get boot-t0001016.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 6078464 100 6078464 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
<Sysname> tftp 2.2.2.2 get system-t0001016.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 97750016 100 97750016 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
<Sysname> tftp 2.2.2.2 get feature-t0001016.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 1008640 100 1008640 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
# Display active software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
# Identify the recommended ISSU methods.
<Sysname> display version comp-matrix file boot flash:/boot-t0001016.bin system flash:/system-t0001016.bin feature flash:/feature-t0001016.bin
Verifying the file flash:/boot-t0001016.bin on slot 0.......................Done.
Verifying the file flash:/system-t0001016.bin on slot 0................. .................Done.
Verifying the file flash:/feature-t0001016.bin on slot 0.................Done.
Identifying the upgrade methods....Done.
Slot Upgrade Way
0 Reboot
1 Reboot
The output shows that reboot upgrades are recommended.
# Save the running configuration.
<Sysname> save
# Upgrade the system software on the standby MPU.
<Sysname> issu load file boot flash:/boot-t0001016 system flash:/system-t0001016.bin feature flash:/feature-t0001016.bin slot 1
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:y
Copying file flash:/boot-t0001016.bin to slot1#flash:/boot-t0001016.bin......Done.
Copying file flash:/system-t0001016.bin to slot1#flash:/system-t0001016.bin........................Done.
Copying file flash:/feature-t0001016.bin to slot1#flash:/feature-t0001016.bin......Done.
Verifying the file flash:/boot-t0001016.bin on slot 1...Done.
Verifying the file flash:/system-t0001016.bin on slot 1............Done.
Verifying the file flash:/feature-t0001016.bin on slot 1...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/boot-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/system-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
1 Reboot
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# Verify that the ISSU is in a stable state.
<Sysname> display issu state
ISSU state: Loaded
Compatibility: Compatible
Work state: Normal
Upgrade method: Card by card
Upgraded slot:
slot 1
Current upgrading slot: None
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
feature: 7.1.070, Test 0001016
Upgrade software images:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature-t0001016.bin
The Loaded state is a stable state, which indicates that the system is waiting for an active/standby switchover. Slot 1 has completed the upgrade, and slot 0 has not.
# Perform an active/standby switchover.
<Sysname> issu run switchover
Upgrade summary according to following table:
flash:/boot-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/system-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Switchover Way
0 Master subordinate switchover
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait.........
# Verify that the ISSU is in a stable state.
<Sysname> display issu state
ISSU state: Switchover
Compatibility: Compatible
Work state: Normal
Upgrade method: Card by card
Upgraded slot:
slot 1
Current upgrading slot: None
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
feature: 7.1.070, Test 0001016
Upgrade software images:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature-t0001016.bin
The Switchover state is a stable state, which indicates that the system has completed the active/standby switchover and is waiting for a commit operation to upgrade slot 0.
# Upgrade the system software on the original active MPU.
<Sysname> issu commit slot 0
Upgrade summary according to following table:
flash:/boot-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/system-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
0 Reboot
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
Verifying the upgrade
# Verify that the ISSU is finished.
<Sysname> display issu state
ISSU state: Init
Compatibility: Unknown
Work state: Normal
Upgrade method: Card by card
Upgraded slot: None
Current upgrading slot: None
Current version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
feature: 7.1.070, Test 0001016
Current software images:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature-t0001016.bin
The ISSU state field displays Init, which indicates that the ISSU is finished.
# Verify that both MPUs are running the new software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature-t0001016.bin
Active packages on slot 1:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature-t0001016.bin
Example: Upgrading the system software to an incompatible version
Network configuration
As shown in Figure 6, the device has one active MPU (slot 0) and one standby MPU (slot 1).
Upgrade the boot, system, and feature images from T0001015 to T0001017. The two versions are incompatible.
Procedure
# Download the upgrade image files from the TFTP server.
<Sysname> tftp 2.2.2.2 get boot-t0001017.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 6078464 100 6078464 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
<Sysname> tftp 2.2.2.2 get system-t0001017.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 97750016 100 97750016 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
<Sysname> tftp 2.2.2.2 get feature-t0001017.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 1008640 100 1008640 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
# Display active software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
# Identify the recommended ISSU methods.
<Sysname> display version comp-matrix file boot flash:/boot-t0001017.bin system flash:/system-t0001017.bin feature flash:/feature-t0001017.bin
Verifying the file flash:/boot-t0001017.bin on slot 0..............Done.
Verifying the file flash:/system-t0001017.bin on slot 0..................................Done.
Verifying the file flash:/feature-t0001017.bin on slot 0.........Done.
Identifying the upgrade methods....Done.
Incompatible upgrade.
The output shows that an incompatible upgrade is recommended.
# Save the running configuration.
<Sysname> save
# Upgrade the system software on the standby MPU.
<Sysname> issu load file boot flash:/boot-t0001017.bin system flash:/system-t0001017.bin feature flash:/feature-t0001017.bin slot 1
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:y
Copying file flash:/boot-t0001017.bin to slot1#flash:/boot-t0001017.bin......Done.
Copying file flash:/system-t0001017.bin to slot1#flash:/system-t0001017.bin........................Done.
Copying file flash:/feature-t0001017.bin to slot1#flash:/feature-t0001017.bin......Done.
Verifying the file flash:/boot-t0001017.bin on slot 1...Done.
Verifying the file flash:/system-t0001017.bin on slot 1............Done.
Verifying the file flash:/feature-t0001017.bin on slot 1...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/boot-t0001017.bin
Running Version New Version
Test 0001015 Test 0001017
flash:/system-t0001017.bin
Running Version New Version
Test 0001015 Test 0001017
flash:/feature-t0001017.bin
Running Version New Version
Test 0001015 Test 0001017
Slot Upgrade Way
1 Reboot
Upgrading software images to incompatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# Verify that the ISSU is in a stable state.
<Sysname> display issu state
ISSU state: Loaded
Compatibility: Incompatible
Work state: Normal
Upgrade method: Card by card
Upgraded slot:
slot 1
Current upgrading slot: None
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001017
system: 7.1.070, Test 0001017
feature: 7.1.070, Test 0001017
Upgrade software images:
flash:/boot-t0001017.bin
flash:/system-t0001017.bin
flash:/feature-t0001017.bin
The Loaded state is a stable state, which indicates that the system is waiting for an active/standby switchover to upgrade slot 0. Slot 1 has completed the upgrade, and slot 0 has not.
# Upgrade the system software on the original active MPU.
<Sysname> issu run switchover
Upgrade summary according to following table:
flash:/boot-t0001017.bin
Running Version New Version
Test 0001015 Test 0001017
flash:/system-t0001017.bin
Running Version New Version
Test 0001015 Test 0001017
flash:/feature-t0001017.bin
Running Version New Version
Test 0001015 Test 0001017
Slot Switchover Way
0 Master subordinate switchover
Verifying the upgrade
# Verify that the ISSU is finished.
<Sysname> display issu state
ISSU state: Init
Compatibility: Unknown
Work state: Normal
Upgrade method: Card by card
Upgraded slot: None
Current upgrading slot: None
Current version list:
boot: 7.1.070, Test 0001017
system: 7.1.070, Test 0001017
feature: 7.1.070, Test 0001017
Current software images:
flash:/boot-t0001017.bin
flash:/system-t0001017.bin
flash:/feature-t0001017.bin
The ISSU state field displays Init, which indicates that the ISSU is finished.
# Verify that both MPUs are running the new software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001017.bin
flash:/system-t0001017.bin
flash:/feature-t0001017.bin
Active packages on slot 1:
flash:/boot-t0001017.bin
flash:/system-t0001017.bin
flash:/feature-t0001017.bin
Example: Rolling back the system software
Network configuration
As shown in Figure 7, the device has two MPUs. The active MPU is in slot 0. The standby MPU is in slot 1.
Roll back the boot, system, and feature images from T0001016 to T0001015 after upgrading them from T0001015 to T0001016. T0001016 and T0001015 are compatible.
Procedure
# Download the upgrade image files from the TFTP server.
<Sysname> tftp 2.2.2.2 get boot-t0001016.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 6078464 100 6078464 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
<Sysname> tftp 2.2.2.2 get system-t0001016.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 97750016 100 97750016 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
<Sysname> tftp 2.2.2.2 get feature-t0001016.bin
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 1008640 100 1008640 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
# Display active software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
# Identify the recommended ISSU methods.
<Sysname> display version comp-matrix file boot flash:/boot-t0001016.bin system flash:/system-t0001016.bin feature flash:/feature-t0001016.bin
Verifying the file flash:/boot-t0001016.bin on slot 0.......................Done.
Verifying the file flash:/system-t0001016.bin on slot 0................. .................Done.
Verifying the file flash:/feature-t0001016.bin on slot 0.................Done.
Identifying the upgrade methods....Done.
Slot Upgrade Way
0 Reboot
1 Reboot
The output shows that reboot upgrades are recommended.
# Save the running configuration.
<Sysname> save
# Upgrade the system software on the standby MPU.
<Sysname> issu load file boot flash:/boot-t0001016.bin system flash:/system-t0001016.bin feature flash:/feature-t0001016.bin slot 1
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:y
Copying file flash:/boot-t0001016.bin to slot1#flash:/boot-t0001016.bin......Done.
Copying file flash:/system-t0001016.bin to slot1#flash:/system-t0001016.bin........................Done.
Copying file flash:/feature-t0001016.bin to slot1#flash:/feature-t0001016.bin......Done.
Verifying the file flash:/boot-t0001016.bin on slot 1...Done.
Verifying the file flash:/system-t0001016.bin on slot 1............Done.
Verifying the file flash:/feature-t0001016.bin on slot 1...Done.
Identifying the upgrade methods….Done.
Upgrade summary according to following table:
flash:/boot-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/system-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
2 Reboot
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# Verify that the ISSU is in a stable state.
<Sysname> display issu state
ISSU state: Loaded
Compatibility: Compatible
Work state: Normal
Upgrade method: Card by card
Upgraded slot:
slot 1
Current upgrading slot: None
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
feature: 7.1.070, Test 0001016
Upgrade software images:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature-t0001016.bin
The Loaded state is a stable state, which indicates that the system is waiting for an active/standby switchover. Slot 1 has completed the upgrade, and slot 0 has not.
# Perform an active/standby switchover.
<Sysname> issu run switchover
Upgrade summary according to following table:
flash:/boot-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/system-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Switchover Way
0 Master subordinate switchover
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait.........
# Verify that the ISSU is in a stable state.
<Sysname> display issu state
ISSU state: Switchover
Compatibility: Compatible
Work state: Normal
Upgrade method: Card by card
Upgraded slot:
slot 1
Current upgrading slot: None
Previous version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature: 7.1.070, Test 0001015
Previous software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Upgrade version list:
boot: 7.1.070, Test 0001016
system: 7.1.070, Test 0001016
feature: 7.1.070, Test 0001016
Upgrade software images:
flash:/boot-t0001016.bin
flash:/system-t0001016.bin
flash:/feature-t0001016.bin
The Switchover state is a stable state, which indicates that the system has completed the active/standby switchover and is waiting for a commit operation to upgrade slot 0.
# Roll back the software images to T0001015.
<Sysname> issu rollback
This command will quit the ISSU process and roll back to the previous version. Continue? [Y/N]:Y
# Verify that the rollback is finished.
<Sysname> display issu state
ISSU state: Init
Compatibility: Unknown
Work state: Normal
Upgrade method: Card by card
Upgraded slot: None
Current upgrading slot: None
Current version list:
boot: 7.1.070, Test 0001015
system: 7.1.070, Test 0001015
feature: 7.1.070, Test 0001015
Current software images:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
The ISSU state field displays Init, which indicates that the rollback is finished.
# Verify that both MPUs are running the old software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature-t0001015.bin
Examples of using install commands for ISSU
Example: Upgrading the system software
Network configuration
As shown in Figure 8, the device has two MPUs. The active MPU is in slot 0. The standby MPU is in slot 1.
Upgrade the Feature1 feature image from T0001015 to T0001016. The two versions are compatible.
Procedure
# Download the .ipe file that contains the T0001016 Feature1 feature image from the TFTP server.
<Sysname> tftp 2.2.2.2 get feature1-t0001016.ipe
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 256 100 256 0 0 764 0 --:--:-- --:--:-- --:--:-- 810
Writing file...Done.
# Decompress the .ipe file.
<Sysname> install add flash:/feature1-t0001016.ipe flash:/
Verifying the file flash:/feature1-t0001016.ipe on slot 0...Done.
Decompressing file feature1-t0001016.bin to flash:/feature1-t0001016.bin.......................Done.
# Display active software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
# Identify the recommended ISSU methods and possible impact of the upgrade.
<Sysname> install activate feature flash:/feature1-t0001016.bin slot 1 test
Copying file flash:/feature1-t0001016.bin to slot1#flash:/feature1-t0001016.bin......Done.
Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.
Upgrade summary according to following table:
flash:/feature1-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
1 Service Upgrade
Influenced service according to following table on slot 1:
flash:/feature1-t0001016.bin
Feature1
<Sysname> install activate feature flash:/feature1-t0001016.bin slot 0 test
Verifying the file flash:/feature1-t0001016.bin on slot 0...Done.
Upgrade summary according to following table:
flash:/feature1-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
0 Service Upgrade
1 Service Upgrade
Influenced service according to following table on slot 0:
flash:/feature1-t0001016.bin
Feature1
The output shows that both MPUs need a service upgrade and the Feature1 module will be rebooted during the upgrade.
# Activate the new Feature1 image to upgrade the Feature1 feature.
<Sysname> install activate feature flash:/feature1-t0001016.bin slot 1
flash:/feature1-t0001016.bin already exists on slot 1.
Overwrite it?[Y/N]:y
Copying file flash:/feature1-t0001016.bin to slot1#flash:/feature1-t0001016.bin......Done.
Verifying the file flash:/feature1-t0001016.bin on slot 1...Done.
Upgrade summary according to following table:
flash:/feature1-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
1 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
<Sysname> install activate feature flash:/feature1-t0001016.bin slot 0
Verifying the file flash:/feature1-t0001016.bin on slot 0...Done.
Upgrade summary according to following table:
flash:/feature1-t0001016.bin
Running Version New Version
Test 0001015 Test 0001016
Slot Upgrade Way
0 Service Upgrade
1 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# Verify that the new Feature1 image has been activated.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001016.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001016.bin
# Commit the software changes.
<Sysname> install commit
This operation will take several minutes, please wait...........................Done.
The current software images have been saved as the startup software images.
Current software images on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001016.bin
Current software images on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001016.bin
Example: Rolling back a feature
Network configuration
As shown in Figure 8, the device has two MPUs. The active MPU is in slot 0. The standby MPU is in slot 1.
The Feature1 feature has been upgraded from T0001015 to T0001016. However, the software change has not been committed.
Roll back the Feature1 feature from T0001016 to T0001015.
Procedure
# Display active software images.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001016.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001016.bin
# Display available rollback points.
<Sysname> display install rollback
Install rollback information 1 on slot 0:
Updating from flash:/feature1-t0001015.bin
to flash:/feature1-t0001016.bin.
Install rollback information 2 on slot 1:
Updating from flash:/feature1-t0001015.bin
to flash:/feature1-t0001016.bin.
# Roll back the Feature1 feature to T0001015.
<Sysname> install rollback to original
This operation might take several minutes, please wait...Done.
# Verify that the MPUs are running the old Feature1 image.
<Sysname> display install active
Active packages on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
Active packages on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
# Commit the software changes.
<Sysname> install commit
This operation will take several minutes, please wait...........................Done.
The current software images have been saved as the startup software images.
Current software images on slot 0:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin
Current software images on slot 1:
flash:/boot-t0001015.bin
flash:/system-t0001015.bin
flash:/feature1-t0001015.bin