Netroot is netbootable Gentoo environment that is used for most server installations and emergency maintenance in the CSL. It is run from Steeltoe.
Netroot is comprised of two main components, a kernel and initramfs are served via PXEBoot/TFTP. They then mount the main netroot environment over NFS. This system provides many advantages over traditional USB or optical medium by being always available and easily updated.
For details on how to setup the netroot PXE setup, please see Netroot/Configuration.
Any client that wishes to have netroot available via PXEBoot must be added to DHCP. In addition, the following two options need to be set to allow PXE to find steeltoe and begin the PXE process:
filename "pxelinux.0"; next-server 126.96.36.199;
These options are automatically set on for any DHCP entry in our server or workstation subnets. For other subnets, they may need to be added to the individual client configuration.
Once DHCP is configured, the system needs to be PXEBooted, on almost any modern system, this can be accomplished by pressing F12 while the system is POSTing. On HP servers, it can be triggered through VSP by using <ESC> + @ when prompted.
The system will use DHCP to pick up its network configuration. It will then use TFTP to download pxelinux.0 from Steeltoe and execute it. The pxelinux configuration is currently set to default booting to netroot if no input is provided so you can just let it sit (or hit enter). Finally, pxelinux will then download the netroot kernel and initramfs and execute the kernel using the configured arguments.
The kernel will go through a fairly normal boot process and finally, towards the end, will re-run DHCP to configure its own networking:
[ 19.860255] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready [ 19.880262] Sending DHCP requests .., OK [ 24.507954] IP-Config: Got DHCP answer from 188.8.131.52, my address is 184.108.40.206 [ 25.248521] IP-Config: Complete: [ 25.249246] device=eth0, addr=220.127.116.11, mask=255.255.254.0, gw=18.104.22.168 [ 25.250914] host=chatham, domain=csl.tjhsst.edu dev.csl.tjhsst.edu sun.tjhsst.edu tjhsst.edu, nis-domain=(none) [ 25.253137] bootserver=22.214.171.124, rootserver=126.96.36.199, rootpath= [ 25.254604] nameserver0=188.8.131.52, nameserver1=184.108.40.206 [ 25.255938] , nameserver2=220.127.116.11
and shortly thereafter will mount its root filesystem via NFS and proceed with a fairly normal Gentoo init sequence.
>> Determining root device... >> Mounting /dev/nfs as root... >> Attempting to mount NFS root on 18.104.22.168:/srv/netroot with options ro,nolock,rsize=1024,wsize=1024 >> Booting (initramfs).. INIT: version 2.88 booting
There are a few minor notes about using the netroot environment.
The biggest is that the root filesystem is largely read-only meaning changes need to be made on steeltoe. While a read-write nfs root is possible, keeping it read-only allows multiple systems to be booted to netroot at the same time.
Netroot has its own set of SSH keys which is uses to run sshd. This means that you will need to clear out the server's SSH keys from .ssh/authorized_keys before sshing to the server while it is in netroot and will then need to clear netroot's ssh keys before sshing to the server once it is back running its own OS.