source: trunk/pxeconfig/INSTALL @ 65

Last change on this file since 65 was 45, checked in by bas, 18 years ago

update version info for:

  • pxeconfig, pxeconfigd and control


  • Fixed an bug two entries for xinetd.d


  • Added Ramon Bastiaans


  • update info for xinetd
File size: 3.1 KB
[9]1Here follow some basic installation instructions.
[41]3If you are using DEBIAN then you can run the following utility:
4 This will make debian package that you can install
5                  with dpkg -i <packagename>
8To activate the 'pxeconfigd' daemon utility on other platforms use this
[5]10 1) edit '/etc/services', eg:
[41]11      pxeconfigd      6611/tcp                       # pxe config daemon
[45]13 2) Install the server:
14    a) inetd.conf
15      - edit '/etc/inetd.conf', eg:
16        pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
17          /usr/sara/sbin/pxeconfigd
[45]19      - /etc/init.d/inetd reload
[45]21    b) xinetd
22      - cp pxeconfigd.xinetd /etc/xinetd.d/pxeconfigd
23      - /etc/init.d/xinetd reload
25    NOTE: the pxeconfigd can only be started from inetd or xinetd!!!
[5]28 4) You can test it by:
[7]29     telnet localhost pxeconfigd (or port number)
31     output:
32       Trying
33       Connected to localhost.
34       Escape character is '^]'.
35       ip =, hex = 7F000001
36       file = /tftpboot/pxelinux.cfg/7F000001
37       Connection closed by foreign host.
[6]39     In syslog a line will be added if the removal is succesful:
40      Feb 20 09:32:40 test pxeconfigd: /tftpboot/pxelinux.cfg/7F000001
42 4) As you can see '/tftpboot/pxelinux.cfg/' is the default directory. If
[9]43    you placed the config files somewhere else you can add the
[5]44    '-d/--directory' option, eg:
45       pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
46        /usr/sara/sbin/pxeconfigd -d /<some>/<other>/<place>
[9]48If the daemon works and you want to install/reinstall a node, a link
[5]49must be placed in the '/tftpboot/pxelinux.cfg' directory. This can
50be done with the 'pxeconfig' utility. This utility will ask some
[9]51questions and will make the links for you. The utility requires the following
[9]53  1) All the pxe configuration files must start with the keyword 'default.'
54     N.B.: yes, the dot after 'default' is part and parcel of the keyword!
[5]55     In this distribution two examples are included. Pxeconfig lets the
[9]56     user decide which 'default.' config file to use.
[9]58  2) If default is a symbolic link to for example default.harddisk, then
[5]59     default.harddisk is not included in the list where the user can
60     choose from.
[9]62  3) You can give a command line switch to specify where the
[5]63     pxe config files reside:
64        pxeconfig -d /<some>/<other>/<place>
[6]66The last utility is 'hexls'. This utility will display the hex pxe config
[9]67file with the corresponding ip-addresses.
[9]69To activate this on a client you must add the following line to the 'master'
[6]70script of the node. It will remove the pxe config file for the node
[30]71from the pxe bootserver. I personally place the line just before the umount
72commands. See below which command to use for which systemimager version.
73Telnet is not included in the 3.X versions.
[6]74   # Remove the <hex_ipaddr> file from the pxelinux.cfg directory.
75   # So the client will boot from disk
76   #       
[41]77   3.X)  chroot /a telnet $IMAGESERVER 6611
78   2.X)  telnet $IMAGESERVER 6611
[8]81Comments or Suggestions mail them to:
[5]82 Bas van der Vlies <>
83 for more info about SARA
Note: See TracBrowser for help on using the repository browser.