source: trunk/INSTALL @ 92

Last change on this file since 92 was 92, checked in by bas, 17 years ago

INSTALL:

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