client replace

Function

The client replace command adds or modifies client replacement information.

The undo client replace command deletes client replacement information.

By default, no client replacement information exists.

Format

client client-id replace { [ mac-address mac-address | esn esn ] | system-software file-name [ version ] | patch file-name | web-file file-name | license file-name | { custom-file file-name } &<1-3> } ^*

Parameters

Parameter	Description	Value
client-id	Indicates the ID of a faulty client.	The value is an integer. It depends on the maximum number of clients supported by the Commander. For details, seeMaximum Number of Managed Clients on the Commander.
mac-address mac-address	Indicates the MAC address of the new client.	The value is in the H-H-H format, where each H contains four hexadecimal digits.
esn esn	Indicates the ESN of the new client.	The value is a string of 10 to 32 case-insensitive characters without spaces.
system-software file-name	Specifies the name of the system software (*.cc) to be loaded to the new client.	The value is a string of 4 to 48 case-insensitive characters without spaces.
version	Specifies the version of a system software package, for example, V200R019C10. If the specified software version is the same as the software version running on the client, a software upgrade will not be performed for the client.	The value is a string of 11 to 32 case-insensitive characters without spaces.
patch file-name	Specifies the name of the patch file (*.pat) to be loaded to the new client.	The value is a string of 5 to 48 case-insensitive characters without spaces.
web-file file-name	Specifies the name of the web page file (.web.7z or .web.zip) to be loaded to the new client.	The value is a string of 8 to 64 case-insensitive characters without spaces.
license file-name	Specifies the name of the license file (*.dat) to be loaded to the new client. NOTE: The license file is not supported in the Easy-Operation view. The file does not take effect even if you configure it.	The value is a string of 5 to 64 case-insensitive characters without spaces.
custom-file file-name	Specifies the name of the user-defined file to be loaded to the new client. A maximum of three user-defined files can be specified. The file names are separated by spaces.	The value is a string of 1 to 64 case-insensitive characters without spaces.

Views

Easy-Operation view

Default Level

3: Management level

Usage Guidelines

Usage Scenario

If a client becomes faulty due to a hardware failure, run this command to add replacement information for the faulty client. After a new client is installed on the network to replace the faulty client, the new client can quickly obtain the configuration file of the faulty client, minimizing impact on services. You can also specify other files that can be loaded on the new client.

Precautions

A new client finds matching replacement information by searching for its own MAC address or ESN; therefore, the mapping between the new client and MAC address or ESN must be configured. After finding matching information, the new client downloads the configuration file and other specified files of the faulty client from the file server.
Before replacing the faulty client with a new client, ensure that the EasyDeploy function has been configured on the network and the backup configuration interval command has been run on the Commander to enable automatic configuration file backup. If this command has not been run, the new client cannot obtain the latest configuration file of the faulty client.
This command can be run once or multiple times to configure the mappings between the new client and MAC address or ESN and specify information about the files to be downloaded.
To delete all replacement information about a client, run the undo client client-id replace command. To delete an item from a client's replacement information, run the undo command with the item specified.
This command is not recorded in the configuration file.

Example

# Replace client 3 with a client that has a MAC address 0000-c102-0702. The new client only needs to download the configuration file of client 3.

<HUAWEI> system-view
[HUAWEI] easy-operation
[HUAWEI-easyoperation] client 3 replace mac-address 0000-c102-0702

# Replace client 3 with a client that has a MAC address 0000-c102-0702. The new client needs to download the configuration file, system software, and user-defined file of client 3.

<HUAWEI> system-view
[HUAWEI] easy-operation
[HUAWEI-easyoperation] client 3 replace mac-address 0000-c102-0702
[HUAWEI-easyoperation] client 3 replace system-software test.cc V200R019C10
[HUAWEI-easyoperation] client 3 replace custom-file header.txt custom-file aaa.bat