xref: /dflybsd-src/libexec/bootpd/Problems (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino# $FreeBSD: src/libexec/bootpd/Problems,v 1.5 1999/08/28 00:09:15 peter Exp $
286d7f5d3SJohn Marino# $DragonFly: src/libexec/bootpd/Problems,v 1.2 2003/06/17 04:27:07 dillon Exp $
386d7f5d3SJohn Marino
486d7f5d3SJohn MarinoCommon problems and ways to work around them:
586d7f5d3SJohn Marino
686d7f5d3SJohn MarinoBootpd complains: "bind: Address already in use" and fails to start.
786d7f5d3SJohn Marino	You are already running something that has bound the
886d7f5d3SJohn Marino	BOOTP listening port number.  Check /etc/inetd.conf or
986d7f5d3SJohn Marino	the equivalent for a bootp line (or in startup files).
1086d7f5d3SJohn Marino
1186d7f5d3SJohn MarinoBootpd complains that it "can not get IP addr for HOSTNAME"
1286d7f5d3SJohn Marino
1386d7f5d3SJohn Marino	If the entry is a "dummy" (not a real host) used only for
1486d7f5d3SJohn Marino	reference by other entries, put '.' in front of the name.
1586d7f5d3SJohn Marino
1686d7f5d3SJohn Marino	If the entry is for a real client and the IP address for
1786d7f5d3SJohn Marino	the client can not be found using gethostbyname(), specify
1886d7f5d3SJohn Marino	the IP address for the client using numeric form.
1986d7f5d3SJohn Marino
2086d7f5d3SJohn MarinoBootpd takes a long time to finish parsing the bootptab file:
2186d7f5d3SJohn Marino
2286d7f5d3SJohn Marino	Excessive startup time is usually caused by waiting for
2386d7f5d3SJohn Marino	timeouts on failed DNS lookup operations.  If this is the
2486d7f5d3SJohn Marino	problem, find the client names for which DNS lookup fails
2586d7f5d3SJohn Marino	and change the bootptab to specify the IP addresses for
2686d7f5d3SJohn Marino	those clients using numeric form.
2786d7f5d3SJohn Marino
2886d7f5d3SJohn Marino	When bootptab entries do not specify an ip address, bootpd
2986d7f5d3SJohn Marino	attempts to lookup the tagname as a host name to find the
3086d7f5d3SJohn Marino	IP address.  To suppress this default action, either make
3186d7f5d3SJohn Marino	the entry a "dummy" or specify its IP numeric address.
3286d7f5d3SJohn Marino
3386d7f5d3SJohn Marino	If your DNS lookups work but are just slow, consider either
3486d7f5d3SJohn Marino	running bootpd on the same machine as the DNS server or
3586d7f5d3SJohn Marino	running a caching DNS server on the host running bootpd.
3686d7f5d3SJohn Marino
3786d7f5d3SJohn MarinoMy huge bootptab file causes startup time to be so long that clients
3886d7f5d3SJohn Marinogive up waiting for a reply.
3986d7f5d3SJohn Marino
4086d7f5d3SJohn Marino	Truly huge bootptab files make "inetd" mode impractical.
4186d7f5d3SJohn Marino	Start bootpd in "standalone" mode when the server boots.
4286d7f5d3SJohn Marino
4386d7f5d3SJohn Marino	Another possibility is to run one bootpd on each network
4486d7f5d3SJohn Marino	segment so each one can have a smaller bootptab.  Only one
4586d7f5d3SJohn Marino	instance of bootpd may run on one server, so you would need
4686d7f5d3SJohn Marino	to use a different server for each network segment.
4786d7f5d3SJohn Marino
4886d7f5d3SJohn MarinoMy bootp clients are given responses with a boot file name that is
4986d7f5d3SJohn Marinonot a fully specified path.
5086d7f5d3SJohn Marino
5186d7f5d3SJohn Marino	Make sure the TFTP directory or home directory tags are set:
5286d7f5d3SJohn Marino	:td=/tftpboot:	(or)
5386d7f5d3SJohn Marino	:hd=/usr/boot:	(for example)
5486d7f5d3SJohn Marino
5586d7f5d3SJohn MarinoMy PC clients running Sun's PC-NFS Pro v1.1 fail to receive
5686d7f5d3SJohn Marinoacceptable responses from the bootp server.
5786d7f5d3SJohn Marino
5886d7f5d3SJohn Marino	These clients send a request with the DHCP "message length"
5986d7f5d3SJohn Marino	option and the (new) BOOTP "broadcast flag" both set.
6086d7f5d3SJohn Marino	The bootp server (on SunOS) will send a fragmented reply
6186d7f5d3SJohn Marino	unless you override the length with :ms=1024: (or less).
6286d7f5d3SJohn Marino	The "broadcast flag" is not yet supported, but there is
6386d7f5d3SJohn Marino	a simple work-around, just add :ra=255.255.255.255:
6486d7f5d3SJohn Marino	for any clients that need their reply broadcasted.
6586d7f5d3SJohn Marino	You may need to use a differnet broadcast address.
6686d7f5d3SJohn Marino	(Thanks to Ivan Auger <ivan.auger@wadsworth.org>)
6786d7f5d3SJohn Marino
68