Restores a workload partition.
restwpar [ -a ] [ -A ] [ -b Blocks ] [ -B devexportsFile ] [ -C ] [ -d Directory ] [ -f Device ] [ -F ] [ -h hostName ] [ -i imagedataFileName ] [ -k ] [-K] [ -M mkwparFlags ] [ -n WparName ] [ -r ] [ -s ] [ -S { a | A | f | F | n } ] [ -U ] [ -w wparSpecificationFile ]
The restwpar command creates a workload partition from a workload partition backup image that was created by the savewpar, mkcd, or mkdvd command.
A workload partition backup image contains an image.data file and a workload partition specification file that are used to establish the characteristics of workload partition WparName. You can use the -i and -w flags to override these default files.
If you do not specify the -f flag, the /dev/rmt0 device is used as the input device.
If you specify a value of Yes in the EXACT_FIT field of the logical_volume_policy stanza of the /tmp/wpardata/WparName/image.data file, the restwpar command uses the map files to preserve the placement of the physical partitions for each logical volume.
Item | Description |
---|---|
-a | Automatically resolves conflicting static settings if required. Resolvable settings are name, host name, base directory, and network configuration. |
-A | Starts the workload partition each time when the /etc/rc.wpars command is run, which is added to the global /etc/inittab to run on each system start. The default is not to start the workload partition automatically. |
-b Blocks | Specifies the number of 512-byte blocks to read in a single input operation. If you do not specify the Blocks parameter, the default value of 100 is used by the restore command. Larger values result in larger physical transfers to tape devices. |
-B devexportsFile | Specifies an alternate file to use as the master device exports file. This file must match the format of a Device Exports File. If you do not specify a file name, the /etc/wpars/devexports file is used. |
-C | Forces the creation of the named workload partition, even when a compatibility
check fails between the system from the backup image and the system
where the backup is being restored. If the workload partition is not compatible with the target system, it might not be operable. |
-d Directory | Specifies a base directory for this workload partition. If you do not specify a directory name, the directory name from the WPAR specification file is used. |
-f Device | Specifies the device name of the backup media. The default value is /dev/rmt0. |
-F | Forces the creation of the named workload partition. If the named workload partition already exists, it is stopped if active, and then removed, before the new workload partition is created. |
-h hostname | Specifies a host name for this workload partition. If not specified, the mkwpar command uses the workload partition name for the host name. |
-i imagedataFileName | An optional flag that specifies a file name. The file is used as the image.data file instead of the one contained within the backup image that is being restored. |
-k | Creates logical volumes with minimum sizes from the backup. |
-K | Creates the post-installation customization script. |
-M mkwparFlags | Specifies additional flags to pass directly
to the mkwpar command to create the workload partition. The -M flag
is used to pass other flags to the mkwpar command. If a flag
is passed through its own option and through the -M flag, both
flags are passed to the mkwpar command. Note: The mkwparFlags value
cannot include the -i and -f flags as these flags are
reserved for use by the restwpar command. Specifying the -i or -f flag
as the mkwparFlags value will cause an error.
|
-n WparName | Specifies the name for the workload partition to be created. If you do not specify the -n flag, the WparName is taken from the WPAR specification file. |
-r | Duplicates the network name resolution configuration
from the global system. The following files, if they exist, are copied
into the workload partition:
|
-s | Starts the workload partition after it is created. |
-S { a | A | f | F | n } | Specifies the type of synchronization to use
after files are restored from the backup to synchronize the levels
of software in the workload partition with
the levels of the software in the global environment.
|
-U | Specifies that the existing MAP files are ignored. The -U flag overrides the value of the EXACT_FIT field in the logical_volume_policy stanza of the WparName.data file. |
-w wparSpecificationFile | An optional flag that specifies a file name. The file is used as the WPAR specification file rather than the version in the WPAR backup image by the mkwpar command. |
restwpar -f/dev/rmt1
restwpar -f/mydata/wpar.img -n mywpar -d /wpars/mywpar
restwpar –f /dev/usbms0