C H A P T E R  3

Installing Red Hat Linux 8.0 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 Linux 8.0 Software From CDs

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

This procedure has been tested using the ISO distribution of the software that is available from Red Hat at the following site :

ftp://ftp.redhat.com/pub/redhat/linux/8.0/en/iso/i386/

If that site is busy or too slow, use a mirror that is closer to you from Red Hat's mirror list, which is available at the following address:

http://www.redhat.com/mirrors



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 CD 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 Linux 8.0 and several optional modules. See Installing Red Hat Linux 8.0 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 Linux 8.0 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 Sun Fire V60x and V65x servers:

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 Linux 8.0 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 Linux 8.0 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 unto 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-rh80.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 Linux 8.0 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 Linux 8.0 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 Linux 8.0 software.

Installing Red Hat Linux 8.0 Software

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



Note - Do not connect a mouse for the installation.



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



Note - You must complete the following step before the prompt times out.



3. When you are prompted in the initial Red Hat screen, do not press Enter. Instead, instruct the server to use a driver disk by typing the following at the boot: prompt.

# 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. After the driver is loaded and the installer prompts you to test the CD media, choose Skip or OK, depending on your preference.

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

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

8. Read the Welcome screen and choose OK to continue.

9. Make the following selections when prompted:

10. When prompted for the Installation Type, choose Custom or the appropriate type for your system.

11. 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.

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

13. 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.

14. Add any additional arguments that you want to pass to the kernel in the Boot Loader Configuration screen.

Most users can choose OK.

15. If prompted, you can choose to add a password to the boot loader.

The boot loader configuration attempts to identify what other operating systems exist on the system.

16. Edit the labels for the operating system or just choose OK.

17. Select MBR for the boot loader configuration.

A network configuration screen for eth0 displays.

18. If you are using the eth0 port for network access, select the Activate on Boot option and do one of the following:

A network configuration screen for eth1 displays.

19. If you are using the eth1 port for network access, select the Activate on Boot option and do one of the following:

20. Make the following selections when prompted:

21. Enter the superuser password of your choice.



Note - Make sure that you remember the password. If you forget the password, you might need to reinstall the operating system.



22. Add an additional user, if necessary.

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

23. Add additional users in the User Account Setup screen, or choose OK.

Passwords must be at least six characters.

24. Select the Authentication Configuration for your environment.

This screen will only display if you are doing a custom installation. If you don't know what to enter for authentication configuration, choose the defaults.

25. In the Package Group Selection setup screen, add and remove package groups if you have different system needs than the default.

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



Note - If you want to install or update the kernel source at a later time, you will need to install the Development Tools package in this screen. This package contains the gcc compiler, which is necessary for compiling the kernel source.



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

This installation of the RPMs takes 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.

27. When prompted about creating a repair disk, choose not to create one.



Note - The Red Hat Linux 8.0 software image, including the drivers needed to support the Sun Fire V60x and V65x server, is too large to fit onto a standard diskette.



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

29. Identify the connected monitor and select the best match in the installer. Choose text for the default login type.

30. Connect the Sun Fire V60x or V65x server to a DHCP server if you choose DHCP for your network interface.

Make sure to connect the Ethernet cable(s) to the port(s) that you set up in Step 18 or
Step 19.

31. Select OK in the Complete dialog box.

The system automatically reboots.

32. Remove any diskettes that are in the diskette drive before the system begins rebooting.

33. Continue with Configuring the Network Connection.

Installing the Kernel Source (Optional)

In order to build the Ethernet and SCSI drivers from source, the kernel-source RPM for the current kernel version must be installed. Also, the gcc compiler needs to be installed in order to build the Ethernet and SCSI drivers from source. (See Step 25 in Installing Red Hat Linux 8.0 Software).

If you are using the kernel version that is part of the Red Hat Linux 8.0 media kit, 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.18-14.i386.rpm

# umount /mnt/cdrom

If you have updated your kernel from what is available on the Red Hat Linux 8.0 CD media, you will need to download the kernel-source RPM from the Red Hat Web site that corresponds to the updated kernel.

Configuring the Network Connection

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

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

# uname -a

3. Insert the formatted diskette into the system that you have downloaded the drivers to.

See 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/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 drive 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* /tmp/

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

# rpm -Uvh --nodeps /tmp/e1000*

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

# umount /dev/fd0

11. Reboot the server.

12. Log in as superuser.

13. Open the Network Configuration screen as follows:

# netconfig

# netconfig --device=eth1

14. In the Network Configuration screen, select Yes.

15. In the Configure TCP/IP screen, do one of the following:

16. Exit out of the Network Configuration tool.

17. Restart the network by typing:

# sh /etc/init.d/network restart

 


Installing Red Hat Linux 8.0 Software From a Network

This section describes how to create a PXE install image on a Linux server and 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 Linux 8.0 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 Linux 8.0 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 onto the Sun Fire V60x or V65x server as the first step of the Red Hat Linux 8.0 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 Linux 8.0 software.

Creating a PXE Install Image on the PXE Server



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.



This procedure describes how to create a PXE install image on the same system 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.

1. Insert Red Hat Linux 8.0 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_8.0/ directory shown below. The examples in this procedure use this directory.



# mkdir -p /home/pxeboot/SunFire_8.0/

# mount /dev/cdrom /mnt/cdrom

# cp -a /mnt/cdrom/RedHat /home/pxeboot/SunFire_8.0/

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

# umount /dev/cdrom

3. Insert Red Hat Linux 8.0 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_8.0/



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 Linux 8.0 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_8.0/



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

If the anaconda-runtime package is listed, go to Step 8. If the package is not listed, perform the following steps:

a. Install the package from Red Hat 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*

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

# umount /dev/cdrom

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

# cp /tmp/rh80-pxefiles/aic79xx* \
/home/pxeboot/SunFire_8.0/RedHat/RPMS/

# cp /tmp/rh80-pxefiles/e1000* \
/home/pxeboot/SunFire_8.0/RedHat/RPMS/

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

9. Check for and download any updates or patches to Red Hat 8.0 software from the Red Hat Web site, http://www.redhat.com

Download any files to the /tmp/ directory of your PXE server.

10. If you downloaded updated RPM files from the previous step, copy them to the directory where you have chosen to place your PXE image.

In this example, it would be:

# cp /tmp/*.rpm /home/pxeboot/SunFire_8.0/RedHat/RPMS/

11. Copy the script file newest.pl from the temporary directory to the directory shown below:

# cp /tmp/rh80-pxefiles/newest.pl \
/home/pxeboot/SunFire_8.0/newest.pl

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

# cd /home/pxeboot/SunFire_8.0/RedHat/RPMS/

# perl /home/pxeboot/SunFire_8.0/newest.pl

You might see warnings about signatures. This is normal.

13. Copy the initrd.img file from the temporary directory to the following directory:

# cp /tmp/rh80-pxefiles/initrd.img /home/pxeboot/SunFire_8.0/

14. Copy the stage2.img file from the temporary directory to the following directory:

# cp /tmp/rh80-pxefiles/stage2.img \
/home/pxeboot/SunFire_8.0/RedHat/base/

15. Copy the vmlinuz file from the temporary directory to the following directory:

# cp /tmp/rh80-pxefiles/vmlinuz /home/pxeboot/SunFire_8.0/

16. Copy the kickstart file ks.cfg from the temporary directory to the following directory:

# cp /tmp/rh80-pxefiles/ks.cfg /home/pxeboot/SunFire_8.0/

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

nfs --server n.n.n.n --dir /home/pxeboot/SunFire_8.0/

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

18. Run the following command so that the installation knows about the SCSI and Network drivers:

# /usr/lib/anaconda-runtime/genhdlist /home/pxeboot/SunFire_8.0/

This command generates the hdlist file. This is accomplished through the program genhdlist.

19. On your PXE server, modify and save the file /home/pxeboot/pxelinux.cfg/default by adding 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.



Note - If the first three lines are already in the file, you do not need to add these lines. The remaining lines must added to the default file.



display motd
prompt 1
default SunFire_8.0

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

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

20. On your PXE server, modify and save the file /home/pxeboot/motd by adding the following entry to it:

PXE Server:
Please report any problems with these images to PXE SERVER ADMIN <admin@domain.com>

Current Default is: SunFire_8.0

Builds:
SunFire_8.0 - RH 8.0 2.4.18-14 Kernel, 1.3.10 aic, 4.4.19_4 e1000

Installing Red Hat Linux 8.0 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 install the Red Hat Linux 8.0 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 server is the target server to which you are installing Red Hat Linux 8.0 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.

The text that you used for the label value in Step 6 of Installing and Configuring the neopxe Boot Server Daemon displays.

4. Select the displayed Linux option.

5. When you are prompted at the boot: prompt, press Enter.

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

6. To configure the Red Hat 8.0 software operating system for your server, refer to the documentation available at the following site:

http://www.redhat.com/docs/manuals/linux

7. Continue with SCSI and Network Driver Upgrades, if needed.


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/

You need to copy the following RPM files that correspond to your kernel version:

Where version corresponds the driver version, kernel version, and operating system version.

For example with the e1000-bigmem version 4.4.19, kernel version 2.4.18-14, and Red Hat Linux 8.0 software, the driver name would be:

e1000-bigmem-4.4.19_2.4.18_14-rh80_4.i686.rpm

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 onto 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/

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

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

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/

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