manpages.info - online man pages   

SunOS man pages : dhcpconfig (1)

Maintenance Commands                               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: SunOS 5.8 Last change: 13 Mar 2001 1 Maintenance Commands dhcpconfig(1M) __________________________________________________________________________ | 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 will not be deleted even if -k sub-option is not specified. -u uninterpreted SunOS 5.8 Last change: 13 Mar 2001 2 Maintenance Commands dhcpconfig(1M) Data which will be ignored by dhcpconfig, but passed on to the datastore for interpretation. This might be used for a database account name or other authentication or authorization parame- ters required by a particular data store. The -u sub-option is not used with the SUNWfiles, SUNWbinfiles, and SUNWnisplus 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. SunOS 5.8 Last change: 13 Mar 2001 3 Maintenance Commands dhcpconfig(1M) -u uninterpreted Data which will be ignored by dhcpconfig, but passed on to the datastore for interpretation. This might be used for a database account name or other authentication or authorization parame- ters required by a particular data store. The -u sub-option is not used with the SUNWfiles, SUNWbinfiles, and SUNWnisplus 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 will be set. -y NIS_domain_name If NIS is used on this network, specify the NIS domain name. SunOS 5.8 Last change: 13 Mar 2001 4 Maintenance Commands dhcpconfig(1M) -R server_addresses Configure the BOOTP relay service. BOOTP or DHCP requests are forwarded to the list of servers speci- fied. -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 SunOS 5.8 Last change: 13 Mar 2001 5 Maintenance Commands dhcpconfig(1M) 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 will forward 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 SunOS 5.8 Last change: 13 Mar 2001 6 Maintenance Commands dhcpconfig(1M) 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), attributes(5) , dhcp(5), dhcp_modules(5), rbac(5) System Administration Guide, Volume 3 SunOS 5.8 Last change: 13 Mar 2001 7