Moving Configuration Data Between DHCP Servers (Task Map)

DHCP Manager and the dhcpconfig utility enable you to move some or all the DHCP configuration data from one Solaris DHCP server to another server. You can move entire networks and all the IP addresses, macros, and options associated with the networks. Alternatively, you can select specific IP addresses, macros, and options to move. You can also copy macros and options without removing the macros and options from the first server.

You might want to move data if you are going to do any of the following tasks:

• Add a server to share DHCP duties.

• Replace the DHCP server's system.

• Change the path for the data store, while still using the same data store.

The following task map identifies the procedures that you must perform when you move DHCP configuration data.

Task	Description	For Instructions
1. Export the data from the first server.	Select the data that you want to move to another server, and create a file of exported data.	How to Export Data From a DHCP Server (DHCP Manager) How to Export Data From a DHCP Server (dhcpconfig -X)
2. Import the data to the second server.	Copy exported data to another DHCP server's data store.	How to Import Data on a DHCP Server (DHCP Manager) How to Import Data on a DHCP Server (dhcpconfig -I)
3. Modify the imported data for the new server environment.	Change server-specific configuration data to match the new server's information.	How to Modify Imported DHCP Data (DHCP Manager) How to Modify Imported DHCP Data (pntadm, dhtadm)

In DHCP Manager, you use the Export Data wizard and the Import Data wizard to move the data from one server to the other server. You then modify macros in the Macros tab. The following figures show the initial dialog boxes for the wizards.

Figure 15-20 Export Data Wizard Dialog Box in DHCP Manager

Figure 15-21 Import Data Wizard Dialog Box in DHCP Manager

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

1. Start DHCP Manager on the server from which you want to move or copy data.

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

2. Choose Export Data from the Service menu.

   The Export Data wizard opens as shown in Figure 15-20.

3. Answer the wizard's prompts.

   If you have difficulty, click Help for detailed information about the prompts.

4. Move the export file to a file system that is accessible to the DHCP server that must import the data.

See Also

Import the data as described in How to Import Data on a DHCP Server (DHCP Manager).

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

1. Log in to the server from which you want to move or copy data.
2. 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 Configuring RBAC (Task Map) in System Administration Guide: Security Services.

3. Export the data.

   You can export all of the DHCP data, or specific parts of the data.

   • To export specific addresses, macros, and options, type a command that uses the following format:

     # dhcpconfig -X filename -a network-addresses -m macros -o options

     filename is the full path name that you want to use to store the compressed exported data. You specify particular network addresses, DHCP macros, and DHCP options in comma-separated lists. The following example shows how to export specific networks, macros, and options.

     # dhcpconfig -X /var/dhcp/0dhcp1065_data \ -a 10.63.0.0,10.62.0.0 \ -m 10.63.0.0,10.62.0.0,SUNW.Sun-Blade-100 -o Sterm
   • To export all DHCP data, type a command that uses the ALL keyword.

     # dhcpconfig -X filename -a ALL -m ALL -o ALL

     filename is the full path name that you want to use to store the compressed exported data. The keyword ALL can be used with the command options to export all the network addresses, macros, or options. The following example shows how to use the ALL keyword.

     # dhcpconfig -X /var/dhcp/dhcp1065_data -a ALL -m ALL -o ALL

   ---

   Tip - You can omit the export of a particular kind of data by not specifying the dhcpconfig command option for that type of data. For example, if you do not specify the -m option, no DHCP macros are exported.

   ---

   See the dhcpconfig(1M) man page for more information about the dhcpconfig command.

4. Move the export file to a location that is accessible to the server that must import the data.

See Also

Import the data as described in How to Import Data on a DHCP Server (dhcpconfig -I).

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

1. Start DHCP Manager on the server to which you want to move data that you previously exported from a DHCP server.

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

2. Choose Import Data from the Service menu.

   The Import Data wizard opens, as shown in Figure 15-21.

3. Answer the wizard's prompts.

   If you have difficulty, click Help for detailed information about the prompts.

4. Modify the imported data, if necessary.

   See How to Modify Imported DHCP Data (DHCP Manager)

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

1. Log in to the server to which you want to import the data.
2. 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 Configuring RBAC (Task Map) in System Administration Guide: Security Services.

3. Import the data by typing a command of the following format:

   # dhcpconfig -I filename

   filename is the name of the file that contains the exported data.

4. Modify the imported data, if necessary.

   See How to Modify Imported DHCP Data (pntadm, dhtadm).

How to Modify Imported DHCP Data (DHCP Manager)

1. Start DHCP Manager on the server to which you imported data.

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

2. Examine imported data for network-specific information that needs modification.

   For example, if you moved networks, you must open the Addresses tab and change the owning server of addresses in the imported networks. You might also need to open the Macros tab to specify the correct domain names for NIS, NIS+ or DNS in some macros.

3. Open the Addresses, tab and select a network that you imported.
4. To select all the addresses, click the first address, press and hold the Shift key, and click the last address.
5. From the Edit menu, choose Properties.

   The Modify Multiple Addresses dialog box opens.

6. At the Managing Server prompt, select the new server's name.
7. At the Configuration Macro prompt, select the macro that should be used for all clients on this network, and then click OK.
8. Open the Macros tab.
9. Use the Find button to locate the options that are likely to need modified values.

   The Find button is located at the bottom of the window.

   DNSdmain, DNSserv, NISservs, NIS+serv, and NISdmain are examples of options that might need modification on the new server.

10. Change the options in the appropriate macros.

    See How to Modify DHCP Option Properties (DHCP Manager) for the procedure for changing options.

How to Modify Imported DHCP Data (pntadm, dhtadm)

1. Log in to the server to which you imported data.
2. 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 Configuring RBAC (Task Map) in System Administration Guide: Security Services.

3. Examine the network tables for data that needs to be modified.

   If you moved networks, use the pntadm -P network-address command to print out the network tables for the networks you moved.

4. Modify IP address information by using the pntadm command.

   You might need to change the owning server and the configuration macro for imported addresses. For example, to change the owning server (10.60.3.4) and macro (dhcpsrv-1060) for address 10.63.0.2, you would use the following command:

   pntadm -M 10.63.0.2 -s 10.60.3.4 -m dhcpsrv-1060 10.60.0.0

   If you have a large number of addresses, you should create a script file that contains commands to modify each address. Execute the script with the pntadm -B command, which runs pntadm in batch mode. See the pntadm(1M) man page.

5. Examine the dhcptab macros for options with values that need modification.

   Use the dhtadm -P command to print the entire dhcptab table to your screen. Use grep or some other tool to search for options or values that you might want to change.

6. Modify options in macros, if necessary, by using the dhtadm -M command.

   For example, you might need to modify some macros to specify the correct domain names and servers for NIS, NIS+ or DNS. For example, the following command changes the values of DNSdmain and DNSserv in the macro mymacro:

   dhtadm -M -m mymacro -e 'DNSserv=dnssrv2:DNSdmain=example.net' -g