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
[9]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:
[7]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.
[6]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
[9]30    you placed the config files somewhere else you can add the
[5]31    '-d/--directory' option, eg:
32       pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
33        /usr/sara/sbin/pxeconfigd -d /<some>/<other>/<place>
[9]35If the daemon works and you want to install/reinstall a node, a link
[5]36must be placed in the '/tftpboot/pxelinux.cfg' directory. This can
37be done with the 'pxeconfig' utility. This utility will ask some
[9]38questions and will make the links for you. The utility requires the following
[9]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!
[5]42     In this distribution two examples are included. Pxeconfig lets the
[9]43     user decide which 'default.' config file to use.
[9]45  2) If default is a symbolic link to for example default.harddisk, then
[5]46     default.harddisk is not included in the list where the user can
47     choose from.
[9]49  3) You can give a command line switch to specify where the
[5]50     pxe config files reside:
51        pxeconfig -d /<some>/<other>/<place>
[6]53The last utility is 'hexls'. This utility will display the hex pxe config
[9]54file with the corresponding ip-addresses.
[9]56To activate this on a client you must add the following line to the 'master'
[6]57script of the node. It will remove the pxe config file for the node
[30]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.
[6]61   # Remove the <hex_ipaddr> file from the pxelinux.cfg directory.
62   # So the client will boot from disk
63   #       
[30]64   3.X)  chroot /a telnet $IMAGESERVER 10000
65   2.X)  telnet $IMAGESERVER 10000
[8]68Comments or Suggestions mail them to:
[5]69 Bas van der Vlies <>
70 for more info about SARA
Note: See TracBrowser for help on using the repository browser.