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>
113When 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>
116The 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>
118When the configuration is completed, the DHCP server starts.
119</LI>
120</OL>
121<P>
122To 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>
123To 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>
127When 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>
130The Configure BOOTP Relay dialog box is displayed.<P></LI>
131
132<LI><STRONG>Enter DHCP servers.</STRONG><BR>
133Type 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>
137When the configuration is completed, the BOOTP relay agent starts.<P>
138To 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>
142When 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>
151To 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>
155The 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>
159You 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>
163You 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>
166The Modify Service Options dialog is displayed.
167<LI><P><STRONG>Enter configuration information</strong><BR>
168Use 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>
169You 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>
175The DHCP server or BOOTP relay agent starts
176automatically when you have completed the
177initial configuration. You can stop or start the service by
178choosing Stop or Start from the Services menu. This is analogous
179to running the <tt>/etc/init.d/dhcp</tt>
180script 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
186menu.</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
192service 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
198BOOTP 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>
213Disabling 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>
214Enabling 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>
238If 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>
241The 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>
247After 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>
250The 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>
254If 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>
265The Solaris DHCP service supports several data stores, which are designed for use by
266sites with varying requirements. <p>
267You may need to convert to a new data store if, for
268example, your number of DHCP clients increases to the point that you need higher
269performance or higher capacity from the DHCP service, or if you want to share the
270DHCP server duties among multiple servers.<p>
271<ol>
272<li><Strong>From the Services menu, choose Convert Data Store.</strong><BR>
273The 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>
280If 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>
283The 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>
306The 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>
327