HP Insight Foundation Suite for Integrity with Linux User's Guide HP Smart Setup HP Support Pack HP Part Number: 5992-3193 Published: March 2010 Edition: 2.
© Copyright 2007–2010 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Table of Contents About This Document.........................................................................................................9 Additional Documentation.....................................................................................................................9 Intended Audience.................................................................................................................................9 Typographic Conventions......................................................
EFI Boot Manager............................................................................................................................37 EFI Shell...........................................................................................................................................38 HP Smart Setup Utilities.......................................................................................................................38 Accessing HP Smart Setup Utilities......................................
Installing the MPT Fusion HBA Driver on RHEL 5 and RHEL 5+ using a Xen Kernel Hangs the Server....................................................................................................................................................58 HP System Management Homepage Session Time-out Error..............................................................60 HP SAS Integrated Raid (IR) Configuration Utility May Cause Kernel Panics on RHEL4U7.............
List of Figures 1-1 1-2 1-3 3-1 3-2 3-3 3-4 3-5 3-6 3-7 3-8 3-9 3-10 3-11 3-12 3-13 4-1 6 Serial Console Configuration........................................................................................................16 VGA Console Configuration.........................................................................................................16 Installation Overview....................................................................................................................
List of Tables 1-1 2-1 D-1 Supported Minimum OS Distributions by HP Integrity Server...................................................14 Graphics Support on Server Models.............................................................................................21 Supported Products Matrix...........................................................................................................
About This Document This document describes how to use the HP Insight Foundation Suite for Integrity with Linux (IFIL) V2.7 product. • • The HP Smart Setup software prepares your system for installation of the Linux operating system (OS). The HP Smart Setup EFI-based setup utility (EBSU) utility assists with tasks such as configuring storage adapters, upgrading firmware, preparing a system hardware inventory, and installing diagnostics tools.
Variable The name of a placeholder in a command, function, or other syntax display that you replace with an actual value. [] The contents are optional in formats and command descriptions. If the contents are a list separated by |, you must choose one of the items. {} The contents are required in formats and command descriptions. If the contents are a list separated by |, you must choose one of the items. ... The preceding element can be repeated an arbitrary number of times.
Manufacturing Part Number Supported OS Supported Versions Edition Number Publication Date 5991-7635 RHEL SLES RHEL3U8, RHEL4U4 and later, 2.0 and RHEL5 SLES8 (HP Smart Setup only), SLES9SP3 and SLES10 March 2007 5991-6413 RHEL SLES RHEL3U8 and RHEL4U4 and later SLES8 (HP Smart Setup only), SLES9SP3 and SLES10 1.2 November 2006 5991-6413 RHEL SLES RHEL3U8 and RHEL4U4 and later SLES8 (HP Smart Setup only) and SLES9SP3 1.1 September 2006 5991-5295 RHEL RHEL4U3 1.
In Asia Pacific: +8522 599 7777 In Europe/Africa/Middle East: +41 22 780 81 11 For product information, contact any of the HP worldwide sales offices or HP Channel Partners (in the United States, call 1 800 637 7740). HP Encourages Your Comments HP encourages your comments concerning this document. We are committed to providing documentation that meets your needs. Send any errors found, suggestions for improvement, or compliments to: docsfeedback@hp.
1 Planning the Installation Installing the Linux operating system (OS) on an HP Integrity server involves preparing the hardware for the OS installation, installing the OS, and updating the system with the latest OS patches. This chapter helps you plan the installation based on the server model, the OS edition, the source of the OS media, and your network environment. Subsequent chapters guide you through the installation process.
The following table provides the minimum RHEL and SLES OS distributions that are supported using the latest HP Insight Foundation Suite for Integrity with Linux: Table 1-1 Supported Minimum OS Distributions by HP Integrity Server Server RHEL Distributions SUSE Distributions BL860c RHEL4U6, RHEL5U1 SLES10, SLES11 BL870c RHEL4U6, RHEL5U1 SLES10SPI, SLES11 cx2620 RHEL4U4 None rx1600 RHEL None rx1620 RHEL4, RHEL5 SLES10 rx2600 RHEL4 None rx2620 RHEL4, RHEL5 SLES10 rx2660 RHEL4U4, RHEL5
1. Go to the Open Source and Linux from HP website at: http://www.hp.com/go/integritylinux 2. 3. Click Linux certification and support matrices. Select the appropriate Linux distribution tab, locate the server name of interest, and then click the link. Detailed product information, downloads, documentation, and specific certification information is provided in a categorized listing.
Using a Serial Console A serial console is a PC running terminal emulation software, such as a Secure SHell (SSH) client like PuTTY (available from the web or on your Linux system). Using the minicom or cu command, connect to the server through the Management Processor (MP) serial port or LAN port. Figure 1-1 shows serial consoles connected to an HP Integrity rx4640 server.
Using the HP Smart Setup EBSU Utility You can use HP Smart Setup both before and after the OS is installed. HP recommends that you obtain the latest version of the HP Insight Foundation Suite for Integrity with Linux. For more information about downloading HP Smart Setup, see “Obtaining the Latest HP Insight Foundation Suite for Integrity with Linux” (page 19). • Before Installing the OS Use any bootable, removable media containing HP Smart Setup to boot the server.
Figure 1-3 Installation Overview There are minor differences in the sequence of tasks or the interface you use to perform them based on your choice of console and installation media. Use the detailed instructions in the following chapters, and note any warnings or cautions that might apply.
2 Preparing for Installation Preparing your server for an OS installation involves setting up a console (VGA, serial, or both) and preparing the hardware for installation. If you are migrating from another OS, you must also ensure that the server platform and its peripheral devices are compatible with Linux before proceeding. This chapter provides detailed instructions for each task.
5. Verify existing device compatibility at the HP Integrity server connectivity website: http://www.hp.com/go/serverconnectivity 6. Verify storage compatibility by reviewing the HP Integrity Server-Storage Support Matrices located at: http://www.hp.com/products1/serverconnectivity/support_matrices.html NOTE: This list is not exhaustive because storage vendors may support more configurations than those indicated at this site.
3. 4. 5. Use the Keyboard Configuration Panel to map the Backspace character to Ctrl-H. Boot the server. Run the terminal emulator and press Enter. The MP> prompt is displayed if you are using the Management Processor; otherwise, the server's output is shown. NOTE: Before the Linux OS is booted, all console interaction occurs through EFI. To modify the default local graphics display to a serial console path, you must configure a single serial port (UART) for both Console-In/Out in the EFI boot manager.
2. 3. 4. Make a list of all device connections so you can reconnect them after the installation is completed. Disconnect all mass storage devices from all controllers except the boot controller. Configure the boot controller and boot drive. NOTE: If you are using an HP SmartArray controller, see the Controller's User Guide. You can interrupt the boot process to invoke the EFI-based SmartArray configuration utility, ORCA. To invoke this utility press F8 on the VGA console or Esc–8 on the serial console.
5. Change directories to \EFI\boot, and then enter the following: # bootia64.efi The Smart Setup EBSU entry is created in the EFI Boot Manager as a selection for booting to launch the HP Smart Setup EBSU utility. Enabling a USB Device To access a USB HDD device, you must enable the EFI shell to detect and then access it using the following steps: IMPORTANT: 1. 2. 3. 4. The USB HDD device must be formatted with a FAT32 file system. From any Linux system, go to the http://www.hp.
11. Change directories to \EFI\boot, and then enter the following: # bootia64.efi The Smart Setup EBSU entry is created in the EFI Boot Manager as a selection for booting to launch the HP Smart Setup EBSU utility. NOTE: This entry may fail if you change the USB connection. You must execute the preceding steps again to reconnect the USB HDD device.
3 Installing the OS and Updating the Server This chapter provides instructions for installing Linux using the HP Smart Setup EBSU utility or a cold installation. You can install the HP Support Pack after installing the OS. Using HP Smart Setup to Install the OS The HP Smart Setup EBSU utility provides an easy-to-use interface for installing the OS and for performing other tasks, such as configuring storage adapters, upgrading firmware, partitioning the hard disk, and installing diagnostic tools.
NOTE: The entry Smart Setup EBSU (if configured) are not displayed in all EFI Boot Managers. If this entry does not appear, perform the steps detailed in “Accessing the Removable Media Devices Using EFI” (page 22). 3. The HP Smart Setup EBSU utility starts and displays the introduction screen. Press Enter to accept the default selection and continue. The Main Menu is displayed, as shown in Figure 3-2.
Based on the type of server, the option to configure either the Advanced Configuration and Power Interface (ACPI) or maximum payload size (MPS) setting appears. Use the following steps to configure your system's ACPI or MPS settings properly: Select System Settings and press Enter. Choose one of the following processes as appropriate for your system, either ACPI or MPS: ACPI Setting a. The following screen is displayed: Figure 3-4 Configure the ACPI Setting b. c. d.
NOTE: This setting cannot be changed for the rx2660, rx3600, and rx6600 PCI-X servers, therefore, this menu option is not available. 5. Select Configure Storage Adapters and press Enter. A submenu displays the list of adapters on the system, as shown in Figure 3-6. Figure 3-6 Configure Storage Adapters Option NOTE: Prior to launching the Smart Setup wizard, you must use the Configure Storage Adapters option to ensure that Linux is installed with the desired storage configuration.
NOTE: If you have just configured a RAID volume, then you must reboot the system so that it is detected. Additionally, on rx7620 and rx8620 servers, you must run the search all command from the EFI shell before attempting to use this volume. 10. To launch the Smart Setup wizard, from the Main Menu select Smart Setup and press Enter, as shown in Figure 3-8. Figure 3-8 Select Smart Setup 11. Smart Setup provides an introduction to the wizard.
Figure 3-10 Page 1: Update Firmware, Cell-Based Servers For either server type, all hardware devices present are listed and automatically selected if updating is necessary. If multiples of one type of PCI adapter exist, only those adapters that are in need of updating are actually upgraded, provided that the adapter flasher enables the selection of adapters to flash. 12. Select the devices with firmware that you want to update.
13. Make the appropriate selections for the options on Smart Setup Page 2 as follows: a. For question 2, specify the logical volume on which you want to create partitions. NOTE: The EFI System Partition (ESP) and the HP Service Partition (HPSP) will be created on the chosen logical volume to simplify the maintenance of your server. b. For question 3, specify the option to install the Drive Explorer utility, which enables you to browse a drive in EFI.
18. A prompt is displayed with a message directing you to insert the Linux installer media in the CD or DVD drive, as shown in Figure 3-13. IMPORTANT: If you are using a serial console, prior to starting the Linux OS Installation, see “Configuring and Using a Serial Console” (page 51) and follow the instructions. Figure 3-13 Inserting the Linux Installer Media Insert the Linux Installer media and press Enter. The Linux OS installation completes.
To install the OS, follow these steps: 1. 2. Begin the OS installation as described in the installation guide for the OS you are installing. Select the defaults (or configure as needed) until the Firewall Configuration screen appears. Modify the selections offered as follows: a. b. Click the No firewall radio button to disable the firewall. For RHEL4 or RHEL5, set Enable SELinux to Enable to use a security policy.
Installing the Fibre Channel HBA Drivers or Inbox Driver Kits for Linux If your system contains Fibre Channel Host Bus Adapters (HBAs), you should ensure that the most current drivers supported by HP are installed; this is applicable to all releases of Linux distributions.
1. 2. 3. 4. 5. 6. 7. Go to http://www.hp.com/. Click Support & Drivers. Click Download drivers and software (and firmware). In the For Product field, enter the model number of your Fibre Channel adapter (for example, AD300A). Press Go. Select the appropriate OS from the Product search results list. Click the Download button for the latest Linux Driver Kit for Qlogic HBAs and Qlogic-based mezzanine HBAs driver to obtain a tar archive of all necessary files.
NOTE: To avoid any potential issues, review the known issue “Installing the MPT Fusion HBA Driver on RHEL 5 and RHEL 5+ using a Xen Kernel Hangs the Server” (page 58). For additional information, see the documentation that is included with the MPT Fusion driver update.
4 EFI and HP Smart Setup Media Utilities This chapter describes functions available through the HP Smart Setup EBSU utility and provides an easy-to-use interface to upgrade the firmware, partition the hard disk, install diagnostic tools, configure storage controllers, and run other EFI utilities. Using the Option ROM Configuration for Arrays Utility Option ROM Configuration for Arrays (ORCA) is an EFI utility that enables you to configure a RAID array without booting Linux.
Figure 4-1 EFI Boot Manager EFI Shell Available as a selection from the EFI Boot Manager, the EFI Shell provides a command-line interface from which you can get information about the system, install an operating system, boot the operating system, execute batch scripts, launch EFI applications, load EFI drivers, and manage files and system variables. For Additional Information Use the following resources to obtain additional EFI information. • The Intel™ EFI website: http://developer.intel.
The HP Smart Setup EBSU utility provides the following capabilities: • • • Configure Storage Adapters—Configures bootable I/O adapters. A submenu provides a list of storage adapters from which to choose.
5 Installing and Using the HP Support Pack This chapter provides instructions for installing and using the HP Support Pack. This contents of this software package must be installed after installation of the OS only.
For more information, see HP Insight Management Agents for Linux on HP Integrity Servers: Installation Guide and Release Notes: http://www.docs.hp.com/en/5991-2731/ HP System Management Homepage The HP System Management Homepage (SMH) is a web server that can be used by HP web-enabled system management software. The System Management Homepage provides an interface between the HP Insight Management Agents and the HP manageability tools.
HP Array Configuration Utility – Command Line Interface HP Array Configuration Utility – Command Line Interface (ACU-CLI) for Linux on Itanium-based systems is an online tool that can be used to manage and configure Smart Array-based storage controllers. The HP ACU-CLI is an interactive command console that provides immediate feedback to the user, and is functionally equivalent to the ACU GUI.
The WBEM schema files for the HP Utilization Provider are installed at /opt/util/mof. For more information, see utild(1M). HP SmartSetup Scripting Toolkit The SmartSetup Scripting Toolkit (SSTK) enables you to deploy a large number of HP Integrity servers rapidly and efficiently. Using SSTK, you can develop custom scripts that simplify server deployments by automating various hardware configuration and software installation operations.
should verify that you do not need these utilities before you remove them. The HPIMA, ACU-CLI, and HP SMH utilities do not require OpenPegasus. The installer prompts you to remove OpenWBEM if you choose to install any of the above packages that require OpenPegasus. You are first prompted to view more information about the package before removal, and then you are prompted to remove the OpenWBEM package from your system.
3. Set execute permissions on the downloaded file: # chmod a+x jrockit-R27.5.0-jdk1.5.0_14-linux-ipf.bin 4. Run the self-extracting binary to extract the RPM file: # ./jrockit-R27.5.0-jdk1.5.0_14-linux-ipf.bin NOTE: The initial "./" is required if you do not have "." (a period) in your PATH environment variable. A binary license agreement is displayed. 5. You must agree to the BEA JRockit 5.0 JDK license agreement to proceed with the installation.
1. Start the installer: # ./install.sh The following message is displayed: Welcome to the HP Insight Foundation suite for Integrity with Linux version *.**. For the latest information and downloads go to http://www.hp.com/go/integritylinuxessentials. Press to continue the installation of the current version of the HP Support Pack. 2. You are prompted to make additional selections based on the software update option you selected in the previous step.
Menu for SLES11: 1. Install HP Insight Management WBEM Webapp via HP SMH 2. Install HP Insight Management WBEM Providers 3. Install HP Management Base for Integrity and Proliant Servers 4. Install HP System Management Homepage 5. Install The Open64 Compiler Suite v4.2.1 6. Install MPT Fusion SAS Integrated RAID configuration utility 7. Install HP Command Line Array Configuration Utility 8. Install Everything 9. Uninstall IFIL and return to this menu 10. Configure Software Delivery Repository access 11.
installer automatically exits after all products are updated or installed. Uninstall IFIL This option is displayed only when HP Management Base is installed on the system. To remove the IFIL product, including HP Management Base, enter the appropriate option number and press Enter. The installer returns to the menu after the entire IFIL product is removed. 3. Enter an option from the menu and press Enter.
NOTE: If you need to use a proxy to access the repository, consult the manual pages of the tool you are using to access the repository. for example, use apt-get, yum, zypper, to set up the correct proxy configuration. You can also set the http_proxy environment variable by entering the following: export http_proxy=http://proxy_web_addres:port Obtaining the "bootstrap.sh" Script You can review the content of the boottstrap.sh script to satisfy any security or invocation concerns.
A Configuring and Using a Serial Console Before the Linux operating system (OS) is booted, all console interaction occurs through EFI. To modify the default local graphics display to be a serial console path, you must configure a single serial port (UART) for both Console-In/Out in the EFI boot manager. This configuration allows the Linux kernel to interpret the UART as ttyS0 on system boot sending output to the selected display screen.
IMPORTANT: Exactly one UART must be selected in the EFI Console-In/Out tables for a serial console to work. The UART selected in this table is ttyS0. The format of the console parameter is as follows: console=ttySn[,spb] n = Serial line where: s = Speed Example: 9600, 19200, 38400, 57600, 115200 (9600 is the default if no speed is specified. 115200 is the maximum for HP UART.) p = Parity Example: n (no parity, typical case) b = Bit Encoding. Example: 7, 8 (8 is the typical case).
B HP Support Pack Dependencies Some software products contained in the HP Support Pack have dependencies or prerequisites that may or may not, already be available on your system. If there are dependencies that are not delivered with the installer or with the Linux OS installation, an error message displays with information on the missing software packages or files and the installation process is aborted.
glibc openssl open64-4.2.1-xxx.ia64.rpm need below packages: gcc glibc info perl RHEL5 The following list provides information about software contained in RHEL5 and the related dependencies. hpacucli-8.28-xxx.ia64.rpm need below packages: glibc prctl libunwind hpima-3.12-xxx.rhel5.ia64.rpm need below packages: compat-libstdc++-296 e2fsprogs-libs glibc net-snmp net-snmp-libs openssl perl redhat-release tcp_wrappers zlib hpima-webapp-4.5-xxx.rhel5.ia64.rpm need below packages: net-snmp hpmgmtbase-2.11-xxx.
glibc libstdc++ libunwind hp.com-npartition-cmds-1.03.00-xxx.sles10.ia64.rpm need below packages: glibc libgcc libstdc++ libunwind hp.com-parmgr-2.02.04-xxx.sles10.ia64.rpm need below packages: None hp-smx-02.05-xxx.sles10.ia64.rpm need below packages: glibc libgcc libstdc++ libunwind hp-utilprovider-01.07-xxx.sles10.ia64.rpm need below packages: glibc libgcc libstdc++ libunwind mptsas_cfggen-2.0.30-xxx.ia64.rpm need below packages: None open64-4.2.1-xxx.ia64.
C Known Issues This appendix contains known issues with the HP Insight Foundation Suite for Integrity with Linux product, which undergoes rigorous testing before each release. From HP test activities to date, the following items have been uncovered that you should keep in mind. HP Insight Management WBEM Providers on Pegasus cimserver Supports Multi-Process Mode Only HP Insight Management WBEM providers running on Pegasus cimserver (RHEL5, SLES10) only support running in multi-process mode.
with the following line: auth 3. required pam_succeed_if.so quiet_success user ingroup sfcb Restart SFCB by entering the following: # /etc/init.d/sfcb start Configuring Storage Adapters The Configure Storage Adapters function in the HP Smart Setup EBSU utility requires that the EFI driver for the storage adapter be installed prior to configuring storage adapters.
This is the result of the MPT Fusion driver rebuilding the initrd file and modifying elilo.conf when the it is installed. The following is a comparison of the elilo.conf file contents before and after the driver installation: Before After prompt timeout=20 default=linux relocatable prompt timeout=20 default=HP #Corresponds to kernel 2.6.18-92.el5xen # (previously, default=linux) relocatable image=vmlinuz-2.6.18-92.el5xen vmm=xen.gz-2.6.18-92.el5 label=linux initrd=initrd-2.6.18-92.el5xen.
label=HP #Corresponds to kernel 2.6.18-92.el5xen initrd=HP-initrd-2.6.18-92.el5xen.img read-only root=/dev/VolGroup00/LogVol00 append="-- rhgb quiet" 3. Reboot the server. HP System Management Homepage Session Time-out Error The default value of the ui-timeout option in the HP SMH is 20 seconds. For servers with numerous devices, 80 CPUs for example, the home or device pages may take more than 20 seconds to load and you may encounter a timeout message in your browser.
D Supported Products Matrix This appendix lists the adapters that are supported by the HP Insight Foundation Suite for Integrity with Linux in each of the supported OS distribution release. Table D-1 lists the I/O adapter part number by category, a brief description of the part, and the initial, supported Linux distribution(s) including later updates or service packs.
Table D-1 Supported Products Matrix (continued) Part Number Description RHEL Support 4 4U1 SLES Support 4U3 4U4 4U6 5 5U1 10 10 SP1 10 SP2 11 LAN 62 447883B21 4-port GbE Mezz A5506B PCI 4 Port 100Base-TX LAN Adapter A6794A SCSI & LAN Core I/O (Procurium) X X A6865A PCI core I/O for SuperDome X X A7061A Win/Linux X 1000Base-T Gigabit Eth Adpt X X A7073A Win/Linux 1000Base-SX Gigabit Eth Adpt X X X A9899A Win/Linux 2 port 1000Base-SX Giga Adptr X X X X A9900A Win/Linu
Table D-1 Supported Products Matrix (continued) Part Number Description RHEL Support 4 BL860c Embedded I/O for BL860c BL870c Embedded I/O for BL870c rx1600/ rx2600 Embedded I/O for X rx1600/rx2600 rx1620/ rx2620/ cx2620 Embedded I/O for X rx1620/ rx2620/cx2620 rx2660 Embedded I/O for rx2660 4U1 SLES Support 4U3 4U4 4U6 5 X X 5U1 10 X X X X X X X X 10 SP1 10 SP2 11 X X X X MP A6695 69101 SCSI and MP Core I/O A6875A HP Management X Processor Adapter for ZX6000 A9918A Co
Table D-1 Supported Products Matrix (continued) Part Number Description RHEL Support 4 4U1 SLES Support 4U3 4U4 4U6 5 X 5U1 10 X 10 SP1 X 10 SP2 11 AH226A HP PCIe Smart Array E500 SAS Controller X SA P400 (core 1) PCIe 8-port int SAS Smart Array P400 (Core I/O rx2660) X X X X SA P400 (core 2) PCIe 8-port SAS Smart Array P400 (Core I/O rx3600, rx6600) X X X X SA P600 PCI-X 8-port int/4-port ext SAS Smart Array P600 (Core I/O rx3600, rx6600) X X X X SA P800 PCIe 8-port int/
Table D-1 Supported Products Matrix (continued) Part Number Description RHEL Support 4 4U1 SLES Support 4U3 4U4 4U6 5 5U1 10 X X 10 SP1 10 SP2 11 AB290A HP PCI-X 2p 1000BT, 2p U320 SCSI Adpter X X AB306A Core IO for the rx86/rp8420 server X AB314A HP Integrity rx8640 Core I/O Adapter X X X X AB31560201 Core I/O for Mittlehorn server X X X X rx1600/ rx2600 Embedded I/O for X rx1600/ rx2600 rx1620/ rx2620/ cx2620 Embedded I/O for X rx1620/ rx2620/cx2620 X X X USB A6869A
Table D-1 Supported Products Matrix (continued) Part Number Description RHEL Support 4 66 4U1 SLES Support 4U3 4U4 4U6 5 BL860c Embedded I/O for BL860c BL870c Embedded I/O for BL870c RUSA UCIO Ruby/Sapphire Unified Core I/O board X X rx2660 Embedded I/O for rx2660 X X rx4640 Embedded I/O for X rx4640 Supported Products Matrix X X 5U1 10 X X X X 10 SP1 X X X X X X X 10 SP2 11 X
