Installation Guide and Reference

Troubleshooting a Migration Installation

The following sections offer solutions for problems that can occur during a migration installation.

Boot Logical Volume Not Large Enough

If you receive errors indicating the boot logical volume is not large enough, see Acting on System and Error Messages.

Insufficient Disk Space for Migration

At the beginning of a migration installation, the system verifies that there will be enough space to attempt the migration. If there is not enough disk space, a message is printed explaining how much is needed. You must now reboot the machine from the media containing your current version of AIX, and make more space available in the rootvg volume group. After you do this, attempt the migration again.

You can use the following options for adding additional disk space for the migration installation:

Add another disk to the rootvg volume group using either the SMIT smit extendvg fast path or the extendvg command.
Move any user data logical volumes from the rootvg volume group to another volume group. You can use either the SMIT smit cplv fast path or the cplv command to move individual logical volumes to another volume group's disk. It is a good idea to have only system logical volumes in the rootvg, and have user data logical volumes in other volume groups.
After you use the cplv command, you must remove the original logical volumes with the rmlv command. If the moved logical volume contains a file system, you must modify its corresponding entries in the /etc/filesystems file to reflect the new logical volume name.

For more detailed information about manipulating logical volumes and volume groups, refer to Logical Volumes in AIX 5L Version 5.2 System Management Guide: Operating System and Devices.
Remove unneeded logical volumes (and file systems) from the rootvg. Run the lsvg -l rootvg command to see all the logical volumes in the rootvg volume group. The only logical volumes that must be in the rootvg are: hd2, hd3, hd4, hd5, hd6, hd8, and hd9var. The hd1 (/home) logical volume can reside in another volume group if necessary.
The hd7 (system dump) logical volume is not needed in AIX 5L because the paging space logical volume (hd6) is used. The migration code automatically removes this logical volume if space is needed, but you can remove it ahead of time with the following commands:
```
sysdumpdev -P -p /dev/hd6
rmlv -f hd7
```
If you cannot find extra space in your rootvg, you may have to do a preservation installation instead of a migration installation to AIX. A preservation installation saves all the "non-system" logical volumes and file systems (for example, /home), but removes and re-creates the following logical volumes: hd2, hd3, hd4, hd5 and hd9var.
If you do a preservation installation, you must reinstall any applications that were installed in your rootvg after the preservation installation has completed. You must also reconfigure devices, as well as re-create users and groups. See Introduction to Base Operating System Installation for more information about a preservation installation.

After you have released enough space, reboot from your installation media, and try the migration installation again. You must have at least 8 MB of free disk space to complete the migration installation.

If there is insufficient space to complete the migration installation during the BOS installation process, a message similar to the following is displayed at the end of the installation:

An error occurred while migrating packages.

Some packages have not been installed.

Please see /var/adm/ras/devinst.log for details or perform an overwrite or
   preservation install.

If space limitations prevent the migration of all software that is usually automatically migrated, the installation program attempts to install the software that is usually installed for a Preservation or Overwrite installation. If there is still not enough disk space available, the minimum set of software required to support the use of the system is installed.

If there is not enough space to migrate all of the usually migrated software, a collection of software called a Migration Bundle will be available when you install additional software later. If the minimum set of software is installed, or if the installation is not performed from a graphics console, a Graphics_Startup Bundle is created. Before installing either of these bundles, create additional disk space on the machine you want to install. Refer to Optional Software Products and Service Updates for more information about installing software bundles and migrating or installing optional software products. Maintaining Optional Software Products and Service Updates describes how to remove software from the system to release disk space.