Sparc/Netboot/en

Guide for setting up a netboot server for use with the Gentoo/SPARC netboot installation images.

Introduction
This document will describe how to setup a network booting environment for a Sun Microsystems SPARC or UltraSPARC based computer. The document assumes that you have an existing Gentoo Linux computer available to act as the netboot server.

Both the netboot server and netboot client will need to be on the same network subnet, as the ARP protocol is typically not forwarded across different network subnets.

A generic overview of what happens during the netboot process is as follows;


 * 1) Client machine sends out a reverse ARP (RARP) request to get an IP address
 * 2) A server machine returns a response to the client with the IP address
 * 3) The client then attempts to download a boot image from the RARP server using the TFTP protocol
 * 4) Once the image is downloaded, the netboot client then boots the image

Based on this overview, we will need to install software for a reverse ARP daemon and a TFTP daemon.

The Reverse ARP Daemon
A reverse ARP daemon is already installed on your system; it's part of the  package

Setting up common rarpd elements :

You will need to setup the file. This file indicates which hosts  should respond to when a request is seen, and what address to reply with.

The format of is the MAC address of the NIC the machine will be netbooting and its hostname. Whitespace delimits the MAC address from the hostname, and each entry should have its own line. The following example is for a host named sparc-netboot.gentoo.org:

If you desire to add additional hosts to, you do not need to restart the   services as the file is checked each time a request is received.

Resolving hostnames :

Since each entry in has a hostname, the netboot server needs to be able to resolve the hostname into its IP address. This can be done two ways, or the nameserver the netboot server uses.

An entry for resolving a hostname will look very similar to the one that probably exists from when you installed Gentoo on the netboot server. For our example host, sparc-netboot.gentoo.org, we'll assume that it has an IP address of 10.0.1.15. So the entry would look like;

If you use a nameserver, then the DNS server administrator will need to add a record for the hostname, in our example sparc-netboot.gentoo.org, to point to the appropriate IP address. Please consult your DNS server administrator and/or the documentation for the DNS server's DNS software for how to add the entry.

Setting up rarpd

First, we will need to determine the options to use for. While there are more options than we'll cover here, these options should get you started As there is currently no script for  , an entry will need to be added to  if you want to enable   services at boot time. A sample entry is as follows:

An explanation of the above  options (as taken from the man page):


 * Be verbose
 * Do not check for the presence of a boot image, reply if MAC address resolves to a valid IP address using database and DNS
 * eth0 represents the interface  should bind to

For more options, consult.

The tftpd Daemon
Here there are two options for a TFTP daemon,  and. You only need to install one of the TFTP daemons for proper operation.

Setting up common tftpd elements

Each TFTP daemon will need a directory from which to serve files to tftp clients. The directory we will use for this howto will be. This will appear as the root directory to the clients when requests are received. Additionally, we'll setup the system to run the TFTP daemon with the user and group.

If the directory you have chosen does not currently exist, it will need to be created with the  command. The command for the example is:

Then we will need to change the owner of so that it is owned by user nobody and group   :

The atftp Daemon
First, install the  package as follows;

After the  package has been installed, it will need to be configured. If tftpd services are desired at boot time, an entry to will need to be added as   has no ,   or   scripts of its own. If you want to use  or   for controlling the tftpd service, please see their respective man pages.

Below is an example entry for  in.

An explanation of the above options (as taken from the man page);


 * Increase or set the logging level. No args will increase by one the current value. Default is LOG_NOTICE, see syslog(3) for log level. Current value range from 0 (LOG_EMERG) to 7 (LOG_DEBUG)
 * Run as a daemon. Do not use this option if atftpd is started by inetd.

For more options, consult.

The tftp-hpa Daemon
First, install the  package:

comes with an and the accompanying  configuration file. Check to make sure that INTFTPD_PATH and INTFTP_OPTS in match those below:

The TFTP daemon can then be started via the script:

For more options, consult.

Preparing a tftpboot image for use by a client
Make sure you have an image you want to use for netbooting. Please check your local Gentoo distfiles mirror for the appropriate image. We'll assume you are planning to boot using the image.

Once you have an image, copy the image into :

Now, when the netboot client makes a TFTP request, it looks for a file that is the hexadecimal number of its current IP address, and on some platforms an suffix. The hexadecimal number should use capital characters.

So for our example IP address, 10.0.1.15, let's look at its hexadecimal equivalent:

Example IP address

So for the example netboot client, it would look for a file named when it tftpboots.

Iif you are really, really lazy (like me), you can netboot the host to get the filename the client is looking for from the netboot server logs.

Make sure that both the  and TFTP daemon you've chosen are currently running, then boot the host as described below in.

The client will appear to hang after the boot net command is issued. Then on the netboot server, check the system logs for an entry for.

An example entry from a netboot server running  and   looks like:

Log entry for netboot server

The filename is shown above after "filename" in the log entry, which in this case is.

As a way to keep track of what netboot image you are using, and to allow multiple machines to use the same netboot image, you can use a soft link to create the file with the hexadecimal value. To create this using our sample sparc64 host and the, use the following command:

Now everything should be set for netbooting!

Netbooting the client
From OpenBoot PROM (OBP) on the SPARC, enter the command;

Other methods for certain machines are:

This will initiate the networking booting process. A constantly changing string of hexadecimal digits should appear. When the image has finished loading, the kernel will take over and start the OS booting process. In the case of our sparc64 install image, you will be left at a shell prompt from which you can begin the install process.

Troubleshooting
Building the prerequisite software

If the netboot server is a Gentoo Linux system and experiences problems after installing the rarpd and tftpd packages, please search the Gentoo Forums and Gentoo Bugzilla to see if this problem has been encountered by anyone else. If it has not, or the solutions found do not work, then please open a new bug.

I've issued the boot net command but it appears to hang.

This is presumably because the file your system is trying to load from the tftpboot server is not available. On a SPARC system, you would probably see the following:

Booting appears to hang

Double check that the file the client needs does exist in. You can confirm the filename it is requesting by looking in the system logs. Also, once this file exists, the client will try to load it. Sometimes, when the file is missing originally, it will freeze downloading the file once it appears. To resolve this, just get back to an OBP prompt, and issue the "boot net" command again. The host should then start downloading the tftpboot image and boot the OS.

I'm trying to netboot, but all I see are "Timeout waiting for ARP/RARP packet" messages.

This could be due to a few different problems;


 * 1) Make sure the entry in  exists for the client in question. If the MAC address is incorrect and/or the netboot server cannot resolve the hostname for the client, it cannot respond with the needed information.


 * 1) Verify that the network hub or switch the netboot server and client are connected to allow RARP traffic to flow freely. If the client's request cannot reach the server, or vice versa, the host will be unable to continue.


 * 1) No one is responding to the RARPD request because no services are listening. Verify that the rarpd service is up and running.


 * 1) The client does not think its NIC has a link to the network hub/switch it is plugged into. Check to see if the NIC and the port on the network hub or switch has a link light. If the link light is on, check to see what the setting of tpe-link-test? is in OBP with the command;   . You should receive something like  . The first column represents the parameter name, the second column shows the current value for the the parameter, and the third column shows the default value for the parameter. In the example above, we can see that the current value is false, which means that the client is not checking to see if the client and network hub or switch can establish a link before issuing its RARP request. Often times this can cause the problem.

To change the value of tpe-link-test? from an OBP prompt, issue the following command:

This shows the value of tpe-link-test? is now true. Try netbooting the client again.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * weeve
 * nightmorph