C H A P T E R  4

Installing Red Hat Enterprise Linux

This chapter applies to the Sun Fire X4600 servers and to Sun Fire X4600 M2 servers and describes installing Red Hat Enterprise Linux (RHEL). This chapter contains the following sections:



Note - If you want to make the operating system boot drive part of a mirrored RAID configuration, the recommended procedure is to configure the RAID volume before you install the OS. To configure RAID volumes using your the server’s internal disk drives, see Appendix A.



About the RHEL Installation

If you have installed Red Hat Enterprise Linux software on other Intel or AMD Opteron servers, you are already familiar with how to install it on a Sun Fire X4600 server. The two most common methods to install Red Hat Enterprise Linux on your server are:

Important RHEL Limitations

Note that some versions of Red Hat have limitations:

Red Hat Installation and Administration Documentation

Before you install the Red Hat Enterprise Linux software on a Sun Fire X4600 server, consult the following Red Hat Enterprise Linux documentation.


Document

Description

Where to Find

README file

Contains late-breaking information about system requirements and system configuration for your version of the Red Hat Enterprise Linux software.

On the Red Hat Enterprise Linux CD 1, and online from http://www.redhat.com/docs/

Red Hat Enterprise Linux Quick Installation Guide

Brief printed guide containing useful information to assist you during the installation of Red Hat Enterprise Linux.

Included with the Red Hat Enterprise Linux distribution media

Red Hat Enterprise Linux Installation Guide

Full version of the printed Quick Installation Guide.

Included on the Red Hat Documentation CD, and available for download from http://www.redhat.com/docs/

Red Hat Enterprise Linux Introduction to System Administration

Introductory information for Red Hat Enterprise Linux system administrators.

Available for download from http://www.redhat.com/docs/manuals/enterprise/

Red Hat Enterprise Linux System Administration Guide

Information on customizing the Red Hat Enterprise Linux software.

Available for download from http://www.redhat.com/docs/manuals/enterprise/

System Administration for Diskless Booting

Information on configuring your server and Red Hat Linux for diskless booting.

Available for download as the Red Hat Enterprise Linux Installation Guide for the x86, Itaniumtrademark, and AMD64 Architectures at http://www.redhat.com/docs/manuals/enterprise/

Red Hat Enterprise Linux Security Guide

Guide for securing the Red Hat Enterprise Linux software.

Available for download from http://www.redhat.com/docs/manuals/enterprise/


Task Map for Red Hat Enterprise Linux Installation

Consult the following table to determine which sections in this document are relevant to the installation tasks that you want to perform.


Installation Task

Relevant Section

Collect information about your system and network.

Preparing to Install RHEL.

Install Red Hat Enterprise Linux from distribution media using a local or network-attached CD or DVD drive.

Installing RHEL From Distribution Media.

Update Red Hat Enterprise Linux operating system files.

Updating the Red Hat Enterprise Linux Operating System.



Preparing to Install RHEL

Although you can install the Red Hat Enterprise Linux software from a local CD/DVD, a remote CD/DVD, or the network, you will need to collect some information about your system and your network before you proceed with any of these installation methods.

Additional Software Updates or Patches

After installing the Red Hat Enterprise Linux software on the server, you might also need to update your system software with patches and packages. See Updating the Red Hat Enterprise Linux Operating System for details.

Obtaining Updated Media Kits

To install Red Hat Enterprise Linux on the Sun Fire X4600 server, you will need to obtain the Red Hat Enterprise Linux 4 Update Media Kit.

To obtain this kit, log into http://rhn.redhat.com.

You will need your enterprise account information to download the updated ISO images. An enterprise account is an account that the customer creates to access Red Hat's support network after purchasing the Red Hat Enterprise Linux media kit.

After you obtain the updated .iso images, write them to CDs and use them in place of the media you obtained with your Red Hat Enterprise Linux 4 box. This updated media contains important drivers that are required by the Sun Fire X4600 server.


Installing RHEL From Distribution Media

Red Hat Enterprise Linux provides both a text mode and an easy-to-use graphical interface for installing and configuring the operating system. At the boot prompt, you can select the interface that you want to use. Both options are shown later in this section.

Before You Begin

Installing Red Hat Enterprise Linux software from CDs consists of the following procedures:

1. Download the updated media kit from http://rhn.redhat.com.

See Obtaining Updated Media Kits.

2. Install the Red Hat Enterprise Linux software.

3. Update the Red Hat Enterprise Linux software.

See Updating the Red Hat Enterprise Linux Operating System.

Required Items

Installation from distribution media requires the following items:


procedure icon  To Install From Local Media

1. Turn on the system.

2. Insert the Red Hat Enterprise Linux Distribution CD 1 into the local DVD/CD drive on the Sun Fire X4600 server.

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

3. Do one of the following at the boot prompt, depending on which type of interface you want to use:

4. Refer to the Red Hat Enterprise Linux Installation Guide to guide you through the remainder of the installation process.

5. Proceed to Updating the Red Hat Enterprise Linux Operating System.


Installing the RHEL Using the Remote Console Application

This section explains how to install the Red Hat Enterprise Linux operating system on your server using the Integrated Lights Out Manager (ILOM) Remote Console application.

Use the following procedure to install the Red Hat Enterprise Linux 4 Update 3 or later OS using the ILOM Remote Console application.



Note - Read the Integrated Lights Out Manager (ILOM) documentation before completing the following steps. This guide provides details on using the ILOM Service Processor web interface to redirect the console.



procedure icon  To Install Using the ILOM Remote Console

1. Locate your Red Hat Enterprise Linux installation CD/DVD or the equivalent iso images.

2. Connect to the ILOM Service Processor web interface.

3. Click the Remote Control tab, then the Mouse Mode Settings tab.

4. If necessary, change the mouse mode to Relative Mouse Mode.

See the “Remote Console Application” information in the Integrated Lights Out Manager (ILOM) documentation for further instructions.

5. Click the Redirection tab.

6. Click the Launch Redirection button to start the JavaRConsole application.

7. Log in to the JavaRConsole.

8. Start keyboard and mouse redirection.

Select Keyboard and Mouse in the Devices menu.

9. Start CD/DVD redirection.

From the JavaRConsole Devices menu, you can redirect the CD in two ways:



Note - Floppy diskette redirection is also available through the JavaRConsole. See the Integrated Lights Out Manager (ILOM) documentation for more details.


10. Turn on the server using the ILOM web interface.

11. Set up the BIOS as follows:

a. Press CTRL-E to enter BIOS Setup Utility.

b. Select the Boot menu.

c. Select CD/DVD Drives.

d. Set AMI Virtual CD as the first boot device.

e. Press F10 to save changes and exit.

f. Reboot.

g. Press CTRL-P to select CD/DVD as the boot device.

12. When the boot prompt appears, type linux text.

13. When prompted to test the CD media before installation, select Skip if you do not want the media test to run.

14. Refer to the Red Hat Enterprise Linux Installation Guide to guide you through the remainder of the installation process.


Installing RHEL Using PXE

About Red Hat Enterprise Linux and PXE

The onboard network interface card (NIC) in your Sun Fire X4600 server supports the Preboot Execution Environment (PXE) network booting protocol. The system BIOS and network interface BIOS on your server automatically query the network for a DHCP server. If that DHCP server on the network has been configured to support the PXE protocol and PXE image servers on the same network, then the BIOS on your system can be used to install a bootable Red Hat Enterprise Linux image on your server.



Note - PXE is a powerful and convenient solution for setting up a number of Sun Fire X4600 servers so their configuration is identical.


Task Map

To take advantage of Red Hat Enterprise Linux and PXE on your network, you need to perform the following tasks.


Task

Related Sections

Obtain the updated media kit from http://rhn.redhat.com.

Obtaining Updated Media Kits.

Set up your Linux network and PXE server.

Preconfiguring Your Network to Support PXE Installation of RHEL.

Install Red Hat Enterprise Linux images on that PXE server.

Creating a PXE Install Image on the PXE Server.

Configure your server to install from a Red Hat Enterprise Linux image on a PXE server.

Installing RHEL From a PXE Server.


Preconfiguring Your Network to Support PXE Installation of RHEL

This section describes how to preconfigure your network running Red Hat Enterprise Linux to support PXE installation of Red Hat Enterprise Linux software on your server. These procedures assume that you already have a bootable server that is running a version of the Red Hat Enterprise Linux operating system to use as a PXE server.

Preconfiguring your network for PXE installation involves the following procedures:

Required Items

Preconfiguring your network for PXE installation requires the following items:

Downloading the Tools and Drivers CD Image

If you do not have access to the Tools and Drivers CD, you can download the iso image from the following URL:

http://www.sun.com/servers/x64/x4600 and select Downloads.

If you create your own CD from the download site, use this CD in place of the Tools and Drivers CD referenced in this procedure.


procedure icon  To Copy Files From the Tools and Drivers CD

This section describes how to copy the PXE support files, which are required for PXE configurations, from the Tools and Drivers CD.



Note - This example uses Red Hat Enterprise Linux 4. Replace rhel4 with the file name that corresponds to your version and update.


1. Insert the Tools and Drivers CD into the DHCP/PXE server.

2. Create a temporary directory to copy the PXE support files if /tmp does not exist. Type:

# mkdir /tmp

3. Type the following commands to copy the files to the /tmp/ directory:

# mount /dev/cdrom /mnt/cdrom

# cp /mnt/cdrom/linux/pxe/rhel4-pxefiles.tar.gz /tmp/

4. Uncompress and extract the contents of the tar file into the /tmp/ directory. Type:

# cd /tmp

# tar -zxvf rhel4-pxefiles.tar.gz

When you extract the file, a directory with all required files will be created, for example: /tmp/rhel4u3-pxefiles/


procedure icon  To Configure a DHCP Server

Complete the following steps on the server that will be your DHCP server.



Note - This example uses Red Hat Enterprise Linux 4. Replace rhel4 with the file name that corresponds to your version and update.


1. Turn on the server and log in as superuser.

2. Determine whether the DHCP server package is already installed on the server. Type:

# rpm -qa | grep dhcp-

3. If the DHCP server package is not listed, insert the Red Hat Enterprise Linux CD 5 and install the DHCP server. Type:

# mount /dev/cdrom /mnt/cdrom

# rpm -Uvh /mnt/cdrom/RedHat/RPMS/dhcp-*.rpm

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

# umount /mnt/cdrom

5. Set up your DHCP configuration file (for example, /etc/dhcpd.conf) so that only PXEClient requests receive PXEClient responses.



Note - If the server does not already have a dhcpd.conf file in its /etc directory, you can copy the dhcpd.conf file from the sample DHCP configuration file in the /tmp/rhel4u3-pxefiles directory.


Add the following entry to the DHCP configuration file (refer to the dhcpd.conf man page for more information):

class "PXE" {match if substring(option vendor-class-identifier, 0, 9) ="PXEClient"; option vendor-class-identifier "PXEClient"; vendor-option-space PXE; next-server n.n.n.n}

Where n.n.n.n is the PXE server’s IP address.

6. In the DHCP configuration file, edit the server-identifier entry:

server-identifier n.n.n.n

Where n.n.n.n is the PXE/dhcp server’s IP address.

7. Also in the DHCP configuration file, find the subnet entry fields:

subnet 1.2.3.0 netmask 255.255.255.0 {

range dynamic-bootp 1.2.3.100 1.2.3.200;

option routers 1.2.3.1;

option broadcast-address 1.2.3.225;

}

Edit the subnet, range, router and broadcast-address entries according to the PXE/dhcp server’s network configuration.

8. Start the DHCP service. Type:

# service dhcpd start

9. Configure the server to always start DHCP. Type:

# chkconfig dhcpd on


procedure icon  To Install Portmap on Your DHCP Server

1. Determine whether the portmap server package is already installed on the server. Type:

# rpm -qa | grep portmap

2. If portmap is not listed, insert the RHEL CD 2 and install the portmap service by typing the following commands:

# mount /dev/cdrom /mnt/cdrom

# rpm -Uvh /mnt/cdrom/RedHat/RPMS/portmap-*

3. Unmount the CD/DVD by entering the following command.

# umount /mnt/cdrom

4. Remove the CD/DVD from the server.


procedure icon  To Configure the TFTP Service on Your DHCP Server

1. Determine whether the TFTP server package is already installed on the server. Type:

# rpm -qa | grep tftp-server

2. If the TFTP server package is not listed, insert the RHEL CD 4 and install the TFTP service by typing the following commands:

# mount /dev/cdrom /mnt/cdrom

# rpm -Uvh /mnt/cdrom/RedHat/RPMS/tftp-server*

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

# umount /mnt/cdrom

4. Edit and save the /etc/xinetd.d/tftp file.

Make the following changes:

5. Restart the inetd server. Type:

# service xinetd restart


procedure icon  To Install and Configure the neopxe Boot Server Daemon

Complete the following steps on your DHCP server. The neopxe server is designed for use with a DHCP server that is running on the same system.



Note - This example uses Red Hat Enterprise Linux 4 Update 3. Replace rhel4 with the file name that corresponds to your version and update.


1. Install the neopxe boot server daemon onto the system that is your DHCP server. Type:

# cd /tmp/rhel4u3-pxefiles/neopxe-0.2.0

# ./configure

# make

# make install

2. Append the path /usr/local/sbin/neopxe to the rc.local file by typing the following command, making sure to use two greater-than signs:

# echo "/usr/local/sbin/neopxe" >> /etc/rc.d/rc.local

3. Copy the PXE Linux image from the /tmp/ directory. Type:

# mkdir /home/pxeboot

# cp /tmp/rhel4u3-pxefiles/pxelinux.0 /home/pxeboot

4. Configure the PXE Linux image. Type:

# mkdir /home/pxeboot/pxelinux.cfg/

# touch /home/pxeboot/pxelinux.cfg/default

5. Edit the /usr/local/etc/neopxe.conf configuration file, which is read by neopxe at startup.

If the neopxe.conf file is not in the /usr/local/etc directory, you can copy it from the /tmp/rhel4u3-pxefiles/neopxe-0.2.0/ directory.

A valid configuration file must have entries for each of the following lines, including at least one service line.

ip_addr=n.n.n.n

prompt=boot-prompt-string

prompt_timeout=timeout

service=service-number,boot-server,boot-file,label

Where:

For example:

ip_addr=192.168.0.1

prompt=Press [F8] for menu.. .

prompt_timeout=10

service=1,192.168.0.1,pxelinux.0,Linux

service=2,192.169.0.1,nbp.unknown,Solaris



Note - Refer to the neopxe.conf man page for more information.


6. Start the neopxe daemon. Type:

# /usr/local/sbin/neopxe


procedure icon  To Configure the NFS Service on Your DHCP Server

1. Determine whether the NFS service package is already installed on the server. Type:

# rpm -qa | grep nfs-utils

2. If the NFS service package is not listed, insert the Red Hat Enterprise Linux CD 2 and install the NFS service with the following commands:

# mount /dev/cdrom /mnt/cdrom

# rpm -Uvh /mnt/cdrom/RedHat/RPMS/nfs-utils-*

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

# umount /mnt/cdrom

4. Edit and save the /etc/exports file to add the following line to it:

/home/pxeboot *(no_root_squash,no_subtree_check,insecure)

5. Start the NFS service. Type:

# service nfs start

6. Configure the server to always start the NFS service. Type:

# chkconfig nfs on

# chkconfig nfslock on



Note - If you are using a DNS server, verify that DNS entries exist for the range of addresses defined in the PXE subnet dynamic-bootp entry in the dhcpd.conf file. If you are not using a DNS server, edit the /etc/hosts file to add the range of host addresses found in the PXE subnet dynamic-bootp entry in the dhcpd.conf file.



procedure icon  To Disable the Firewall

If you enabled firewall security when you installed Red Hat Enterprise Linux software on the system that will be your PXE server, complete the following steps to disable the firewall so that PXE clients can download from the server.



caution icon Caution - Network security vulnerability. When you disable the firewall protection on the system that is your PXE server, the security of the data on that server cannot be ensured. If this server is networked outside of your local intranet, be sure to re-enable the firewall after downloading software to PXE clients.


1. Stop the ipchains service. Type:

# service ipchains stop

2. Stop the iptables service. Type:

# service iptables stop

3. Stop the ipchains service from starting when you restart the server. Type:

# chkconfig ipchains off

4. Stop the iptables service from starting when you restart the server. Type:

# chkconfig iptables off



Note - You might encounter error messages if the ipchains service is not installed on the server. You can safely ignore these messages.


5. Reboot the PXE/DHCP server.

6. Refer to the Creating a PXE Install Image on the PXE Server.

Creating a PXE Install Image on the PXE Server

This procedure describes how to create a Preboot Execution Environment (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.

Before You Begin

Before you install a Red Hat Enterprise Linux image on your PXE server, you must configure your Linux network to support PXE images. See Preconfiguring Your Network to Support PXE Installation of RHEL.

Required Items

The PXE installation procedure requires the following items:


procedure icon  To Create a RHEL Image on Your PXE Install Server

1. Insert the Tools and Drivers CD into the CD/DVD drive of the DHCP/PXE server.

2. Type the following commands to copy the Sun support files from the CD to the /tmp directory on your DHCP/PXE server:



Note - The compressed .tar file that is used in this step depends on which Red Hat Enterprise Linux you are creating an install image for. The remainder of the instructions will assume that Red Hat Enterprise Linux 3 is being used. Modify the example based on the substitutions shown in TABLE 4-1.



TABLE 4-1 Red Hat Enterprise Linux Installation tar Filenames

Red Hat Enterprise Linux OS

Compressed .tar File Name

RHEL 3 32- and 64-bit

rhel3-pxefiles.tar.gz

RHEL 4 64-bit

rhel4-pxefiles.tar.gz

RHEL 5 64-bit

rhel5-pxefiles.tar.gz


# mount /dev/cdrom /mnt/cdrom

# cp -a /mnt/cdrom/support/pxeboot/rhel4-pxefiles.tar.gz /tmp

# cd /tmp

# tar -zxvf rhel4-pxefiles.tar.gz

# umount /mnt/cdrom

3. Set up the directory structure that will hold the Red Hat Enterprise Linux software. Type:

# mkdir -p /home/pxeboot/rhel4/



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


4. For each Red Hat Enterprise Linux Distribution CD, type the following commands to copy the contents of the Distribution CD to the appropriate PXE target subdirectory:

# mount dev/cdrom /mnt/cdrom

# cp -r /mnt/cdrom/* /home/pxeboot/rhel4/

# umount /mnt/cdrom



Note - Eject and insert RHEL CDs only when the CD/DVD drive is unmounted.


5. Copy the vmlinuz and initrd.img files to the appropriate PXE target subdirectory (/home/pxeboot/rhel4/).


# cp /home/pxeboot/rhel4/images/pxeboot/vmlinuz /home/pxeboot/rhel4/

# cp /home/pxeboot/rhel4/images/pxeboot/initrd.img /home/pxeboot/rhel4/


6. Copy the kickstart file ks.cfg to your PXE server. Type:

# cp /tmp/rhel4u3-pxefile/ks.cfg /home/pxeboot/rhel4/

The kickstart configuration file contains a configuration that might not be optimal for your operating environment. Modify the file as necessary to suit your environment.

For example, to make the RHEL5 installation process fully automatic, add the following line to the end of the kickstart configuration file:

key --skip

7. On your PXE server, edit and save the kickstart file: /home/pxeboot/rhel4/ks.cfg.

Edit the nfs line is as follows:

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

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

8. Add the following entry to the file /home/pxeboot/pxelinux.cfg/default:



Note - Type the text block from append through ks.cfg as one continuous string with no returns.


default rhel4

label rhel4

kernel rhel4/vmlinuz

append ksdevice=eth0 console=tty0 load_ramdisk=1

initrd=rhel4/initrd.img network

ks=nfs:n.n.n.n:/home/pxeboot/rhel4/ks.cfg

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



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


9. Save the modified version of the /home/pxeboot/pxelinux.cfg/default file.

Installing RHEL From a PXE Server

This procedure describes how to configure your Sun Fire X4600 server to initiate the request to download the boot image file from the PXE/DHCP server and how to install the Red Hat Enterprise Linux boot image onto your Sun Fire X4600 server.

Before You Begin

Before you configure your server to install Red Hat Enterprise Linux from a PXE server, you need to have done the following:


procedure icon  To Install a RHEL Image from a 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 X4600 server to which you are installing Red Hat Enterprise Linux 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. When prompted, press the F8 key to begin downloading the PXE boot image.

4. At the boot: prompt, type in the label you gave the image when you installed a Red Hat Enterprise Linux image on the PXE server.

The Red Hat Enterprise Linux install image downloads onto the target Sun Fire X4600 server.

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

6. Update the operating system files.

See Updating the Red Hat Enterprise Linux Operating System.


Updating the Red Hat Enterprise Linux Operating System

This procedure describes how to update the Red Hat Enterprise Linux operating system.

Before You Begin

Since software is constantly being updated, your distribution media might not contain the most up-to-date versions of the operating system.

The following two procedures assume that you have already installed the Red Hat Enterprise Linux software on the Sun Fire X4600 server. These procedures explain how to update that Red Hat Enterprise Linux installation with the latest OS.

If your system is on a publicly accessible network, updating your system can help to improve security.



Note - If you install RHEL 4 U3 on a server with eight or less logical CPUs, then later upgrade the server to more than eight logical CPUs, you must use the largesmp kernel package for 64-bit platforms. The largesmp kernel is included with RHEL 4 U3 and later versions. The package is called kernel-largesmp-2.6.9-xxx.EL.yyy.rpm. Where xxx specifies the kernel version, and yyy specifies the platform name (either x86_64 for AMD®, or ia64 for Intel®).



procedure icon  To Update the Red Hat Enterprise Linux Software

These procedures assume that your system has access to the internet.

1. Set up the up2date program on the server.

Refer to the documentation included with your Red Hat Enterprise Linux media kit for details.

2. Run the up2date program.

Select the kernel packages in the available package updates section.


procedure icon  To Update the RHEL 5 Software

Your system must have access to the internet and be registered with the Red Hat Network.

1. To run the yum update program, enter:

# yum

The program checks that the machine is registered with Red Hat Network. If so, yum downloads necessary updates from the Red Hat Network repository.

2. Answer the questions and make your choices before the packages are downloaded and installed.

You should periodically update your system using yum.

For more information, refer to the man page. Enter:

# man yum


Updating the RHEL SCSI Drivers

If you install your RHEL OS with SIA, these drivers are automatically updated. If you install the OS manually, you must update the drivers yourself.


procedure icon  To Update the RHEL SCSI Drivers

1. Insert the Tools and Drivers CD for your Sun Firetrademark X4600 or X4600 M2 server and mount it onto the directory /mnt.

2. Enter the following commands:

# cd /mnt/Linux/drivers

# rpm -ivh driver-filename

For example, for RHEL 5.1 and 5.2, 64 bit for the Sun Fire X4600 M2 server:

# cd /mnt/Linux/drivers

# rpm -ivh mptlinux-4.00.43.00-1-rhel5.x86_64.rpm



Note - Check the /linux/drivers directory on your Tools and Drivers CD for the correct driver file name for your operating system.


Installation of the new drivers is now complete.

3. Reboot the server for the changes to take effect.