migwpar Command

Purpose

After an operating system migration of a global system to version 7, the migwpar command is used to migrate a workload partition (WPAR) that was created on the version 6 global system, to version 7.

The migwpar command can also be used to migrate from a 5.2 or 5.3 versioned WPAR to a native 7.1 WPAR.

Syntax

migwpar [ -d<software_source> ] { -A | -f <wparNamesFile> | [ -C ] wpar_name }

Description

After an operating system migration of a global system to version 7, the migwpar command is used to migrate a workload partition (WPAR) that was created on the version 6 global system, to version 7. Software that no longer exists (it might be replaced by a different software package) on the global system, is removed.

Ensure that all software on the global system has been migrated before you begin to migrate the WPARs. The use of the pre_migration script before the global system migration, and the post_migration script after the migration, will provide data that can be used to verify the migration, such as listing software that will be removed during the migration, and software that did not migrate.

The -C flag is used to migrate from a 5.2 or 5.3 versioned WPAR to a native 7.1 WPAR. The -C flag is incompatible with the list flags (-A or -f). When you migrate a versioned WPAR, the -d software_source information is mandatory.
Note: It is highly recommended to back up the WPAR before you begin to migrate.

A log of all actions of the migwpar command is saved in the /var/adm/ras/migwpar.log file. The output of the actual software migration of each WPAR is saved in /var/adm/ras/devinst.log within the WPAR.

Flags

Item Description
-A Migrates all migratable WPARs
-f wparNamesFile Migrates the list of WPARs contained in the file wparNamesFile, one per line.
-C wparName Migrates the specified 5.2 or 5.3 versioned WPAR.
-d software_source Specifies the installation location that is used for the detached WPAR migration.
Note: The install (or update) images in the specified location must be the same as the ones used to install (or update) the global system.

Security

Access control: Only the root user can run this command.

Examples

  1. After the base operating system of GLOBAL has been migrated to 7.1 to migrate a single WPAR, wpar1 to 7.1, enter the following command:
    # migwpar wpar1
  2. To migrate a detached WPAR, wpar2 by using install images from /images, enter the following command:
     # migwpar -d /images wpar2
  3. To migrate all shared WPARs, enter the following command:
     migwpar -A
  4. To migrate all detached WPARs by using install images in /images, enter the following command:
     migwpar -A -d /images
  5. To migrate a 5.2 versioned WPAR wpar_52 by using install images in /images, enter the following command:
    migwpar -d /images -C wpar_52