source: trunk/pxeconfig/INSTALL @ 30

Last change on this file since 30 was 30, checked in by bas, 20 years ago

Updated the install instructions for systemimager 3.0

File size: 2.8 KB
1Here follow some basic installation 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
29 4) As you can see '/tftpboot/pxelinux.cfg/' is the default directory. If
30    you placed the config files somewhere else you can add the
31    '-d/--directory' option, eg:
32       pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
33        /usr/sara/sbin/pxeconfigd -d /<some>/<other>/<place>
35If the daemon works and you want to install/reinstall a node, a link
36must be placed in the '/tftpboot/pxelinux.cfg' directory. This can
37be done with the 'pxeconfig' utility. This utility will ask some
38questions and will make the links for you. The utility requires the following
40  1) All the pxe configuration files must start with the keyword 'default.'
41     N.B.: yes, the dot after 'default' is part and parcel of the keyword!
42     In this distribution two examples are included. Pxeconfig lets the
43     user decide which 'default.' config file to use.
45  2) If default is a symbolic link to for example default.harddisk, then
46     default.harddisk is not included in the list where the user can
47     choose from.
49  3) You can give a command line switch to specify where the
50     pxe config files reside:
51        pxeconfig -d /<some>/<other>/<place>
53The last utility is 'hexls'. This utility will display the hex pxe config
54file with the corresponding ip-addresses.
56To activate this on a client you must add the following line to the 'master'
57script of the node. It will remove the pxe config file for the node
58from the pxe bootserver. I personally place the line just before the umount
59commands. See below which command to use for which systemimager version.
60Telnet is not included in the 3.X versions.
61   # Remove the <hex_ipaddr> file from the pxelinux.cfg directory.
62   # So the client will boot from disk
63   #       
64   3.X)  chroot /a telnet $IMAGESERVER 10000
65   2.X)  telnet $IMAGESERVER 10000
68Comments or Suggestions mail them to:
69 Bas van der Vlies <>
70 for more info about SARA
Note: See TracBrowser for help on using the repository browser.