client

Function

The client command adds information to the client database or modifies information in the client database.

The undo client command deletes information from the client database.

By default, the client database does not contain client information.

Format

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

Parameters

Parameter	Description	Value
client-id	Specifies the client ID, which identifies a client. If this parameter is not specified when you add client information, the system assigns the minimum ID not in use to the client.	The value is an integer. It depends on the maximum number of clients supported by the Commander. The value ranges from 1 to 255.
mac-address mac-address	Specifies the MAC address of the client.	The value is in the H-H-H format, where each H contains four hexadecimal digits.
esn esn	Specifies the ESN of the 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 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, V200R005C00. If the specified software version is the same as the software version running on the client, 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 client.	The value is a string of 5 to 48 case-insensitive characters without spaces.
configuration-file file-name	Specifies the name of the configuration file (.zip or .cfg) to be loaded to the 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.zip or .web.7z) to be loaded to the 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 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 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

2: Configuration level

Usage Guidelines

Usage Scenario

If a few unconfigured clients need to be deployed on a network, you can run this command multiple times to add client information one by one.

Precautions

Clients search the matching database by searching for their MAC addresses or ESNs in the database; therefore, the mappings between clients and MAC addresses or ESNs must be configured. When a client finds a matching database, it obtains information mapping its client ID, including system software name and patch file name.
This command can be executed once or multiple times to configure the mappings between clients and MAC addresses or ESNs and specify information about the files to be downloaded.
To delete all information about a client, run the undo client client-id command. To delete an item from a client's information, run the undo command with the item specified.
Each Commander supports a limited number of clients; therefore, the client information that can be added to the client database is also limited.
You can specify a path for each file.

Example

# Add client information in which MAC address is 0102-1122-3333, configuration file is vrpcfg.zip, and file path is /configfile/.

<HUAWEI> system-view
[HUAWEI] easy-operation
[HUAWEI-easyoperation] client mac-address 00E0-FC34-3190 configuration-file /configfile/vrpcfg.zip

# Add client information in which client ID is 3, ESN is 210235165110A6000619, system software name is test.cc, and user-defined file names are header.txt and aaa.bat.

<HUAWEI> system-view
[HUAWEI] easy-operation
[HUAWEI-easyoperation] client 3 esn 210235165110A6000619
[HUAWEI-easyoperation] client 3 system-software test.cc
[HUAWEI-easyoperation] client 3 custom-file header.txt custom-file aaa.bat

# Delete the configuration file of the client with client ID 4.

<HUAWEI> system-view
[HUAWEI] easy-operation
[HUAWEI-easyoperation] undo client 4 configuration-file

# Delete all information about the client with client ID 5.

<HUAWEI> system-view
[HUAWEI] easy-operation
[HUAWEI-easyoperation] undo client 5