1 <!--
   2   -- ident      "%W%    %E% SMI"
   3   --
   4     Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
   5     Use is subject to license terms.
   6 
   7     CDDL HEADER START
   8 
   9     The contents of this file are subject to the terms of the
  10     Common Development and Distribution License, Version 1.0 only
  11     (the "License").  You may not use this file except in compliance
  12     with the License.
  13 
  14     You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  15     or http://www.opensolaris.org/os/licensing.
  16     See the License for the specific language governing permissions
  17     and limitations under the License.
  18 
  19     When distributing Covered Code, include this CDDL HEADER in each
  20     file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  21     If applicable, add the following below this CDDL HEADER, with the
  22     fields enclosed by brackets "[]" replaced with your own identifying
  23     information: Portions Copyright [yyyy] [name of copyright owner]
  24 
  25     CDDL HEADER END
  26   -- All rights reserved.
  27   -->
  28 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
  29 <html>
  30 
  31 <head>
  32 <title>DHCP Manager Help: How To... Servers and Relays</title>
  33 <meta NAME="AUTHOR" CONTENT="smorgan">
  34 <meta NAME="KEYWORDS" CONTENT="DHCP">
  35 
  36 </head>
  37 
  38 <body bgcolor="#FFFFFF">
  39 
  40 <a name="top"></a>
  41 
  42 <table border=0 cellspacing=0 cellpadding=0 width=615>
  43 
  44 <!-- Start navigation banner -->
  45 
  46 <tr><td colspan=4  WIDTH="615" align="center" valign="top"><IMG SRC="art/bannersmc.gif" WIDTH=615 BORDER=0 ALT="DHCP Manager Help">
  47 
  48         </td>
  49         </tr>
  50 
  51 <!-- End navigation banner -->
  52 
  53 
  54 <tr>
  55 
  56 <!-- Start contents block -->
  57 
  58         <td colspan=1 valign="top" width=105>
  59         <P>&nbsp;</P>
  60         <A HREF="dhcp_main_top.html"><STRONG>Overview</STRONG></A><P>
  61         <A HREF="dhcp_relay_ref.html"><STRONG>Servers and Relays</STRONG></A><P>
  62         <A HREF="dhcp_addr_ref.html"><STRONG>IP Addresses</STRONG></A><P>
  63         <A HREF="dhcp_macro_ref.html"><STRONG>Macros</STRONG></A><P>
  64         <A HREF="dhcp_option_ref.html"><STRONG>Options</STRONG></A><P>
  65                 
  66         <A HREF="dhcp_main_how.html"><STRONG>How To..</STRONG></A><BR>
  67 <IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT="">Servers and Relays<BR>
  68 &nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#srvr"><EM>Configure DHCP</EM></A><BR>
  69 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#relay"><EM>Configure BOOTP</EM></a><BR>
  70 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#ntwrk"><EM>Configure Network</EM></a><BR>
  71 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#delnet"><EM>Delete Network</EM></a><BR>
  72 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#adv"><EM>Customize Service</EM></a><BR>
  73 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#start"><EM>Start/Stop/Restart</EM></a><BR>
  74 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#dis"><EM>Enable/Disable</EM></a><BR>
  75 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#exp"><EM>Export/Import</EM></a><BR>
  76 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#conv"><EM>Convert Data Store</EM></a><BR>
  77 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#uncon"><EM>Unconfigure DHCP</EM></a><BR>
  78 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#uncon2"><EM>Unconfigure BOOTP</EM></a><BR>
  79 &nbsp;&nbsp;<A HREF="dhcp_addr_how.html">Addresses</A><BR>
  80 &nbsp;&nbsp;<A HREF="dhcp_macro_how.html">Macros</A><BR>
  81 &nbsp;&nbsp;<A HREF="dhcp_option_how.html">Options</A><P>
  82 
  83 <A HREF="dhcp_main_idx.html"><STRONG>Index</STRONG></A>
  84         
  85                 </td>
  86         
  87 <!-- End contents block -->
  88 
  89 <!-- Start column rule -->
  90 
  91         <td colspan=1 width=5 bgcolor="#CCCCCC">&nbsp;</td>
  92 
  93 <!-- End column spacer -->
  94 
  95 <!-- Start column spacer -->
  96 
  97         <td colspan=1 width=10 bgcolor="#FFFFFF">&nbsp;</td>
  98 
  99 <!-- End column spacer -->
 100 
 101 
 102 
 103 <!-- Start topic block -->
 104 
 105 <td colspan=1 valign="top" bgcolor="#ffffff">
 106 
 107 
 108         
 109 <P>&nbsp;</P>
 110 <H1>How To: Servers and Relays</H1>
 111 
 112 <strong><big><a name="srvr">Configure a DHCP Server</A></big></strong><P>
 113 When you start DHCP Manager on a Solaris system that has not been configured as either a DHCP server or as a BOOTP relay agent, the Choose Server Configuration dialog box is displayed.  You can choose to configure a server as either a DHCP server or as a BOOTP relay agent, but not both.<p>
 114 <OL>
 115 <LI><STRONG>Select Configure as DHCP Server.</STRONG><BR> 
 116 The DHCP Server Configuration Wizard starts.<P></LI>
 117 <LI><STRONG>Step through the configuration, providing the <A HREF="dhcp_config_wiz.html">information</A> requested.</STRONG><BR>
 118 When the configuration is completed, the DHCP server starts.
 119 </LI>
 120 </OL>
 121 <P>
 122 To change any of the configuration parameters, you can later <a href="dhcp_macro_how.html#modmacro">modify</a> the macros containing the configuration parameters.  Alternatively, you can <A href="#uncon">unconfigure</A> the server and then use the Configuration Wizard to reconfigure the server.<P>
 123 To customize <A HREF="#adv">DHCP services</A>, select Modify from the Services menu.<P>
 124 
 125 <HR NOSHADE><P>
 126 <strong><big><A NAME="relay">Configure a BOOTP Relay Agent</A></big></strong><P>
 127 When you start DHCP Manager on a Solaris system that has not been configured as either a DHCP server or as a BOOTP relay agent, the Choose Server Configuration dialog box is displayed.  You can choose to configure a server as either a DHCP server or as a BOOTP relay agent, but not both.<p>
 128 <OL>
 129 <LI><STRONG>Select Configure as BOOTP Relay.</STRONG><BR>
 130 The Configure BOOTP Relay dialog box is displayed.<P></LI>
 131 
 132 <LI><STRONG>Enter DHCP servers.</STRONG><BR>
 133 Type the names or IP addresses of one or more DHCP servers to which to relay configuration requests, and click OK.
 134 <p>
 135 </LI>
 136 </OL>
 137 When the configuration is completed, the BOOTP relay agent starts.<P>
 138 To customize <A HREF="#adv">BOOTP relay services</A>, select Modify from the Services menu.<P>
 139 <HR NOSHADE>
 140 <P>
 141 <big><STRONG><A NAME="ntwrk">Configure a Network</A></STRONG></big><p>
 142 When you first configure the DHCP server, the Configuration Wizard configures the first network.  To add additional networks, follow these steps.<P>
 143 <OL>
 144 <LI><STRONG>Choose Network Wizard from the Edit menu of the View Addresses window.</STRONG><P></LI>
 145 <LI><STRONG>Enter configuration <A HREF="dhcp_net_wiz.html">information</A> for the new network.</STRONG><P></LI>
 146 <LI><STRONG>Click OK to confirm your action.</STRONG><P></LI>
 147 </OL>
 148 <HR NOSHADE>
 149 <P>
 150 <big><STRONG><A NAME="delnet">Delete a Network</A></STRONG></big><p>
 151 To delete a network is to remove it from the list of networks monitored by the DHCP server.
 152 <P>
 153 <OL>
 154 <LI><STRONG>Click the Addresses tab and choose Delete Network from the Edit menu.</STRONG><BR>
 155 The Delete Network dialog box is displayed. Configured networks are listed in the Keep Networks list. <P></LI>
 156 <LI><STRONG>Select the network to delete and use the arrow keys to move it to the Delete Networks list.</STRONG><P></LI>
 157 <LI><STRONG>Click OK to confirm your actions.</STRONG><P></LI>
 158 </OL>
 159 You cannot add a network using this dialog box.  To add or restore a network to the DHCP server's list of monitored networks, you must <a href="#ntwrk">configure the network</a>. <P>
 160 <HR NOSHADE>
 161 <P>
 162 <big><STRONG><A NAME="adv">Customize Services</A></STRONG></big><p>
 163 You can configure DHCP or BOOTP services for your server or BOOTP relay agent.
 164 <P><OL>
 165 <LI><STRONG>Choose Modify from the Services menu.</STRONG><br></LI>
 166 The Modify Service Options dialog is displayed.
 167 <LI><P><STRONG>Enter configuration information</strong><BR>
 168 Use the Modify Service Options dialog to customize the <A HREF="dhcp_server_serv.html">DHCP</A> or <A HREF="dhcp_relay_serv.html">Relay</A> services.<P>
 169 You can configure options such as BOOTP compatibility mode (for the DHCP server) or modify the list of DHCP servers to which to forward requests (relay agent).<P></LI>
 170 <LI><STRONG>Click OK.</STRONG></LI>
 171 </OL><P>
 172 
 173 <HR NOSHADE><P>
 174 <strong><big><A NAME="start">Start, Stop, or Restart a Server or Relay Agent</A></big></strong><p>
 175 The DHCP server or BOOTP relay agent starts
 176 automatically when you have completed the
 177 initial configuration. You can stop or start the service by
 178 choosing Stop or Start from the Services menu. This is analogous
 179 to running the <tt>/etc/init.d/dhcp</tt>
 180 script with the <tt>stop</tt> or <tt>start</tt> command.<P>
 181 
 182         <ol type=1>
 183         
 184         <li><STRONG>Choose the Services menu in the main window.</STRONG><p></LI>
 185         <li><STRONG>Choose Start, Stop, or Restart from the Service
 186 menu.</STRONG>
 187         <TABLE BORDER="0" CELLSPACING="3" CELLPADDING="3" COLS="2">
 188         
 189 <TR ALIGN="LEFT" VALIGN="TOP">
 190         <TD WIDTH="60" ALIGN="LEFT" VALIGN="TOP"><STRONG>Start</STRONG></TD>
 191         <TD ALIGN="LEFT" VALIGN="TOP">Click Start to start DHCP or BOOTP relay
 192 service that has been stopped.</TD>
 193         </TR>
 194         
 195         <TR ALIGN="LEFT" VALIGN="TOP">
 196         <TD WIDTH="60" ALIGN="LEFT" VALIGN="TOP"><STRONG>Stop</STRONG></TD>
 197         <TD ALIGN="LEFT" VALIGN="TOP">Click Stop to stop the DHCP or
 198 BOOTP daemon.</TD>
 199         </TR>
 200 
 201 <TR ALIGN="LEFT" VALIGN="TOP">
 202         <TD WIDTH="60" ALIGN="LEFT" VALIGN="TOP"><STRONG>Restart</STRONG></TD>
 203         <TD ALIGN="LEFT" VALIGN="TOP">Click Restart to force the DHCP server to reread the <tt>dhcptab</tt>.</TD>
 204         </TR>
 205 
 206         </TABLE></LI>
 207         <LI><STRONG>Click OK to confirm your actions.</STRONG></LI>
 208 
 209         </ol><P>
 210         
 211         <HR NOSHADE><P>
 212 <strong><big><A NAME="dis">Enable or Disable a Server or Relay Agent</A></big></strong><p>
 213 Disabling DHCP stops the DHCP daemon and removes it from the boot sequence. When the DHCP service is disabled, it will not start automatically when you reboot the server.<P>
 214 Enabling DHCP starts the DHCP daemon and restores it to the boot sequence.<P>
 215 
 216         <ol type=1>
 217         
 218         <li><STRONG>Choose the Services menu in the main window.</STRONG><p></LI>
 219         <li><STRONG>Choose Enable or Disable from the Services menu.</STRONG>
 220         <TABLE BORDER="0" CELLSPACING="3" CELLPADDING="3"  COLS="2">
 221         
 222 <TR ALIGN="LEFT" VALIGN="TOP">
 223         <TD WIDTH="60" ALIGN="LEFT" VALIGN="TOP"><STRONG>Enable</STRONG></TD>
 224         <TD ALIGN="LEFT" VALIGN="TOP">Click Enable to restore a DHCP service that has been disabled.</TD>
 225         </TR>
 226         
 227         <TR ALIGN="LEFT" VALIGN="TOP">
 228         <TD WIDTH="60" ALIGN="LEFT" VALIGN="TOP"><STRONG>Disable</STRONG></TD>
 229         <TD ALIGN="LEFT" VALIGN="TOP">Click Disable to remove DHCP service from the boot sequence.</TD>
 230         </TR>
 231 
 232         </TABLE></LI>
 233         <LI><STRONG>Click OK to confirm your actions.</STRONG></LI>
 234         </OL>
 235 
 236         <HR NOSHADE><P>
 237 <STRONG><big><a name="exp">Export Data From a DHCP Server</a></BIG></STRONG><p>
 238 If you want to move IP addresses, macros, or options to another Solaris DHCP server, you must first export the data from the owning DHCP server. <p>
 239 <ol>
 240 <li><Strong>From the Services menu, choose Export Data.</strong><BR>
 241 The Export Data wizard is displayed.<p></li>
 242 <li><strong>Answer the <a href="dhcp_export_wiz.html">prompts</a> to indicate what you want to export.</strong><p></li>
 243 <li><strong>Click OK to confirm your actions.</strong></li></ol>
 244 
 245 <HR NOSHADE><P>
 246 <STRONG><big><a name="imp">Import Data to a DHCP Server</a></BIG></STRONG><p>
 247 After exporting IP addresses, macros, or options from a DHCP server, you can import it to another Solaris DHCP server.  <p>
 248 <ol>
 249 <li><Strong>From the Services menu, choose Import Data.</strong><BR>
 250 The Import Data wizard is displayed.<p></li>
 251 <li><strong>Type the full path to the file containing the data you want to import to
 252         this DHCP server. </strong><P>This file must have been created by exporting data from a Solaris DHCP server.<p></li>
 253 <li><strong>Choose Overwrite Existing Data if you want conflicting information on the new server to be replaced with data being imported.</strong><p>
 254 If the DHCP server on which
 255         you are importing data has configuration data
 256         for any of the same networks, IP addresses,
 257         macros, or options being imported, that data will be 
 258         replaced with the imported data when
 259         you select this option. By default,
 260         conflicting data will not be overwritten.<p> 
 261 <li><strong>Click OK to confirm your actions.</strong></li></ol>
 262         
 263 <HR NOSHADE> <P>
 264 <STRONG><BIG><a name="conv">Convert to a New Data Store</a></BIG></STRONG><p>
 265 The Solaris DHCP service supports several data stores, which are designed for use by 
 266 sites with varying requirements. <p>
 267 You may need to convert to a new data store if, for
 268 example, your number of DHCP clients increases to the point that you need higher
 269 performance or higher capacity from the DHCP service, or if you want to share the
 270 DHCP server duties among multiple servers.<p>
 271 <ol>
 272 <li><Strong>From the Services menu, choose Convert Data Store.</strong><BR>
 273 The Data Store Conversion wizard is displayed.<p></li>
 274 <li><strong>Answer the <a href="dhcp_convert_wiz.html">prompts</a> to indicate what you want to export.</strong><p></li>
 275 <li><strong>Click OK to confirm your actions.</strong></li></ol>
 276 
 277 
 278 <HR NOSHADE><P>     
 279 <STRONG><BIG><a name="#uncon">Unconfigure a DHCP Server</a></BIG></STRONG><p>
 280 If you no longer want the DHCP server to run on this machine, you can unconfigure the DHCP server.  Be sure that responsibility for the addresses owned by the server has been transferred to another DHCP server before you unconfigure the server.  See <a href="#exp">Export Data From a DHCP Server</a><P>
 281 <OL>
 282 <LI><STRONG>From the Services menu, choose Unconfigure.</STRONG><BR>
 283 The Unconfigure Service dialog box is displayed.<p></li>
 284 
 285 <LI><STRONG>Choose one or both options.</STRONG>
 286 
 287 <TABLE BORDER="0" CELLSPACING="3" CELLPADDING="3" COLS="2">
 288         
 289 <TR ALIGN="LEFT" VALIGN="TOP">
 290         <TD WIDTH="160" ALIGN="LEFT" VALIGN="TOP"><STRONG>Remove <tt>dhcptab</tt> and all DHCP network tables</STRONG></TD>
 291         <TD ALIGN="LEFT" VALIGN="TOP">Use this option with caution. If you use NIS+, removing these tables may cause a problem for other DHCP servers that share these databases.</TD>
 292         </TR>
 293         <TR ALIGN="LEFT" VALIGN="TOP">
 294         <TD WIDTH="160" ALIGN="LEFT" VALIGN="TOP"><STRONG>Remove all hosts table entries for DHCP addresses</STRONG>
 295         </TD>
 296 
 297 <TD>Check this box to also remove entries from the server's hosts name service.</TD></TR>
 298 </table>
 299 </LI>
 300 <LI><STRONG>Click OK to confirm your actions.</STRONG></LI>
 301 </OL> 
 302  <P><HR NOSHADE><P>
 303  <STRONG><BIG><a name="uncon2">Unconfigure a BOOTP Relay Agent</a></BIG></STRONG><p>
 304 <OL>
 305 <LI><STRONG>From the Services menu, choose Unconfigure.</STRONG><BR>
 306 The Unconfigure Service dialog box is displayed.<p></li>
 307 <LI><STRONG>Click OK to confirm your actions.</STRONG></LI>
 308 </OL> 
 309  <P>
 310 &nbsp;&nbsp;&nbsp;<A HREF="#top"><small>return to top</small></A>
 311 <p>&nbsp;</p>
 312 
 313 <!-- Don't go past this line! -->
 314 
 315         </td>
 316 
 317 <!-- End topic block -->
 318 
 319 </tr>
 320 
 321 </table>
 322 
 323 <!-- End topic table -->
 324 
 325 </body>
 326 </html>