patch load

Function

The patch load all command loads the matching patch in the patch package on a board.

Format

patch load file-name all [ active | run ]

Parameters

Parameter	Description	Value
file-name	Specifies the directory in which a patch package is placed and the name of a file. Patches must be placed in the cfcard:/ directory. file-name supports file name association. The disk where the file resides can be automatically associated. Full help: All the disks of the device can be associated and displayed. Partial help: The related disk and file can be associated and displayed after you enter a specified character string.	file-name consists of drive-name and file-name and is a string of 5 to 48 case-sensitive characters with spaces not supported. If the device supports multiple storage media and drive-name is not specified, the patch with a specified name in the root directory of the default storage medium will be loaded.
active	Activates a patch after the patch is loaded. If active is configured in the patch load command, the patch will be run temporarily. After the device is restarted, the patch enters the inactive state.	-
run	Activates a patch after the patch is loaded. If run is configured in the patch load command, the patch will be run. After the device is restarted, the patch remains in the running state.	-

Parameter

Description

Value

file-name

Specifies the directory in which a patch package is placed and the name of a file.

Patches must be placed in the cfcard:/ directory.

file-name supports file name association. The disk where the file resides can be automatically associated.

Full help: All the disks of the device can be associated and displayed.
Partial help: The related disk and file can be associated and displayed after you enter a specified character string.

file-name consists of drive-name and file-name and is a string of 5 to 48 case-sensitive characters with spaces not supported.

If the device supports multiple storage media and drive-name is not specified, the patch with a specified name in the root directory of the default storage medium will be loaded.

active

Activates a patch after the patch is loaded.

If active is configured in the patch load command, the patch will be run temporarily. After the device is restarted, the patch enters the inactive state.

run

Activates a patch after the patch is loaded.

If run is configured in the patch load command, the patch will be run. After the device is restarted, the patch remains in the running state.

Views

User view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

You can run the patch load command to rapidly fix the system software bugs.

Prerequisites

A patch is released based on the device or board type. The patch file must have been loaded to the storage medium using FTP or TFTP.

Before a patch is loaded, the system parses the patch package, verifies the validity of the patch, and obtains attributes of the patch, including the patch version, patch compiling time, and supported board type. The system searches for a matched patch in the patch package based on the patch attribute.

The version and compiling time of the patch must be the same as those of the system software.
The board supported by the patch must have been installed on the device.
The suffix of the patch name must be .pat.

The name of the patch file is displayed in the Patch Package Name field in the display patch-information command output.

Follow-up Procedure

Configure active in the patch load all command to activate but not run a patch after the patch is loaded. Run the patch run all command to run the patch.

Precautions

If no optional parameter is configured in the patch load command, the patches are only loaded from the storage medium to the patch area in the memory and remain in the inactive state.

Patches are classified into hot patches and cold patches.

Hot patch

Loading hot patches does not interrupt running services on the device. A hot patch fixes the system software bug when the device is running.
Cold patch

A cold patch fixes the system software bug only after the device is restarted.

If a patch has been loaded, only an incremental patch can be additionally loaded. An additional patch can be loaded only after the original patch is deleted, regardless of the original patch status.

Example

# Load a patch package.

<sysname> patch load pp031.pat all run

Info: The patch is being loaded. Please wait for a moment......
Info: Succeeded in running the patch on the master board.
Info: Succeeded in running the patch on the slave board.
Info: Succeeded in running the patch on slot 1.
Info: Succeeded in running the patch on slot 4.
Info: Succeeded in running the patch on the card 1/3/0.  
Info: The card 1/3/1 does not have c patch to be loaded.
Info: Succeeded in running the patch on the card 1/7/0.    
Info: Does not have NP patch to be loaded.....................................
Info: Finished loading the patch.

NOTE:

Succeeded in running the patch on the card 1/3/0: The loaded patch package includes the c patch on subcard 0 on the slot-3 board in the chassis 1.
The card 1/3/1 does not have c patch to be loaded: The loaded patch package does not include the c patch on subcard 0 on the slot-3 board in the chassis 1.