source: trunk/pxeconfig/INSTALL @ 6

Last change on this file since 6 was 6, checked in by sscpbas, 21 years ago

Added the license info to each utility and fix and error in the getopt
handling for pxeconfig utility

File size: 2.5 KB
1Here follow some basic installations instructions.
3To activate the 'pxeconfigd' daemon the following actions are required:
4 1) edit '/etc/services', eg:
5      pxeconfigd      10000/tcp                       # pxe config daemon
7 2) edit '/etc/inetd.conf', eg
8      pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
9        /usr/sara/sbin/pxeconfigd
11    NOTE: the pxeconfigd can only be started from inetd!!!
13 3) kill -1 `pidof inetd` (Linux)
15 4) You can test it by:
16     telnet localhost pxeconfigd (or port number>
18     output:
19       Trying
20       Connected to localhost.
21       Escape character is '^]'.
22       ip =, hex = 7F000001
23       file = /tftpboot/pxelinux.cfg/7F000001
24       Connection closed by foreign host.
26     In syslog a line will be added if the removal is succesful:
27      Feb 20 09:32:40 test pxeconfigd: /tftpboot/pxelinux.cfg/7F000001
30 4) As you can see '/tftpboot/pxelinux.cfg/' is the default directory. If
31    you placed the config file some where else you can add the
32    '-d/--directory' option, eg:
33       pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
34        /usr/sara/sbin/pxeconfigd -d /<some>/<other>/<place>
37If the daemon works and you want to install/reinstall a node a link
38must be placed in the '/tftpboot/pxelinux.cfg' directory. This can
39be done with the 'pxeconfig' utility. This utility will ask some
40question and make the links for you. The utility require the following
42  1) All the pxe configuration files must start with preamble 'default.'
43     In this distribution two examples are included. Pxeconfig lets the
44     user decide witch 'default.' config file to use.
46  2) If default is a link to for example default.harddisk. Then
47     default.harddisk is not included in the list where the user can
48     choose from.
50  3) You can give command line switch to specifiy where the
51     pxe config files reside:
52        pxeconfig -d /<some>/<other>/<place>
54The last utility is 'hexls'. This utility will display the hex pxe config
55file with the corresponding ip-addres.
58To activate this on a client tou must add the this line to the 'master'
59script of the node. It will remove the pxe config file for the node
60on the bootserver. I personally place the line just before the network
61interface will be brought down:
62   # Remove the <hex_ipaddr> file from the pxelinux.cfg directory.
63   # So the client will boot from disk
64   #       
65   telnet $IMAGESERVER 10000
67Commens or Suggestions mail them to:
68 Bas van der Vlies <>
69 for more info about SARA
Note: See TracBrowser for help on using the repository browser.