source: trunk/INSTALL @ 106

Last change on this file since 106 was 106, checked in by bas, 14 years ago

Added pxemenu config files and updated some info

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