Migrating to IBM AIX Version 5L

Migrating to IBM AIX Version 5.L NOTE: THIS DOCUMENT IS NOT INTENDED TO REPLACE OFFICAL IBM OPERATING SYSTEM INSTALLATION DOCUMENTATION AND BOOKS. IT IS RECOMMENDED THAT YOU READ ALL IBM AIX 5L DOCUMENTATION LOCATED IN THE README DIRECTORY OF YOUR AIX 5L CD-ROM OR FROM THE OFFICIAL IBM AIX 5L WEB-SITE. LINKS TO 5L WEB-SITES ARE LOCATED IN THIS DOCUMENT. AIX 5L is a trademark and is copyrighted by IBM Corporation. Note: This document is for AIX versions 4.3 and above. If your RS/6000 is running an AIX operating system version lower than 4.3.0.0 call CBMS PRISM SUPPORT at 800-733-4489. 1 Migrating to AIX Version 5.L July 7, 2005 Step 1: Check your RS/6000 machine type-model against the AIX Compatibility Matrix. Your machine type-model can be found on the front of the IBM RS/6000 computer, lower left. Match the type-model of RS/6000 with the AIX version number. A “Y” in the matrix field signifies that the type-model of RS/6000 can run that version of AIX. Do not load a higher version of AIX than your RS/6000 can run. AIX Compatibility Matrix (Unofficial) Power 5 Systems p510; 9110-510 p520; 9111-520 p550; 9113-550 p570; 9117-550 p590; 9119-590 AIX 3.2.5 N N N N N AIX 4.1 N N N N N AIX 4.2 N N N N N AIX 4.3.X N N N N N AIX 4.3.3 N N N N N AIX 5.1 N N N N N AIX 5.2 Y (ML4+) Y Y Y Y (ML4+) Y (ML4+) Y (ML4+) Y (ML4+) AIX 5.3 Y (ML1) Y Y Y Y (Note 1) Y (Note 1) Y (ML1) Y (ML1) p595; 9119-595 JS20 1.6GHz; 8842-21X JS20 2.2GHz; 8842-41X OpenPwr 710; 9123-710 OpenPwr 720; 9124-720 N N N N N N N N N N N N N N N N N N ---------------------------------- OpenPower is a Linux-only platform ------------------------------------------------------------------ OpenPower is a Linux-only platform --------------------------------- Note 1: APAR IY60349 is mandatory Power 4 Systems p610-6C1/6E1 p615-6C3/6E3 p620-6F0 p620-6F1 p660-6H1 p630-6C4/6E4 p640-B80 p650-6M2 p655-639 p660-6H0 p660-6H1 p660-6M1 p670-671 AIX 3.2.5 N N N N N N N N N N N N N AIX 4.1 N N N N N N N N N N N N N AIX 4.2 N N N N N N N N N N N N N AIX 4.3.X N N N N N N N N N N N N N AIX 4.3.3 Y N Y Y Y N Y N N Y Y Y N AIX 5.1 Y Y Y Y Y Y Y Y Y Y Y Y Y AIX 5.2 Y Y Y Y Y Y Y Y Y Y Y Y Y AIX 5.3 Y Y Y Y Y Y Y Y Y Y Y Y Y Migrating to AIX Version 5.L July 7, 2005 2 p680-S85 p690-681 Power 4 Systems N N AIX 3.2.5 N N AIX 4.1 N N AIX 4.2 N N AIX 4.3.X Y N AIX 4.3.3 Y Y AIX 5.1 Y Y AIX 5.2 Y Y AIX 5.3 AIX 5.3 N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N Y Y Y N N N N Y Y Legacy Systems 7009-C10 7009-C20 7011-25S 7011-25T 7011-25W 7012-32H 7012-360 7012-370 7012-390 7012-39H 7012-G30 7012-G40 7013-570 7013-580 7013-58H 7013-590 7013-591 7013-595 7013-59H 7015-990 7015-99J 7015-99K 7015-R10 7015-R20 7015-R21 7015-R24 7013-J30 7013-J40 7013-J50 7015-R30 7015-R40 7015-R50 7017-S70 7017-S7A 7017-S80 7024-E20 7024-E30 7025-F30 7025-F40 7025-F50 7025-F80 AIX 3.2.5 Y N Y Y Y Y Y Y Y Y N N Y Y Y Y Y Y Y Y Y Y Y Y Y Y N N N N N N N N N N N N N N N AIX 4.1 Y Y Y Y Y Y Y Y Y Y Y (4.1.1) Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y (4.1.1) Y Y (4.1.5) Y (4.1.1) Y Y (4.1.5) N N N Y (4.1.4) Y (4.1.4) Y (Note 3) Y (4.1.5) N N AIX 4.2 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y N N N Y Y Y Y Y (4.2.1) N AIX 4.3.X Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y (4.3.0) Y (4.3.2) N Y Y Y Y Y N AIX 4.3.3 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y AIX 5.1 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y AIX 5.2 N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N N Y Y Y N N N N Y Y Migrating to AIX Version 5.L July 7, 2005 3 7026-H10 7026-H50 7026-H70 7026-H80 7026-M80 7043-140 Legacy Systems AIX Compatibility Matrix N N N N N N AIX 3.2.5 Y (4.1.5) N N N N Y (4.1.5) AIX 4.1 Y (4.2.1) Y (4.2.1) N N N Y (4.2.1) AIX 4.2 Y Y Y (4.3.2) N N Y AIX 4.3.X Y Y Y Y Y Y AIX 4.3.3 Y Y Y Y Y Y AIX 5.1 N Y Y Y Y N AIX 5.2 N Y Y Y Y N AIX 5.3 Legacy Systems 7043-150 7043-240 7043-260 7044-170 7044-270 7046-B50 7248-100 7248-120 7248-132 Legacy Systems AIX 3.2.5 N N N N N N N N N AIX 3.2.5 AIX 4.1 N Y (4.1.5) N N N N Y (4.1.3) Y (4.1.3) Y (4.1.3) AIX 4.1 AIX 4.2 Y (4.2.1) Y (4.2.1) Y (4.2.1) N N N Y Y Y AIX 4.2 AIX 4.3.X Y Y Y (4.3.2) N N Y (Note 4) Y Y Y AIX 4.3.X AIX 4.3.3 Y Y Y Y Y Y Y Y Y AIX 4.3.3 AIX 5.1 Y Y Y Y Y Y Y Y Y AIX 5.1 AIX 5.2 Y N Y Y Y Y N N N AIX 5.2 AIX 5.3 Y N Y Y Y Y N N N AIX 5.3 Note 3: Note 4: AIX 4.1.4 is required for proper service mode. AIX 4.3.2 support available only via RPQ Release 5.1 • • • Will reach end of life before Release 5.2 Supported on all platforms Requires 64MB memory (128MB highly recommended) Release 5.2 • • • • Has the latest new function Only supported on CHRP platforms Requires 128MB memory and 2.2GB disk New pre and post_migration scripts to ease migration Release 5.3 • • • Scalable, open, standards-based UNIX OS with Linux affinity POWER5 and IBM Virtualization Engine. Only supported on CHRP platforms Migrating to AIX Version 5.L July 7, 2005 4 Additional information regarding version 5 installation: • • • Version 5L incorporates electronic license acceptance. At the first reboot, after an install, you will be prompted to view/accept your licenses before you can continue to use your system. Any migration will require more space. If you have no free partitions in the root volume group, and all file systems are near full, then it would be a good idea to add another disk to the rootvg. Or install an mksysb of the system to a larger disk before migration. Be sure any additional applications you are currently running are supported in Version 5. Read the release literature for more general information on version 5: • • • 5.1 Release Notes: http://publib.boulder.ibm.com/pseries/aixgen/ relnotes/51RELNOTES/10072905.htm 5.2 Release Notes: http://publib.boulder.ibm.com/pseries/aixgen/ relnotes/52RELNOTES/10073901.htm 5.3 Release Notes: http://publib.boulder.ibm.com/infocenter/pseries/index.jsp?topic=/com.ibm. aix.resources/53relnotes.htm Step 2: upgrade your IBM AIX license or renew your IBM AIX software maintenance and support. Renewing your AIX Software Maintenance and Support or ordering a new version of AIX software has never been more convenient or easier. Ibm.com has taken the complexity out of renewing your AIX software license maintenance and support by building an easy-to-use web tool that takes the guesswork out of configuring AIX for your IBM server. If you know the machine type-model and serial of your pSeries or RS/6000 server, you can price and order AIX software in a few minutes following the six easy steps in this tool. Or if you prefer, use the Request-A-Quote form and a trained ibm.com product specialist will configure your AIX order prior to you placing it. Call IBM Software Delivery at 1-800-879-2755 opt2 then opt2 again. IBM will require the machine model and serial number of a machine licensed to run the AIX version you are ordering. You may also call IBM at 1-888-746-7426 or 1-888-SHOP-IBM Migrating to AIX Version 5.L July 7, 2005 5 ~ NOTES ~ Migrating to AIX Version 5.L July 7, 2005 6 AIX 5.1, 5.2, and 5.3 General install options There are 3 basic installation methods available for moving to version 5: New and complete overwrite install This install completely recreates the root volume group. User volume groups will not be affected as long as their disks are not chosen for the install, but will have to be manually imported at the end of the install. All user data in the root volume group is lost. Preservation install User volume groups are preserved, and an attempt to import them at the end of the install will occur (version 5.2 has an option not to have user volume groups imported). All data in the /home file system of the root volume group is preserved. All data in the /tmp file system is removed. All user created logical volumes and file systems are preserved. All other file systems in the root volume group are removed and recreated. User installed applications are removed and will need to be reinstalled. Migration install This method preserves the most of the existing root volume group. As with a preservation install user volume groups are untouched, and an attempt is made to import them after the install (version 5.2 has an option not to import user volume groups). User created logical volumes and file systems remain untouched. Configurable files are merged or saved. Unsupported software is removed from the system. File systems are unchanged during a migration, except for /tmp, which has its contents removed, and some file systems may be expanded as necessary for installing the latest versions of software. User installed applications remain on the system. CBMS SUPPORT RECOMENDS THE MIGRATION INSTALL. Instructions will follow the IBM MIGRATION INSTALL When migrating the operating system from 4.3 to version 5L, the install method that will save most of the existing system is migration (which this document will cover in more detail). As always, it is strongly recommended that you make a system backup of any system, before moving up to a new version or release of AIX. Migrating to AIX Version 5.L July 7, 2005 7 STEP 3: Making sure your system is ready. Make sure your system does not have existing installation issues before migrating. If you are migrating to 5.2, or 5.3 there is a pre_migration script that MUST be run from the 5.2 or 5.3 CD install disk 1 to check the system and prepare the operating system for migration. Either copy the script to your system or run it from the CD. The location of the script is /mnt/usr/lpp/bos/pre_migration. The pre_migration script can be run multiple times. All output from the pre_migration script is saved in the: /home/pre_migration. directory. To run the pre_migration script, mount the 5.2 or 5.3 CD Disk 1: a. Insert disk install disk 1 in to the CD drive (cd0) Issue the mount command: mount -v cdrfs -o ro /dev/cd0 /mnt b. Run the pre_migration script. Issue this command: /usr/lpp/bos/pre_migration IMPORTANT: If you are migrating to AIX 5.1 you will have to perform the checks yourself. The pre_migration script for 5.2 & 5.3 checks the following for you. If you are migrating to AIX 5.1 these check must be run manually. 1. System platform check. Only CHRP systems are supported in AIX 5.2 or 5.3, (this check is not necessary if you are migrating to 5.1.). lscfg | grep Architecture The output should be similar to: Model Architecture: chrp # Migrating to AIX Version 5.L July 7, 2005 8 2. Verify the major number for /dev/rootvg is 10. ls -al /dev/rootvg The output should be similar to: crw_rw____ 1 crw_rw____ 1 root 10, 0 Feb 13 2002 /dev/rootvg 3. Verify the major number for /dev/hd5 is 10 ls -al /dev/hd5 The output should be similar to: root /dev/hd5 system 10, 0 Feb 13 2002 system If these numbers are not 10 on your system, contact CBMS support personnel for assistance. 4. Check boot logical volume size. lslv hd5 For Version 5.1, the boot logical volume (hd5) and must be 8MB for Versions 5.2 & 5.3, it must be 12MB. There is code called during the BOS Install process, that checks and increases as needed and if possible, the size of hd5. However, here are the commands to check the size of hd5, determine which disk has hd5 (may be multiple if mirroring), and check the free space on the disk. To get the size of hd5, run the following command and multiply "PPs" by "PP SIZE" (1 x 32 = 32MB, in this case) to get the size of hd5: The output should be similar to: LOGICAL VOLUME: hd5 VOLUME GROUP: rootvg LV IDENTIFIER: 0007cd4c00004c00000000f1c1ded0f5.1 PERMISSION: read/write VG STATE: active/complete LV STATE: closed/syncd TYPE: boot WRITE VERIFY: off MAX LPs: 512 PP SIZE: Migrating to AIX Version 5.L July 7, 2005 9 32 megabyte(s) COPIES: 1 POLICY: parallel LPs: 1 1 STALE PPs: 0 relocatable INTER-POLICY: minimum RELOCATABLE: no INTRA-POLICY: edge BOUND: 32 MOUNT POINT: N/A None MIRROR WRITE CONSISTENCY: on/ACTIVE EACH LP COPY ON A SEPARATE PV ?: yes Serialize IO ?: NO SCHED PPs: BB POLICY: UPPER LABEL: To know the disk (or disks if mirroring) hd5 is on, run the following command (the number of copies is the number of mirrors): lslv -l hd5 The output should be similar to: hd5:N/A PV COPIES DISTRIBUTION hdisk0 001:000:000 001:000:000:000:000 IN BAND 100% If you want to know if there are any free partitions available next to hd5, run the following command: lspv -M hdisk0 The output should be similar to: hdisk0:1 hdisk0:2-109 hdisk0:110 hdisk0:111 hdisk0:112 hdisk0:113 hdisk0:114 hdisk0:115 hdisk0:116 hdisk0:117 Migrating to AIX Version 5.L July 7, 2005 hd5:1 hd6:1 hd6:2 hd6:3 hd6:4 hd6:5 hd6:6 hd6:7 hd6:8 10 hdisk0:118 hdisk0:119 hdisk0:120 hd6:9 hd6:10 hd6:11 The partitions hd5 is on must be contiguous, and in the first 4GB of the hard disk. A disk size check is made to verify that at least 2.2GB of disk space is available. 5. A memory check is made to confirm that at least 128MB of memory is on the system. Although for 5.1, 64MB is the minimum, it is highly recommended that you have 128MB memory if you are migrating. Issue the command: bootinfo –r The output should be similar to: 131072 If the output from is equal to, or more than 128000, then you are okay for 5.2, and at the minimum recommended level for 5.3 migration. 6. If you are migrating to 5.2 or 5.3 from a 4.2 system, bos.rte.install must be at level 4.2.1.17 at the least. This can be checked by running the following command: lslpp -L bos.rte.install If not at level 4.2.1.17 or higher, the system should be updated using the September 1999 or a later update CD before migration. Contact CBMS support for instructions and CD. 7. The level of xlC.rte should be at 5.0.2.0 or later. This is a requirement for migrations to all versions (5.1, 5.2 and 5.3). If it is not at this level, order and install APAR IY17981. This can be checked by running the following command: lslpp -L xlC.rte If the xlC level is 4.2.1.17 or higher, the system should be updated using the AIX 4.x APAR xlC update cd. Contact CBMS support for instructions and AIX 4.x APAR fileset update CD. If you need to download this or other AIX 4.x APARs, you can do so at: Migrating to AIX Version 5.L July 7, 2005 11 Fix Central (http://www-912.ibm.com/eserver/support/fixes/fcgui.jsp) The pre_migration script will create a list of filesets that will be removed from the system during the migration. For 5.2, and 5.3, this list may be large if all devices were installed, because 5.2 and 5.3 are only supported on CHRP platform systems. Also, IBM-850 code page messages and locales are no longer supported in 5.2 or 5.3. Generally these are filesets no longer supported on the level of AIX you are migrating to. There is also an option to list these filesets at the Migration Confirmation Menu. A list of system configuration files that will not be merged to the latest level, but will rather, be saved in /tmp/bos, will be created by the pre_migration script, and can be viewed in the Migration Confirmation Menu. In addition, the pre_migration script will generate a list of system configuration files being merged, and will save these files in /home/pre_migration./saved_configuration_files. This information and files are not saved by any processes in version 5.1. 8. lppchk commands should be run to check system consistency, enter the following: lppchk lppchk lppchk lppchk -v -c -f –l In all cases no output is best. (No output when running these checks is expected and good.) If you see errors when running any of these commands. Please call PRISM-ICS Support (800) 733-4489. Migrating to AIX Version 5.L July 7, 2005 12 The pre_migration script will run the following commands for you. If you are migration to AIX 5.1 you may skip these tests If Trusted Computing Base (TCB) is enabled, the following command is run and the output saved for comparison purposes after the migration: tcbck -n tree If bos.net.ipsec.keymgt is installed, a check is made for the directory /etc/ipsec/inet/DB, and if it does not exist, it is recommended you do a force install of bos.net.ipsec.keymgt at the same level as currently installed on the system. This fileset will fail to migrate successfully if this directory is missing. Verify that your system-created file systems and logical volumes in the rootvg are as follows: lsvg -l rootvg NOTE: The numbers for LPs, PPs and PVs will vary. rootvg: LV NAME TYPE STATE MOUNT POINT hd5 boot closed/syncd N/A hd6 paging open/syncd N/A hd8 jfslog open/syncd N/A hd4 jfs open/syncd / hd2 jfs open/syncd /usr hd9var jfs open/syncd /var hd3 jfs open/syncd /tmp hd1 jfs open/syncd /home LPs 1 32 1 1 19 1 1 1 PPs 1 32 1 1 19 1 1 1 PVs 1 1 1 1 1 1 1 1 LV Migrating to AIX Version 5.L July 7, 2005 13 imported and varied on after the migration is complete. It is also recommended to break mirroring on the root volume group before the migration begins. To determine if the system is mirrored, run: lsvg -l rootv NOTE: If the pp's are twice the number of lp's, then that lv is mirrored. LV NAME TYPE LPs PPs PVs LV STATE MOUNT POINT hd5 boot 2 4 2 closed/syncd N/A hd6 paging 96 192 2 open/syncd N/A hd8 jfslog 1 2 2 open/syncd N/A hd4 jfs 3 6 2 open/syncd / hd2 jfs 156 312 2 open/syncd /usr hd9var jfs 3 6 2 open/syncd /var hd3 jfs 38 76 2 open/syncd /tmp hd1 jfs 1 2 2 open/syncd /home hd10opt jfs 11 22 2 open/syncd /opt Migrating to AIX Version 5.L July 7, 2005 14 What migration will do to your system If the boot logical volume (hd5) is too small, and there is not sufficient space to increase it, then the migration will halt with no changes to the system. If the boot logical volume is too small, but there is space to increase it, the migration will do so and continue. The Migration Confirmation Menu comes next. You will be offered choices to: • • • • See which base system configuration files will be stored in /tmp/bos and not automatically merged into the system. See which filesets will be removed from the system and will not be replaced with new filesets. See which directories will have the current contents removed during the migration installation. An option to cancel the migration is also available from this menu. The contents of /tmp are removed to make room for migration processes and for rebuilding the boot image at the end of the migration. Migration first saves system configuration files and then restores the files from the bos image (bos.rte.* subsystems or filesets). After the files are restored, migration performs the operations on the system configuration files, whether it be merging the new data into the old file, using the new file and saving the old file or vice versa. Then the filesets listed for removal are removed. During a migration installation, if /opt exists only as a directory, and has less than 3 MB of data, then a new logical volume and file system (/dev/hd10opt and /opt respectively), will be created and the data that existed in the /opt directory will be moved to the new file system. If there is more than 3 MB of data in /opt, the new logical volume and file system are not created. If any file system existed that had a mount point in the /opt directory, or a mount point of /opt itself, the new logical volume and file system are not created. Afterwards the remaining filesets on the system are migrated up to the latest level available on the media. Special file merge situations are handled after this, a new boot image is built and the system reboots. Migrating to AIX Version 5.L July 7, 2005 15 ~ NOTES~ Migrating to AIX Version 5.L July 7, 2005 16 Step 4: Actual migration to AIX 5L Migration from AIX 4.3 to AIX 5.1 1. All users must be logged of the RS/6000 2. Log into the RS/6000 machine as root user 3. Check and make sure you have a good nightly back up tape. If you do not have a current good back up tape, make a data back up using the manual backup instructions located in the appendix of this document. 4. Make a CLONE tape of your system. Clone tape instructions are in the appendix of this document. THIS IS A MUST DO! Please do not skip this step. 5. Perform the pre_migration checks. (From step 3 above) 6. Place the CD-ROM labeled AIX 5L for Power V 5.1 disk #1. 7. Check the boot sequence of the RS/6000. Issue the command: bootlist –m normal –o The out put will display a list of current the boot sequence. If CD0 is not first in the sequence then issue the following command: bootlist –m normal cd0 rmt0 hdisk0 fd0 8. Issue the shutdown command at the # prompt. Shutdown –F 9. Wait until the machine has come to HALT COMPLETE or is powered off completely. 10. Press the power button and power on the RS/6000 machine to turn it back on again and boot from the install disk in cd0. 11. Press the F1 and then press to use terminal as console. 12. if prompted choose monitor / display type enter vt220 Migrating to AIX Version 5.L July 7, 2005 17 13. Press 1 and to select the English language. 14. The RS/6000 will boot from the CD-ROM. You will see the AIX welcome to base operating system installation and maintenance screen. Welcome to Base Operating System Installation and Maintenance Type the number of your choice and press Enter. Choice is indicated by >>>. >>> 1 Start Install Now with Default Settings 2 Change/Show Installation Settings and Install 3 Start Maintenance Mode for System Recovery 88 Help? 99 Previous Menu >>> Choice [1]: 2 15. Choose Option 2: Change/Show Installation Settings and Install to confirm the type of install that will occur. 16. Enter number 1 to change Method of Installation to Migration. Note: On some system it will default to migration. Version 5.1 sample screen Installation and Settings Either type 0 and press Enter to install with current settings, or type the number of the setting you want to change and press Enter. 1 System Settings: Method of Installation.............Migration Disk Where You Want to Install.....hdisk0 2 Primary Language Environment Settings (AFTER Install): Cultural Convention................English (United States) Language ..........................English (United States) Keyboard ..........................English (United States) Keyboard Type......................Default 3 Advanced Options >>> 0 Install with the current settings listed above. +----------------------------------------88 Help ? | WARNING: Base Operating System 99 Previous Menu | Installation will destroy or impair | recovery of SOME data on the >>> Choice [0]: 3 destination disk hdisk0. Migrating to AIX Version 5.L July 7, 2005 18 17. Enter number 3 to see advanced settings. Version 5.1 sample screen Advanced Options Either type 0 and press Enter to install with current settings, or type the number of the setting you want to change and press Enter. 1 Desktop............................. CDE 2 Enable Trusted Computing Base....... No 3 Enable 64-bit Kernel and JFS2....... No >>> 0 Install with the current settings listed above. 88 Help ? 99 Previous Menu >>> Choice [0]: 18. Enter 0 to install with current settings listed from above. At the advanced options / more options menu screen. 19. Enter 0 to install with current settings listed from above. At the installation and settings screen. 20. AIX will display migration menu preparation in progress. Please wait. 21. AIX will display migration conformation screen. 22. Enter 0 to continue with migration. 23. AIX will display information as migration. Please wait, the migration process can / will take up to 2 or more hours to complete. 24. When prompted by the AIX migration process enter disk number 2. 25. When prompted by the AIX migration process enter disk number 3. 26. When prompted enter yes to accept installed license agreements 27. Enter done to exit screen and return to a AIX login screen 28. Log in as root user and perform Post migration checks a. If you migrated to 5.1 here are some of the commands in the post_migration script that you can run to determine the success of your migration. Enter the following command at the # prompt lppchk –v This command will check the consistency of the software. Migrating to AIX Version 5.L July 7, 2005 19 If some dependency is missing it will be reported here. If you do get any output, then issue this command to get more details on the condition. lppchk -m3 –v Other flags can be used with lppchk, but the -v flag gives the most important post migration data. The other flags are: lppchk -l lppchk -f lppchk –c In all cases no output is best. b. Check to see new AIX OS level, Issue this command to check. oslevel The output should be: 5.1.0.0 Migration to AIX 5.1 is complete. Migrating to AIX Version 5.L July 7, 2005 20 Migration from AIX 4.3 to AIX 5.2 1. All users must be logged off the RS/6000. 2. Log into the RS/6000 machine as root user 3. Check and make sure you have a good nightly back up tape. If you do not have a current good back up tape, make a data back up using the manual backup instructions located in the appendix of this document. 4. Make a CLONE tape of your system. Clone tape instructions are in the appendix of this document. THIS IS A MUST DO! Please do not skip this step. Instructions located in the appendix of this document. 5. Ensure that the root user has primary authentication method of SYSTEM. Check this condition, issue the command: lsuser -a auth1 root The output should be: root auth1=SYSTEM If the output is not like the example above, issue this command to give root user a primary authentication method of SYSTEM: chuser auth1=SYSTEM root 6. Mount and run the pre_migration script. a. Place the CD-ROM labeled AIX 5L for Power V 5.2 disk #1 in the CD drive of the RS/6000 cd0.Issue the mount command: mount -v cdrfs -o ro /dev/cd0 /mnt b. Change directory to /mnt directory. Issue this command: cd /mnt c. Run the pre_migration script. Issue this command: /usr/lpp/bos/pre_migration d. Do not interrupt the pre_migration script. Please wait. Migrating to AIX Version 5.L July 7, 2005 21 e. Do not remove the data created by the pre-migration script; it is used by the post-migration script. f. Do not take the cd out of the cd-drive on the RS/6000. 7. Issue the shutdown and reboot command at the # prompt. Shutdown –r 8. When the system beeps twice press the F5 key (or the 5 key on an ASCll terminal). If you have a graphics display, you will see the keyboard icon on the screen when the beeps occur. If you have an ASCII terminal (also called a tty terminal or console), you will see the word keyboard when the beeps occur. 9. Press the F1 (or 1 on an ASCII terminal) and then press to use terminal as console. 10. If prompted choose monitor / display type enter vt220 and press enter. 11. Press 1 and to select the English language. 12. The RS/6000 will boot from the CD-ROM. You will see the AIX welcome to base operating system installation and maintenance screen. Version 5.2 sample screen Welcome to Base Operating System Installation and Maintenance Type the number of your choice and press Enter. Choice is indicated by >>>. 1 Start Install Now with Default Settings 2 Change/Show Installation Settings and Install 3 Start Maintenance Mode for System Recovery 88 Help ? 99 Previous Menu >>> Choice [1} : 2 13. Choose Option 2 will take you to a summary of the install that will occur. Migrating to AIX Version 5.L July 7, 2005 22 14. Enter number 1 to change Method of Installation to Migration. (Note: On some system it will default to migration) Version 5.2 sample screen Installation and Settings Either type 0 and press Enter to install with current settings, or type the number of the setting you want to change and press Enter. 1 System Settings: Method of Installation.............Migration Disk Where You Want to Install.....hdisk0 2 Primary Language Environment Settings (AFTER Install): Cultural Convention................English (United States) Language ..........................English (United States) Keyboard ..........................English (United States) Keyboard Type......................Default 3 More Options (Desktop, Security, Kernel, Software, ...) >>> 0 Install with the current settings listed above. +----------------------------------------88 Help ? | WARNING: Base Operating System Installation will 99 Previous Menu | destroy or impair recovery of SOME data on the | destination disk hdisk0. >>> Choice [0]: 15. Enter number 3 to see advanced settings. Version 5.2 sample screen Install Options Enable Trusted Computing Base............................No Import User Volume Groups...............................Yes Enable System Backups to install any system.............Yes (Installs all devices and kernels) 4. Remove Java 1.1.8 Software...............................No 1. 2. 3. >>> 0 Install with the current settings listed above. 88 Help ? 99 Previous Menu >>> Choice [0]: 16. Enter 0 to install with current settings listed from above. At the advanced options / more options menu screen. 17. Enter 0 to install with current settings listed from above. At the installation and settings screen. Migrating to AIX Version 5.L July 7, 2005 23 18. AIX will display migration menu preparation in progress. Please wait. 19. AIX will display migration conformation screen. Double check your migration settings. 20. Enter 0 to continue with migration. 21. AIX will display information as migration. Please wait, the migration process can / will take up to 2 or more hours to complete. 22. When prompted by the AIX migration process to enter disk number 2. Place disk labeled number 2 in to the CD drive (cd0) and press enter. 23. If prompted for additional AIX disks, enter the disk that the AIX migration process is prompting for in the CD drive and press enter. 24. When prompted enter yes to accept installed license agreements 25. Enter done to exit screen and return to a AIX login screen 26. Login to AIX 27. Mount and run the post_migration script. a. Place the CD-ROM labeled AIX 5L for Power V 5.2 disk #1 in the CD drive of the RS/6000 cd0.Issue the mount command: mount -v cdrfs -o ro /dev/cd0 /mnt b. Change directory to /mnt directory. Issue this command: cd /mnt c. Run the post_migration script. Issue this command: /usr/lpp/bos/post_migration d. Do not interrupt the post_migration script. Please wait. 28. After Post Migration is complete; Migration to AIX 5.2 is complete Migrating to AIX Version 5.L July 7, 2005 24 Migration from AIX 4.3 to AIX 5.3 1. All users must be logged off the RS/6000. 2. All hardware, including any external devices such as tape drives and printers must be physically connected and powered on. 3. Log into the RS/6000 machine as root user 4. Check and make sure you have a good nightly back up tape. If you do not have a current good back up tape, make a data back up using the manual backup instructions located in the appendix of this document. 5. Make a CLONE tape of your system. Clone tape instructions are in the appendix of this document. THIS IS A MUST DO! Please do not skip this step. Instructions located in the appendix of this document. 6. Record current TCP/IP settings at the # prompt type, smit tcpip a. A screen will appear similar to below highlight Minimum Configuration & Startup. It should be highlighted as default selection and press enter. Move cursor to desired item and press Enter. Minimum Configuration & Startup Further Configuration Use DHCP for TCPIP Configuration & Startup IPV6 Configuration Quality of Service Configuration & Startup Configure IP Security (IPv4) Configure IP Security (IPv6) b. A second box will appear, Choose en0, it should be highlighted as default and press enter. en0 Standard Ethernet Network Interface c. A third screen will appear this screen is where you will see the TCP/IP settings. Write these settings down! You will have to reenter this information later in the migration process. After recording the setting Press F10 to exit smit TCP/IP and return to an administrator prompt (#). Migrating to AIX Version 5.L July 7, 2005 25 Sample Smit TCP/IP screen Host Name______________________________________ IP Address ______._______._______._______ Network Mask ______._______._______._______ Name Server ______._______._______._______ Domain Name____________________________________ Gateway ______._______._______._______ 7. Ensure that the root user has primary authentication method of SYSTEM. Check this condition, issue the command: lsuser -a auth1 root The output should be: root auth1=SYSTEM If the output is not like the example above, issue this command to give root user a primary authentication method of SYSTEM: chuser auth1=SYSTEM root 8. Mount and run the pre_migration script. a. Place the CD-ROM labeled AIX 5L for Power V 5.3 disk #1 in the Migrating to AIX Version 5.L July 7, 2005 26 CD drive of the RS/6000 cd0.Issue the mount command: mount -v cdrfs -o ro /dev/cd0 /mnt b. Change directory to /mnt directory. Issue this command: cd /mnt c. Run the pre_migration script. Issue this command: /usr/lpp/bos/pre_migration d. Do not interrupt the pre_migration script. Please wait. e. Do not remove the data created by the pre-migration script; it is used by the post-migration script. f. Do not take the cd out of the cd-drive on the RS/6000. 9. Issue the shutdown and reboot command at the # prompt. Shutdown –r 10. When the system beeps twice press the F5 key (or the 5 key on an ASCll terminal). If you have a graphics display, you will see the keyboard icon on the screen when the beeps occur. If you have an ASCII terminal (also called a TTY terminal or console), you will see the word keyboard when the beeps occur. 11. Press the F1 (or 1 on an ASCII terminal) and then press to use terminal as console. 12. If prompted choose monitor / display type enter vt220 and press enter. 13. Press 1 and to select the English language. 14. The RS/6000 will boot from the CD-ROM. You will see the AIX welcome to base operating system installation and maintenance screen. Migrating to AIX Version 5.L July 7, 2005 27 Version 5.3 sample screen Welcome to Base Operating System Installation and Maintenance Type the number of your choice and press Enter. Choice is indicated by >>>. 1 Start Install Now with Default Settings 2 Change/Show Installation Settings and Install 3 Start Maintenance Mode for System Recovery 88 Help ? 99 Previous Menu >>> Choice [1} : 2 15. Choose Option 2 will take you to a summary of the install that will occur. 16. Enter number 1 to change Method of Installation to Migration. (Note: On some system it will default to migration) Version 5.3 sample screen Installation and Settings Either type 0 and press Enter to install with current settings, or type the number of the setting you want to change and press Enter. 1 System Settings: Method of Installation.............Migration Disk Where You Want to Install.....hdisk0 2 Primary Language Environment Settings (AFTER Install): Cultural Convention................English (United States) Language ..........................English (United States) Keyboard ..........................English (United States) Keyboard Type......................Default 3 More Options (Desktop, Security, Kernel, Software, ...) >>> 0 Install with the current settings listed above. +----------------------------------------88 Help ? | WARNING: Base Operating System Installation will 99 Previous Menu | destroy or impair recovery of SOME data on the | destination disk hdisk0. >>> Choice [0]: 17. Enter number 3 to see advanced settings. Migrating to AIX Version 5.L July 7, 2005 28 Version 5.3 sample screen Install Options Enable Trusted Computing Base............................No Import User Volume Groups...............................Yes Enable System Backups to install any system.............Yes (Installs all devices and kernels) 4. Remove Java 1.1.8 Software...............................No 1. 2. 3. >>> 0 Install with the current settings listed above. 88 Help ? 99 Previous Menu >>> Choice [0]: 18. Enter 0 to install with current settings listed from above. At the advanced options / more options menu screen. 19. Enter 0 to install with current settings listed from above. At the installation and settings screen. 20. AIX will display migration menu preparation in progress. Please wait. 21. AIX will display migration conformation screen. Double check the settings. Sample AIX 5.3 migration conformation screen: Migration Confirmation Either type 0 and press Enter to continue the installation, or type the number of your choice and press Enter. 1 List the saved Base System configuration files which will not be merged into the system. These files are saved in /tmp/bos. 2 List the filesets which will be removed and not replaced. 3 List directories which will have all current contents removed. 4 Reboot without migrating. Acceptance of license agreements is required before using system. You will be prompted to accept after the system reboots. >>> 0 Continue with the migration. 88 Help ? +------------------------------------------------------Migrating to AIX Version 5.L July 7, 2005 29 WARNING: Selected files, directories, and filesets (installable options) from the Base System will be removed. Choose 2 or 3 for more information. >>> Choice[0]: 22. Enter 0 to continue with migration. 23. AIX will display information as migration. Please wait, the migration process can / will take up to 2 or more hours to complete. 24. When prompted by the AIX migration process to enter disk number 2. Place disk labeled number 2 in to the CD drive (cd0) and press enter. 25. If prompted for additional AIX disks, enter the disk that the AIX migration process is prompting for in the CD drive (cd0) and press enter. 26. When prompted enter yes to accept installed license agreements 27. Verify System Configuration after Installation: After the migration is complete, the system will reboot. Verify the system configuration, as follows: a. On systems with a graphics display, after a migration installation, the Configuration Assistant opens. On systems with an ASCII display, after a migration installation, the Installation Assistant opens. b. Select the Accept Licenses option to accept the electronic licenses for the operating system. You MUST accept the licenses! c. Verify the administrator (root user) password and network communications (TCP/IP) information. Enter the TCP/IP information from step ## above. Use any other options at this time. You can return to the Configuration Assistant or the Installation Assistant by typing configassist or smitty assist at the command line. d. Select Exit the Configuration Assistant and select Next. Or, press F10 (or ESC+0) to exit the Installation Assistant. e. If you are in the Configuration Assistant, select Finish now, and do not start Configuration Assistant when restarting AIX and select Finish. 28. When the login prompt displays, log in as the root user to perform system administration tasks. 29. Mount and run the post_migration script. Migrating to AIX Version 5.L July 7, 2005 30 a. Place the CD-ROM labeled AIX 5L for Power V 5.3 disk #1 in the CD drive of the RS/6000 cd0.Issue the mount command: mount -v cdrfs -o ro /dev/cd0 /mnt b. Change directory to /mnt directory. Issue this command: cd /mnt c. Run the post_migration script. Issue this command: /usr/lpp/bos/post_migration d. Do not interrupt the post_migration script. Please wait. 30. After Post Migration is complete; Migration to AIX 5.3 is complete Migrating to AIX Version 5.L July 7, 2005 31 Appendix 1: Manual Back of PRISM Data Files. These instructions backup a UNIX file system to tape. This manual backup procedure does the same thing as a PRISM nightly backup. ICS and IAS files will be backed up. WARNING: This should not be used on users that have prism in the /prism filesystem instead of the /home. Another set of instructions is below for users whose PRISM filesystem is in /prism directory below These instructions backup a UNIX file system to tape. This backup procedure does the same thing as a PRISM nightly backup. 1) Make sure everyone is logged off of the PRISM ICS and IAS system. 2) At the main console, login as root and press . 3) Enter the root password and press . 4) At the #, type init 0 (that's init zero) and press to move to single user mode. Wait for the " new run level" message to appear, and then press to return to a #. 5) At the #, type umount /home and press to unmount the /home filesystem. 6) Insert a tape in the tape drive attached to the RS-6000. 7) At the #, type chdev -l rmt0 -a block_size=1024 (note: -l is "dash el" and 0 is "zero") and press to setup the tape drive. 8) At the #, type backup -f /dev/rmt0 -0 /home and press to backup the filesystem. 9) After the backup is complete, make sure there are no error messages. 10) Remove the tape from the tape drive. 11) At the #, enter mount /home and press to mount the /home filesystem. 12) At the #, type init 2 and press to restart multi-user mode. Several message will display on the screen. When they have finished (this could take up to 4 minutes), press to return to a #. 13) At the #, type exit and press to return to an AIX login prompt. (Note: entering "backup" at an AIX login prompt will not check the results of a manual backup. This command only checks the results of the last scheduled nightly backup.) Migrating to AIX Version 5.L July 7, 2005 32 Manual Back up instructions for /prism directory: These instructions backup a UNIX file system to tape for users that have their filesystem under /prism instead of /home. This manual backup procedure does the same thing as a PRISM nightly backup. ICS and IAS files will be backed up. WARNING: This should not be used on users that have prism in the /home filesystem instead of the /prism. There is another set of instructions on ICS Help Notes for these users. These instructions backup a UNIX file system to tape. This backup procedure does the same thing as a PRISM nightly backup. 1) Make sure everyone is logged off of the PRISM ICS and IAS system. 2) At the main console, login as root and press . 3) Enter the root password and press . 4) At the #, type init 0 (that's init zero) and press to move to single user mode. Wait for the " new run level" message to appear, and then press to return to a #. 5) At the #, type umount /prism and press to unmount the /home filesystem. 6) Insert a tape in the tape drive attached to the RS-6000. 7) At the #, type chdev -l rmt0 -a block_size=1024 (note: -l is "dash el" and 0 is "zero") and press to setup the tape drive. 8) At the #, type backup -f /dev/rmt0 -0 /prism and press to backup the filesystem. 9) After the backup is complete, make sure there are no error messages. 10) Remove the tape from the tape drive. 11) At the #, enter mount /prism and press to mount the /home filesystem. 12) At the #, type init 2 and press to restart multi-user mode. Several message will display on the screen. When they have finished (this could take up to 4 minutes), press to return to a #. 13) At the #, type exit and press to return to an AIX login prompt. (Note: entering "backup" at an AIX login prompt will not check the results of a manual backup. This command only checks the results of the last scheduled nightly backup.) Migrating to AIX Version 5.L July 7, 2005 33 Appendix 2: How to make a system back up or Clone Tape. 1) The clone must be created from the main system terminal. Terminal directly attached to the RS. Not a computer workstation. 2) Make sure the key on the front of the RS-6000 computer is set to NORMAL (if you have a key). 3) Place the new tape in the tape drive. Do not use your last good daily backup tape! 4) At the console login on the main system terminal, type root and press . 5) When prompted for the password, type your store's root password and press . You will not see the password as it is typed. All other users must be logged off the PRISM ICS and IAS systems. 6) At the #, type init 0 (that's init zero space between t and 0) and press . This command inactivates all remote terminals. Only the main system terminal will be active for the clone procedure. 7) When the message "INIT: New run level 0" appears, press to return to a #. 8) At the #, type chdev -l rmt0 -a block_size=512 and press to return to a #. (That's the lower case letter "L" after chdev and that is a zero after rmt). 9) At the #, type tctl -f /dev/rmt0 rewind and press (there are no spaces). The system will immediately begin to construct a binary boot image on the tape, i.e., making the tape bootable. The operating system, the program, and all data files will then be copied file by file onto the tape. This process requires about 15 to 90 minutes or more. When the clone tape is finished, you will be returned to a #. 11) Remove the tape from the drive. Label it as a FULL SYSTEM CLONE and date it. Save this tape in a secure place. If a second clone is needed, put in a new tape and repeat step 8. If you wish we can store the 2nd tape for you here at CBMS 12) At the #, type init 2 and press . Status messages will display as remote terminals and processes are activated. When status messages stop (this could take up to four minutes), press to return to a #. 13) At the #, type exit and press . You will be returned to a login. Other users may now log back into PRISM ICS and IAS. Migrating to AIX Version 5.L July 7, 2005 34 Appendix 3: Updating AIX 4.3 xlC.rte to 5.0.2.0. The xlC.rte is the C++ runtime environment, and is necessary for the AIX 5.X kernel to boot properly the necessary update files are listed below and can be retrieved from the IBM website, or from CBMS ICS-SUPPORT. 07/08/2005 11:19 AM 18,432 xlC.adt.include.5.0.2.0.bff 07/08/2005 11:39 AM 14,865,920 xlC.aix41.rte.5.0.2.0.bff 07/08/2005 12:36 PM 14,533,120 xlC.aix43.rte.5.0.2.0.bff 07/08/2005 12:14 PM 11,972,096 xlC.aix50.rte.5.0.2.0.bff 07/08/2005 12:14 PM 3,072 xlC.msg.EN_US.rte.5.0.2.0.bff 07/08/2005 12:14 PM 3,072 xlC.msg.JA_JP.rte.5.0.2.0.bff 07/08/2005 12:14 PM 3,072 xlC.msg.ZH_CN.rte.5.0.2.0.bff 07/08/2005 12:14 PM 10,240 xlC.msg.en_US.rte.5.0.2.0.bff 07/08/2005 12:14 PM 11,776 xlC.msg.ja_JP.rte.5.0.2.0.bff 07/08/2005 12:14 PM 3,072 xlC.msg.zh_CN.rte.5.0.2.0.bff 07/08/2005 12:20 PM 4,023,808 xlC.rte.5.0.2.0.bff 11 File(s) 45,447,680 bytes 0 Dir(s) 0 bytes free The instructions for updating the AIX operating system are as follows: 1. Login as root. 2. Copy the above files, either from a CD or website, to the /usr/sys/inst.images directory on the RS/6000. 3. As always with system changes, it is a good idea to backup the system to tape or other media before continuing. 4. At the shell prompt, type: inutoc /usr/sys/inst.images 5. At the shell prompt, type: installp -acgXd /usr/sys/inst.images xlC 6. Then type: smit update_all Note: To retrieve the update files from IBM, use the http://www-912.ibm.com/eserver/support/fixes/fcgui.jsp website to select "Specific Fixes" for 4.3. Next, select APAR from the dropdown selection and type in "IY17981". Migrating to AIX Version 5.L July 7, 2005 35