Installation and Migration Guide

|Migrating the control workstation from AIX 4.3.3 to AIX 5L 5.1

| |

|Notes:

|Before changing your AIX level from AIX 4.3.3 to AIX 5L |5.1, you must first migrate to PSSP 3.4.
|Make sure your system is stable with PSSP 3.4 before migrating to |AIX 5L 5.1. |

|Follow the steps in this section to migrate your control workstation from |AIX 4.3.3 to AIX 5L 5.1.

|Keep in mind that you should always make a mksysb backup of your control |workstation and a backup of the /spdata directory before proceeding |with the migration process. For information on making a mksysb, refer |to Step 10: Back up your control workstation.

|Step 1: Prepare to migrate and verify requirements

| |

|Before beginning, refer to Preparing to migrate for information on preparing to migrate and verifying |control workstation and system requirements.

|Step 2: Quiesce your system

| | |

|Be sure to quiesce your system as follows: |

|Ensure all users are logged off nodes
|Stop all user jobs running over the switch
|Ensure that any jobs that start up automatically (for example batch |submission queues), should be shut down or quiesced.
|If you are using the Switch Admin daemon for node recovery, stop it by |issuing stopsrc -s swtadmd on SP Switch systems or stopsrc -s |swtadmd2 on SP Switch2 systems.
|Quiesce the switch using the Equiesce command |

|Step 3: Perform control workstation BOS migration install to AIX 5L 5.1

| |

|This method preserves all file systems except /tmp, as well as the |root volume group, logical volumes, and system configuration files. |This activity provides installp updates and installs necessary AIX |LPs to the control workstation. You must have all the necessary AIX |file sets and PTFs listed in the READ THIS FIRST document available |by CD-ROM or from the NIM master. Note that you may need certain PTFs |on your nodes if coexistence requirements exist between AIX |4.3.3 and AIX 5L 5.1.

|Migration install from a CD-ROM is an interactive process. You will |be prompted to verify settings, continue the installation, and verify the |migration.

|Refer to the AIX Installation Guide in chapters 1-3 for more |information. The following list provides some hints: |

|Boot off of your AIX CD-ROM or set up the control workstation as a NIM |client from an appropriate NIM master.
|Select option 2 "Change/Show Installation Settings and Install." |Always verify that it has been set to migrate and that the correct |target disk is assigned for root volume group.
|Select option 1 "System Settings" on the Installation and Settings |menu.
|Select option 3 "Migration Install" on the Change Method of Installation |menu.
|Select the proper hdisks being used for rootvg. You may want to |update the hdisk configuration for the control workstation.
|Customize your control workstation based on the documented PSSP |requirements. This includes installing the required AIX LPs and |PTFs. |

|Step 4: Install the runtime prerequisites

| |

|PSSP has a prerequisite for vacpp.ioc.aix50.rte |5.0.1.0 when running with AIX 5L 5.1. This |file is not part of the AIX installation package. The vacpp.ioc |and vacpp.cmp installation files were put in your AIX |4.3.3 lppsource |/spdata/sys1/install/name/lppsource during Step 13: Copy the PSSP images for PSSP 3.4. The |runtime library associated with AIX 5L 5.1 must be installed |now. Issue:

|installp -aXd /spdata/sys1/install/name/lppsource vacpp.ioc.aix50.rte

|Step 5: Verify AIX levels

| |

|Verify that the control workstation was successfully migrated to your |target AIX level (AIX 5L 5.1), by issuing the the following |command:

|oslevel

|For example, if your target AIX level is AIX 5L 5.1 and the output |of this command does not indicate 5.1.0.0, issue the |following command to return a list of AIX files not migrated to AIX 5L |5.1. You may need to install AIX PTFs to migrate those file sets |to AIX 5L 5.1.

|oslevel -l 5.1.0.0

|Step 6: Review space requirements for NIM boot images

| |

|Before creating a PSSP boot/install server, ensure that there is sufficient |space in the root (/) file system or create a separate file system for |/tftpboot to manage the space required for the boot images |(approximately 25 MB per lppsource level supported) created by NIM.

|Step 7: Review space requirements for /spdata

| | |

|The /spdata directory contains mksysb images and installp file |sets. IBM suggests you create a separate volume group for the |/spdata file system. These file sets are large and need much |space (up to 2 GB per lppsource level supported). If you have not done |so already, use RS/6000 SP: Planning, Volume 2, Control Workstation |and Software Environment to help you estimate how much space you need to |define.

|Step 8: Create the required /spdata directories

| |

|You need to create the proper directory structure for AIX file sets.

|Note:: Make sure you mount the new /spdata file system before you create |the /spdata directories. |

|You must create subdirectories on the /spdata file system for |storing critical PSSP data. Make sure the directories have the |permissions rwxr-sr-x. Issue the following commands to |create the required directories:

|To create /spdata/sys1/install/name/lppsource, |issue:

|mkdir -p /spdata/sys1/install/name/lppsource

|This is the subdirectory for the required AIX 5L 5.1 file |sets. You can choose any name, but the name must not contain any dots |(.). If you have multiple lppsources, you should pick more than |one name. By default, this is set up as the string |"default". You might want to pick a more meaningful name, such |as |aix510 for AIX 5L 5.1 level code. If the control workstation |will be the NIM server for different levels of AIX, you should create one |subdirectory for each level of AIX.

|Step 9: Copy the AIX LP images and other required AIX LPs and PTFs

| |

|In AIX 5L 5.1, changes were made to allow installation with |installers other than installp to allow new installation media |formats. With AIX 5L 5.1, two new commands (geninstall |and gencopy) were introduced, which call installp |or bffcreate, or other commands as appropriate. |Additional subdirectories have also been added into the NIM LPP_SOURCE with |AIX 5L 5.1. For NIM, instead of just putting everything in the |LPP_SOURCE directory, appropriate subdirectories are created by the |gencopy and bffcreate commands and the images are copied to |those subdirectories.

|You must copy the AIX file sets into the |/spdata/sys1/install/name/lppsource directory on |your hard disk on the control workstation. The gencopy and |bffcreate commands place the files into the appropriate subdirectory |which is |/spdata/sys1/install/name/lppsource/installp/ppc.

|You can download all of the AIX file sets (a very large number) or only the |minimal required AIX file sets |(approximately 1 GB).

|The following is the minimal list of AIX file sets required to perform |mksysb installations. The prefix.* syntax in the list |refers to everything that starts with the prefix. For example, |devices.* refers to all of the file sets starting with |devices.

|Minimal list of AIX 5L 5.1 file sets:

|IMNSearch.bld.*              bos.net.*
|IMMSearch.rte.*              bos.perf.*
|Java130.rte.*                bos.powermgt.*
|Tivoli_Management_Agent.*    bos.rte.*
|X11.Dt.*                     bos.svprint.*
|X11.adt.*                    bos.sysmgt.*
|X11.apps.*                   bos.terminfo.*
|X11.base.*                   bos.txt.*
|X11.compat.*                 bos.up.*
|X11.fnt.*                    devices.*
|X11.loc.*                    ifor_ls.base.*
|X11.motif.*                  invscout.ldb.*
|X11.msg.*                    invscout.rte.*
|X11.vsm.*                    perl.*
|bos                          perfagent.tools.*
|bos.64bit.*                  printers.rte.*
|bos.adt.*                    rpm.rte.*
|bos.diag.*                   rsct.*
|bos.doc*                     sysmgmt.help.msg.en_US.*
|bos.help.msg.en_US.*         sysmgmt.msg.en_US.websm.*
|bos.html.en_US.topnav.*      sysmgmt.sguide.*
|bos.iconv.*                  sysmgmt.websm.*
|bos.loc.iso.*                xlC.aix50.*
|bos.man.en_US.*              xlC.cpp.*
|bos.mp.*                     xlC.msg.en_US.cpp.*
|bos.mp64.*                   xlC.rte.*
|box.msg.en_US.*

|Additional files you may want to add to your lppsource: |

|bos.acct.*: |Required if you plan to use PSSP accounting. |
|bos.cpr.*: |Required to install LoadLeveler 3.1 or Parallel Environment |3.2. |
|Java130.xml4j: |Required for pSeries 690 servers |
|CIMOM: |Copy from the AIX toolbox for Linux applications CD. It is labeled |in the Contents as openCIMOM, with the file name of |Rpms/noarch/openCIMOM-0.61-1.aix5.1.noarch.rpm
|dce.*: |The DCE file sets are required only if DCE will be configured by PSSP |anywhere on the system. You will need the client portion of the DCE |file sets because the installation code installs the DCE client code. |

|Notes:

|Refer to your disk usage planning in the "Combining the space |requirements" section of RS/6000 SP: Planning, Volume 2, |Control Workstation and Software Environment to determine if you have |allocated enough space to accomplish this task.
|Allow at least 1-3 hours for moving all the file sets from media to |disk. |

|To copy the AIX LP images, login to the control workstation as root and run |bffcreate using SMIT or the command line. The following |example shows the product media on cd0 and the selection of all |LPs. Using all may load unnecessary file sets into the |directory.

|bffcreate -qvX -t/spdata/sys1/install/name/lppsource -d /dev/cd0 all

|The following warning message is issued--ignore it:

|bffcreate:
|Warning: important size information is missing from
|the table of contents file.  Consequently, there may not
|be enough free file system space to successfully create
|the bff image(s).  Continuing anyway...

|Step 10: Verify the correct level of PAIDE

|The perfagent.server file set is part of the Performance Aide for |AIX (PAIDE) feature of the Performance Toolbox for AIX (PTX), a separate |product. This product provides the capability to monitor your SP |system's performance, collects and displays statistical data for SP |hardware and software, and simplifies runtime performance monitoring of a |large number of nodes.

|The Performance Toolbox for AIX, Agent Component (PAIDE) is |required. The correct level of AIX PAIDE (perfagent) needs to be |installed on the control workstation and copied to all of the lppsource |directories. The perfagent.tools file set is part of AIX 5L |5.1. Verify that it was migrated correctly during the AIX 5L |5.1 migration. Issue:

|lslpp -L | grep perfagent

|You should receive output similar to the following:

|perfagent.tools     5.1.0.0     C     F     Local Performance Analysis

|Step 11: Obtain additional PSSP prerequisites

|PSSP has prerequisites for certain compiler related files. These |files are available on the PSSP 3.4 media. They were placed in |the /spdata/sys1/install/pssplpp/PSSP-3.4 directory in Step 13: Copy the PSSP images for PSSP 3.4. They must be copied into the AIX 5L 5.1 |lppsource directory |/spdata/sys1/install/name/lppsource/installp/ppc. |Issue:

|cd /spdata/sys1/install/name/lppsource/installp/ppc
|cp /spdata/sys1/install/pssplpp/PSSP-3.4/xlC.rte.* .
|cp /spdata/sys1/install/pssplpp/PSSP-3.4/xlC.aix50.* .
|cp /spdata/sys1/install/pssplpp/PSSP-3.4/ipfx.* .
|cp /spdata/sys1/install/pssplpp/PSSP-3.4/vacpp.ioc.* .
|cp /spdata/sys1/install/pssplpp/PSSP-3.4/vacpp.cmp.* .
|inutoc .

|The PSSP prerequisite files may now be removed from the PSSP |lppsource directory. Issue:

|cd /spdata/sys1/install/pssplpp/PSSP-3.4
|rm xlC*
|rm ipfx*
|rm vacpp*
|inutoc .

|If your control workstation or nodes have parts of the xlC or vacpp |products installed, other than the files moved earlier in this step, then your |AIX lppsource must contain the files you have installed at the levels |corresponding to levels of the files shipped with PSSP or they must be |installed before the migration. to determine the installed files |do:

|lslpp -L | grep xlC
|lslpp -L | grep vacpp

|If the output shows installed files different from the ones moved |earlier, you must obtain the maintenance corresponding to the files shipped |with PSSP. Maintenance can be obtained from:

|http://techsupport.services.ibm.com/rs6k/fixdb.html

|The PSSP prerequisite files must be in your AIX lppsource. |However, it is suggested that you place the maintenance in a directory other |than your AIX lppsource and install the maintenance on both the control |workstation and the nodes before beginning a migration.

|Step 12: Install (copy) the basic AIX (mksysb) image

| | | | |

|The RS/6000 SP media provides a basic AIX minimal image for each level of |AIX that PSSP 3.4 is supported on. You need to properly load in |the AIX mksysb image to the /spdata/sys1/install/images directory |using the installp command. For example, to install the AIX 5L |5.1 minimal images, issue the following command:

|installp -aXd /dev/cd0 spimg.510

|Note:

|In order to reinstall your nodes, the mksysb image and the lppsource |that you use must both contain the same version, release, modification, and |fix levels of AIX. If you do not have a mksysb image at the same level |as your lppsource, you may do one of the following: |

|Make your own updated mksysb image. In order to do this, you will |need to: |
1. |Update an existing lppsource to the most recent maintenance level of |AIX.
2. |Perform a BOS node upgrade on a single node as described in BOS node upgrade or follow the steps in Installing updates on a per node basis.
3. |Make a mksysb image of that node as described in Installing updates through reinstallation.
4. |Use the mksysb created in Step 1c along with your updated lppsource to install your remaining |nodes. |
|Contact IBM Level 1 service to obtain an updated mksysb image. |

|Refer to Step 17: Copy a basic AIX (mksysb) image for more information.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]