[[PageOutline]] = PXE-utilities = This is a release of the SARA package of utilities that we use to boot our nodes with PXE-enabled network cards. This was developed because we always want to use the PXE-enabled network card as our first boot device. With pxelinux, which is a derivative of syslinux, you can specify with a PXE configuration file how the node must boot. This configuration is placed in, e.g. ''/tftpboot/pxelinux.cfg'' directory. We use this utiltiy for the following purposes: * To instruct a node to do a memory test ([http://www.memtest86.com/ memtest86]) . * To instruct a node to flash its bios firmware or other firmware via the pxe dos boot method ([http://syslinux.zytor.com/ memdisk]) * Installation of a node with [http://wwww.systemimager.org systemimager] software == Systemimager Setup == In our setup we have a default setup. The default setup is to boot from harddisk. When a node boots it fetches the default configuration file and the configuration file instructs the node to boot from the harddisk. This setup is used for nodes that are being been installed by [http://wiki.systemimager.org/index.php/Main_Page systemimager]. At SARA we have developed the following strategy how to install a fresh node. 1. The ip-address in our setup is known for the new node. So we make a link in the ''/tftpboot/pxelinux.cfg'' directory to a pxe config file which instructs that it has to fetch the kernel and root filesystem from our bootserver, eg: {{{ 0A000A02 ---> default.node_install (10.0.10.2) }}} 1. The client starts and uses the systemimager software to install the node. The installation script connects to a daemon on the bootserver. This daemon will remove the PXE config file for this node. 1. The node reboots and will use the default pxe config file which will instruct the node to boot from harddisk. == Utilities == This release contains the following utilities (All utilities are written in Python): pxeconfigd:: This is daemon that removes the pxe configuration file of a node. pxeconfig:: With this program we can specify which pxe config file a node or nodes must use. This utility will create the links in ''/tftpboot/pxelinux.cfg'' hexls:: Is a utility that diplays a directory, and, if in this directory contains HEX files, it will convert them to IP-numbers and hostnames. == Documentation == How to install and make use of this package: * [wiki:PxeInstallation Installation] * [wiki:PxeUsage Usage] An useful link about how to use Systemimager and the pxeconfig tools is: * https://wiki.fysik.dtu.dk/niflheim/System_administration == How to use this system == The system is configured for the following tasks: * Submit problems via [report:1 ticket system] or via email to [mailto:pxeconfig@sara.nl pxeconfig emailing list] * Can checkout the sources via subversion: * svn co https://subtrac.sara.nl/oss/svn/pxeconfig/tags, for the ''stable'' sources * svn co https://subtrac.sara.nl/oss/svn/pxeconfig/trunk for the latest source * Browse the [source: sources] * Everybody can add or change documentation.