C H A P T E R  3

Installing Red Hat Enterprise Linux 3 Software

This chapter describes how to install and update Red Hat Enterprise Linux 3 Software on Sun Fire V20 and Sun Fire V40z servers. Any differences in procedure between the two servers are noted.



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





Note - You can use the Sun Installation Assistant CD to help you install the operating system. The assistant also takes care of upgrading the SCSI and Network drivers for your server.



This chapter is organized into the following sections.


Installing Red Hat Enterprise Linux 3 Software From CDs

The tasks for installing Red Hat Enterprise Linux 3 software from CDs consist of the following procedures.

1. Install the Red Hat Enterprise Linux 3 software. See Installing the Software.

2. Update the Red Hat Enterprise Linux 3 software. See Updating the Operating System and Drivers.

Required Items

The CD installation procedure requires the following items.

Installing the Software



Note - If you are using the Sun Installation Assistant CD, you begin at Step 5.





Note - This procedure provides the steps for a text-mode installation. The GUI mode combines several of these steps into one screen.



1. Connect the keyboard and monitor to the appropriate connectors on the Sun Fire V20z or Sun Fire V40z server.

2. Power on the server and insert the Red Hat Enterprise Linux 3 CD 1 into the CD tray.

The server will boot off of the CD and display a boot: prompt.

3. At the boot: prompt, type the following command:

boot: linux text

4. When prompted to test the CD media, select OK to test the media or select Skip to bypass the media test.

After the CD media test (if you choose to run it), the Anaconda installer starts. This takes a few minutes.

5. At the Welcome screen, select OK.

6. Make the following selections when prompted:

a. Select the appropriate language.

b. Select your keyboard type.

c. Select No-mouse if you do not have a mouse connected, or verify that the mouse you have attached has been properly detected.

7. When prompted for disk partitioning, select Autopartition.

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

8. Select one of the following options in the Autopartition dialog box:

9. If you chose Remove all partitions on this server, the system displays a warning about data being removed from the drives. Select Yes.

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

You now proceed through the configuration screens.

a. To change the boot-loader, select GRUB or no boot-loader. Tab to OK and press Enter.

b. Specify the kernel options. Tab to OK and press Enter.

c. Add a password for the bootloader. Tab to OK and press Enter.

d. If you can dual-boot your server, select the OS to boot from your boot-loader. Tab to OK and press Enter.

e. Select the device from which to boot. Tab to OK and press Enter.



Note - If you are performing a GUI-mode installation, the configuration screens appear in the following order:

1. To change the boot-loader, select GRUB or no bootloader. Click Next.
2. If you can dual-boot your server, select the OS to boot from your boot-loader, and select the device from which to boot. Click Next.
3. Add a password for the bootloader. Click Next.



11. The Network Configuration screen appears.

You can apply network settings to the embedded ethernet port(s).

You can have the server obtain its network settings over DHCP or you can enter the static network-configuration information.

The default choice is DHCP.



Note - In a text-mode installation, you will see one screen for the network settings and and a second screen for entering a host name.

In a GUI-mode installation, these options are combined on one screen.



12. The Firewall Configuration screen appears.

You can enable or disable the firewall function. For greater network security, we recommend that you enable the firewall function.

The default setting is enabled.

13. In the Language Support screen, select any other additional languages you need to install.

14. In the Timezone screen, select the timezone in which the server is located.

15. In the Root Password screen, enter the superuser password of your choice.



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



You will be prompted to choose whether or not to customize the package selection.

16. In the Workstation Defaults screen, check the box to Customize software selection, then select OK.



Note - In a GUI-mode installation, this screen is labelled as Package Defaults.



17. In the Package Group Selection setup screen, select the appropriate packages for your environment.

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

18. Read the dialog box about the installation log, then select OK.

This installation of the RPMs will take about 10 minutes, depending on what you selected for installation. When you are prompted to switch a CD, the installer automatically ejects the CD.

19. When prompted to change CDs, insert the requested CD and press OK.

You might not need all the CDs, depending on which options you selected for installation.

20. If prompted, perform the following steps:

a. Select the default video interface detected by the installer.

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

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

21. Select OK in the Complete dialog box.

The installation is complete.

22. Continue to Updating the Operating System and Drivers for information on updating the Red Hat Enterprise Linux 3 Software.


Installing Red Hat Enterprise Linux 3 Software From a Network

The tasks for installing Red Hat Enterprise Linux 3 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.

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 the Software from a PXE Server.

4. Update the Red Hat software. See Updating the Operating System and Drivers.

Required Items

The PXE installation procedure requires the following items.

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 - For 32-bit users: The extracted directories described in the following procedure are for setting up a 64-bit network image. If you are setting up a 32-bit network image, some files and directories are slightly different.

For 64-bit, the extracted directory is: rhel3_64-pxefiles/
For 32-bit, the extracted directory is: rhel3_32-pxefiles/

All other directories and directions are the same for both 64-bit and 32-bit.





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



1. Insert Red Hat Enterprise Linux 3 CD 1 into your DHCP/PXE server and copy its contents to your PXE server, by typing the commands listed below:

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

# mkdir -p /home/pxeboot/SunFire_rhel3/

# mount /dev/cdrom /mnt/cdrom

# cp -a /mnt/cdrom/RedHat /home/pxeboot/SunFire_rhel3/

2. Copy the initial ramdisk and kernel from CD 1 into the base of the PXE image with the following commands:

# cp /mnt/cdrom/images/pxeboot/initrd.img \
/home/pxeboot/SunFire_rhel3/

# cp /mnt/cdrom/images/pxeboot/vmlinuz \
/home/pxeboot/SunFire_rhel3/

3. Unmount CD 1 with the following command and remove it from the server:

# umount /dev/cdrom

4. Insert Red Hat Enterprise Linux 3 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_rhel3/

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

5. Unmount CD 2 with the following command and remove it from the server:

# umount /dev/cdrom

6. Insert Red Hat Enterprise Linux 3 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_rhel3/

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

7. Unmount CD 3 with the following command and remove it from the server: :

# umount /dev/cdrom

8. Insert Red Hat Enterprise Linux 3 CD 4 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_rhel3/

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

9. Unmount CD 4 with the following command and remove it from the server:

# umount /dev/cdrom

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

# cp /tmp/rhel3_64-pxefiles/ks.cfg /home/pxeboot/SunFire_rhel3/

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

# cp /tmp/rhel3_64-pxefiles/bcm* /home/pxeboot/SunFire_rhel3/
# cp /tmp/rhel3_64-pxefiles/lsi* /home/pxeboot/SunFire_rhel3/

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

nfs --server n.n.n.n --dir /home/pxeboot/SunFire_rhel3/

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

13. 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_rhel3
label SunFire_rhel3
kernel SunFire_rhel3/vmlinuz

append ksdevice=eth0 console=tty0
load_ramdisk=1 initrd=SunFire_rhel3/initrd.img network
ks=nfs:
n.n.n.n:/home/pxeboot/SunFire_rhel3/ks.cfg

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



Note - For console-based installations, add console=ttyS0,19200 to the append line.



Installing the Software from a PXE Server

This procedure describes how to initiate the request from the target Sun Fire V20z or Sun Fire V40z server to download the boot image file from the PXE/DHCP server and to install the Red Hat Enterprise Linux 3 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 V20z or Sun Fire V40z server to which you are installing Red Hat Enterprise Linux 3 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. If you are prompted at the boot: prompt, type in the label you gave the image in Step 13 of Creating a PXE Install Image on the PXE Server.

The Red Hat Enterprise Linux 3 install image downloads onto the target Sun Fire V20z or Sun Fire V40z server.

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

6. Proceed to Updating the Operating System and Drivers.


Updating the Operating System and Drivers

The CD media may not contain the most up-to-date versions of the software. Since the media has been released, there have been many updates to the software.

See the following sections for instructions on updating the Red Hat Enterprise Linux 3 software.

Updating Red Hat Enterprise Linux 3 Software

The CD media does not contain the most up-to-date versions of the software. Since the media has been released, there have been many updates to the Red Hat Enterprise Linux software. To keep your system protected against security threats and increase stability, you should run the up2date program when the system is fully installed.

Refer to the Red Hat manual included with your Red Hat Enterprise Linux 3 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.

Upgrading SCSI and Network Drivers

The kernel that is installed on the system might not contain the optimal drivers that Sun Microsystems recommends. Updating the drivers ensures proper system performance.

The instructions below describe how to copy the latest drivers from the Sun Fire V20z and Sun Fire V40z Servers Documentation and Support Files CD. You can also download the driver RPMs from the product pages for the Sun Fire V20z and Sun Fire V40z servers. The following URL is valid for both servers:

http://www.sun.com/servers/entry/v20z/downloads.html

 

1. Determine which kernel is currently installed on the system by running the following command:

# rpm -qa | grep ^kernel

The following is an example of the output you might get:

kernel-2.4.21-4.EL.x86_64
kernel-smp-2.4.21-4.EL.x86_64
kernel-source-2.4.21-4.EL.x86_64

In this example, you are running the 2.4.21-4.EL.x86_64 kernel.

2. Insert the Documentation and Support Files CD into the server.

3. Mount the CD and locate the Ethernet and SCSI drivers by typing the following commands:

# mount /dev/cdrom /mnt/cdrom
# cd /mnt/cdrom/support/drivers/rhel3/64/



Note - If you are using the 32-bit version of Red Hat Enterprise Linux, the directory to change to is:
/mnt/cdrom/support/drivers/rhel3/32/



4. Determine which driver RPMs correspond to the kernel version, as determined in Step 1.

The filenames of the RPMs contain the kernel version and type. Using the example kernel versions shown in Step 1, the Ethernet (bcm5700) and SCSI (lsi) drivers would be:

bcm5700-7.1.22_2.4.21_4.EL-rhel3_1.x86_64.rpm
bcm5700-smp-7.1.22_2.4.21_4.EL-rhel3_1.x86_64.rpm
lsi-2.05.11_2.4.21_4.EL-rhel3_1.x86_64.rpm
lsi-smp-2.05.11_2.4.21_4.EL-rhel3_1.x86_64.rpm

5. Run the following command to install the RPM files:

# rpm -Uvh /mnt/cdrom/support/drivers/rhel3/64/bcm5700-drivers.rpm
# rpm -Uvh /mnt/cdrom/support/drivers/rhel3/64/lsi-drivers.rpm

Where bcm5700-drivers and lsi-drivers refer to the appropriate Ethernet and SCSI driver RPM files, as determined in Step 4.



Note - Be sure to pick the correct architecture of the driver for the kernel you are running. For example, if you are running the i686 kernel, be sure to choose the correct driver rpm that ends with .i686.rpm.





Note - The following steps are for installing NPS drivers, which include JNET and machine check kernel drivers, as well as POCI, a monitoring daemon. This software is required in order to enable hardware monitoring, OS-state reporting and SNMP proxy service to the server's service processor.



6. Locate the NPS RPM on the Documentation and Support Files CD that corresponds to your operating system version and architecture.

The NPS RPM files are located in OS-specific directories within this top level path on the CD: /support/sysmgmt/

7. Install the NPS RPM by typing the following command:

# rpm -Uvh /mnt/cdrom/support/sysmgmt/redhat/rhel3/nps-V2.rpm

Where nps-V2 represents the version and architecture of the NPS RPM file.

Alternatively, the NPS RPM can be compiled and installed from source by typing the following commands:

# cd /usr/src/redhat

# tar -xvf /mnt/cdrom/support/sysmgmt/src/nps-V2*.tar.gz

# rpm -bb SPECS/nps.spec

# rpm -ivh `find ./RPMS | grep nps`



Note - Some Linux variants might require the rpmbuild command instead of the rpm command. Check with the documentation for your version of Linux.



8. After successful installation, reboot the system by running the following command:

# reboot