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> } *
undo 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 ] ]
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. For details, seeMaximum Number of Managed Clients on the Commander. |
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, 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 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.7z or *.web.zip) 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. |
Usage Guidelines
Usage Scenario
If a few zero touch 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.
When parameters are specified in this undo command to delete specified information, this command takes effect only for the manually configured clients.
- 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 0102-1122-3333 configuration-file configfile/vrpcfg.zip
# Add client information in which client ID is 3, ESN is 210235165110xxxxxxxx, 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 210235165110xxxxxxxx [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