The option command configures the user-defined option that a DHCP server assigns to a DHCP client.
The undo option command deletes the user-defined option that a DHCP server assigns to a DHCP client.
By default, no user-defined option that a DHCP server assigns to a DHCP client is configured.
option code [ sub-option sub-code ] { ascii ascii-string | hex hex-string | cipher cipher-string | ip-address ip-address &<1-8> }
undo option [ code [ sub-option sub-code ] ]
Parameter |
Description |
Value |
---|---|---|
code |
Specifies the code of a user-defined option. |
The value is an integer that ranges from 1 to 254, except the values 1, 3, 6, 15, 44, 46, 50, 51, 52, 53, 54, 55, 57, 58, 59, 61, 82, 120, 121, and 184.
NOTE:
There are well-known options and user-defined options. For details about well-known options, see RFC 2132. When the switch functions as a DHCP client, Option 147 can be used in an EasyDeploy scenario and is not recommended in other scenarios. |
sub-option sub-code |
Specifies the code of a user-defined sub-option. |
The value is an integer that ranges from 1 to 254. For details about well-known options, see RFC 2132. |
ascii ascii-string |
Specifies the user-defined option code as an ASCII character string. |
The value is a string of case-sensitive characters with spaces supported. If sub-option is not specified, the value is a string of 1 to 255 characters. If sub-option is specified, the value is a string of 1 to 253 characters. |
hex hex-string |
Specifies the user-defined option code as a hexadecimal character string. |
The value is a hexadecimal string with an even number of characters, for example, hh or hhhh. If sub-option is not specified, the value without spaces ranges from 1 to 254 characters; if sub-option is specified, the value without spaces ranges from 1 to 252. The value can be a combination of digits (0-9), uppercase letters (A-F), and lowercase letters (a-f). |
cipher cipher-string |
Specifies the user-defined option code as a ciphertext character string. |
The value is a character string either in plain text or cipher text.
No matter whether the character string is entered in plain or cipher text, the character string is displayed in cipher text in the configuration file and in plain text in packets. |
ip-address ip-address |
Specifies the user-defined option code as an IP address. |
The value is in dotted decimal notation. |
Usage Scenario
This command applies to DHCP servers. The option field in a DHCP packet carries control information and parameters. If a DHCP server is configured with options, when a DHCP client applies for an IP address, the client can obtain the configurations in the option field of the DHCP response packet from the DHCP server. To configure user-defined options for an interface address pool, run the dhcp server option command.
Precautions
To ensure configuration accuracy, read the Request For Comments (RFC) before configuring options.
When an option contains a password, the option code in ascii or hex type is insecure. You are advised to set the option code type to cipher. For security purposes, a password must contain at least two types of the following: lowercase letters, uppercase letters, digits, and special characters. In addition, the password must consist of at least six characters.
If you need to configure multiple IP addresses when the option is specified as an ASCII character string, use commas (,) to separate the IP addresses.
When users on an enterprise's intranet use a proxy server to connect to the Internet, you need to configure proxy server parameters so that users can use browsers to access the network. The Web Proxy Auto-Discovery Protocol (WPAD) implements automatic configuration of these parameters. The administrator does not need to manually configure these parameters on each client. To implement the WPAD function, the administrator needs to deploy the configuration file of the proxy server in advance, and then run the option 252 asciiascii-string command to specify the URL of the configuration file. The ascii-string parameter specifies the URL of the configuration file, in the format of http://xxx/proxy.pac. Set ascii-string according to the actual location of the configuration file. When a browser accesses the network, the browser requests the DHCP server to send the URL of the configuration file on the proxy server, and then downloads the configuration file to conduct automatic configuration. After the configuration is completed, the browser can access the network.
The value of ascii-string cannot be enclosed in double quotation marks as "ascii-string". Otherwise, terminals cannot parse Option252.
<HUAWEI> system-view [HUAWEI] ip pool global1 [HUAWEI-ip-pool-global1] option 64 hex 11
<HUAWEI> system-view [HUAWEI] dhcp option template template1 [HUAWEI-dhcp-option-template-template1] option 64 hex 11