syncwpar Command

Purpose

Synchronizes software between a global system and a workload partition.

Syntax

Shared WPAR synchronization

/usr/sbin/syncwpar [ [ -a ] [ -i ] | [ -F ] [ -r ] ] [ -p ] [ -v ] [ -X ] { -A | -f wparnamesfile | wparname }

Detached WPAR synchronization

/usr/sbin/syncwpar -D [ -d device ] [ -p ] [ -v ] [ -X ] { -A | -f wparnamesfile | wparname }

Detached WPAR interim fix operations

/usr/sbin/syncwpar -D { -E <path to fix> | -R <ifix label>} { -A | -f wparnamesfile | wparname }

Description

The syncwpar command synchronizes the software that is installed in the global shared parts (usually the /usr and /opt) with the workload partition's root part.

If you specify the -D flag, the syncwpar command recovers the system software that is in a detached workload partition (WPAR) with writable /usr directory, and that has diverged from the system software in the global environment. If you do not specify the -D flag, the syncwpar command runs only on shared WPARs that have a read-only /usr directory.

Note: The syncwpar command cannot be used to synchronize software levels in compatibility WPARs. Software in compatibility WPARs is independent from the software in the global environment.

The syncwpar command operates on a single WPAR when you specify the wparname parameter, on a list of WPARs when you specify the wparname parameter with the -f wparnamesfile parameter, or on all system WPARs when you specify the -A flag.

Restriction: Running the syncwpar command on application workload partitions is restricted.

Note: If you run the syncwpar command to sync a version 6 workload partition, on a version 7 global system, the syncwpar command will call the migwpar command and migrates the workload partition.

Flags

Item	Description
-a	Performs additional installation only. Does not downlevel the installp filesets (that is, uninstall, reject, force overwrite). Not valid with the -r flag.
-D	Synchronizes software in the detached system workload partitions that have a writable /usr directory. The default is to synchronize software in only shared system workload partitions that have a read-only /usr directory.
-i	Only updates the installp filesets. Not valid with the -r flag.
-F	Forces the RPM files to be copied. Not valid with the -i flag.
-r	Updates only the RPM files. Not valid with the -i flag.
-p	Previews the operation. Does not actually perform the synchronization.
-v	Specifies the verbose mode.
-X	Expands file systems if necessary and possible.
-A	Synchronizes all of the available system workload partitions with the global system.
-f	Specifies the file containing a list of workload partitions in the wparnamesfile parameter.
-d	Synchronizes the software in a detached WPAR `wpar`, using the specific software installation directories. The -d flag is valid only when used along with -D. When the -d flag is specified, the images in the directory are used to apply the base installation or updates to the detached WPARs. When the -d flag is not specified, the synchronization rejects or commits the levels of software in the detached WPARs.
-R	Removes the specified interim fix from the WPARs. The argument is the label of the ifix parameter that must to be removed. The flag is valid only for detached system workload partitions.
-E	Installs the specified interim fix into the detached system workload partitions. The argument is the full path to the ifix parameter. The flag is valid only for detached system workload partitions.

Parameters

Item	Description
wparnamesfile	Specifies the file that contains a list of workload partition names.
wparname	Specifies the name of a workload partition.
device	Specifies the name of a device.

Security

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

Examples

To synchronize all of the software on workload partition mywpar, enter the following command:
```
syncwpar mywpar
```
To synchronize all WPARs, enter the following command in the global environment:
```
# syncwpar -A
```
To synchronize WPAR that is named mywpar and to expand the file system automatically, enter the following command:
```
# syncwpar -X mywpar
```
To synchronize software in the detached WPAR named privatewpar using the /mysw software installation directory, enter the following command:
```
# syncwpar -D -d /mysw privatewpar
```
To install the myfix.epkg.Z interim fix to all the detached system workload partitions, enter the following command:
```
# syncwpar -D -E /tmp/myfix.epkg.Z -A
```
To remove an interim fix with the label myfix from all the detached system workload partitions, enter the following command:
```
# syncwpar -D -R myfix -A
```