C H A P T E R  2

Installing Red Hat Enterprise Linux 2.1 Software on Sun Fire V60x and V65x Servers


Note - The system administration procedures in this chapter are intended for users with at least basic Linux administration experience.



This chapter is organized into the following sections.


Installing Red Hat Enterprise Linux 2.1 Software From CDs

This section describes how to install Red Hat Enterprise Linux 2.1 software using supplemental drivers provided at: http://www.sun.com

This procedure has been tested with the Red Hat Enterprise Linux 2.1 distribution available for purchase from Sun Microsystems.



Note - The server's USB ports are not enabled until Linux is booted and the USB drivers are installed. A PS/2 keyboard is required for initial bootup and configuration.



Installing from CDs consists of the following procedures.

1. Download the SCSI driver disk image, SCSI driver RPMs, and Ethernet driver RPMs from the Sun Web site. See Downloading Required Drivers and Support Files.

2. Put the latest SCSI driver disk image onto a diskette. See Creating a SCSI Driver Disk.

3. Install Red Hat Enterprise Linux 2.1 software and several optional modules. See Installing Red Hat Enterprise Linux 2.1 Software.

4. Configure the network connection. See Configuring the Network Connection.

Required Items

The CD installation procedure requires the following items.



Note - Do not connect a mouse for the installation.



Optional Item

Downloading Required Drivers and Support Files

This section describes how to download the required supplemental drivers and files that are needed to run Red Hat Enterprise Linux 2.1 software on the Sun Fire V60x and V65x servers.

1. On a system running Linux, use a browser to go to the Sun download site for your server:

http://www.sun.com/servers/entry/v60x/downloads.html
or
http://www.sun.com/servers/entry/v65x/downloads.html

2. Navigate to the download links for Red Hat Enterprise Linux 2.1 software and download the following three items to a /tmp/ directory on the system.

3. Extract the contents of the two tar files into the /tmp/ directory by typing the following command:

# tar -zxf /tmp/filename

4. Continue with Creating a SCSI Driver Disk.

Creating a SCSI Driver Disk

The Red Hat Enterprise Linux 2.1 Media CD does not contain the correct driver for the SCSI controller installed on the server. An additional diskette, containing the driver source code, is required when installing the operating system onto the server's disk drive.

1. Insert a formatted diskette to the system that you have downloaded the drivers to in Downloading Required Drivers and Support Files.

2. Log in as superuser.

3. Type the following command to write the disk image to the diskette:

# dd if=/tmp/aic79xx-version.img of=/dev/fd0

Where version is the highest numeric file available, for example:

aic79xx-1.3.10-i686-rh72as.img



Note - The output device may vary depending on your server; /dev/fd0 is typical.



4. When the operation is complete, eject the diskette.

5. Continue with Installing Red Hat Enterprise Linux 2.1 Software.

Installing the Service Partition (Optional)

You can optionally install the service partition from the Diagnostics CD as the first step of the Red Hat Enterprise Linux 2.1 software installation. The service partition has utilities that might be useful. Refer to the Sun Fire V60x and Sun Fire V65x Server User Guide for more information about the utilities provided by installing the service partition, and for instructions on installing it. If you want to install the service partition, it must be installed prior to installing Red Hat Enterprise Linux 2.1 software.

Installing Red Hat Enterprise Linux 2.1 Software

1. Connect the keyboard and monitor to the appropriate connectors on the Sun Fire V60x or V65x server.



Note - Do not connect a mouse for the installation.



2. Power on the server and insert Red Hat Enterprise Linux 2.1 CD 1 into the CD tray before the boot process begins.

3. When you are prompted in the Welcome to Red Hat screen, do not press Enter. Instead, instruct the server to use a driver disk:



Note - You must type this command before the prompt times out.



# linux dd

The installation process begins and prompts you for a driver disk, which is required by the server's SCSI controller.

4. When you are prompted for whether you have a driver disk, select Yes.

5. When you are prompted for the driver disk, insert the SCSI driver diskette you created in Creating a SCSI Driver Disk and select OK when you are prompted to continue.

This will take a few moments as the aic79xx driver is loaded.

6. When prompted for whether you want to provide mouse information or choose text mode installation, choose text mode installation.

The installer does not search for a mouse. No mouse is required and a mouse should not be connected.

7. Make the following selections when prompted:

8. When the dialog box about Red Hat Linux and registration appears, read it, then select OK.

9. When prompted for the Installation Type, choose Custom.

10. When prompted for disk partitioning, select Autopartition.

A dialog box appears, prompting you to choose whether you want to keep the existing partitions.

Your choice depends on whether you installed the service partition earlier (see Installing the Service Partition (Optional)).

If you chose Remove all partitions on this server a warning about data being removed from the drives is displayed. Select Yes.

11. On the Partitioning screen, tab to OK and press Enter.

12. Select a boot manager of your choice, then choose OK.

For example, if you choose LILO, use the arrow keys to move the cursor into the check box for LILO. Then press the spacebar to select LILO, select OK, and press Enter.

13. Make the following selections when prompted:

14. Enter the superuser password of your choice.



Note - Ensure that you remember the password. If you forget it, you may have to reinstall the operating system.



15. Add an additional user, if necessary.

admin is a recommended user to add to the server by default. Enter all the appropriate information.

16. You may add additional users in the User Account Setup screen, or choose OK.

Passwords must be at least six characters.

17. Select the Authentication Configuration for your environment.

18. In the Package Group Selection setup screen, check the following options, in addition to any other software features that you want.

Use the arrow keys to move the cursor, then press the spacebar to check selections.

19. When prompted, select the default video interface detected by the installer.

20. Read the dialog box about the installation log, then choose OK.

This installation of the RPMs will take about 10 minutes, depending on what you selected for installation. When you are prompted to switch the CD, the installer automatically ejects the CD. Insert the requested CD and press OK. You might not need CD 3, depending on which options you selected for installation.

21. When prompted about creating a repair disk, choose whether you want to create one.



Note - It is good practice to make a repair disk for emergency system recovery when prompted, but it is optional.



22. Identify the connected monitor and select the best match in the installer.

23. At the X-Customization screen, select Text Interface.

24. Select OK in the Complete dialog box.

Be sure to remove the repair diskette from the diskette drive, if you created one.

25. Continue with Configuring the Network Connection.

Installing the Kernel Source (Optional)

This procedure is provided for reference, but is not required.

Check to see if the kernel source is installed by typing:

rpm -q kernel-source

# mount /mnt/cdrom

# rpm -ivh /mnt/cdrom/RedHat/RPMS/ \
kernel-source-2.4.9-e.3.i386.rpm

# umount /mnt/cdrom

Configuring the Network Connection

1. Log in as superuser on the Sun Fire V60x or V65x target server to which you are installing Red Hat Enterprise Linux 2.1 software.

2. Determine the kernel level installed on the target server by typing the following command:

# uname -a

3. Insert a formatted diskette in the system that you have downloaded the drivers to in Downloading Required Drivers and Support Files.

4. Mount the diskette by typing the following command:

# mount /dev/fd0 /mnt/floppy

5. Copy the e1000 network drivers from the /tmp/ location where you downloaded them to the diskette by typing the following command:

# cp /tmp/as-e1000/e1000-version.rpm /mnt/floppy

Where version is the RPM version that corresponds to the kernel version you are using, as determined in Step 2.

6. When the operation is complete, remove the diskette from the server after you type the following command:

# umount /dev/fd0

7. Insert the diskette with the e1000 network drivers into this target server and mount the diskette by typing the following command:

# mount /dev/fd0 /mnt/floppy

8. Copy the e1000 network drivers from the diskette to the target server by typing the following command:

# cp /mnt/floppy/e1000-version.rpm /tmp/

9. Install the network driver RPMs by typing the following command:

# rpm -Uvh --nodeps /tmp/e1000-version.rpm

10. Remove the diskette from the server after you type the following command:

# umount /dev/fd0

11. Reboot the server.

12. Configure Network Devices using the Kudzu utility when prompted.



Note - You must choose to enter the Kudzu utility when prompted.





Note - Red Hat Enterprise Linux refers to network port 2 on the back of the server as eth0. The network adapter for port 2 is the first adapter that you are prompted to configure. Ignore the prompt to configure a second network adapter.



13. Continue with Upgrading the Kernel to check for more optimal kernel upgrades available.


Installing Red Hat Enterprise Linux 2.1 Software From a Network

This section describes how to create a PXE install image on a Linux server, and how to initiate the request from the target Sun Fire V60x and V65x server to download the image through the PXE server. The PXE server then transfers the boot image file to the target server using TFTP. This boot image file is used to boot the target server.

The tasks for installing Red Hat Enterprise Linux 2.1 software from a networked PXE server consist of the following procedures.

1. Configure your network to support PXE installation. See Preconfiguring Your Network to Support PXE Installation. These procedures apply for all Red Hat versions covered in this guide.

2. Create a PXE install image on a system that will be the PXE server, from which the software is downloaded to other systems (PXE clients). See Creating a PXE Install Image on the PXE Server.

3. Install the Red Hat software to the PXE clients from the PXE server. See Installing Red Hat Enterprise Linux 2.1 Software From a PXE Server.

Required Items

The PXE network installation procedure requires the following items.



Note - Do not connect a mouse for the installation.



Optional Item

Installing the Service Partition (Optional)

You can optionally install the service partition from the Diagnostics CD to the Sun Fire V60x or V65x server onto the Sun Fire V60x and V65x server as the first step of the Red Hat Enterprise Linux 2.1 software installation. The service partition has utilities that might be useful. Refer to the Sun Fire V60x and Sun Fire V65x Server User Guide for more information about the utilities provided by installing the service partition, and for instructions on installing it. If you want to install the service partition, it must be installed prior to installing Red Hat Enterprise Linux 2.1 software.

Creating a PXE Install Image on the PXE Server

This procedure describes how to create a PXE install image on the same server that is your DHCP server, so that it will also act as your PXE server. The PXE server provides the operating system files to your PXE client.



Note - Before you start this procedure, verify that your network has been configured to support PXE installation, as described in Preconfiguring Your Network to Support PXE Installation.



1. Insert Red Hat Enterprise Linux 2.1 CD 1 into your server and copy its contents to your PXE server by typing the following commands:



Note - You can use a different target directory than the /home/pxeboot/SunFire_as2.1/ directory shown below. The examples in this procedure use this directory.



# mkdir -p /home/pxeboot/SunFire_as2.1/

# mount /dev/cdrom /mnt/cdrom

# cp -a /mnt/cdrom/RedHat /home/pxeboot/SunFire_as2.1/

2. Remove CD 1 from the server after you type the following command:

# umount /dev/cdrom

3. Insert Red Hat Enterprise Linux 2.1 CD 2 into your server and copy its contents to your PXE server, by typing the following commands:

# mount /dev/cdrom /mnt/cdrom

# cp -a /mnt/cdrom/RedHat /home/pxeboot/SunFire_as2.1/



Note - If you are prompted whether to overwrite any existing files, type y to overwrite the files.



4. Remove CD 2 from the server after you type the following command:

# umount /dev/cdrom

5. Insert Red Hat Enterprise Linux 2.1 CD 3 into your server and copy its contents to your PXE server, by typing the following commands:

# mount /dev/cdrom /mnt/cdrom

# cp -a /mnt/cdrom/RedHat /home/pxeboot/SunFire_as2.1/



Note - If you are prompted whether to overwrite any existing files, type y to overwrite the files.



6. Remove CD 3 from the server after you type the following command:

# umount /dev/cdrom

7. On your PXE server, determine whether the anaconda-runtime package is already installed on the server by typing the following command:

# rpm -qa | grep anaconda-runtime

8. If the anaconda-runtime package is not listed, install it from Red Hat Enterprise Linux CD 2 by typing the following commands:

Use the CD 2 for the version of Red Hat Linux that is installed on the PXE server.

# mount /dev/cdrom /mnt/cdrom

# rpm -ivh /mnt/cdrom/RedHat/RPMS/anaconda-runtime*

9. Remove CD 2 from the server after you type the following command:

# umount /dev/cdrom

10. Copy the SCSI and network drivers from the temporary directory to the directory shown below:

# cp /tmp/as-pxefiles/aic79xx* \
/home/pxeboot/SunFire_as2.1/RedHat/RPMS/

# cp /tmp/as-pxefiles/e1000* \
/home/pxeboot/SunFire_as2.1/RedHat/RPMS
/

The temporary directory /tmp/as-pxefiles/ was created during the procedure in Downloading the Required Support Files, when you preconfigured your PXE server.

11. Add the following entries to the /home/pxeboot/SunFire_as2.1/RedHat/base/comps file (after the existing line that reads anacron):

aic79xx

aic79xx-enterprise

aic79xx-smp

Save the file.

12. Extract and copy the script file newest.pl to your PXE server by typing the following commands:

# cd /tmp/as-pxefiles

# tar -zxf /tmp/as-pxefiles/newest.tar.gz

# cp /tmp/as-pxefiles/newest.pl \
/home/pxeboot/SunFire_as2.1/newest.pl

13. On your PXE server, run the newest.pl script to remove any old packages by typing the following commands:



Note - The following Perl command must be run from the /home/pxeboot/SunFire_as2.1/RedHat/RPMS/ directory.



# cd /home/pxeboot/SunFire_as2.1/RedHat/RPMS/

# perl /home/pxeboot/SunFire_as2.1/newest.pl

14. On your PXE server, run the genhdlist script to update your disk drive list (hdlist) by typing the following command:

# /usr/lib/anaconda-runtime/genhdlist --withnumbers \
/home/pxeboot/SunFire_as2.1/

15. Copy the initrd.img file to your PXE server by typing the following command:

# cp /tmp/as-pxefiles/initrd.img /home/pxeboot/SunFire_as2.1/

16. Copy the stage2.img file to your PXE server by typing the following command:

If you are prompted whether to overwrite an existing stage2.img file, select Yes.

# cp /tmp/as-pxefiles/stage2.img \
/home/pxeboot/SunFire_as2.1/RedHat/base/

17. Copy the vmlinuz file to your PXE server by typing the following command:

# cp /tmp/as-pxefiles/vmlinuz /home/pxeboot/SunFire_as2.1/

18. Copy the kickstart file ks.cfg to your PXE server by typing the following command:

# cp /tmp/as-pxefiles/ks.cfg /home/pxeboot/SunFire_as2.1/

19. On your PXE server, edit and save the kickstart file /home/pxeboot/SunFire_as2.1/ks.cfg so that the nfs line is as follows:

nfs --server n.n.n.n --dir /home/pxeboot/SunFire_as2.1/

Where n.n.n.n is the IP address of your PXE server. Double check that the location at --dir is pointing to the top level of your image.

20. On your PXE server, modify and save the file /home/pxeboot/pxelinux.cfg/default to add the following entry to it:

Note that you should type the text block from "append ksdevice" through "ks.cfg" as one continuous string with no returns.

default SunFire_as2.1
label SunFire_as2.1
kernel SunFire_as2.1/vmlinuz
append ksdevice=eth0 console=ttyS1,9600 console=tty0 load_ramdisk=1 initrd=SunFire_as2.1/initrd.img network
ks=nfs:
n.n.n.n:/home/pxeboot/SunFire_as2.1/ks.cfg

Where n.n.n.n is the IP address of your PXE server.

Installing Red Hat Enterprise Linux 2.1 Software From a PXE Server

This procedure describes how to initiate the request from the target Sun Fire V60x or V65x server to download the boot image file from the PXE/DHCP server and to install the Red Hat Enterprise Linux 2.1 software onto the target server.



Note - This procedure assumes that you have already preconfigured your network and PXE server install image as described in Preconfiguring Your Network to Support PXE Installation and Creating a PXE Install Image on the PXE Server.



1. Connect the PXE client to the same network as the PXE server, and power on the PXE client.

The PXE client is the target Sun Fire V60x and V65x server to which you are installing Red Hat Enterprise Linux 2.1 software.

2. When the PXE client prompts you for a network boot, press the F12 key.

The PXE client connects to the PXE server and attempts to obtain an IP address from the DHCP server.

3. Press the F8 key to begin the downloading of the PXE boot image.

4. When you are prompted at the boot: prompt, type in the label you gave the image during Step 20 of Creating a PXE Install Image on the PXE Server.

The Red Hat Enterprise Linux 2.1 install image downloads onto the target Sun Fire V60x or V65x server.

5. To configure the Linux operating system for your server, refer to the manual that is shipped with your Red Hat Enterprise Linux 2.1 media kit.

6. Continue with Upgrading the Kernel.


Upgrading the Kernel

The kernel that ships with Red Hat Enterprise Linux 2.1 software is not as optimally tuned as a later kernel that is provided through an update.



Note - The updated kernel is obtained by running the up2date program provided with the distribution. You must register and set up the up2date program before proceeding with these instructions. Refer to the Red Hat manual included with your Red Hat Enterprise Linux 2.1 media kit for information about setting up the up2date program. When running up2date, select the kernel packages on the available package updates section. After up2date has completed, reboot the server.



Once the new kernel is installed, the SCSI driver and Ethernet driver should also be reinstalled, because the versions that ship with the e.12 kernel do not provide optimal system performance. See SCSI and Network Driver Upgrades.

SCSI and Network Driver Upgrades

The latest kernel update might downgrade the drivers that were installed during the initial installation of the operating environment. Updating the drivers ensures proper system performance.

You can use the drivers that you already downloaded, as described in Downloading Required Drivers and Support Files. Use the procedure in Copying Driver Upgrade Files to copy the RPMs to the target server.

Copying Driver Upgrade Files

1. Insert a formatted diskette to the system that you have downloaded the drivers to in Downloading Required Drivers and Support Files.

2. Log in as superuser.

3. Mount the diskette by typing the following command:

# mount /dev/fd0 /mnt/floppy/

4. Copy the drivers that correspond to your new kernel version onto the diskette by typing the following commands:

# cp /tmp/aic79xx-version.rpm /mnt/floppy/

# cp /tmp/e1000-version.rpm /mnt/floppy/

Copy the RPMs that correspond to your new kernel version. For example, if you are running the e.12 kernel, copy the following SCSI drivers and network drivers (these examples are current at the time of this publishing):

5. When the operation is complete, remove the diskette from the server after you type the following command:

# umount /dev/fd0

6. Log in as superuser on the target server.

7. Insert the diskette with the drivers into the target server and mount the diskette by typing the following command:

# mount /dev/fd0 /mnt/floppy

8. Create a directory on the target server by typing the following command:

# mkdir /tmp/e12/

9. Copy the RPMs from the diskette to the target server by typing the following command:

# cp /mnt/floppy/*.rpm /tmp/e12/

10. When the operation is complete, remove the diskette from the server after you type the following command:

# umount /dev/fd0

11. Change directories by typing the following command:

# cd /tmp/e12/

12. Install the drivers to the target server with the following commands.

# rpm -Uvh aic79xx*

# rpm -Uvh e1000*

13. Reboot the target server by typing the following command:

# reboot