Title | Size | Downloads |
---|---|---|
Patch Installation Guide-6W102-book.pdf | 91.83 KB |
- Table of Contents
- Related Documents
-
| NOTE: · This guide applies to the S10500 software release trains 1120 and 1130, the S7500E software release trains 6620 and 6630, and the S7508E-X software release trains 6820 and 6830. · This document uses S10500 as an example. The described patch installation methods apply to all the previously mentioned models. · If you insert a new LPU in to the switch after installing patches, the switch automatically installs the patches on the new LPU. |
Patch overview
Patches are used to solve software defects in a fast, low-cost way. There are two types of patches, hot and cold.
· A hot patch (also knows as hotfix) solves software problems without shutting down the system or impacting running services.
· A cold patch requires a reboot of the target card to take effect.
A hot patch and a cold patch are installed in the same way except that the cold patch needs a reboot to take effect.
CAUTION: Before installing a patch, read the patch usage guide carefully to avoid any failure. |
Installing a patch package
Preparations
A patch package contains the patch files released at the same time for different cards.
A patch package file is a .bin file and is typically named in the form product name-platform version-software version numberHpatch number, such as S10500-CMW520-R1126H03.bin.
Before installing a patch package, read the patch release notes carefully to get clear information about patch type, number of patches, and patch usage guidelines.
CAUTION: The version of the patch package must match the device model and system software. Otherwise, patch installation will fail. |
| NOTE: Before installation, put the patch package into the root directory of the flash on the active and standby MPUs. |
# Display device information. (The output may vary with switches.)
<Sysname> display device
Slot No. Brd Type Brd Status Subslot Num Sft Ver Patch Ver
0 LSU1SUPA Master 0 S10500-1126 P001
1 LSU1SUPA Slave 0 S10500-1126 P001
2 LSU1GP24TXSE Normal 0 S10500-1126 P001
3 LSU1GP24TXSE Normal 0 S10500-1126 P001
4 LSU1GP48EB Normal 0 S10500-1126 P001
5 LSU1GP48EB Normal 0 S10500-1126 P001
6 LSU1FAB04A Normal 0 S10500-1126 P001
7 NONE Absent 0 NONE None
8 NONE Absent 0 NONE None
9 NONE Absent 0 NONE None
The output shows that the switch has two MPUs, an active MPU in slot 0 and a standby MPU in slot 1.
# Check the free storage space on the active MPU.
<Sysname> dir /all
Directory of flash:/
0 -rw- 32923732 Aug 23 2011 17:21:35 main.bin
1 -rw- 151 Jun 02 2011 16:50:44 system.xml
2 -rw- 6625 Jun 02 2011 16:50:51 startup.cfg
3 drw- - Apr 28 2011 09:12:00 seclog
4 -rw- 29880628 Aug 11 2011 11:04:20 backup.bin
125349 KB total (62537 KB free)
If the free storage space is not enough for storing the patch package, delete undesired files with the delete/unreserved command to release storage space.
# Check the free storage space on the standby MPU.
<Sysname> dir slot1#flash:/
Directory of slot1#flash:/
0 -rw- 32923732 Aug 23 2011 17:21:35 main.bin
1 -rw- 151 Jun 02 2011 16:50:44 system.xml
2 -rw- 6625 Jun 02 2011 16:50:51 startup.cfg
3 drw- - Apr 28 2011 09:12:00 seclog
4 -rw- 29880628 Aug 11 2011 11:04:20 backup.bin
125349 KB total (62537 KB free)
If the free storage space is not enough for storing the patch package, delete undesired files with the delete/unreserved command to release storage space.
| NOTE: · The delete /unreserved file-url command deletes a file permanently and the action cannot be undone. · The delete file-url command moves a file to the recycle bin and the file still occupies storage space. To permanently delete the file from the recycle bin, execute the reset recycle-bin command in the original directory of the file. |
| NOTE: In IRF mode, you need to check the free storage space on the active MPU and all standby MPUs to ensure each MPU has enough space to store the patch package. |
# Use the display patch information command to check whether the cards have been patched and view patch running status.
| NOTE: If a card has been patched, you must uninstall the previous patch before you can install the new patch package. |
<Sysname> display patch information
The location of patches: flash:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
0 MPU001 0 1 1 0 1 0x86d97d90
0.1 MPO001 0 1 1 0 1 0x80a7b5dc
1 MPU001 0 1 1 0 1 0x86d97d90
1.1 MPO001 0 1 1 0 1 0x80a7b5dc
2 LPU001 0 1 1 0 1 0x856d5b88
2.1 LPO001 0 1 1 0 1 0x80a7b5dc
3 LPU001 0 1 1 0 1 0x856d5b88
3.1 LPO001 0 1 1 0 1 0x80a7b5dc
4 LPU001 0 1 1 0 1 0x856d5b88
4.1 LPO001 0 1 1 0 1 0x80a7b5dc
5 LPU001 0 1 1 0 1 0x856d5b88
5.1 LPO001 0 1 1 0 1 0x80a7b5dc
6 LPU001 0 1 1 0 1 0x856d5b88
The output shows that each card has a running patch. Use the undo patch install command to uninstall the patch.
# Uninstall the patch.
<Sysname> system-view
[Sysname] undo patch install
Patches will be uninstalled. Continue? [Y/N]:y
# Check whether the uninstallation is successful.
[Sysname] display patch information
The location of patches: flash:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
0 MPU 0 0 0 0 0 0x86d97d90
0.1 MPO 0 0 0 0 0 0x80a7b5dc
1 MPU 0 0 0 0 0 0x86d97d90
1.1 MPO 0 0 0 0 0 0x80a7b5dc
2 LPU 0 0 0 0 0 0x856d5b88
2.1 LPO 0 0 0 0 0 0x80a7b5dc
3 LPU 0 0 0 0 0 0x856d5b88
3.1 LPO 0 0 0 0 0 0x80a7b5dc
4 LPU 0 0 0 0 0 0x856d5b88
4.1 LPO 0 0 0 0 0 0x80a7b5dc
5 LPU 0 0 0 0 0 0x856d5b88
5.1 LPO 0 0 0 0 0 0x80a7b5dc
6 LPU 0 0 0 0 0 0x856d5b88
The output shows that the patch has been uninstalled successful.
Downloading the patch package to MPUs
| NOTE: Download the patch package to the flash memory of the active MPU and the standby MPU. Skip this section if the patch package is already located there. |
You can download the patch package through FTP or TFTP. The device can act as the FTP server, FTP client, or TFTP client. The following describes how to download the package when the switch serves as the FTP server.
· Configure the FTP server on the switch
# Enable the FTP server on the switch.
[Sysname] ftp server enable
# Create a local user account abc and specify the password as pwd.
[Sysname] local-user abc
[Sysname-luser-abc] password simple pwd
# Specify the service type as FTP.
[Sysname-luser-abc] service-type ftp
# Specify the user level as 3 so that users using this account can upload the patch package to the server.
[Sysname-luser-abc] authorization-attribute level 3
[Sysname-luser-abc] quit
· Upload the patch package from the PC to the FTP server
# Log in to the FTP server.
c:\> ftp 1.1.1.1
Connected to 1.1.1.1.
220 FTP service ready.
User(1.1.1.1:(none)):abc
331 Password required for abc.
Password:
230 User logged in.
# Specify the file transfer mode as binary.
ftp> binary
200 Type set to I.
# Put the patch package (S10500-CMW520-R1126H03.bin in this example) to the root directory of the flash of the active MPU on the switch.
ftp> put s10500-cmw520-r1126h03.bin
200 Port command okay.
150 Opening BINARY mode data connection for /s10500-cmw520-r1126h03.bin.
226 Transfer complete.
ftp: 463364 bytes sent in 2.23 secs (207.32 Kbytes/sec).
# Copy the patch package on the active MPU to the root directory of the flash on the standby MPU.
<Sysname> copy s10500-cmw520-r1126h03.bin slot1#flash:/
Copy flash:/s10500-cmw520-r1126h03.bin to slot1#flash:/s10500-cmw520-r1126h03.bin? [Y/N]:y
...
%Copy file flash:/s10500-cmw520-r1126h03.bin to slot1#flash:/s10500-cmw520-r1126h03.bin
...Done.
| NOTE: In IRF mode, you need to copy the patch package on the active MPU to the root directory of the flash on all standby MPUs. |
Installing the patch package
# Install the patch package.
<Sysname> system-view
[Sysname] patch install file s10500-cmw520-r1126h03.bin
Patches will be installed. Continue? [Y/N]:y ------Note①
Do you want to continue running patches after reboot? [Y/N]:y ------Note②
Installing patches........
Note①: Type Y to install the patch package. Type N to exit installation.
Note②: Type Y to enable the installed patches to survive reboots. Type N to disable the installed patches from surviving reboots.
| NOTE: · You must use the patch install file filename command to install a patch package. The patch install flash: command is not suited to install a patch package. · If you install a patch package, upgrade the system software, and then roll back to the previous version, the installed patches may become invalid, and you need to re-install the patch package. · If you install a patch package and then insert a standby MPU or replace the standby MPU with a new one, you must install the patch package for the standby MPU separately to ensure the patches can run on the standby MPU. · After you install a cold patch, you must reboot the target card to validate the patch. Installing a hot patch does not need to reboot the target card. |
Verifying the installation
# Display patch information.
[Sysname] display patch information
The location of patches: flash:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
0 MPU001 0 1 1 0 1 0x86d97d90
0.1 MPO001 0 1 1 0 1 0x80a7b5dc
1 MPU001 0 1 1 0 1 0x86d97d90
1.1 MPO001 0 1 1 0 1 0x80a7b5dc
2 LPU001 0 1 1 0 1 0x856d5b88
2.1 LPO001 0 1 1 0 1 0x80a7b5dc
3 LPU001 0 1 1 0 1 0x856d5b88
3.1 LPO001 0 1 1 0 1 0x80a7b5dc
4 LPU001 0 1 1 0 1 0x856d5b88
4.1 LPO001 0 1 1 0 1 0x80a7b5dc
5 LPU001 0 1 1 0 1 0x856d5b88
5.1 LPO001 0 1 1 0 1 0x80a7b5dc
6 LPU001 0 1 1 0 1 0x856d5b88
The output shows that the patches have been installed successfully.
Uninstalling the patches
# Uninstall the patches.
<Sysname> system-view
[Sysname] undo patch install
Patches will be uninstalled. Continue? [Y/N]:y ------Note③
Note③: Type Y to uninstall the patches. Type N to exit uninstallation.
# Check whether the patches have been uninstalled.
[Sysname] display patch information
The location of patches: flash:
Slot Version Temporary Common Current Active Running Start-Address
----------------------------------------------------------------------
0 MPU 0 0 0 0 0 0x86d97d90
0.1 MPO 0 0 0 0 0 0x80a7b5dc
1 MPU 0 0 0 0 0 0x86d97d90
1.1 MPO 0 0 0 0 0 0x80a7b5dc
2 LPU 0 0 0 0 0 0x856d5b88
2.1 LPO 0 0 0 0 0 0x80a7b5dc
3 LPU 0 0 0 0 0 0x856d5b88
3.1 LPO 0 0 0 0 0 0x80a7b5dc
4 LPU 0 0 0 0 0 0x856d5b88
4.1 LPO 0 0 0 0 0 0x80a7b5dc
5 LPU 0 0 0 0 0 0x856d5b88
5.1 LPO 0 0 0 0 0 0x80a7b5dc
6 LPU 0 0 0 0 0 0x856d5b88
The output shows that the patches have been uninstalled successfully.