source: trunk/INSTALL @ 171

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

Added pxemenu config files and updated some info

File size: 3.1 KB
RevLine 
[97]1Here are some basic instructions for installation. See for
[92]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
[97]11 - make install
12
[92]13 - To activate the 'pxeconfigd' daemon utility on other platforms use this
14   procedure:
[5]15 1) edit '/etc/services', eg:
[41]16      pxeconfigd      6611/tcp                       # pxe config daemon
[5]17
[45]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
[5]23
[45]24      - /etc/init.d/inetd reload
[5]25
[45]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!!!
[5]31
[45]32
[5]33 4) You can test it by:
[7]34     telnet localhost pxeconfigd (or port number)
[5]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
[6]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
[5]46
47 4) As you can see '/tftpboot/pxelinux.cfg/' is the default directory. If
[9]48    you placed the config files somewhere else you can add the
[5]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
[9]53If the daemon works and you want to install/reinstall a node, a link
[5]54must be placed in the '/tftpboot/pxelinux.cfg' directory. This can
55be done with the 'pxeconfig' utility. This utility will ask some
[9]56questions and will make the links for you. The utility requires the following
[5]57setup:
[9]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!
[5]60     In this distribution two examples are included. Pxeconfig lets the
[9]61     user decide which 'default.' config file to use.
[5]62
[9]63  2) If default is a symbolic link to for example default.harddisk, then
[5]64     default.harddisk is not included in the list where the user can
65     choose from.
66
[9]67  3) You can give a command line switch to specify where the
[5]68     pxe config files reside:
69        pxeconfig -d /<some>/<other>/<place>
70
[6]71The last utility is 'hexls'. This utility will display the hex pxe config
[9]72file with the corresponding ip-addresses.
[5]73
[9]74To activate this on a client you must add the following line to the 'master'
[6]75script of the node. It will remove the pxe config file for the node
[30]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.
[6]79   # Remove the <hex_ipaddr> file from the pxelinux.cfg directory.
80   # So the client will boot from disk
81   #       
[41]82   3.X)  chroot /a telnet $IMAGESERVER 6611
83   2.X)  telnet $IMAGESERVER 6611
[6]84
[30]85
[8]86Comments or Suggestions mail them to:
[106]87 pxeconfig@sara.nl
[5]88 http://www.sara.nl for more info about SARA
Note: See TracBrowser for help on using the repository browser.