syncwpar Command

Edit online

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 }

Versioned WPAR device data synchronization

/usr/sbin/syncwpar -c 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 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 WPAR that have a read-only /usr directory.

Note: The syncwpar command cannot be used to synchronize software levels in AIX® 5.2 or AIX 5.3 versioned WPAR. Software in versioned WPAR 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 WPAR when you specify the wparname parameter with the -f wparnamesfile parameter, or on all system WPAR 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.
-c Synchronizes the predefined storage device data in a specified versioned workload partition. The -d device flag is not required to synchronize the device data. Synchronization of the device data helps to resolve problems while configuring a storage device in a WPAR.
-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 with the -D flag.
  • When the -d flag is specified, the images in the directory are used to apply the base installation or updates to the detached WPARs. It is important that the install or update images in the specified location are the same as the ones that were last used to install or update the global system so that the resulting software levels match.
  • 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 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

  1. To synchronize all of the software on workload partition mywpar, enter the following command: 
    syncwpar mywpar
  2. To synchronize all WPAR, enter the following command in the global environment: 
    # syncwpar -A
  3. To synchronize WPAR that is named mywpar and to expand the file system automatically, enter the following command: 
    # syncwpar -X mywpar
  4. To synchronize software in the detached WPAR named privatewpar using the /mysw software installation directory, enter the following command: 
    # syncwpar -D -d /mysw privatewpar
  5. 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
  6. 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