Moving your HP-UX 10.20 system to 11.x

Transition Planning

For a complete listing of which HP Workstation platforms support HP-UX 11.X, visit the HP-UX Update Matrix page.

Pre-Planning

The first decision you must make when transitioning your HP-UX 10.20 system to HP-UX 11.X is whether you want to use HP's Ignite-UX Tools to cold install the new system or to update your system.

Cold install means installing system software on a new (uninstalled) or existing system disk by completely rebuilding the root file system, erasing the existing operating system and data on that volume and installing the new operating system and specified software and data. Here is a Cookbook on the Cold Install process.

Update means using the HP Software Distributor (SD-UX) tools to selectively overwrite the operating system and/or application software from a media or network source depot. In most cases, the user data and disk layout can be preserved when updating to a new operating system. Here is a Cookbook on the Update process.

The advantages of both of these schemes is discussed in more detail in the Installing vs. Updating HP-UX 11.X Systems section of the HP-UX 11.X Software Transition Kit.

A Cookbook for the HP-UX 11.0 Cold Install Process

An HP-UX 10.20 to 11.X cold install can easily be done using the HP Ignite-UX utility. Here are the planning and preparation tasks required for a cold install:

1. Backup the entire existing system. This allows you to recover your system in case there are any problems. For more information on backups, see the book Managing Systems and Workgroups.
2. Identify the root disk for the target system. All information on this disk will be destroyed during the cold install. All of the new files will be installed onto this disk. If you currently mount system directories from other disks (for example, if /usr, /var, /opt or /etc are large enough to have their own disk), you should manually update the mounted disks, see step 5 below.
3. Backup any important data on the root disk that you want transferred to the 11.X system. These backups should be done in a way that allows restoring files to a directory other than the originally named directory.
    
   
   1. Identify any local system data on the root disk. Make backup copies of any important data. Backups could be on another disk drive, on tape, on another system or even on paper depending on the type of data. Examples of system files that might need to be saved include:

      /etc/passwd
      group
      /etc/fstab
      /usr/lib/cron

      The actual list of files will depend on how your system is used and configured. It also depends on any tools that you might already be using to configure a new system.

   2. Identify any user data on the root disk. If /home is on the root disk, it should probably be saved. Other user data might be in /usr/local or /usr/contrib.
   3. Identify any applications on the root disk. Make certain that the Install media (supported and available for HP-UX 11.X) is available for these applications so they can be reinstalled after the cold Install.
4. Boot the system from the physical media or network install server and perform a cold install. If there is a file system on the root disk you have chosen, you will be warned that the install will destroy data on the disk.
5. Configure the system for your environment. This includes LAN configuration, user configuration, printers and probably other items. This is "generic" configuration which is done for all workstations. This is also a good time to make sure your system is running the proper firmware. See Installing and Updating 11.0 and Updating HP-UX 10.x to 11.0 for supported versions of the PDC and firmware if updating to 64 bit 11.00.
6. Restore local data and applications to the root disk. This is the data that was saved in step 3 above.
    
   
   1. Load the application CD-ROM(s) and update all the applications including the correct user-level license.
   2. Install the appropriate patches. Make sure the buffer cache size (dbc_max_pct) is at least 128MB or 50% of memory—whichever is larger. Patches will load slowly if the buffer cache is very small. Remember to reset the parameter after the patches are loaded.
7. Start using the system!

A Cookbook for the HP-UX 11.0 Update Process

Planning Tasks:

1. Software Transition Kit (STK): Make sure you have installed the current Software Transition Kit from CD or download it from the following Web site:

   » http://devresource.hp.com/STK/download.html

   Run this Kit and analyze the output from it. It can lessen the likelihood of problems when running scripts and/or programs after the upgrade. Use of the Software Transition Kit is recommended but not required.

2. Software: You should be able to answer Yes to these questions:
    
   
   1. Is all non-HP software certified to run on HP-UX 11.0?
   2. Do codewords unlock all HP software packages on the Application CD ROMs?
   3. Are all HP applications ported to 11.0?
       
      
3. Patches: Make sure you have the current HP-UX Support Plus patch bundle (including the HP-UX 11.X Quality Pack) which are downloadable from the HP Software Support page at:

   » http://www.software.hp.com

   Look for the "Enhancement Releases" button.

   For more information on managing and installing patches, see

   » http://devrsrc1.external.hp.com/STK/hpuxpatch.html

4. Disk Space: HP-UX 11.0 is larger than 10.20 by the following approximate sizes:

   /var 5MB larger
   /usr 120MB larger
   /opt 55MB larger

   When extending JFS file systems, use the -F vxfs option to the extendfs command to avoid corrupting the filesystem.

5. Check Fileset Status: Execute the following command to check the status of all installed filesets:

   swlist -l fileset -a state | more

   All of the filesets should appear in a "configured" state. If some of the filesets are listed in the "installed" state, then the swconfig(1M) command should be run to configure those filesets. If some of the filesets are shown as "corrupted", then they should be reloaded using swinstall.

6. Hardware Compatability: Check to make sure the system can be updated to HP-UX 11.X. For a complete listing of which HP Workstation platforms support HP-UX 11.X (both 32- and 64-bit), go to:

   » HP-UX Support Matrix

   11.0 requires 32 MB of memory, but 64 MB (minimum) is recommended.

7. PDC and Firmware: Moving your system to 11.X is a good time to make sure you have the correct firmware for your system. See Installing and Updating 11.0 and Updating HP-UX 10.x to 11.0 for supported versions of the PDC and firmware if updating to 64 bit 11.00.
    
   
8. Install Ignite-UX: Install Ignite-UX from the Application CDs, or from the Ignite-UX Web Page.

Preparation Tasks

1. System Backup: Using either fbackup or make_recovery, ensure that all filesystems in the root volume group (usually vg00) are backed up. These generally include /, /stand, /opt, /var, /home, /usr, and /tmp.

   /usr/sbin/fbackup -f /dev/rmt/0m -0i / (Backs up all mounted filesystems.)
   /opt/ignite/bin/make_recovery -A (Creates bootable recovery tape)

2. Save Important Information: Make a directory named /important and cd to that directory. Execute

   print_manifest > manifest

   In addition to this information, you may want to save the following information:

   cp /etc/rc.config.d/netconf netconf
   cp /etc/hosts hosts
   cp /etc/resolv.conf resolv.conf
   vgexport -m vg01map -p -v vg01 .....continue for all vgXX
   cp /etc/passwd passwd
   cp /etc/group group

   Also save any startup files in the /etc/rc.config.d, /sbin/rcX.d, and /sbin/init.d directories that you have modified. Also, any terminal and printer definition files that have been customized should be saved.

   Continue this for any other information you may need in the event of a disaster; then save contents of the /important directory to tape or ftp it to another system.

3. Name Resolution: Make sure that the system being updated has an Ethernet card (802.3). If DNS is used, re-name /etc/resolv.conf to /etc/resolv.conf.hold. Then make sure the /etc/hosts file resolves the hostname of the system being updated to the IP address of the Ethernet card. NOTE: The update may fail if you ignore this step!
    
   
4. Lock Out Users: Copy the /etc/passwd to /etc/passwd.hold and then execute vipw and delete all the users that have been added. Since the update is done from the normal init state (see first line in the /etc/inittab), deleting the users will prevent anyone from logging on during the update. You may already have a script to lock out users. Execute pwck to make sure the password file is error free. After the update, you will copy the /etc/passwd.hold back to /etc/passwd.
    
   
5. Mount Only Necessary File Systems: Copy /etc/fstab to /etc/fstab.hold. Edit the /etc/fstab file and comment out nfs mounts and unnecessary file systems. Do umount -a and then mount -a and make sure there are no errors other than the "already mounted" ones.
    
   
6. Disable Application Startup: Edit startup files in the /etc/rc.config.d directory to prevent startup of unnecessary programs.
    
   
7. Remove Patches: The existing patches should be removed before the update.
   NOTE: Be aware that this procedure removes ALL references to patches—whether you wanted to or not!
    
   
   • Make a backup copy of the IPD by issuing the following command:

     find /var/adm/sw/products | cpio -pdumv /some_safe_place,

   • Remove references to patches in the IPD:

     swmodify -u PH[CKNS][OLES]_\*.\* PH[CKNS][OLES]_\*

   • After backing up the /var/adm/sw/patch directory, remove it:

     rm -rf /var/adm/sw/patch

   • Remove any empty patch bundles with swremove.

   For more information on managing patches and HP's Patching Strategy, see

   » http://devrsrc1.external.hp.com/STK/hpuxpatch.html

8. Disable cron: You don't want a cron job kicking off in the middle of your update, so make sure that that the cron jobs are disabled by editing the /etc/rc.config.d/cron file and changing CRON=1 to CRON=0. Do this prior to executing step 9 below, so the change takes effect on the reboot.
    
   
9. Remove Filesets: Execute swremove and remove GlancePlus (PAK) and Netscape Navigator Gold. This will cause a reboot. Note any errors at bootup and copy the /etc/rc.log to /etc/rc.log.10.X for future reference.
    
   
10. Check /stand/bootconf: Check to make sure that the disk(s) referenced in the bootconf file are the correct bootdisk(s). NOTE: The update will fail if this is not correct.

Performing The Update

1. Load the Tools From the Core OS CD: Execute swgettools as follows (also found in Installing and Updating 11.0 and Updating HP-UX 10.x to 11.0):

   mount /dev/dsk/c1t2d0 /SD_CDROM
   cp /SD_CDROM/catalog/SW-GETTOOLS/pfiles/swgettools /var/tmp
   /var/tmp/swgettools -s /SD_CDROM
   -execute the previous sequence again if you reboot before updating.

2. Update the Core OS: Mount the Install/Core OS CD-ROM. Execute swinstall as follows to install the 32 bit OS:

   swinstall -x os_name=HP-UX:32 -x os_release=B.11.00

   The SD Graphical User Interface will come up.

   Choose Local CDROM, then choose HPUXEng32RT. Change options to overwrite filesets and files. If you do not want to install patches with the OS, make sure the Automatically Select Patches box is not checked under the Actions, Manage Patch Selection pull down menus. After the system reboots, copy the /etc/rc.log to /etc/rc.log.new11.0.

   Execute swlist -l fileset -a state | more to check to make sure all filesets configured correctly.

3. Enable the Command Stack: Beginning with 10.20, command logging is turned off by default. To enable command logging (thereby allowing you to use esc k for recent commands), you must edit the /.profile and add the following lines at the end:

   HISTFILE=.sh_history
   export HISTFILE

4. Load the Diagnostics from the HP-UX Diagnostic/Independent Product Release Media CD: In swinstall, specify /SD_CDROM/DIAGNOSTICS/B.11.00 as the source.
    
   
5. Load the Applications: Load the application CD-ROM(s) and update all the applications including the correct user-level license.
    
   
6. Install Patches: Install critical patches from the HP Support Plus patch bundles. The HP-UX 11.X Quality Pack is strongly recommended.

   For more information on managing and installing patches, see

   » http://devrsrc1.external.hp.com/STK/hpuxpatch.html

   You are also encouraged to have a patch analysis done as soon as possible.

Cleanup

1. Enable Application Startup: Remember to edit files previously changed in the /etc/rc.config.d directory to enable applications to start at bootup.
    
   
2. Enable Name Resolution: Copy the /etc/resolv.conf.hold back to /etc/resolv.conf. Copy the original /etc/hosts back if you changed it.
    
   
3. Enable File System Mounting: Copy the /etc/fstab.hold back to /etc/fstab.
    
   
4. Enable Logon: Closely inspect the /etc/passwd.hold to see if any of the same lines in the /etc/passwd have been changed by the update before you copy /etc/passwd.hold back to /etc/passwd.
    
   
5. Enable the cron jobs: Edit the /etc/rc.config.d/cron file and change CRON=0 back to CRON=1.
    
   
6. Make a copy of the new kernel:

   cp /stand/vmunix /stand/vmunix.prev

7. Enable cron: Check the /etc/rc.config.d/cron file and verify that CRON is set to 1 again.
    
   
8. Reboot and you are done!