Installation

First get the latest stable source of the package from:

• ​ftp://ftp.sara.nl/pub/outgoing/pxeconfig.tar.gz

Then unpack the package. There are 2 methods to build the package:

• Debian package
• Manual installation

Debian package

How to build a debian package:

• debian/rules binary
• dpkg -i <packagename>

The debian package determines if inetd or xinetd configuration must be used.

Manual installation

How to install the package:

• ./configure (default install directory = /usr/local)
• make install

How to configure the daemon (pxeconfigd)

To activate the pxeconfigd daemon utility on other platforms use this procedure:

• edit '/etc/services', eg:

        pxeconfigd      6611/tcp                       # pxe config daemon
  

• Install the server, the server can ONLY be started from inetd or xinetd:

      a) inetd.conf
        - edit '/etc/inetd.conf', eg:
          pxeconfigd stream  tcp nowait  root.sys /usr/sbin/tcpd \
            /usr/local/sbin/pxeconfigd
  
        - /etc/init.d/inetd reload
  
      b) xinetd
        - cp examples/pxeconfigd.xinetd /etc/xinetd.d/pxeconfigd
        - /etc/init.d/xinetd reload
  

Test the setup

You can test it by:

• telnet localhost pxeconfigd (or port number)

       output:
         Trying 127.0.0.1...
         Connected to localhost.
         Escape character is '^]'.
         ip = 127.0.0.1, hex = 7F000001
         file = /tftpboot/pxelinux.cfg/7F000001
         Connection closed by foreign host.
  

In syslog a line will be added if the removal is succesful:

      Feb 20 09:32:40 test pxeconfigd: /tftpboot/pxelinux.cfg/7F000001

Configuration

The pxeconfig and pxeconfigd utility can be configured with a configuration file:

• pxeconfig.conf (usually located in /usr/local/etc or /etc)

The following options are supported: pxe_config_dir::

Specify which tftpboot directory must be used, default: /tftpboot/pxelinux.cfg

client_script_hook::

This option is used by the client program pxeconfig it executes a script before a host link is created with the host ip-address as first argument. We use this to open ports on our firewall to allow the host to use rsync or bittorrent protocol.

daemon_script_hook::

This option is used by the daemon program pxeconfigd it executes a script before a host link is removed with the host ip-address as first argument. We use this to close ports on our firewall for the specified IP-address/host.