Upgrading from 9.X to 10.2

Prepared by Peggy Bruehl 3/20/97
Both HP and I suggest that most users upgrade their HP-UX 9.X systems to 10.2 rather than do a complete cold install of the 10.2 operating system. The upgrade process allows you to preserve the local configurations you have made on your workstation.

The upgrade process requires two steps, and will likely take longer than a cold install. However, the time invested in the upgrade will save you from having to invest time in reconfiguring your system. Before starting the upgrade, please read these instructions in their entirety.

The steps for the upgrade process are

You will need the following materials for your upgrade:

Additional CDs that you should have in your office, but are not necessarily required for the upgrade process:

Prepare your 9.X system for the upgrade to 10.01

The steps described in this preparation section can be performed while the system is being used by other processes. These steps do not make any fundamental changes to your operating system. At any time during these preparation steps, you may stop what you are doing and start again later. The workstation may experience a slow-down while you are running the preparation programs, but they will not affect the overall functioning of the system.

  1. As we go through the steps to prepare your system for the upgrade, you should be reading along in Chapter 4 Pre-Upgrade Tasks for all 9.X Systems of the Upgrading from HP-UX 9.X to 10.X manual.

  2. Log in as user root

  3. Check the number of available inodes on your root file system:

    # bdf -i

    You shouldn't have more than 10 or 20% of the inodes used (iused). If you do, you should start looking for a directory filled with lots of tiny files. Delete or move them and check the inodes again.

  4. Download the HP Patch PHSS_9809. You can obtain this patch direct from HP at HP's anonymous FTP patch site at "us_support.external.hp.com." or you can get this patch from the patches/ directory of the SAC FTP server. Put it in the root directory /. DO NOT install this patch now...it is a 10.01 X11 patch. There will be instructions for installing this patch later in this document.

  5. Load the 9.*->10.* Upgrade Tools from the Upgrade Tools CD. Put the CD in the CD-ROM drive and mount it. The full set of upgrade tools will require 38.4MB of disk space on your root file system. Make sure that you have enough space to load these tools.

  6. Run /etc/update from an HPterm. Choose Change source or destination and From CD-ROM to local system. Type in the source directory, which is the mount point for the CD-ROM drive. This is usually /cdrom. Now press Done. Choose Select all Filesets on the Source Media and answer yes to start loading the filesets. When the installation is done, check the update log in /tmp/update.log for errors.

  7. Now we are ready to test our system to see if can be successfully upgraded. None of the remaining instructions in this Preparation section will change your operating system. The following commands are simply testing whether your system will upgrade properly.

  8. Put the HP-UX Release 10.0 VUF B.10.01 Core OS CD into the CD-ROM drive and mount the drive.

  9. Create an HPterm window with a scroll bar. You will use this window to run a program that generates a lot of output. You may want to scroll back through that output, and that's why the scroll bar is a good idea.

    # /usr/bin/X11/hpterm -sb

  10. In the hpterm, check your $DISPLAY variable.

    # echo $DISPLAY
    # mymachine:0.0

    $DISPLAY should reflect the name of your machine. If it does not, set it now:

    # DISPLAY=mymachine:0.0
    # export DISPLAY

  11. Now run the snoop program in that hpterm to test your system. snoop is located in the directory /usr/sbin. Get used to this directory, since at 10.2 many system administration programs have moved from /etc to /usr/sbin and /sbin.

    # /usr/sbin/snoop

    You can run snoop as many times as you like.

  12. The snoop program has two parts. The first part will check your system for configurations that are incompatible with 10.*. The second part starts up the new 10.* software installation program swinstall. swinstall replaces /etc/update in 10.*. swinstall will run in preview mode to simulate what will happen when you actually upgrade your machine. Please remember, nothing that you do in this phase will change your operating system. These steps are simply testing your system.

  13. During the first phase, snoop will run through a series of checks, and will ask you a series of questions. For nearly all the questions, the default answer or NO is correct. The exception is the question whether you want to upgrade the system to B10.10 (or B10.20). You should answer YES to this one. For a step-by-step listing of everything snoop will do, please see the page Running Snoop in the Analyzing Your System section of Chapter 4 in the Upgrade Manual.

  14. The second phase of snoop starts when it asks you if it is OK to use the swinstall GUI. If you set your $DISPLAY variable as instructed above, answer yes to this question. snoop will start up swinstall which will run through a lot of checking and unpacking.

  15. Eventually, you will see a Source Selection Dialog window. Click OK here.

  16. Then, the Specify Source window will appear. This is where you configure your system to look at the CD-ROM drive. In the Source Hostname box, type in the name of the machine that has the CD-ROM drive. In the Source depot path box, type in the mount point of the CD-ROM drive. For example /cdrom.

  17. A couple additional windows may pop up, advising you of a few things. Just keep pressing OK until you get to the Software Selection window.

  18. In the Software Selection window, you will see a list of all the software contained on the HP-UX 10.01 CORE OS CD. Now, you will tell swinstall to select the software from the 10.01 CD that matches what is currently installed on your 9.X system. To do this, choose Actions->Match What The Target Has, and click OK. Now, to start the installation preview, select Actions->Install(analysis).

  19. A new window will pop up that reports the status of the analysis. If you click on Log file you can watch the messages get sent to the log file. This process will run for a while, writing all the important information to that log file. Now is a good time for a coffee break or lunch.

  20. Eventually, the preview of the install will finish. Press OK to close the logging window (if you had it open). The contents of the logging window are in the file /var/adm/sw/swagent.log. You can see the list of 10.01 software that will be installed by clicking on the Product Summary button.

  21. If your system failed the install preview test because of a disk space shortage, you will see a message on in the swinstall screen. If you are short disk space, you'll have to clean out your 9.X system and run snoop again. Good places to clean out things are the /tmp and /usr/tmp directories and user directories in /users. Use SAM to trim log files, locate large files, and remove core files. You can also move software installed in /usr/local to an external disk drive, etc. There is also some advice in Chapter 4 of the upgrade manual for freeing up disk space.

  22. To close the swinstall session, click OK. Once you close swinstall, snoop will give you a summary of problems, cautions, and notes that you must address. You can read these messages in the file /var/adm/sw/snoop.log. You should look through the whole snoop.log. Read the notes and act on any cautions and problems. The log file will give you instructions on how to proceed. Most of the messages in snoop.log don't require any action, but you should read and remember this info. Consult the section Handling snoop Problems in Chapter 4 of your upgrade manual for more information. You must resolve all problems listed in the snoop.log file before you can proceed with the upgrade

    For an example, see my snoop.log. There is a problem listed in my snoop.log with my cron configuration for doing tape backups. I chose to eliminate that problem by commenting out the cron entries. I reconfigured my backups after finishing the upgrade. If, for some reason, commenting out the crontab entries for user root does not make the snoop error go away, I recommend that you do the following:

    # crontab -l > cronfile.root
    # crontab -r
    # rm /usr/spool/cron/crontabs/root

    You can copy the cronfile.root file on to one of your external disk drives for safe keeping. After the upgrade, read the cronfile.root file back into root's cron:

    # crontab cronfile.root
    # crontab -l

  23. After reading and correcting the problems listed in the snoop.log, you must re-run the snoop program. When running snoop multiple times, snoop might ask you questions about private copies of converted files. If you answer yes, snoop will re-convert them. This is a good idea if you've been fixing problems.

  24. You must continue re-running snoop until it tells you there are no more problems. At that point, you are ready to do the actual upgrade.

  25. Before proceeding with the actual upgrade, you should evaluate any locally developed scripts or software for their compatibility with HP-UX 10.2. Note that any software you receive from the SOO/SAC Program will have already been tested on HP-UX 10.2 and you do not need to evaluate it. Only software and scripts that you have developed locally need to be tested.

  26. Chapter 5 Converting Code and Scripts in the upgrade manual will describe how to use the program prepare to test your software. My advice is to create a directory somewhere and put copies of all your scripts and source code in that directory. Then run prepare in that directory. For most SACs, the One-stage Cookbook for Running Prepare instructions should be enough.

    After running prepare, you must now go through each program and script and read the comments inserted into the code. Most of the comments are for your information only. However, sometimes prepare will catch a conflict that will prohibit your script or program from running at 10.2. In this case, you must make the appropriate change to the script so that it will work when you've upgraded to 10.2.

  27. You are now finished preparing your system for the upgrade.

Upgrading from 9.X to 10.01

You should reserve plenty of time for the 9.X to 10.01 upgrade. I suggest reserving half a day for this phase of the upgrade. You will not be able to stop the upgrade in the middle and go back to normal operations of the workstation.

  1. Log in as user root

  2. Before you upgrade your machine, I recommend making a back up tape of all your file systems, including the root file system. You will NOT be able to simply restore the files from your tape of the 9.X root file system to your new 10.2 root disk, however, at some point in using your 10.X system, you may want to refer to an old 9.X configuration file. With a back up tape, you can always extract the needed file or files into a neutral directory.

    You should also back up the file systems on your external disk drives. These file systems should not be affected by the upgrade process. After the upgrade, those file systems will appear the same as they've always been. However, in the unlikely event of a disk crash, or some other strange occurrence, it does not hurt to have a clean backup. (Chalk it up to an ounce of prevention.)

  3. If you have a DDS DAT tape drive, I advise you to make a 9.X recovery system tape. See the document Making & using a DAT recovery system for details.

  4. No users will be able to log into the system during the upgrade. Stop all your cron jobs (comment them out, rather than removing them), and shut off your NFS or automounters. This workstation will be out of commission until the upgrade is complete.

  5. As we go through the steps to upgrade your system, you should be reading along in Chapter 6 Upgrading your System from 9.X to 10.01 of the Upgrading from HP-UX 9.X to 10.X manual.

  6. Reboot to single user mode:

    # /etc/shutdown

  7. Restart VUE:

    # /etc/vuerc

  8. Open a couple of HPterms with scroll bars:

    # /usr/bin/X11/hpterm -sb

  9. In the hpterm, check your $DISPLAY variable.

    # echo $DISPLAY
    # mymachine:0.0

    $DISPLAY should reflect the name of your machine. If it does not, set it now:

    # DISPLAY=mymachine:0.0
    # export DISPLAY

  10. Put the HP-UX Release 10.0 VUF B.10.01 Core OS CD into the CD-ROM drive and mount the drive.

  11. Run the command /usr/sbin/upgrade. Answer yes to the question about the graphical user interface.

  12. You will see some warning and reminder screens. Read them. The /usr/sbin/upgrade program will also unmount any NFS-mounted file systems at this point.

    The upgrade program will check you system for problems or errors reported by snoop. Answer any questions, just like you did when your ran snoop. If the upgrade program finds any errors, do not continue. Exit the upgrade and find the problem in the file /var/adm/sw/swagent.log. Fix the problem and then start the upgrade process again.

  13. After the initial checks, the swinstall program will start up. This should also look familiar from your work with snoop.

  14. Eventually, the Specify Source window will appear. This is where you configure your system to look at the CD-ROM drive. In the Source Hostname box, type in the name of the machine that has the CD-ROM drive. In the Source depot path box, type in the mount point of the CD-ROM drive. For example /cdrom.

  15. A couple additional windows may pop up, advising you of a few things. Just keep pressing OK until to get to the Software Selection window.

  16. In the Software Selection window, you will see a list of all the software contained on the HP-UX 10.01 CORE OS CD. Now, you will tell swinstall to select the software from the 10.01 CD that matches what is currently installed on your 9.X system. To do this, choose Actions->Match What The Target Has, and click OK.

  17. To start the install analysis, select Actions->Install(analysis).

  18. A new window will pop up that reports the status of the analysis. If you click on Log file you can watch the messages get sent to the log file. This process will run for a while, writing all the important information to that log file.

  19. Eventually, the analysis of the install will finish. If there were errors, press cancel on the Install Analysis screen to exit. Then, fix the problem(s) and re-run snoop as directed in the Preparation section above. When snoop reports no more errors, then start the upgrade process again.

  20. If there were no errors, then click the disk space button to be sure there is enough space.

  21. If there are no problems, and enough disk space, press the OK button on the Install Analysis screen. This will start the install process. You may watch the log file if you choose. The installation will take about 1 hour.

  22. After the installation is complete, press OK. The upgrade program will ask you a couple more questions, the last one telling you that it will reboot the system. Answer all the questions. The reboot and subsequent auto-configuration will take approximately 2 hours.

  23. After the reboot, HP-VUE should be running and the operating system should be at 10.01. If you started at HP-UX 9.0.7, there will be a big warning that you are not allowed to stay at HP-UX 10.01. It is true that you must continue the upgrade to 10.2, but it is not as big an emergency as the message would make you believe.

  24. If you had a problem in this phase of the upgrade, you have a few choices.

Preparing for the 10.01->10.2 Upgrade

There are a couple of steps you must take before you can proceed with the upgrade to 10.2. These steps should only take an hour or two.

  1. You are now running HP-UX 10.01. Log in as user root.

  2. If you'd like to review the log file created during the 9.X->10.01 upgrade, it is in the file /var/adm/sw/swagent.log. If you want to review what occurred during the first reboot and auto-configuration, a log is available in /etc/rc.log.

  3. Now we must install the 10.01 X11 patch that we downloaded during the Preparation for the Upgrade phase:

  4. Next, we need to install the 10.2 upgrade software installation tools. You may follow along these steps in Chapter 7 After the Upgrade of your upgrade manual. In particular, see the section Updating to 10.10 or Updating to 10.20. (The instructions are the same, whether it is 10.10 or 10.20.)

  5. You will need approximately 11MB of free disk space to install this software. If you do not have enough disk space, check the /tmp and /var/tmp directories, or use /usr/sbin/swremove to remove some software filesets.

  6. Put the HP-UX Release 10.20 Install and Core OS CD into the CD-ROM drive and mount it.

  7. Now copy the software tools into /var/tmp and install them:

    # cp /cdrom/catalog/SW-DIST/pfiles/swgettools /var/tmp
    # /var/tmp/swgettools -s /cdrom

  8. At this point, a warning window will pop up telling you that you must patch your X11 system. Since you applied patch PHSS_9809 above, you can answer yes.

  9. After the software tools are installed, check the /var/adm/sw/swagent.log for any errors. You may see some dependency warnings. These can be ignored. However, if you see any other errors, fix them before proceeding.

Upgrading from 10.01 to 10.20

This is the easiest step of all. You should allow one or two hours for this step.

  1. Be sure that the HP-UX Release 10.20 Install and Core OS CD is still in the CD-ROM drive and that the drive is mounted.

  2. Now we will run the ugrade. You may follow along these steps in the Updating to 10.10 or Updating to 10.20 section of Chapter 7 of your upgrade manual. See the Running the Update section.

  3. Start swinstall:

    # /usr/sbin/swinstall

  4. Configure the software source, as usual. Choose Actions->Match What The Target Has, as usual.

  5. This time, however, you may want to install some additional software. Start by changing the way the software is listed on the screen. Choose View->Change Software View->Start with Products. In the main window, you will see which software packages are marked for installation.

  6. Note that the CDE will be partially installed by default. VUE will also be installed. The VUE-to-CDE migration tools are not installed. For my system, I marked all the CDE filesets (except for the foreign language help and man pages) for install. I unmarked the VUE software. You may also choose to install other software packages at this time. On the other hand, you can always run swinstall later to install more software. You can use swremove to remove software that you don't want any more.

  7. After you've marked all the software you'd like to install, choose Actions->Install(analysis). As usual, you can view the log file while the analysis is occurring. You may notice messages in the log file that a few filesets will be skipped. This is because you already installed these filesets when you installed the swgettools fileset before starting the 10.01 to 10.2 upgrade. When the analysis is finished, press the OK button on the log file window.

  8. Before starting the installation, check the disk space button to be sure you have enough space, and the product summary button for a list of all the software you will install. Check the log file for any errors and fix them before continuing with the installation.

  9. Press OK on the Install Analysis screen to continue the upgrade. This process will be much quicker than the 9.X->10.01 install. When the install completes, press OK to reboot and auto-configure the system.

After the Upgrade

  1. You are now running HP-UX 10.2. You can add back your cron jobs, and reconfigure your tape back ups, etc. Most of your local configurations should have survived the upgrade process. If you find that something is not working, try using swremove and swinstall to remove and reinstall the software. The script /etc/set_parms has moved to /sbin/set_parms initial. If networking is giving you trouble, try re-running this.

  2. If you are still running HP-VUE, but would like to switch to the CDE, use swremove and swinstall to remove HP-VUE and install CDE.

  3. If you run CDE, you must make an important change to the /etc/dt/config/C/sys.resources file. See the document Important CDE Setting for instructions.

  4. In order to run NAWIPS & GARP, you will have to reconfigure the number of colors used by the CDE. To do this, log on and choose the Style Manager from the Front Panel. Click on Color, and then click on Number of Colors. Finally, click on "More Colors for Applications". Log in and out again. This will free up enough colors for NAWIPS & GARP to run.

  5. If you have a license and code words for the FORTRAN and ANSI C compilers, you can install them by running swinstall and using the HP-UX 10.2 Application CD(s). (Don't forget to mark the C and FORTRAN man pages for installation.) You will be asked to fill in a window with the code words for your CDs. There is also some free software on those application CDs, so even if you can't install the compilers, you might want to check the application CD(s) for any software that interests you. You are already a swinstall expert, so I won't bother with instructions, however, you should note that unless you are upgrading the operating system, you do not have to use the Actions->Mark What The Target Has options. Simply choose the software you want to install and use the Actions->Mark option.

  6. You may want to amend your PATH and MANPATH environment variables to include the following paths:

    /opt/fortran/bin:/opt/ansic/bin:/opt/upgrade/bin:/usr/sbin/:/sbin:/etc
    and
    /usr/dt/man:/usr/man:/usr/share/man:/usr/local/man:/usr/contrib/man: /opt/fortran/share/man:/opt/ansic/share/man:/opt/upgrade/share/man

  7. If you were running HP-UX 9.X, you may have to remove the /etc/motd file to get rid of the annoying message about needing to upgrade to HP-UX 10.2. Just remove the file.

  8. If you are a C-shell user, I strongly recommend the patch PHCO_9878. (You will need this patch if you intend to run the gribmaster scripts which download model data to your system.) You can get this patch direct from HP at HP's anonymous FTP patch site at "us_support.external.hp.com.", or you can get this patch from the patches/ directory of the SAC FTP server. Download the patch to your /tmp directory and unshare it:

    # sh /tmp/PHCO_9878

    Follow the instructions in the PHCO_9878.text file to install the patch.

  9. You may also have received a CD called HP Extension Software. This CD contains patch bundles that you can install on your new 10.2 system. You are free to install these patches, or you can wait for patch recommendations from me. I currently have patch bundle 02_700_1020 available on the patches/ directory of the SAC FTP server. If your extension software CD has an earlier patch bundle, don't bother installing it. Use the one on the SAC FTP server instead. (See the document Installing an HPUX 10.2 Patch Bundle for details.)

  10. To list all software installed on your system, use the commands /usr/sbin/swlist or /usr/sbin/swlist -l product.

  11. After verifying all your SCSI devices are connected and funcitoning, I recommend that you print out a copy of your /etc/fstab file. (This file replaces your /etc/checklist file.) Store the printout with the Support CD. If you ever have to boot from your Support CD, you will need to know the names and device files for your root file system.

  12. If you are running the CDE and notice that the .profile or .cshrc file is not getting sourced when a user logs in, please follow the instructions in the document CDE & local environment configuration.

  13. After re-configuring your system, if you have a DDS DAT tape drive, I recommend making a recovery system tape. See the document Making & using a DAT recovery system for details.

  14. After re-configuring your system, I recommend making a full back up of your root file system using the SAM fbackup facility or the back up facility of your choice.

  15. Finally, you should put your LaserROM 10.* CD into your CD drive and install the the LaserROM software. Please see the document Installing and Using your LaserROM CD for instructions.