dhcpconfig(1M)
NAME
dhcpconfig - DHCP service configuration utility
SYNOPSIS
dhcpconfig -D -r resource -p path [-u uninterpreted] [-
l lease_length] [-n ] [-d DNS_domain] [-
a DNS_server_addresses] [-h hosts_resource] [-
y hosts_domain]
dhcpconfig -R server_addresses
dhcpconfig -U [-f] [-x] [-h]
dhcpconfig -N network_address [-m subnet_mask] [-b ] [-
t router_addresses] [-y NIS-domain] [-
a NIS_server_addresses]
dhcpconfig -C -r resource -p path [-f] [-k] [-
u uninterpreted]
dhcpconfig -X filename [-m macro_list] [-o option_list] [-
a network_addresses] [-f] [-x]
dhcpconfig -I filename [-f]
DESCRIPTION
The dhcpconfig command is used to configure and manage the
Dynamic Host Configuration Protocol (DHCP) service or BOOTP
relay services. It is intended for use by experienced
Solaris system administrators and is designed for ease of
use in scripts. The dhcpmgr utility is recommended for less
experienced administrators or those preferring a graphical
utility to configure and manage the DHCP service or BOOTP
relay service.
The dhcpconfig command can be run by root, or by other users
assigned to the DHCP Management profile. See rbac(5) and
user_attr(4).
dhcpconfig requires one of the following function flags: -D,
-R, -U, -N, -C, -X, or -I.
The dhcpconfig menu driven mode is supported in Solaris 8
and previous versions of Solaris.
Where dhcpconfig Obtains Configuration Information
dhcpconfig scans various configuration files on your Solaris
machine for information it can use to assign values to
options contained in macros it adds to the dhcptab confi-
guration table. The following table lists information
dhcpconfig needs, the source used, and how the information
is used:
__________________________________________________________________________
| Information | Source | Where Used |
| Timezone | System date, timezone settings | Locale macro |
| DNS parameters| nsswitch.conf, /etc/resolv.conf| Server macro |
| NIS parameters| System domainname,| Network macros |
| | nsswitch.conf, NIS | |
| Subnetmask | Network interface, netmasks| Network macros |
| | table in nameservice | |
|_______________|_________________________________|_______________________|
If you have not set these parameters on your server machine,
you should do so before configuring the DHCP server with
dhcpconfig. Note that if you specify options with the
dhcpconfig -D command line, the values you supply override
the values obtained from the system files.
OPTIONS
The following options are supported:
-C Convert to using a new data store, recreating the DHCP
data tables in a format appropriate to the new data
store, and setting up the DHCP server to use the new
data store.
The following sub-options are required:
-p path_to_data
The paths for SUNWfiles and SUNWbinfiles must be
absolute UNIX pathnames. The path for SUNWn-
isplus must be a fully specified NIS+ directory
(including the tailing period.) See
dhcp_modules(5).
-r data_resource
New data store resource. One of the following
must be specified: SUNWfiles, SUNWbinfiles, or
SUNWnisplus. See dhcp_modules(5).
The following sub-options are optional:
-f Do not prompt for confirmation. If -f is not
used, a warning and confirmation prompt are
issued before the conversion starts.
-k Keep the old DHCP data tables after successful
conversion. If any problem occurs during conver-
sion, tables are not deleted even if -k sub-
option is not specified.
-u uninterpreted
Data which is ignored by dhcpconfig, but passed
on to the datastore for interpretation. The
private layer provides for module-specific con-
figuration information through the use of the
RESOURCE_CONFIG keyword. Uninterpreted data is
stored within RESOURCE_CONFIG keyword of
dhcpsvc.conf(4). The -u sub-option is not used
with the SUNWfiles, SUNWbinfiles, and SUNWn-
isplus data stores. See dhcp_modules(5).
-D Configure the DHCP service.
The following sub-options are required:
-r data_resource
One of the following must be specified:
SUNWfiles, SUNWbinfiles, or SUNWnisplus. Other
data stores may be available.See
dhcp_modules(5).
-p path
The paths for SUNWfiles and SUNWbinfiles must be
absolute UNIX pathnames. The path for SUNWn-
isplus must be a fully specified NIS+ directory
(including the tailing period.) . See
dhcp_modules(5).
The following sub-options are optional:
-a DNS_servers
IP addresses of DNS servers, separated with com-
mas.
-d DNS_domain
DNS domain name.
-h hosts_resource
Resource in which to place hosts data. Usually,
the name service in use on the server. Valid
values are nisplus, files, or dns.
-l seconds
Lease length used for addresses not having a
specified lease length, in seconds.
-n Non-negotiable leases
-y hosts_domain
DNS or NIS+ domain name to be used for hosts
data. Valid only if dns or nisplus is specified
for -h sub-option.
-u uninterpreted
Data which is ignored by dhcpconfig, but passed
on to the datastore for interpretation. The
private layer provides for module-specific con-
figuration information through the use of the
RESOURCE_CONFIG keyword. Uninterpreted data is
stored within RESOURCE_CONFIG keyword of
dhcpsvc.conf(4). The -u sub-option is not used
with the SUNWfiles, SUNWbinfiles, and SUNWn-
isplus data stores. See dhcp_modules(5).
-I filename
Import data from filename, containing data previously
exported from a Solaris DHCP server. Note that after
importing, you may have to edit macros to specify the
correct domain names, and edit network tables to
change the owning server of addresses in imported net-
works. Use dhtadm and pntadm to do this.
The following sub-option is supported:
-f Replace any conflicting data with the data being
imported.
-N net_address
Configure an additional network for DHCP service.
The following sub-options are supported:
-a NIS_server_addresses
List of IP addresses of NIS servers.
-b Network is a point-to-point (PPP) network,
therefore no broadcast address should be config-
ured. If -b is not used, the network is assumed
to be a LAN, and the broadcast address is deter-
mined using the network address and subnet mask.
-m xxx.xxx.xxx.xxx
Subnet mask for the network; if -m is not used,
subnet mask is obtained from netmasks.
-t router_addresses
List of router IP addresses; if not specified,
router discovery flag is set.
-y NIS_domain_name
If NIS is used on this network, specify the NIS
domain name.
-R server_addresses
Configure the BOOTP relay service. BOOTP or DHCP
requests are forwarded to the list of servers speci-
fied.
server_addresses is a comma separated list of host-
names and/or IP addresses.
-U Unconfigure the DHCP service or BOOTP relay service.
The following sub-options are supported:
-f Do not prompt for confirmation. If -f is not
used, a warning and confirmation prompt is
issued.
-h Delete hosts entries from name service.
-x Delete the dhcptab and network tables.
-X filename
Export data from the DHCP data tables, saving to
filename, to move the data to another Solaris DHCP
server.
The following sub-options are optional:
-a networks_to_export
List of networks whose addresses should be
exported, or the keyword ALL to specify all net-
works. If -a is not specified, no networks are
exported.
-m macros_to_export
List of macros to export, or the keyword ALL to
specify all macros. If -m is not specified, no
macros are exported.
-o options_to_export
List of options to export, or the keyword ALL to
specify all options. If -o is not specified, no
options are exported.
-x Delete the data from this server after it is
exported. If -x is not specified you are in
effect copying the data.
EXAMPLES
Example 1: Configuring DHCP Service with Binary Files Data
Store
The following command configures DHCP service, using the
binary files data store, in the DNS domain acme.eng, with a
lease time of 28800 seconds (8 hours),
example# dhcpconfig -D -r SUNWbinfiles -p /var/dhcp -l 28800 -d acme.eng
-a 120.30.33.4 -h dns -y acme.eng
Example 2: Configuring BOOTP Relay Agent
The following command configures the DHCP daemon as a BOOTP
relay agent, which forwards BOOTP and DHCP requests to the
servers having the IP addresses 120.30.33.7 and
120.30.42.132:
example# dhcpconfig -R 120.30.33.7,120.30.42.132
Example 3: Unconfiguring DHCP Service
The following command unconfigures the DHCP service, with
confirmation, and deletes the DHCP data tables and host
table entries:
example# dhcpconfig -U -x -h
Example 4: Configuring a Network for DHCP Service
The following command configures an additional LAN network
for DHCP service, specifying that clients should use router
discovery and providing the NIS domain name and NIS server
address:
example# dhcpconfig -N 120.30.171.0 -y east.acme.eng.com -a 120.30.33.4
Example 5: Converting to SUNWnisplus Data Store
The following command converts a DHCP server from using a
text or binary files data store to a NIS+ data store, delet-
ing the old data store's DHCP tables:
example# dhcpconfig -C -r SUNWnisplus -p whatever.com.
Example 6: Exporting a Network, Macros, and Options from a
DHCP Server
The following command exports one network (120.30.171.0) and
its addresses, the macro 120.30.171.0, and the options motd
and PSptrfrom a DHCP server, saves the exported data in file
/export/var/120301710_data, and deletes the exported data
from the server.
example# dhcpconfig -X /var/dhcp/120301710_export
-a 120.30.171.0 -m 120.30.171.0 -o motd,PSptr
Example 7: Importing Data on a DHCP Server
The following command imports DHCP data from a file,
/net/golduck/export/var/120301710_data, containing data pre-
viously exported from a Solaris DHCP server, and overwrites
any conflicting data on the importing server:
example# dhcpconfig -I /net/golduck/export/var/120301710_data -f
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWdhcsu |
|_____________________________|_____________________________|
| Interface Stability | Evolving |
|_____________________________|_____________________________|
SEE ALSO
dhcpmgr(1M), dhtadm(1M), in.dhcpd(1M), pntadm(1M),
dhcp_network(4), dhcptab(4), dhcpsvc.conf(4),
nsswitch.conf(4), resolv.conf(4), user_attr(4), attri-
butes(5), dhcp(5), dhcp_modules(5), rbac(5)
System Administration Guide: IP Services
Man(1) output converted with
man2html