HP-UX 11i v3 installation and update guide HP Integrity Server Blades, HP Integrity Servers, and HP 9000 Servers HP Part Number: 5992-6552 Published: September 2009, Edition 6
© Copyright 2000, 2009 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 1 Welcome to HP-UX 11i v3...........................................................................................................7 Introduction to HP-UX 11i v3...............................................................................................7 HP-UX 11i v3 Operating Environments...............................................................................7 Media kit contents....................................................................................................
Backing up your system.....................................................................................................27 Part I: Creating an operating system recovery image...................................................28 Choosing make_net_recovery..................................................................................28 Choosing make_tape_recovery................................................................................29 Choosing drd clone..........................................
Completing the cold-install process...................................................................................54 Retrieving configuration files after cold-installing.......................................................54 Creating a new root home directory........................................................................54 Recovering customized and personal files..............................................................55 Restoring /home....................................................
Part I: Listing all software installed on your system.....................................................82 Part II: Verifying the installed software.........................................................................82 Configuring Operating Environment applications............................................................82 Migrating to the agile mass storage stack..........................................................................83 System tuning for VxFS 4.1.................................
1 Welcome to HP-UX 11i v3 This chapter introduces you to the OEs of HP-UX 11i v3 (B.11.31). It also describes the media kit contents. Introduction to HP-UX 11i v3 HP-UX 11i v3 is an enterprise release delivering the highest level of integrated virtualization and automation. HP-UX 11i v3 dynamically reduces complexity and cuts deployment times to maximize return on investment.
Table 1-1 New HP-UX 11i v3 Operating Environments HP-UX 11i v3 OE Description Base OE (BOE) Provides integrated HP-UX functionality for cost-conscious customers. The BOE contains all the applications included in the Foundation OE, and improves the bundle set by adding much-requested products such as PRM, APA, as well as math libraries and graphics for technical computing applications. This OE is bundled as HPUX11i-BOE.
Documentation NOTE: In support of HP's Green Business Technology Initiative and move towards electronic delivery, printed documentation previously included in this software media offering is now being provided electronically. The documentation is available on the Instant Information CD/DVD-ROM or may be viewed, downloaded, and printed from the web at these locations: For HP-UX 11i v3: http://www.docs.hp.com/en/oshpux11iv3.html For HP-UX 11i v2: http://www.docs.hp.com/en/oshpux11iv2.
2 Assessing your system and meeting system requirements This chapter helps you meet various requirements, as well as assess the current state of your system prior to cold-installing or updating to HP-UX 11i v3.
System requirements To cold-install or update HP-UX 11i v3, you must have the following: • • • A supported system. See “Supported systems” (page 12) and “Identifying the model” (page 16). HP-UX 11i v3 OE and Application Software (also known as “Application Release”) DVDs. 1.5 GB memory, minimum. NOTE: The minimum memory limit is intended for running the HP-UX 11i v3 Base OE and minimal applications. Additional memory will be required for optimal performance, and optional software and applications.
The list below provides additional hints and information to help you determine your disk needs for HP-UX 11i v3. If you need more disk space, be sure to order the equipment and plan on installing it after backing up your current system. • • Record the hardware path to the DVD drive.
• • Ignite-UX will consider available root disk space and adjust sizes to be larger. The Ignite-UX UI File System tab can be used to set specific sizes. CAUTION: If the default size for the /stand partition is too small for your environment, do not use the lvextend command to increase the size of the /stand partition; doing so may render your system unbootable.
Disk space requirements for an update To ensure a successful update to HP-UX 11i v3, make sure that you have at least as much disk space allocated to the partition/file system listed in Table 2-1 (page 14) and that each partition/file system (most importantly, /usr, /opt, and /var) has at least 10-20 percent free space to allow for any growth. Note the update process will check the disk space requirements. If the system doesn't meet the requirements, the update will not proceed.
• • clicking the appropriate links for your product until you arrive at the link for firmware downloads. You can also search for your product's firmware requirements at the Business Support Center. Enter “Firmware” and the name of your hardware in the search box. Note that the results also return a GUI that you can use to further refine your search. To automatically receive email notices for the latest firmware updates, sign up each of your products for Subscriber’s Choice: Go to http://itrc.hp.com.
Each HP-UX 11i release has an associated release name and release identifier. The uname(1) command with the -r option returns the release identifier. Table 2-2 lists the releases available for HP-UX 11i. Table 2-2 HP-UX 11i release identifiers Release identifier Release name Supported processor architecture B.11.11 HP-UX 11i v1 PA-RISC B.11.23 HP-UX 11i v2 Intel® Itanium® and PA-RISC1 B.11.
3 Choosing your installation methods This chapter provides information and scenarios to help you choose the most appropriate methods to install or update HP-UX 11i v3 on your system.
Choosing cold-install or update Now that you have evaluated your system and ordered any needed hardware, you need to decide whether to cold-install or update to HP-UX 11i v3 on your system. When to cold-install NOTE: If you have ordered a new system with the Instant Ignition option (also known as factory integrated), the cold-installation process described here has already been performed. You can skip this section.
When to update Update means using update-ux to selectively overwrite the operating system and application software from a DVD or network source depot. You can update to HP-UX 11i v3 from HP-UX 11i v2 (B.11.23). Updating from any other HP-UX OS directly to HP-UX 11i v3 is not supported. You must first update to an HP-UX 11i v2 Operating Environment.
Table 3-1 Supported update paths (continued) Operating Environment (OE) HP-UX 11i v3 BOE HP-UX 11i v2 TCOE x HP-UX 11i v3 FOE x HP-UX 11i v3 HA-OE x HP-UX 11i v3 EOE HP-UX 11i v3 VSE-OE HP-UX 11i v3 DC-OE x x x x HP-UX 11i v3 MCOE x HP-UX 11i v3 TCOE x HP-UX 11i v3 BOE x HP-UX 11i v3 HA-OE HP-UX 11i v3 VSE-OE HP-UX 11i v3 DC-OE x x x x x x x x Update path notes • • You cannot downgrade to a lower level Operating Environment.
TIP: With Dynamic Root Disk (DRD), you can efficiently provision VMs and blades with a DRD clone. For more information, see “Reducing downtime using Dynamic Root Disk” (page 36). Local media Uses: Cold-install or update one system at a time. You can cold-install or update directly from the DVDs in the media kit: • • HP-UX 11i v3 OE DVDs — Boot and install a new system or update an existing system.
IMPORTANT: Be sure also to read the important information in “Standard HP-UX patch bundles” [p. 79]. Golden image Uses: Deploy a customized system configuration to many systems. Avoid manual media swaps. Speed up installation time for multiple systems. Simply put, a golden image is built by setting up a single system the way you want all of your systems to look, and then creating an image of that system. Once a golden image has been created, it is then deployed to multiple clients.
4 Before you begin This chapter describes the steps you should take before actually cold-installing or updating to HP-UX 11i v3. It also describes situations that you should carefully consider before you cold-install and/or update.
Reviewing known problems Before beginning any cold-install or update process, you should review the descriptions of known problems provided for you in this guide, Appendix A: “Known install and update problems” (page 91), and in the DVD booklet, HP-UX 11i v3 Read Before Installing or Updating (also available at http://www.docs.hp.com/en/ oshpux11iv3.html#Installing%20and%20Updating.) These known problems notes include, but are not limited to, issues with cold-installing and/or updating to HP-UX 11i v3.
Backing up your system Any data on the client disks that are used for installation, including the operating system, are removed entirely as part of the installation process. Make a recovery image of your system so you can easily restore it to its original state if a problem occurs. Back up your system before and after performing a cold-installation or update.
Part I: Creating an operating system recovery image To protect your system data, create an operating system (OS) recovery image: • The Ignite-UX server has two commands you can use to create an OS recovery image: — make_net_recovery ◦ Create an OS recovery image and store it on an Ignite-UX server on the network. ◦ Works on any system that has Ignite-UX installed. ◦ See “Choosing make_net_recovery” (page 28). — make_tape_recovery ◦ Create an OS recovery image on a bootable recovery tape.
The contents of the OS recovery image always includes all files and directories that are essential to bringing up a functional system. This essential list is predefined by make_net_recovery. For more information on using make_net_recovery, refer to the make_net_recovery(1M) manpage or the Ignite-UX Administration Guide (http:// docs.hp.com/en/oshpux11iv3.html#Ignite-UX).
NOTE: Once you have updated from 11iv2 to 11iv3 on the active system image, you can go back and forth between the inactive 11iv2 image and the updated 11iv3 image by ensuring the following: • That you have manually installed Dynamic Root Disk (DRD) version A.3.1.0.1027 or later onto your updated HP-UX 11i v3 system image if you updated to HP-UX 11i v3 update 1 (September 2007) or update 2 (March 2008).
• • • Indicate specific files or directories to include or exclude from a backup Specify different levels of backup on a daily, a weekly, or monthly basis Create an online index file The frecover command restores backup files made using the fbackup utility. The -r option to the frecover command is generally used for recovering all files from your backup; the -x option is used for restoring individual files to your system. For complete details, see the frecover (1M) and fbackup (1M) manpages.
1 2 P S Serial VGA Acpi(HWP0002,PNP0A03,0)/Pci(1|2) Acpi(HWP0002,PNP0A03,0)/Pci(4|0) The above is an example of factory defaults. As you will see later in these steps, one of these devices will have to be configured as “primary” (P); the other will have to be configured with a status of “Not Configured” (NC). • If the command does not exist, the system will return the error message: conconfig not found. 2.
4. Next, use the conconfig to deselect all other consoles so that only one console is marked P and all others are marked NC.
NOTE: The following figure shows consoles with a primary (P) status and secondary (S) status. This would not be correct for your configuration. You should select only one device for a P status. The rest should be given an NC status. Only one active console should be configured; otherwise, HP-UX may either fail to boot or boot with output directed to the wrong location. e. Press Esc to return to the boot option maintenance menu. f. Select Cold Reset to reset your system.
Unmounting the DVD You must unmount the DVD before you can eject it from the DVD drive. For example: umount /dvdrom Note the DVD is automatically unmounted whenever the server reboots. For more information about mounting and unmounting, see the mount(1M) and umount(1M) manpages. Creating a network depot (optional) You can create a network depot if you intend to cold-install or update HP-UX 11i v3 on other systems on the network.
6. For each additional DVD in the OE media set, replace the media in the DVD drive with the next DVD. Then repeat steps 2 and 4. Messages: errors, warnings, and notes While the HP-UX 11i v3 install or update progresses, you will see progress messages that are being entered into the log file. These messages usually refer to normal behavior.
For information about using a drd clone for creating an OS recovery image, see “Choosing drd clone” (page 29). The HP-UX Dynamic Root Disk website at http://www.hp.com/go/drd provides a product overview, download links, documentation links, and installation instructions. Securing your system at install- and update-time At install- and update-time, you can harden your system by choosing from a variety of security levels. This ensures that your system is in a secured state upon installation or update.
IMPORTANT: As is required by increased system hardening, some of the services and protocols needed by some products may be disabled when you select specific security levels. One of these affected products is HP Serviceguard. For important information about configuring Serviceguard with Bastille and IPFilter, see the document below. For more information about HP-UX Bastille, including details of the effects of ITS levels, see the HP-UX System Administrator's Guide: Security Management (http://docs.hp.
11i v3” and “HP-UX 11i v3 Persistent DSF Migration Guide” (http://www.docs.hp.com/ en/oshpux11iv3.html#Storage%20Area%20Management ). HP-UX 11i v3 device special files (DSF) In a similar way to hardware paths, there are two types of Device Special Files (DSFs) for mass storage: legacy DSFs and persistent DSFs. Both can be used to access a given mass storage device independently, and can coexist on a given system.
5 Cold-installing HP-UX 11i v3 from local media This chapter describes cold-installing HP-UX 11i v3 from local OE media.
Preparing to cold-install The following sections describe the initial steps you should take before proceeding with your installation. Also included is a graphic overview of the cold-install process. CAUTION: The cold-install process overwrites everything on all disks selected to participate in the installation. Make sure you have reviewed and completed the steps in “Backing up your system” (page 27).
Figure 5-1 Cold-Installing HP-UX 11i v3 Start Determine install approach If Factory Integrated From Recovery Image From Media Install 11i v3 OS/OE using Ignite-UX Install recovery image Install additional non-OE applications using swinstall Using tools from ITRC, identify and install additionally needed patches 1 Install 3rd-party and internal software 1 The Patch Assessment Tool can be found at the ITRC (http://itrc.hp.
Backing up your configuration files If you plan to cold-install HP-UX 11i v3 on a system that already has HP-UX installed, and you want to have that system serve the same role as it did before, then you will want to preserve your configuration files.
Table 5-1 Miscellaneous data Type of data Your specific data Root Disk Path NOTE: Your root disk will typically display a legacy style Path name. However, HP-UX 11i v3 contains a new naming scheme for Root Disks. Refer to the white paper “The Next Generation Mass Storage Stack: HP-UX 11i v3” for information on how to identify your legacy root disk device name in the agile HP-UX 11i v3 naming scheme.
Table 5-2 Network data Type of data Your specific data HP-UX command to confirm data after system is up and running Host Name uname -n/hostname Host IP Address nslookup hostname Subnet Mask grep SUBNET_MASK /etc/rc.config.d/netconf Default Gateway IP Address grep ROUTE_GATEWAY /etc/rc.config.d/netconf Domain Name cat /etc/resolv.conf DNS IP Address cat /etc/resolv.conf NIS Domain Name grep NIS_DOMAIN /etc/rc.config.
NOTE: The cold-install process may involve multiple media swaps. To avoid manually swapping media, use a network depot. For information, see “Network depot” (page 23). Booting Your Itanium-based system 1. 2. 3. Make sure any external devices that need to be configured at cold-install are connected to the target system and are turned on and operational. Insert the HP-UX 11i v3 DVD (Disk 1) into the drive. Turn the system on, reboot, or cycle power.
3. Stop the autoboot by pressing any key. The boot console menu is displayed. If you need help, enter: HELP. 4. Ensure that Fast Boot is enabled. a. Select the Configuration Menu: CO b. If the Fast Boot selection is available, switch Fast Boot ON: FB ON The full memory check that is run when Fast Boot is OFF may take several hours on a large system. (Remember to switch Fast Boot back OFF after installing HP-UX 11i.) c. 5.
NOTE: On partitionable systems only the core cell is searched by default. If you want to search all cells, you can use the all option to the sea command or provide a cell number to search. Using the all option may take a significant amount of time if a large number of I/O devices are connected to the system. The valid options to the sea command for the system you are using will be shown when you interrupt the boot process to gain access to the BCH prompt. 6.
1. 2. 3. If the installation detects that you have a PS2 or USB keyboard, the system displays the Language Mapping screen. Select the number of the language you want to use (such as 26 for US English) and then press Enter to confirm your choice. From the Ignite-UX Welcome screen, select Install HP-UX to begin interacting with the Ignite-UX (cold-install) program and then press Enter. The system displays the User Interface and Media Options window.
2. 3. In the Environments field, select the type of Operating Environment you want to install on your system. Press Enter to view the choices. In the Root Disk field, select the disk to store your root file system. Press Enter to view the choices. If you are unsure of what to choose, keep the default selection that has been determined by Ignite-UX. HP-UX 11i v3 contains a new naming scheme for Root Disks. Note that the Root Disk screen displays the lunpath hardware path instead of the legacy hardware path.
a. b. Navigate to the Software tab. Select any optional software that you want loaded onto your system and deselect any recommended (default-installed) software that you do not want. Browse the list, marking your selections. Use the arrow keys to select a bundle and the spacebar to change the option. The bundles and associated product names are listed in Appendix C: “HP-UX 11i v3 software bundles contained in the OEs” (page 119).
The File System tab will differ in appearance, depending on whether you previously selected LVM or whole disk on the Basic tab. Note that renaming or changing any disk file system structure on which Ignite-UX installs file system content causes the old file system on that disk to be lost. For more information on using the File System tab, refer to the Ignite-UX Administration Guide (http://docs.hp.com/en/oshpux11iv3.html#Ignite-UX). 9.
2. 3. 4. You are prompted to answer a few questions before you can use the system. The first is whether or not you plan to use the system on a network. If you completed the pre-install data collection tables (see “Collecting information about your system” (page 44)), you have all the information you need for set_parms, so answer Y for yes. Enter the basic network information that you collected in Table 5-1: “Miscellaneous data” on the screens that are displayed. Confirm your choices.
Recovering customized and personal files Recover all the customized and personal files that you saved previously by merging them manually. For example, do not overwrite /etc/passwd with your old version. Instead, either paste in entries from your old files or merge the old information into the new files. Restoring /home If you had a local home directory, you can restore it as follows: • For instance, if you copied it to /backup/system1/home, enter these commands: cd /backup/system1/home find .
6 Updating to HP-UX 11i v3 This chapter describes updating to HP-UX 11i v3 using update-ux to selectively overwrite the operating system and application software from a DVD or network source depot.
Preparing to update The following sections describe the initial steps you should take before proceeding with your update. Also included is a graphic overview of the update process. Completing the preliminary tasks Before you update to HP-UX 11i v3, make sure that: • • • You have assessed the current state of your system and have met all the requirements described in Chapter 2: “Assessing your system and meeting system requirements” (page 11).
Figure 6-1 Updating to HP-UX 11i v3 Create recovery image update Determine update approach R e qu ire d ! Install latest update-ux from OE media network depots Determine source Create one or more depot(s) media cold-install Update OS/OE from 11 i v3 OE media using update-ux Update HP-UX 11i v3 from depot containing OS/OE bundles using update-ux Cold-Install from media (Chapter 5) Update non-OE applications from Application media using swinstall Update non-OE applications using swinstall Identify
2. After updating to HP-UX 11i v3, run the swlist command again and compare the output to the output you saved from step 1 to determine what software products and bundles still need to be updated. Rebuilding the kernel The update can fail if the HP-UX kernel build fails in the starting environment. To ensure that you have a reliable starting point, rebuild the kernel before you update: 1. As root, enter: /usr/bin/mk_kernel –o /stand/vmunix 2. 3. Fix any problems listed in the mk_kernel output.
You should install the Update-UX product (which includes the update-ux command) that is included on the Operating Environment DVD that came with your HP-UX 11i v3 release. From the DVD media To install the Update-UX product from the Operating Environment DVD: 1. 2. Mount the DVD. (For instructions, see “Mounting and unmounting the DVD” (page 34).
Table 6-1 Updating tips (continued) Topic Tip All Software Does Not Get Updated Update-UX updates the HP-UX OS and any software specified in additional software bundles available on the source media or depot. Update-UX may not automatically update software that is not contained in an Operating Environment. In addition, Update-UX may not automatically update optional software bundles that have changed names since the last release.
Updating to HP-UX 11i v3 using the terminal user interface This section describes how to update your system using the update-ux Terminal User Interface (TUI). There are seven steps in the TUI update-ux process: Step 1: Start-up Start the update-ux TUI. Step 2: Select source Provide the location of the software depot from which the software will be installed. Step 3: Select OE Select the OE to which you want to update.
Figure 6-2 Overview Screen b. After reviewing the information on the Update-UX Overview tab, enter n (next) to proceed to the Source Selection tab. Step 2: Select source The Source tab appears. The Source tab displays a list of registered source depots on the local host system.
Figure 6-3 Select Source Tab a. Specify the source depot that contains the new OE that you want to use to update your target system. The system automatically selects the local host and default depot path. You can expand any entry that is preceded by the + sign. This allows you to view the available depots on the server. b.
The OE-Selection tab displays the list of OEs to which you can update. The OE that matches the one currently installed on your system is automatically selected. You may choose a different OE by selecting it (which will automatically deselect the other). Figure 6-4 OE Selection Tab With this screen, you can accomplish two tasks: 1) review the contents of an OE you are considering for update, and 2) make the actual OE selection.
Step 4: Select software The SW-Selection tab appears. The SW-Selection tab displays the software contents of the OE you selected on the OE-Selection tab. On the SW-Selection tab you can choose the software contents you want to include within the OE. Figure 6-5 Software Selection Tab Use the spacebar to select or deselect software from the list. Select any optional software that you want and deselect any recommended (default-installed) software that you do not want. Browse the list, marking your selections.
Information DVD and on the web (http://www.docs.hp.com/en/ oshpux11iv3.html#Release%20Notes). CAUTION: HP recommends that you do not deselect recommended software bundles or remove them from your system unless you know for certain that the software contained in these bundles is not required for your OE. If you deselect recommended software during the update, the old version of the software you deselected will remain on your system.
Figure 6-6 Analysis Dialog b. c. d. The preview stops after the analysis. Press Enter to return to the SW-Selection tab. After returning to the SW-Selection tab, enter l (log) to view the log file, which presents a view of detailed install information. Review any errors, warnings, or notes. Warnings and notes are simply informational. If there are any errors, they will need to be resolved before the update can continue. Step 6: Update In this step, the system proceeds with the actual update.
compress /var/adm/sw/tmp/update-ux/swagent uncompress /var/adm/sw/tmp/update-ux/swagent.Z chmod +x /var/adm/sw/tmp/update-ux/swagent * Copying an SD agent from the source depot /usr/sbin/swagentd -k /usr/sbin/swagentd -r /usr/sbin/swcopy -s depot_server:/var/11iv3/update_depot -x logfile=/var/adm/sw/tmp/update-ux/swcopy.log -x autoselect_dependencies=false -x enforce_dependencies=false -x mount_all_file systems=false -x register_new_depot=false -x uncompress_files=true -x reinstall=true SW-DIST.
Table 6-2 “Log files generated during update” lists the log files that are generated during an update: Table 6-2 Log files generated during update Log file Description /var/opt/swm/swm.log This log file contains the output from the software selection, analysis and installation phases of the software update. In addition, this log file includes output from all control scripts that run during the update. The swm.
Table 6-3 update-ux command options update-ux command options Description -s source_location Specifies the source containing the new software depot. Possible locations are a local directory, a mounted DVD containing a depot, or a remote system-and-depot combination. All paths used in the source_location must be absolute paths.
Updating to an Operating Environment from the command line To update to a specific HP-UX 11i v3 OE, you need to specify the OE name in the update-ux command. For example, to update to the HP-UX 11i v3 Base OE, you can insert the HP-UX 11i v3 DVD in the local drive mounted at /dvdrom. As root, enter: /usr/sbin/update-ux -s /dvdrom HPUX11i-BOE IMPORTANT: Make sure you install all new optional software included in the OE collection that you want at the same time that you do your update. See the next section.
7 Installing applications and patches This chapter first describes how to install HP applications from the HP-UX Application Software DVD. Then it describes areas of concern when using third-party software and hardware. Finally, it describes the standard HP-UX patch bundles, sources for individual patches, and tools you can use for patch management.
Installing HP-UX applications Your HP-UX 11i v3 media kit contains the HP-UX Application Software DVD. The Application Software DVD provides a wide variety of HP-UX software products from which you can choose. You can install them new or use them to update the existing software on your system. Products for HP-UX 11i v1, HP-UX 11i v2, and HP-UX 11i v3 are included, although some may require a key. See your HP Customer Representative for information.
Installing HP-UX applications from the DVD This section describes installation of applications from the HP-UX 11i v3 Application Software DVD, which can be found in the HP-UX 11i v3 media kit. You must boot HP-UX 11i v3 to install HP-UX Application Software products. Use the following procedure to install products from the Application Software DVD: 1. 2. Mount the HP-UX Application Software DVD. (For instructions, see “Mounting and unmounting the DVD” (page 34).
http://www.hp.com/products1/serverconnectivity/mass_storage_devices.html WARNING! If third-party (non-HP) storage will be connected to your HP-UX 11i v3 system, HP recommends that you contact your third-party storage vendor to determine the compatibility of the storage with HP-UX 11i v3. Check with your third-party storage vendor for information about any prerequisites and limitations with the storage on HP-UX 11i v3.
The following standard patch bundles are provided on the OE DVD: • Hardware Enablement Patch Bundle for HP-UX 11i v3 (HWEnable11i) Provides patches required for new systems and for add-on hardware supported on HP-UX 11i v3, including I/O adapters and devices. • Feature Enablement Patch Bundle (FEATURE11i) Consists of required core patch files that meet dependencies for new or updated software products. Included patches may also enable new products/features or provide product enhancements.
• • • HP strongly advises you review the “readme” document file that is delivered with each patch bundle. The document files can be found in the OEDocs directory on the OE DVD and at the ITRC (http://itrc.hp.com). The Patch Management User Guide for HP-UX 11.x Systems provides information and procedures for acquiring and installing standard HP-UX patch bundles. You can find the document at http://www.docs.hp.com/en/ oshpux11iv3.html#Patch%20Management.
8 Post-install/update tasks and troubleshooting This chapter provides steps to verify that your system is ready and back in production. It also includes additional tasks you may need to perform, as well as instructions for uninstalling an HP-UX 11i v3 OE and removing applications and patches.
Verifying the HP-UX cold-install or update To verify that HP-UX 11i v3 was installed or updated successfully, use the Software Distributor commands swlist and swverify, as described in this section. For an update, you can also view the results of the update in the log file /var/opt/swm/ swm.log. Refer to Step 7 in “Updating to HP-UX 11i v3 using the terminal user interface” (page 63) for more information.
Refer to each product’s installation instructions for details. If the products are new or have changed with the current OE update release, the locations of many OE product-specific documentation are listed in the HP-UX 11i v3 Release Notes, available on the Instant Information DVD and at http://docs.hp.com/en/ oshpux11iv3.html#Release%20Notes. Otherwise, search for the product documentation at http://docs.hp.com or http://hp.com/go/bizsupport.
System tuning for VxFS 4.1 If your system has the minimum amount of memory, you may need to manually set VxFS tunables for optimal performance after cold-installing or updating to HP-UX 11i v3. Two VxFS tunables, vx_ninode and vxfs_bc_bufhwm, have an effect on system memory consumption. For guidelines on setting them for machines with relatively low RAM, see the Veritas File System 4.1 Administrator's Guide at http://www.docs.hp.com/en/ oshpux11iv3.html#VxFS.
Diagnostics Now that you have installed or updated HP-UX, you can use it to keep your system running. The diagnostics software for HP servers helps you troubleshoot and fix problems when a hardware failure occurs.
9 Support and other resources HP encourages your comments HP encourages your comments concerning this document. We are truly committed to providing documentation that meets your needs. Please send comments to: http://docs.hp.com/en/feedback.html Please include document title, manufacturing part number, and any comment, error found, or suggestion for improvement you have concerning this document. Also, please include what we did right so we can incorporate it into other documents.
README document, so several README documents may be included. The HP-UX 11i v3 Read Before Installing or Updating booklet is included with your media kit. • White Papers on HP-UX White papers associated with the HP-UX 11i v3 release are available at http:// docs.hp.com/en/oshpux11iv3.html. Other white papers, including an HP-UX 11i v3 overview, can be found at the HP-UX Information Library (http:// h20338.www2.hp.com/hpux11i/cache/324537-0-0-0-121.html).
• Software Distributor: http://www.docs.hp.com/en/SD/ • HP-UX Software Assistant: https://www.hp.com/go/swa • Dynamic Root Disk: http://www.hp.com/go/drd Typographic conventions The following conventions are used in this document: Table 9-1 Typographic conventions Typeface Usage Examples audit(5) An HP-UX manpage. audit is the name and audit(5) 5 is the section in the HP-UX Reference. From agent_config(1M) the HP-UX command line, enter “man utild(1M) audit” or “man 5 audit” to view the manpage.
Table 9-1 Typographic conventions (continued) 90 Typeface Usage WARNING An alert that calls attention to important information that if not understood or followed can result in personal injury. CAUTION An alert that calls attention to important information that if not understood or followed can result in data loss, data corruption, or damage to hardware or software. IMPORTANT An alert that calls attention to essential information.
A Known install and update problems Table A-1 (page 91) and Table A-2 (page 92) describe problems currently known to occur while installing and/or updating to the HP-UX 11i v3 release. IMPORTANT: Review the HP-UX 11i v3 Read Before Installing or Updating DVD booklet. It provides information about known install and update problems that was not available when this guide was published. NOTE: To uninstall HP-UX 11i v3, see “Uninstalling HP-UX 11i v3” (page 84).
Table A-2 Known install and update problems Problem Description/action Updates directly from media Updates directly from media are not supported for DRD updates. In are not supported for DRD order to update from media, you must copy the contents to a directory updates depot either on a remote server (easiest method) or to a directory on the active system. If it must be on the active system image you must first copy the media’s contents to a directory depot and then create the clone.
Table A-2 Known install and update problems (continued) Problem Description/action Certain nsswitch.conf entries DRD runcmd does not support the following nsswitch.conf entries not supported by drd runcmd on the clone while managing software through drd runcmd. If the file contains them, the runcmd will fail. passwd: group: hosts: compat compat nis [NOTFOUND=return] files You might see these errors during the execution of drd runcmd if your nsswitch.
Table A-2 Known install and update problems (continued) Problem Description/action fsdaemon and the swagentd daemons are left running if drd runcmd is sent an interrupt signal The fsdaemon and the swagentd daemons are left running if drd runcmd is sent an interrupt signal that stops the process before it has had a chance to clean up.
Table A-2 Known install and update problems (continued) Problem Description/action Error message during update from HP-UX 11i v2 with OnlineJFS 3.5/4.1 to HP-UX 11i v3 with OnlineJFS 5.0 During an update from HP-UX 11i v2 with OnlineJFS 3.5/4.1 to HP-UX 11i v3 with OnlineJFS 5.0 (B3929FB), the following error message may be seen. ERROR: [140167] The product "OnlineJFS,l=/,r=B.11.23.05" is not compatible with this system's architecture or operating system.
Table A-2 Known install and update problems (continued) Problem Description/action During update to the September 2009 11i v3 OE, patches may be partially installed During an update from an earlier HP-UX 11i v3 OE to the September 2009 HP-UX 11i v3 OE, one or more patches may be partially installed. You may see the following warning after running swverify on the system updated with the September 2009 OE: WARNING: The patch "PHCO_37128,l=/,r=1.
Table A-2 Known install and update problems (continued) Problem Description/action Update using HP-UX 11i v3 March 2009 from OE media may fail when the base page size is not 4K or 8K On an HP Integrity system, update from HP-UX 11i v3 September 2008 to HP-UX 11i v3 March 2009 (or later) using OE media may fail when the kernel base page size (BPS) is set to greater than the 8K value.
Table A-2 Known install and update problems (continued) Problem Description/action After DRD update is performed on a clone, you may see errors during swverify Dynamic Root Disk (DRD) now supports doing updates from an earlier version of HP-UX 11i v3 to the HP-UX 11i v3 March 2009 release on the clone while the active system is up and running. You can run this on a stand-alone machine, on virtual machines (VM), or on nPars.
Table A-2 Known install and update problems (continued) Problem Description/action Installing the VSEMgmt bundle together with the VMMGR+HPVM bundles may impact performance Installing both item 1 and item 2 on the same system may negatively impact performance: 1. The VSEMgmt bundle (containing HP VSE Management Software and HP Integrity VM Manager for HP SIM) 2.
Table A-2 Known install and update problems (continued) Problem Description/action vxesd May Dump Core after Cold-Installing HP-UX 11i v3 September 2009 and VxVM 5.0 After cold-installing HP-UX 11i v3 September 2009 and VxVM 5.0, vxesd may dump core. Due to this core dump, the internal logging functionality of vxesd will not be available. The vxesd daemon listens for events from various sources and logs them. This is an additional cosmetic feature, an add-on feature of VxVM.
Table A-2 Known install and update problems (continued) Problem Description/action Harmless error messages After Serviceguard has been installed as part of an Operating logged to syslog after install Environment (OE) or separately, the Serviceguard cmproxyd and of Serviceguard cmwbemd daemons log “Permission denied to 127.0.0.1” messages to /var/adm/syslog/syslog.log. For example: Jan 21 07:33:02 run1 cmproxyd[1577]: Permission denied to 127.0.0.
Table A-2 Known install and update problems (continued) Problem Description/action Install or update of an older OE with certain patches in a combined depot may result in errors If you ignite or update a system to an Operating Environment (OE) older than March 2009 using a combined depot that also contains certain patches, the session may result in the following errors. The triggers for these errors are the patches PHKL_38623, PHKL_38733, PHKL_38715, and PHKL_38762.
Table A-2 Known install and update problems (continued) Problem Description/action VxVM not supported on A message such as the following may be logged into dmesg during VxVM systems with USB devices at operations: this time "WARNING: VxVM vxio V-5-3-946 vol_disk_change_iopolicy: Public region policy specific open failed for c0t2d0 0x5000020 ret = 0xffffffff" These messages are logged when internal or external USB devices are detected on the system and when the minor number of the USB devices collide with
Table A-2 Known install and update problems (continued) Problem Description/action Update from previous OEUR to HP-UX 11i v3 September 2008 and beyond may log harmless message on console regarding VRTSat While updating from a previous OEUR to the HP-UX 11i v3 September 2008 OEUR and beyond, the following message may be logged onto the console: /sbin/rc[14]: /sbin/rc2.d/S700vxatd: not found. What to do This is a harmless message. Installation is not affected.
Table A-2 Known install and update problems (continued) Problem Description/action Update to HP-UX 11i v3 generates harmless warning messages in the install log file When updating to HP-UX 11i v3 September 2008 from HP-UX 11i v1, 11i v2 or 11i v3, one or both of the following warning messages may be logged in to the install log file: "EMS-Core.EMS-WRAPPER-COM". WARNING: [1296] Encountered a message of unknown priority.
Table A-2 Known install and update problems (continued) Problem Description/action HFS file system block size The HP-UX 11i v3 September 2008 release includes the option to tune must be greater than or equal the system base page size to values larger than its 4 KB default. Integrity to system base page size Virtual Machines always uses this feature to tune the system base page size in the Platform Manager to 64 KB.
Table A-2 Known install and update problems (continued) Problem Description/action Updating from HP-UX 11i v2 to HP-UX 11i v3 September 2008 and beyond generates spurious error message When updating from HP-UX 11i v2 to HP-UX 11i v3 September 2008 and beyond, the following error message is logged to the console on the final reboot: VxVM sysboot INFO V-5-2-3390 Starting restore daemon...
Table A-2 Known install and update problems (continued) Problem Description/action HP Serviceguard Storage Management Suite may be incompatible with upgrade of OE When you purchase an HP Serviceguard Storage Management Suite (SG SMS) Operating Environment (OE) bundle, the SG SMS software is provided on one DVD and the HP-UX OE (Mission Critical - MCOE, Data Center - DC-OE, or High Availability - HA-OE) is provided on a separate DVD.
Table A-2 Known install and update problems (continued) Problem Description/action Warning message during update from HP-UX 11i v2 with OnlineJFS 4.1 to HP-UX 11i v3 with OnlineJFS 5.0 When OnLineJFS 5.0 (B3929FB) is selected during an update from 11i v2 OnlineJFS 4.1 to 11i v3 with OnlineJFS 5.
Table A-2 Known install and update problems (continued) Problem Description/action Online Diagnostics are no longer started by default With the HP-UX 11i v3 March 2008 release, Online Diagnostics are no longer started by default.
Table A-2 Known install and update problems (continued) Problem Description/action HP Servicecontrol Manager (SCM) not supported on HP-UX 11i v3 The HP Servicecontrol Manager (HP SCM) is not supported on HP-UX 11i v3. If your system is running SCM, you must migrate to HP System Insight Manager (HP SIM) version 4.2 BEFORE updating to HP-UX 11i v3; otherwise the update may fail. What to do Remove HP SCM before updating to HP-UX 11i v3.
Table A-2 Known install and update problems (continued) Problem Description/action NFS*MAN filesets produce swverify errors during install/update or removal After an HP-UX 11i v3 install/update, the swverify command may report that one or more of the following ONCplus.NFS manpage files is missing: /usr/share/man/man1m.Z/portmap.1m /usr/share/man/man1m.Z/umount_nfs.1 /usr/share/man/ja_JP.eucJP/man1m.Z/umount_nfs.1m /usr/share/man/ja_JP.SJIS/man1m.Z/umount_nfs.
Table A-2 Known install and update problems (continued) Problem Description/action Warning message when If you are on an HP-UX 11i v1 system and perform swcopy, swlist, or performing swcopy, swlist, swverify on a depot containing HP-UX 11i v2 or HP-UX 11i v3 software, or swverify you may encounter the following warning message: WARNING: Ignoring duplicate information for the keyword “dynamic_module” at line. What to do For swlist or swverify on HP–UX 11i v1, you can safely ignore this message.
B Installing VxFS and VxVM Previous HP-UX 11i v3 Operating Environment Update Releases (OEURs) included the 4.1 and 5.0 versions of VxFS and the (recommended (default-installed) selection would install VxFS 4.1. Starting with the HP-UX 11i v3 September 2009 OEUR, the default version of VxFS installed is changed from 4.1 to 5.0. The following software is included in HP-UX 11i v3 September 2009 OEUR: • VxFS 4.1 (Base-VXFS bundle) — required (always-installed) installed in all OEs • OnlineJFS 4.
IMPORTANT: For important information regarding a known problem with installing VxVM, see vxesd may dump core after cold-installing HP-UX 11i v3 September 2009 and VxVM 5.0, located in Appendix A: “Known install and update problems” (page 91). Supported VxFS 5.0 and VxVM 5.0 installations are achievable with proper selections in the Ignite-UX tool. The following sections describe the steps required to get to each possible configuration.
Unsupported system configurations Many different configurations are selectable at update time, but not all of them would result in supported system configurations. For this reason, pre-update scripts built into the September 2008 OEUR and beyond will block certain updates before they start, to prevent updates into unstable configurations. The scripts will print an error message, and the error can be resolved by restarting the update with different software selections.
C HP-UX 11i v3 software bundles contained in the OEs This appendix describes the software bundles included in the HP-UX 11i v3 new Operating Environments. Starting with the March 2008 release, HP presents a set of new Operating Environments for HP-UX 11i v3. These new Operating Environments provide a richer set of products and improved choices over the original set of HP-UX 11i OEs. For more information on the new OEs, see “HP-UX 11i v3 Operating Environments” (page 7).
Table C-1 HP-UX 11i v3 software product categories (continued) Software category Description Performance Performance Tools Security Security Tools SecurityChoices Security Level Choices SupportTools Diagnostic and Support Tools SystemManagement System Management Tools Utilities Miscellaneous Utilities OE Optional All optional bundles in the OE OE Recommended All recommended (default-installed) bundles in the OE OE Required All required (always-installed) bundles in the OE Each of the abo
Recommended software product category (listed in Table C-1 (page 119)) to select or deselect all recommended items. CAUTION: HP recommends that you do not deselect recommended software bundles or remove them from your system unless you know for certain that the software contained in these bundles is not required for your operating environment. Software may have unstated dependencies. Deselecting software may prevent products with dependencies on the software you deselected from functioning correctly.
Table C-2 Required (always-installed) software Description Bundle name HP-UX 11i v3 operating system software. This is a core bundle.
Table C-2 Required (always-installed) software (continued) Description Bundle name PropPlus (HP-UX SMH Supplemental Functionality) SysMgmtPlus Base VxFS 4.
Table C-3 Recommended (default-installed) software Description Bundle name Contains operating system software that is required by most HP-UX users. HPUXEssential NOTE: Make sure you do not deselect this bundle or remove it from your system unless you know for certain that the software contained in this bundle is not required for your operating environment. Contains internationalization support for many languages.
Table C-3 Recommended (default-installed) software (continued) Description Bundle name HP aCC_link bundle HP-ACC-Link HP Caliper HP-Caliper-Perf HP CIFS Client CIFS-CLIENT HP CIFS Server CIFS-SERVER HP FTP Server HPUX-FTPServer HP Integrity Virtual Machines (VMGuestLib) VMGuestLib HP-UX Nameserver/BIND HPUX-NameServer HP WildeBeest Debugger HP-WDB-DEBUGGER HP-UX DHCPv4 Server HPUX-DHCPv4 This is a core bundle. HP-UX DHCPv6 Server HPUX-DHCPv6 This is a core bundle.
Table C-3 Recommended (default-installed) software (continued) Description Bundle name Partition Manager ParMgr Perl Programming Language perl Process Resource Manager B3835DA Provider Default Tools • HP-UX WBEM SCSI Provider (SCSIProvider) • Online Provider (OLOSProvider) • HP-UX WBEM LAN Provider for Ethernet Interfaces (WBEMP-LAN-00) • WBEM Provider for Fibre Channel HBAs (WBEMP-FCP) • Utilization Provider (utilProvider) • vPartition Provider ( VParProvider) • HP Integrity Virtual Machines Provid
Table C-3 Recommended (default-installed) software (continued) Description Bundle name Java bundles Runtime Environment (v1.6/6.0) for Java Java60JRE Java Runtime Environment Add-On (v1.6/6.0) Java60JREadd Java Development Kit (v1.6/6.0) Java60JDK Java Development Kit for HP-UX Add-On (v1.6/6.0) Java60JDKadd Runtime Environment (v1.5) for Java Java15JRE Java Runtime Environment Add-On (v1.5) Java15JREadd Java Development Kit (v1.5) Java15JDK Java Development Kit for HP-UX Add-On (v1.
Table C-3 Recommended (default-installed) software (continued) Description Bundle name HA-OE and DC-OE Only Enterprise Cluster Master (ECM) Toolkit T1909BA HP Serviceguard T1905CA HP Serviceguard NFS Toolkit B5140BA VSE-OE and DC-OE Only HP Global Workload Manager Agent LTU T2762AA HP Virtualization Manager LTU T2782AC HP Capacity Advisor LTU T2784AC HP VSE Suite LTU T2786AC VMGuestSW VMGuestSW VxFS 5.
Table C-4 Optional software (continued) Description Bundle name HP-UX Host Intrusion Detection System HPUX-HIDS MemFS MemFS HP Message Passing Interface (MPI) B6060BA HP MLIB Mathematical Software Library B6061AA HP-UX Password Hash Infrastructure for HP-UX 11i v3 PHI11i3 Pax Enhancement (PAX-ENH) PAX-ENH HP Process Resource Manager (PRM) Web GUI Systems Insight Manager (SIM) PRMSIMTools Integration Files HP-UX Security Containment Extensions ContainmentExt HP Systems Insight Manager (HP SIM
Table C-4 Optional software (continued) Description Bundle name HP-UX Mobile IPv6 HPUXMOBILEIP Network Server Accelerator NSAHTTP Numeric User Group Name NumericUsername Pay per use T2351AA Software Package Builder SwPkgBuilder Security Level 10 Sec10Host Security Level 20 Sec20MngDMZ Security Level 30 Sec30DMZ UmountallEnh UmountallEnh Base VxTools 5.0 Base-VxTools-50 VxVM 5.
Index Symbols /etc, 44 /etc/passwd editing to change home directory, 54 recovering, 55 /home restoring, 55 retrieving configuration files, 54 /local restoring, 55 /opt restoring, 55 /usr restoring, 55 /usr/local/, 44 10GigEther-00, 130 10GigEther-01, 130 10GigEthr-02, 123 3D Graphics Development Kit (DK) and Runtime Environment (RTE) for OpenGL, 128 “HP-UX 11i v3 Persistent DSF Migration Guide”, 83 “The Next Generation Mass Storage Stack: HP-UX 11i v3” white paper web address, 38 A AccessControl, 129 agile
swremove, 84 swverify, 82 umount, 34 update-ux, 60, 62 Common Desktop Environment (CDE), 128 CommonIO, 122 configuration OE Applications, 82 configuration files backup, 44 retrieving post-install, 54 considerations cold-install, 19 update, 19 console for Itanium-based systems selecting, 31 ContainmentExt, 129 contents media kit, 8 Cpio Enhancement, 128 create depot, 35 D data backup, 27 data collection table miscellaneous, 44 network, 45 default-installed software deselecting during cold-install , 52 desel
GlancePlus Pak, 127 Gnome GTK+, 124 Gnome GUI Runtime Toolkit, 124 Gnome GUI Runtime Toolkit source, 124 golden image, 24 GTK+ Libraries, 124 Guest AVIO LAN software , 127 Guest AVIO Stor software , 127 H HA Monitors, 127 hardware diagnostics, 85 Hardware Enablement Patch Bundle, 123 Hardware Enablement Patch Bundle for HP-UX 11i v3, 78 hardware failures, 85 hardware paths, 38 agile view, 38 LUN hardware path, 38 lunpath hardware path, 38 HFS file system block Size, 106 home directory creating, 54 Host AVI
I J I/O cards supported, 15 IB4X-00 Driver for InfiniBand, 130 identifying installed software, 16 identifying model, 16 identifying OE, 16 identifying release date, 16 IEther-00, 123 Ignite-UX, 20, 28, 129 customizing your installation (cold-install), 49 installing the latest, 43 navigation tips, 49 website, 88 iLO 2 vMedia, 23 information product-specific, 8 install known problems, 91 post-install tasks, 81 problems, 91 verify, 81 verifying, 82 install types, 119 install-time security levels, 37 Install-
media Application Release (AR), 75 Application Software, 75 cold-installing from, 41 contents, 119 installation source, 23 kit, 8 locating, 26 Media Streaming Protocol, 129 MemFS, 129 messages errors, warnings, and notes, 36 migrating to agile mass storage stack, 83 migration paths choosing a method, 20 from previous HP-UX releases, 21 MirrorDisk/UX, 127 miscellaneous data collection, 44 Mission Critical Support proper installation method, 19 mk_kernel command, 60 MLIB, 129 Mobile IPv4 , 129 model identifyi
HP-UX IPsec, 129 HP-UX Mobile IPv6, 130 HP-UX Password Hash Infrastructure for HP-UX 11i v3, 129 HP-UX Swapoff, 129 HP-UX Virtual Partitions, 130 HyprFabrc-00, 130 IB4X-00 Driver for InfiniBand, 130 Ignite-UX, 129 Integrity VM Online Migration Software (OVMM), 130 IPv6 Upgrade, 129 Java Out-of-Box, 129 Kerberos Client, 129 KRB5CLIENT, 129 Libc Enhancements, 129 MallocNextGen, 129 Media Streaming Protocol, 129 MemFS, 129 MLIB, 129 Mobile IPv4 , 129 Network Server Accelerator, 130 Numeric User Group Name, 130
deselecting during update, 68 Distributed Systems Administration Utilities, 124 Drivers, 127 Dynamic nPartitions, 124 Dynamic Root Disk, 124 Enterprise Cluster Master Toolkit, 128 FibrChanl-00, 127 FibrChanl-01, 127 FibrChanl-02, 127 Firefox, 124 Firefox Source, 124 GlancePlus Pak, 127 Gnome GTK+, 124 Gnome GUI Runtime Toolkit, 124 Gnome GUI Runtime Toolkit source, 124 GTK+ Libraries, 124 Guest AVIO LAN software , 127 Guest AVIO Stor software, 127 HA Monitors, 127 Host AVIO LAN software , 127 Host AVIO Stor
USB-00, 123 requirements disk space, 12, 13, 15 firmware, 15 system, 12 restoring /home, 55 restoring /usr, 55 retrieving configuration files post-install, 54 root, 44 home directory, 54 S saving configuration files, 44 scsiU320-00, 123 SD, 89 Sec00Tools, 37 Sec10Host, 37 Sec20MngDMZ, 37 Sec30DMZ, 37 Secure Path migration to Native Multipathing , 62 security settings, 37 security bulletins management, 80 Security Level 10, 130 Security Level 20, 130 Security Level 30, 130 Security Patch Check, 80 SerialSCS
deselecting recommended software, 68 determining which products, 59 error messages, 62 how to, 57 installing Update-UX, 60 known problems, 91 legacy and persistent DSFs, 39 miscellaneous recommendations, 61 operating environments, 57 OS, 57 overview, 58 persistent and legacy DSFs, 39 post-update tasks, 81 problems, 91 tips, 61 unsupported products, 62 verify, 81 verifying, 82 vs.