source: trunk/pxeconfig/INSTALL @ 60

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

update version info for:

  • pxeconfig, pxeconfigd and control

postinst:

  • Fixed an bug two entries for xinetd.d

Authors:

  • Added Ramon Bastiaans

INSTALL:

  • update info for xinetd
File size: 3.1 KB
Line 
1Here follow some basic installation instructions.
2
3If you are using DEBIAN then you can run the following utility:
4 make_deb_pkg.sh) This will make debian package that you can install
5                  with dpkg -i <packagename>
6       
7
8To activate the 'pxeconfigd' daemon utility on other platforms use this
9procedure:
10 1) edit '/etc/services', eg:
11      pxeconfigd      6611/tcp                       # pxe config daemon
12
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
18
19      - /etc/init.d/inetd reload
20
21    b) xinetd
22      - cp pxeconfigd.xinetd /etc/xinetd.d/pxeconfigd
23      - /etc/init.d/xinetd reload
24       
25    NOTE: the pxeconfigd can only be started from inetd or xinetd!!!
26
27
28 4) You can test it by:
29     telnet localhost pxeconfigd (or port number)
30
31     output:
32       Trying 127.0.0.1...
33       Connected to localhost.
34       Escape character is '^]'.
35       ip = 127.0.0.1, hex = 7F000001
36       file = /tftpboot/pxelinux.cfg/7F000001
37       Connection closed by foreign host.
38
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
41
42 4) As you can see '/tftpboot/pxelinux.cfg/' is the default directory. If
43    you placed the config files somewhere else you can add the
44    '-d/--directory' option, eg:
45       pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
46        /usr/sara/sbin/pxeconfigd -d /<some>/<other>/<place>
47
48If the daemon works and you want to install/reinstall a node, a link
49must be placed in the '/tftpboot/pxelinux.cfg' directory. This can
50be done with the 'pxeconfig' utility. This utility will ask some
51questions and will make the links for you. The utility requires the following
52setup:
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!
55     In this distribution two examples are included. Pxeconfig lets the
56     user decide which 'default.' config file to use.
57
58  2) If default is a symbolic link to for example default.harddisk, then
59     default.harddisk is not included in the list where the user can
60     choose from.
61
62  3) You can give a command line switch to specify where the
63     pxe config files reside:
64        pxeconfig -d /<some>/<other>/<place>
65
66The last utility is 'hexls'. This utility will display the hex pxe config
67file with the corresponding ip-addresses.
68
69To activate this on a client you must add the following line to the 'master'
70script of the node. It will remove the pxe config file for the node
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.
74   # Remove the <hex_ipaddr> file from the pxelinux.cfg directory.
75   # So the client will boot from disk
76   #       
77   3.X)  chroot /a telnet $IMAGESERVER 6611
78   2.X)  telnet $IMAGESERVER 6611
79
80
81Comments or Suggestions mail them to:
82 Bas van der Vlies <basv@sara.nl>
83 http://www.sara.nl for more info about SARA
Note: See TracBrowser for help on using the repository browser.