JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
System Administration Guide: IP Services     Oracle Solaris 10 8/11 Information Library
search filter icon
search icon

Document Information

Preface

Part I Introducing System Administration: IP Services

1.  Oracle Solaris TCP/IP Protocol Suite (Overview)

Part II TCP/IP Administration

2.  Planning Your TCP/IP Network (Tasks)

3.  Introducing IPv6 (Overview)

4.  Planning an IPv6 Network (Tasks)

5.  Configuring TCP/IP Network Services and IPv4 Addressing (Tasks)

6.  Administering Network Interfaces (Tasks)

7.  Configuring an IPv6 Network (Tasks)

8.  Administering a TCP/IP Network (Tasks)

9.  Troubleshooting Network Problems (Tasks)

10.  TCP/IP and IPv4 in Depth (Reference)

11.  IPv6 in Depth (Reference)

Part III DHCP

12.  About DHCP (Overview)

13.  Planning for DHCP Service (Tasks)

14.  Configuring the DHCP Service (Tasks)

15.  Administering DHCP (Tasks)

About DHCP Manager

DHCP Manager Window

DHCP Manager Menus

Starting and Stopping DHCP Manager

How to Start and Stop DHCP Manager

Setting Up User Access to DHCP Commands

How to Grant Users Access to DHCP Commands

Starting and Stopping the DHCP Service

How to Start and Stop the DHCP Service (DHCP Manager)

How to Enable and Disable the DHCP Service (DHCP Manager)

How to Enable and Disable the DHCP Service (dhcpconfig -S)

DHCP Service and the Service Management Facility

Modifying DHCP Service Options (Task Map)

Changing DHCP Logging Options

How to Generate Verbose DHCP Log Messages (DHCP Manager)

How to Generate Verbose DHCP Log Messages (Command Line)

How to Enable and Disable DHCP Transaction Logging (DHCP Manager)

How to Enable and Disable DHCP Transaction Logging (Command Line)

How to Log DHCP Transactions to a Separate syslog File

Enabling Dynamic DNS Updates by a DHCP Server

How to Enable Dynamic DNS Updating for DHCP Clients

Client Host Name Registration

Customizing Performance Options for the DHCP Server

How to Customize DHCP Performance Options (DHCP Manager)

How to Customize DHCP Performance Options (Command Line)

Adding, Modifying, and Removing DHCP Networks (Task Map)

Specifying Network Interfaces for DHCP Monitoring

How to Specify Network Interfaces for DHCP Monitoring (DHCP Manager)

How to Specify Network Interfaces for DHCP Monitoring (dhcpconfig)

Adding DHCP Networks

How to Add a DHCP Network (DHCP Manager)

How to Add a DHCP Network (dhcpconfig)

Modifying DHCP Network Configurations

How to Modify the Configuration of a DHCP Network (DHCP Manager)

How to Modify the Configuration of a DHCP Network (dhtadm)

Removing DHCP Networks

How to Remove a DHCP Network (DHCP Manager)

How to Remove a DHCP Network (pntadm)

Supporting BOOTP Clients With the DHCP Service (Task Map)

How to Set Up Support of Any BOOTP Client (DHCP Manager)

How to Set Up Support of Registered BOOTP Clients (DHCP Manager)

Working With IP Addresses in the DHCP Service (Task Map)

Adding IP Addresses to the DHCP Service

How to Add a Single IP Address (DHCP Manager)

How to Duplicate an Existing IP Address (DHCP Manager)

How to Add Multiple IP Addresses (DHCP Manager)

How to Add IP Addresses (pntadm)

Modifying IP Addresses in the DHCP Service

How to Modify IP Address Properties (DHCP Manager)

How to Modify IP Address Properties (pntadm)

Removing IP Addresses From the DHCP Service

Marking IP Addresses as Unusable by the DHCP Service

How to Mark IP Addresses as Unusable (DHCP Manager)

How to Mark IP Addresses as Unusable (pntadm)

Deleting IP Addresses From the DHCP Service

How to Delete IP Addresses From DHCP Service (DHCP Manager)

How to Delete IP Addresses From the DHCP Service (pntadm)

Assigning a Reserved IP Address to a DHCP Client

How to Assign a Consistent IP Address to a DHCP Client (DHCP Manager)

How to Assign a Consistent IP Address to a DHCP Client (pntadm)

Working With DHCP Macros (Task Map)

How to View Macros Defined on a DHCP Server (DHCP Manager)

How to View Macros Defined on a DHCP Server (dhtadm)

Modifying DHCP Macros

How to Change Values for Options in a DHCP Macro (DHCP Manager)

How to Change Values for Options in a DHCP Macro (dhtadm)

How to Add Options to a DHCP Macro (DHCP Manager)

How to Add Options to a DHCP Macro (dhtadm)

How to Delete Options From a DHCP Macro (DHCP Manager)

How to Delete Options From a DHCP Macro (dhtadm)

Creating DHCP Macros

How to Create a DHCP Macro (DHCP Manager)

How to Create a DHCP Macro (dhtadm)

Deleting DHCP Macros

How to Delete a DHCP Macro (DHCP Manager)

How to Delete a DHCP Macro (dhtadm)

Working With DHCP Options (Task Map)

Creating DHCP Options

How to Create DHCP Options (DHCP Manager)

How to Create DHCP Options (dhtadm)

Modifying DHCP Options

How to Modify DHCP Option Properties (DHCP Manager)

How to Modify DHCP Option Properties (dhtadm)

Deleting DHCP Options

How to Delete DHCP Options (DHCP Manager)

How to Delete DHCP Options (dhtadm)

Modifying the DHCP Client's Option Information

Supporting Oracle Solaris Network Installation With the DHCP Service

Supporting Remote Boot and Diskless Boot Clients (Task Map)

Setting Up DHCP Clients to Receive Information Only (Task Map)

Converting to a New DHCP Data Store

How to Convert the DHCP Data Store (DHCP Manager)

How to Convert the DHCP Data Store (dhcpconfig -C)

Moving Configuration Data Between DHCP Servers (Task Map)

How to Export Data From a DHCP Server (DHCP Manager)

How to Export Data From a DHCP Server (dhcpconfig -X)

How to Import Data on a DHCP Server (DHCP Manager)

How to Import Data on a DHCP Server (dhcpconfig -I)

How to Modify Imported DHCP Data (DHCP Manager)

How to Modify Imported DHCP Data (pntadm, dhtadm)

16.  Configuring and Administering the DHCP Client

17.  Troubleshooting DHCP (Reference)

18.  DHCP Commands and Files (Reference)

Part IV IP Security

19.  IP Security Architecture (Overview)

20.  Configuring IPsec (Tasks)

21.  IP Security Architecture (Reference)

22.  Internet Key Exchange (Overview)

23.  Configuring IKE (Tasks)

24.  Internet Key Exchange (Reference)

25.  IP Filter in Oracle Solaris (Overview)

26.  IP Filter (Tasks)

Part V Mobile IP

27.  Mobile IP (Overview)

28.  Administering Mobile IP (Tasks)

29.  Mobile IP Files and Commands (Reference)

Part VI IPMP

30.  Introducing IPMP (Overview)

31.  Administering IPMP (Tasks)

Part VII IP Quality of Service (IPQoS)

32.  Introducing IPQoS (Overview)

33.  Planning for an IPQoS-Enabled Network (Tasks)

34.  Creating the IPQoS Configuration File (Tasks)

35.  Starting and Maintaining IPQoS (Tasks)

36.  Using Flow Accounting and Statistics Gathering (Tasks)

37.  IPQoS in Detail (Reference)

Glossary

Index

Working With DHCP Options (Task Map)

Options are keywords for network configuration parameters that the DHCP server can pass to clients. In the DHCP service, you cannot create, delete, or modify the standard DHCP options. The standard options are defined by the DHCP protocol, so the options cannot change. You can only perform tasks on options that you create for your site. For this reason, when you first set up your DHCP service, the Options tab in DHCP Manager is empty until you create options for your site.

If you create options on the DHCP server, you must also add information about the options on the DHCP client. For the DHCP client, you must edit the /etc/dhcp/inittab file to add entries for the new options. See the dhcp_inittab(4) man page for more information about this file.

If you have DHCP clients that are not Oracle Solaris clients, refer to the documentation for those clients for information about adding options or symbols. See About DHCP Options for more information about options in DHCP.

You can use either DHCP Manager or the dhtadm command to create, modify, or delete options.


Tip - Options are called symbols in the DHCP literature. The dhtadm command and its related man page also refer to options as symbols.


The following task map lists tasks that you must perform to create, modify, and delete DHCP options. The task map contains links to procedures for the tasks.

Task
Description
For Instructions
Create DHCP options.
Add new options for information not covered by a standard DHCP option.
Modify DHCP options.
Change properties of DHCP options you have created.
Delete DHCP options.
Remove DHCP options that you have created.

Before you create DHCP options, you should be familiar with the option properties listed in the following table.

Table 15-5 DHCP Option Properties

Option Property
Description
Category
The category of an option must be one of the following:
  • Vendor – Options specific to a client's vendor platform, either hardware or software.

  • Site – Options specific to your site.

  • Extend – Newer options that have been added to the DHCP protocol, but not yet implemented as standard options in DHCP.

Code
The code is a unique number that you assign to an option. The same code cannot be used for any other option within its option category. The code must be appropriate for the option category:
  • Vendor – Code values of 1–254 for each vendor class

  • Site – Code values of 128–254

  • Extend – Code values of 77–127

Data type
The data type specifies what kind of data can be assigned as a value for the option. The valid data types are described in the following list.
  • ASCII – Text string value.

  • BOOLEAN – No value is associated with the Boolean data type. The presence of the option indicates that a condition is true, while the absence of the option indicates that a condition is false. For example, the Hostname option is Boolean. The presence of Hostname in a macro causes the DHCP server to look up the host name associated with the assigned address.

  • IP – One or more IP addresses, in dotted decimal format (xxx.xxx.xxx.xxx).

  • OCTET – Uninterpreted ASCII representation of binary data. For example, a client ID uses the octet data type. Valid characters are 0–9, A–F, and a–f. Two ASCII characters are needed to represent an 8-bit quantity.

  • UNUMBER8, UNUMBER16, UNUMBER32, UNUMBER64, SNUMBER8, SNUMBER16, SNUMBER32, or SNUMBER64 – Numeric value. An initial U or S indicates whether the number is unsigned or signed. The digits at the end indicate how many bits are in the number.

Granularity
The granularity specifies how many “instances” of the data type are needed to represent a complete option value. For example, a data type of IP and a granularity of 2 would mean that the option value must contain two IP addresses.
Maximum
The maximum number of values that can be specified for the option. For example, suppose the maximum is 2, the granularity is 2, and the data type is IP. In this case, the option value could contain a maximum of two pairs of IP addresses.
Vendor client classes
This option is available only when the option category is Vendor. Vendor client classes identify the client classes with which the Vendor option is associated. The class is an ASCII string that represents the client machine type or operating system. For example, the class string for some models of Sun workstations is SUNW.Sun-Blade-100. This type of option enables you to define configuration parameters that are passed to all clients of the same class, and only clients of that class.

You can specify multiple client classes. Only those DHCP clients with a client class value that matches a class that you specify receive the options scoped by that class.

The client class is determined by the vendor of the DHCP client. For DHCP clients that are not Oracle Solaris clients, refer to the vendor documentation for the DHCP client for the client class.

For Oracle Solaris clients, the Vendor client class can be obtained by typing the prtconf -b command on the client. To specify the Vendor client class, substitute periods for any commas in the string returned by the uname command. For example, if the string SUNW,Sun-Blade-100 is returned by the prtconf -b command, you should specify the Vendor client class as SUNW.Sun-Blade-100.

Creating DHCP Options

If you need to pass client information for which there is not already an existing option in the DHCP protocol, you can create an option. See the dhcp_inittab(4) man page for a list of all the options that are defined in DHCP before you create your own option.

You can use the dhtadm -A -s command or DHCP Manager's Create Option dialog box to create new options.

The following figure shows DHCP Manager's Create Option dialog box.

Figure 15-17 Create Option Dialog Box in DHCP Manager

image:Dialog box shows fields that define properties of a new option. Shows Vendor Client Classes area and Notify DHCP server check box.

How to Create DHCP Options (DHCP Manager)

  1. In DHCP Manager, select the Options tab.

    See How to Start and Stop DHCP Manager for information about DHCP Manager.

  2. Choose Create from the Edit menu.

    The Create Options dialog box opens.

  3. Type a short descriptive name for the new option.

    The name can contain up to 128 alphanumeric characters and spaces.

  4. Type or select values for each setting in the dialog box.

    Refer to Table 15-5 for information about each setting, or view the DHCP Manager help.

  5. Select Notify DHCP Server of Change if you are finished creating options.

    This selection tells the DHCP server to reread the dhcptab table to put the change into effect immediately after you click OK.

  6. Click OK.

    You can now add the option to macros, and assign a value to the option to pass to clients.

How to Create DHCP Options (dhtadm)

  1. Become superuser or assume a role or user name that is assigned to the DHCP Management profile.

    For more information about the DHCP Management profile, see Setting Up User Access to DHCP Commands.

    Roles contain authorizations and privileged commands. For more information about roles, see Initially Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Create a DHCP option by typing a command using the following format:
    # dhtadm -A -s option-name -d 'category,code,data-type,granularity,maximum' -g
    option-name

    Is an alphanumeric string of 128 characters of less.

    category

    Is one of the following: Site, Extend, or Vendor=list-of-classes. list-of-classes is a space-separated list of vendor client classes to which the option applies. See Table 15-5 for information about how to determine the vendor client class.

    code

    Is a numeric value that is appropriate to the option category, as explained in Table 15-5.

    data-type

    Is specified by a keyword that indicates the type of data that is passed with the option, as explained in Table 15-5.

    granularity

    Is specified as a nonnegative number, as explained in Table 15-5.

    maximum

    Is a nonnegative number, as explained in Table 15-5.

Example 15-3 Creating a DHCP Option With dhtadm

The following command would create an option called NewOpt, which is a Site category option. The option's code is 130. The option's value can be set to a single 8-bit unsigned integer.

# dhtadm -A -s NewOpt -d 'Site,130,UNUMBER8,1,1' -g

The following command would create an option called NewServ, which is a Vendor category option that applies to clients whose machine type is SUNW,Sun-Blade-100 or SUNW,Sun-Blade-1000. The option's code is 200. The option's value can be set to one IP address.

# dhtadm -A -s NewServ -d 'Vendor=SUNW.Sun-Blade-100 \ SUNW.Sun-Blade-1000,200,IP,1,1' -g

Modifying DHCP Options

If you have created options for your DHCP service, you can change the properties for these options. You can use the dhtadm -M -s command or DHCP Manager's Option Properties dialog box to modify options.

Note that you should modify the DHCP client's option information to reflect the same modification that you make to the DHCP service. See Modifying the DHCP Client's Option Information.

The following figure shows DHCP Manager's Option Properties dialog box.

Figure 15-18 Option Properties Dialog Box in DHCP Manager

image:Dialog box shows current properties of selected option. Shows Vendor Client Classes and Notify DHCP server check box.

How to Modify DHCP Option Properties (DHCP Manager)

  1. In DHCP Manager, select the Options tab.

    See How to Start and Stop DHCP Manager for information about DHCP Manager.

  2. Select the option that you want to modify.
  3. Choose Properties from the Edit menu.

    The Option Properties dialog box opens.

  4. Edit the properties as needed.

    See Table 15-5 for information about the properties, or view the DHCP Manager help.

  5. Select Notify DHCP Server of Change when you are finished with options.

    The change is made to the dhcptab table. The DHCP server is signaled to reread the dhcptab table to put the changes into effect.

  6. Click OK.

How to Modify DHCP Option Properties (dhtadm)

  1. Become superuser or assume a role or user name that is assigned to the DHCP Management profile.

    For more information about the DHCP Management profile, see Setting Up User Access to DHCP Commands.

    Roles contain authorizations and privileged commands. For more information about roles, see Initially Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Modify an option by typing a command using the following format:
    # dhtadm -M -s option-name -d 'category,code,data-type,granularity,maximum' -g
    option-name

    Specifies the name of the option that you want to change.

    category

    Can be Site, Extend, or Vendor=list-of-classes. list-of-classes is a space-separated list of vendor client classes to which the option applies. For example, SUNW.Sun-Blade-100 SUNW.Ultra-80 SUNWi86pc.

    code

    Specifies a numeric value that is appropriate to the option category, as explained in Table 15-5.

    data-type

    Specifies a keyword that indicates the type of data that is passed with the option, as explained in Table 15-5.

    granularity

    Is a nonnegative number, as explained in Table 15-5.

    maximum

    Is a nonnegative number, as explained in as explained in Table 15-5.

    Note that you must specify all of the DHCP option properties with the -d switch, not just the properties that you want to change.

Example 15-4 Modifying a DHCP Option With dhtadm

The following command would modify an option called NewOpt. The option is a Site category option. The option's code is 135. The option's value can be set to a single 8-bit unsigned integer.

# dhtadm -M -s NewOpt -d 'Site,135,UNUMBER8,1,1'

The following command would modify an option called NewServ, which is a Vendor category option. The option now applies to clients whose machine type is SUNW,Sun-Blade-100 or SUNW,i86pc. The option's code is 200. The option's value can be set to one IP address.

# dhtadm -M -s NewServ -d 'Vendor=SUNW.Sun-Blade-100 \ SUNW.i86pc,200,IP,1,1' -g

Deleting DHCP Options

You cannot delete standard DHCP options. However, if you have defined options for your DHCP service, you can delete these options by using DHCP Manager or the dhtadm command.

How to Delete DHCP Options (DHCP Manager)

  1. In DHCP Manager, select the Options tab.

    See How to Start and Stop DHCP Manager for information about DHCP Manager.

  2. Select the option that you want to delete.
  3. Choose Delete from the Edit menu.

    The Delete Option dialog box opens.

  4. Select Notify DHCP Server of Change if you are finished deleting options.

    This selection tells the DHCP server to reread the dhcptab table to put the change into effect immediately after you click OK.

  5. Click OK.

How to Delete DHCP Options (dhtadm)

  1. Become superuser or assume a role or user name that is assigned to the DHCP Management profile.

    For more information about the DHCP Management profile, see Setting Up User Access to DHCP Commands.

    Roles contain authorizations and privileged commands. For more information about roles, see Initially Configuring RBAC (Task Map) in System Administration Guide: Security Services.

  2. Delete a DHCP option by typing a command using the following format:
    # dhtadm -D -s option-name -g

Modifying the DHCP Client's Option Information

If you add a new DHCP option to your DHCP server, you must add a complementary entry to each DHCP client's option information. If you have a client that is not a DHCP client, refer to that client's documentation for information about adding options or symbols.

On an DHCP client, you must edit the /etc/dhcp/inittab file and add an entry for each option that you add to the DHCP server. If you later modify the option on the server, you must also modify the entry in the client's /etc/dhcp/inittab file.

Refer to the dhcp_inittab(4) man page for detailed information about the syntax of the /etc/dhcp/inittab file.


Note - If you added DHCP options to the dhcptags file in a previous Oracle Solaris release, you must add the options to the /etc/dhcp/inittab file. See DHCP Option Information for more information.