Migrating your system from media

Using this scenario, you can migrate a system from AIX® 7.1 to AIX 7.3.

The information in this how-to scenario was tested using specific versions of AIX. The results you obtain might vary significantly depending on your version and level of AIX.

In this scenario, you will do the following:
  • Perform a migration installation of AIX 7.1 to AIX 7.3.
  • Use English as the primary language.
  • Use the default options in the Advanced Options menu.
Attention: This procedure requires shutting down and reinstalling the base operating system. Whenever you reinstall any operating system, schedule your downtime when it least impacts your workload to protect yourself from a possible loss of data or functionality. Before you perform a migration installation, ensure you have reliable backups of your data and any customized applications or volume groups. For instructions on how to create a system backup, see Creating system backups.

Step 1. Prepare for the migration

Before starting the migration, complete the following prerequisites:
  • Ensure that the root user has a primary authentication method of SYSTEM. You can check this condition by typing the following command:
    # lsuser -a auth1 root
    If needed, change the value by typing the following command:
    # chuser auth1=SYSTEM root
  • Before you begin the installation, other users who have access to your system must be logged off.
  • Verify that your applications will run on AIX 7.3. Also, check if your applications are binary-compatible with AIX 7.3. If your system is an application server, verify that there are no licensing issues. Refer to your application documentation or provider to verify on which levels of AIX your applications are supported and licensed.
  • Check that your hardware microcode is up-to-date.
  • All requisite hardware, including any external devices (such as tape drives or CD/DVD-ROM drives), must be physically connected and powered on. If you need further information, refer to the hardware documentation that accompanied your system.
  • Use the errpt command to generate an error report from entries in the system error log. To display a complete detailed report, type the following:
    # errpt -a
  • Adequate disk space and memory must be available. You need at least 4 GB of memory and minimum of 20 GB of physical disk space.
  • Run the pre_migration script located in the mount_point/usr/lpp/bos directory on your media. To mount the media, enter the following command, where N is your media drive number:
    # mount -v cdrfs -o ro /dev/cdN  /mnt
    Note: Do not remove the data created by the pre_migration script, because it is used by the post_migration script.
  • For the latest migration information see the latest release notes.

Step 2. Boot from the AIX product media

  1. If they are not already on, turn on your attached devices.
  2. Insert the AIX Volume 1 media into the media device.
  3. Reboot the system by typing the following command:
    # shutdown -r
  4. When the system beeps twice, press F5 on the keyboard (or 5 on an ASCII 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), you will see the word keyboard when the beeps occur.
    Note: If your system does not boot using the F5 key (or the 5 key on an ASCII terminal), refer to your hardware documentation for information about how to boot your system from an AIX product media.
  5. Select the system console by pressing F1 (or 1 on an ASCII terminal) and press Enter.
  6. Select the English language for the BOS Installation menus by typing a 5 at the Choice field and press Enter. The Welcome to Base Operating System Installation and Maintenance menu opens.
  7. Type 2 to select 2 Change/Show Installation Settings and Install in the Choice field and press Enter.
                          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
    
        4 Make Additional Disks Available
    
        5 Select Storage Adapters
    
    
        88  Help ?
        99  Previous Menu
    >>> Choice [1]: 2
    

Step 3. Verify migration installation settings and begin installation

  1. Verify that migration is the method of installation. If migration is not the method of installation, select it now. Select the disk or disks you want to install.
        1  System Settings:
             Method of Installation.............Migration
             Disk Where You Want to Install.....hdisk0
  2. Select Primary Language Environment Settings (AFTER Install).
  3. Type 3 and press Enter to select More Options. To use the Help menu to learn more about the options available during a migration installation, type 88 and press Enter in the Installation Options menu. For more information about the installation options available in AIX 7.3, see BOS installation options.
  4. Verify the selections in the Migration Installation Summary screen and press Enter.
  5. When the Migration Confirmation menu opens, follow the menu instructions to list system information or continue with the migration by typing 0 and pressing Enter.
                                       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 ?
    
    +---------------------------------------------------------------------------
      WARNING: Selected files, directories, and filesets (installable options)
        from the Base System will be removed.  Choose 2 or 3 for more information.
    
    
    >>> Choice[0]:

Step 4. Verify system configuration after installation

After the migration is complete, the system will reboot. as follows:
  1. 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.

    For more information on the Configuration Assistant or the Installation Assistant, see Configuring AIX with the Configuration Assistant.

  2. Select the Accept Licenses option to accept the electronic licenses for the operating system.
  3. Verify the administrator (root user) password and network communications (TCP/IP) information.

    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.

  4. Select Exit the Configuration Assistant and select Next. Or, press F10 (or ESC+0) to exit the Installation Assistant.
  5. If you are in the Configuration Assistant, select Finish now, and do not start Configuration Assistant when restarting AIX and then select Finish.
  6. When the login prompt displays, log in as the root user to perform system administration tasks.
  7. Run the /usr/lpp/bos/post_migration script.