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 version 7 WPAR.
The migwpar command can also be used to enable a 5.2 or 5.3 versioned WPAR to work after the global system is migrated to a new operating system level. The versioned WPAR remains at the previous level.
Syntax
migwpar [ -d<software_source> ] [-V]{ -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 version 7 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.
The -V flag can be used to enable a versioned WPAR after the
global system is migrated. This option maintains the WPAR at its current level and allows the WPAR
to work on the newly migrated global system. This functionality is available on IBM®
AIX® 7.2 with Technology Level 2 or later. Only
rootvg versioned WPARs require enablement by using the -V
option.
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.
|
| -V | Enables a WPAR after the global system is migrated. The -V option is not compatible with the -C or -d flags. |
Security
Access control: Only the root user can run this command.
Examples
- After the base operating system of GLOBAL has been migrated to version 7 to
migrate a single WPAR, wpar1 to version 7, enter the following command:
# migwpar wpar1 - To migrate a detached WPAR, wpar2 by using install images from /images,
enter the following command:
# migwpar -d /images wpar2 - To migrate all shared WPARs, enter the following command:
migwpar -A - To migrate all detached WPARs by using install images in /images,
enter the following command:
migwpar -A -d /images - 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 - To enable all versioned WPARs on a system after a global system is migrated,
enter the following command:
migwpar -VA