Importing AIX LPARs into Skytap Cloud

Skytap Cloud provides tools to help you export your on-premises AIX LPARs to disk images that you can then import into Skytap environments. The toolset consists of a pair of scripts that you copy to an empty hard disk on the same LPAR that you want to import into Skytap Cloud. The scripts make disk images of the hard disks that you specify and then create an OVF that contains an index of all the hard disk images. Then you use the Skytap Cloud VM Import tool to create a VM from the OVF and disk images.

x86 VM imports use a different process. For instructions about importing x86 The most common type of CPU for Windows and Linux VMs in Skytap Cloud. VMs, see Importing x86 VMs using the VM Imports page.

Contents

Requirements

Things to consider when you export an AIX LPAR:

  • Currently, the following are the minimum versions of AIX that Skytap Cloud supports:
    • AIX 6.1: AIX 6.1 TL 9 SP 10
    • AIX 7.1: AIX 7.1 TL 4 SP 4
    • AIX 7.2: AIX 7.2 TL 1 SP 2
  • Workloads on the LPAR should be at minimal activity.

    Recommended: Deactivate the volume groups to be exported, using the varyoffvg command. For details, see the varyoffvg Command reference help.

  • The combined file size of the LPAR hard disk image files must be less than 1 TB.
  • The export process creates full-sized disk image files(.img) for all of the hard disks that you specify. Because Skytap Cloud import for AIX VMs doesn’t support compressed files, each .img file is the full allocated size of the source hard disk—including empty space.
  • The disk image files are created on a hard disk that you specify. Make sure you have enough space to store all of the disk image files that the Skytap Cloud tool creates.

    The amount of free space on the destination disk must be larger than the combined sizes of all of the disks that you will export.

  • Though all of the hard disks that you specify will be imported, the order of the disks can vary.

Step 1: Export the LPAR

  1. Prepare rootvg for export using alt_disk_copy. For details, see the alt_disk_copy Command reference help.
  2. Download the Skytap Cloud aix-export tool from GitHub: https://github.com/skytap/aix-export.

    The Skytap Cloud aix-export tool consists of two scripts: export_lpar.ksh and make_ovf.ksh.

  3. On the LPAR you want to import to Skytap, copy the scripts to the target disk where the disk images will be saved. Make sure the target disk has enough space to accommodate all of the hard disks that you plan to export.
  4. Create the export package with the following command:

    /export_lpar.ksh hdisk1 [hdisk2] … [hdiskn]

    If there are multiple hard disks, be sure to specify the bootable hard disk first. In the example above, hdisk1 is the bootable disk.

    Do not include the hard disk where the export scripts are running. For example, if you copied the scripts to hdisk4, do not include hdisk4 in the export_lpar.ksh command line.

    1. Disk image (.img) files are created for all of the hard disks that you specified in the command, in the same directory where you ran export_lpar.ksh.
    2. When export_lpar.ksh completes, it automatically runs make_ovf.ksh to create <hostname>.ovf, which contains an index of the .img files that were exported by export_lpar.ksh.
    3. Optional: To reduce SFTP file transfer times when you import the LPAR into Skytap Cloud, you can combine <hostname>.ovf and its indexed .img files into a single, compressed .ova file with the following command:

      tar -cvf - <hostname>.ovf <hostname>-disk1.img [<hostname>-disk2.img] … [<hostname>-diskn.img] | gzip > <hostname>.ova

      The combined, uncompressed file size of the LPAR hard disk image files must be less than 1 TB. If the collection of files to be imported exceeds 1 TB, contact Skytap Support at support@skytap.com to enable import of larger LPAR file sets.

Step 2: Create Import job

Create single import job for each LPAR that you want to upload. The import job will specify the .ovf and associated .img files or a single .ova (if you combined the files using tar).

To create an import job

  1. From the Navigation bar in Skytap Cloud, click Environments.
  2. Click the VM Imports tab.

    vm imnports

    The VM Imports tab notifies you if you do not have permission to import VMs. If needed, work with your account administrator to gain access.

  3. Click Create VM Import Job (Create VM Import Job).
  4. Provide details about the import, including:
    • Type an Environment Name (maximum 255 characters).
    • For Import includes Power VMs, click Yes.
    • Select the Region where the environment will be added.
    • Optional: Type or paste an MD5 Hash Value. For more information, see Creating MD5 hash values for VM imports.

    VM Import Job Details

  5. Click Save Import Job.

Step 3: Upload VM files to the Skytap Cloud FTP server

Upload the prepared VM files to the Skytap Cloud FTP server using an SFTP client (such as WinSCP). Skytap Cloud provides you with the hostname, and temporary FTP account credentials for a depot on the Skytap FTP server.

Skytap SFTP Information

Important:

  • Do not place compressed files in nested directories inside the /upload directory. If you have a choice for transfer method, choose binary transfer.
  • The temporary FTP account expires after 10 days.

Though Skytap Cloud can accept transfers over FTP, SFTP is more secure and provides better protection against file corruption.

SFTP client

Step 4: Start the import process

When the FTP upload is complete, click Create environment on the Skytap Cloud Import page. Skytap Cloud imports the VM file and create your new environment.

Skytap Cloud notifies you via email when the import completes. If the import is successful, Skytap Cloud provides a link to the new environment; if the import fails, Skytap Cloud provides an error message (see Resolving import errors).