DAQ Controller diskless setup

Summary

This page will document how to set up a new VME controller for the PXE boot and diskless OS client on the Hall D DAQ network.

JNET

JNET access is necessary for properly obtaining an IP address and assigning a hostname to a specified MAC address on the VME Controler.

• In a web browser (on a machine on the Hall D network), log into JNET
• Click on the Machine Registration tab
• Click on Add Device
• Enter the relevant information
  • MAC Address of front panel LAN port to be used
  • VLAN 635 : Hall D DAQ (CODA)
  • Requested Hostname (please conform to Hall D Naming Convention)
  • Take note of the automatically assigned IP Address

GLUON26

gluon26.jlab.org hosts the Hall D DHCP and tftp servers. DHCP is required to provide the Controller's IP address, tftp server IP, and tftp boot file information. Modification of the relevant configuration files for both servers requires root or sudo privledges.

DHCP

• Configuration file:

 /etc/dhcp/dhcpd.conf -> /gluonfs1/diskless/conf/dhcpd.conf

• Add an entry for requested hostname within the group with commented line:

 # PXE bootable hosts

This group has the common configuration parameters

 filename "linux-diskless/pxelinux.0";      # Binary for PXE booting environment
 next-server 129.57.172.40;                 # tftp server: gluon26.jlab.org

The new entry should have this format

 host rocfcal1                              # Requested hostname
   { 
       hardware ethernet 00:40:9E:03:2D:75; # MAC ADDRESS
       fixed-address 129.57.135.11;         # Assigned IP address
   }

• After saving the file, restart the DHCP server with:

 /sbin/service dhcpd restart

TFTP

The tftp server runs off of the xinetd daemon and very rarely needs to be restarted. The relevant configuration files are located here

 /gluonfs1/diskless/tftpboot/linux-diskless/pxelinux.cfg/

Each host has its own configuration file with the filename provided by its IP address. For example

 8139870B -> 129.57.135.11

This translation can be done using the command gethostip (installed on gluon26 from syslinux RPM). For example

> gethostip rocfcal1.jlab.org
rocfcal1.jlab.org 129.57.135.11 8139870B

To restart:

 /sbin/service xinetd restart

tftp server configuration file (rarely changed)

 /etc/xinetd.d/tftp -> /gluonfs1/diskless/conf/tftp