syncvg Command

Purpose

Synchronizes logical volume copies that are not current.

Syntax

syncvg [ -f ] [ -i ] [ -H ] [ -P NumParallelLps ] { -l | -p | -v } Name ...

Description

The syncvg command synchronizes the physical partitions, which are copies of the original physical partition, that are not current. The syncvg command can be used with logical volumes, physical volumes, or volume groups, with the Name parameter representing the logical volume name, physical volume name, or volume group name. The synchronization process can be time consuming, depending on the hardware characteristics and the amount of data.

When the -f flag is used, a good physical copy is chosen and propagated to all other copies of the logical partition, whether or not they are stale. Using this flag is necessary in cases where the logical volume does not have the mirror write consistency recovery.

Unless disabled, the copies within a volume group are synchronized automatically when the volume group is activated by the varyonvg command.
Note: For the syncvg command to be successful, at least one good copy of the logical volume should be accessible, and the physical volumes that contains this copy should be in ACTIVE state. If the -f option is used, the above condition applies to all mirror copies.

If the -P option is not specified, syncvg will check for the NUM_PARALLEL_LPS environment variable. The value of NUM_PARALLEL_LPS will be used to set the number of logical partitions to be synchronized in parallel.

Flags

Item Description
-f Specifies a good physical copy is chosen and propagated to all other copies of the logical partition, whether or not they are stale.
-H Postpones writes for this volume group on other active concurrent cluster nodes until this sync operation is complete. When using the -H flag, the -P flag does not require that all the nodes on the cluster support the -P flag. This flag is ignored if the volume group is not varied on in concurrent mode.
-i Reads the names from standard input.
-l Specifies that the Name parameter represents a logical volume device name.
-p Specifies that the Name parameter represents a physical volume device name.
-P NumParallelLps Numbers of logical partitions to be synchronized in parallel. The valid range for NumParallelLps is 1 to 32. NumParallelLps must be tailored to the machine, disks in the volume group, system resources, and volume group mode.
When a volume group is varied on in concurrent mode, all other cluster nodes that have this volume group varied must be at least AIX® 4.3.0, otherwise syncvg will ignore this option and continue.
Note: See Description above for more information.
-v Specifies that the Name parameter represents a volume group device name.

Security

Attention RBAC users and Trusted AIX users: This command can perform privileged operations. Only privileged users can run privileged operations. For more information about authorizations and privileges, see Privileged Command Database in AIX Version 7.1 Security. For a list of privileges and the authorizations associated with this command, see the lssecattr command or the getcmdattr subcommand.

Examples

  1. To synchronize the copies on physical volumes hdisk04 and hdisk05, enter: 
    syncvg  -p hdisk04 hdisk05
  2. To synchronize the copies on volume groups vg04 and vg05, enter: 
    syncvg  -v vg04 vg05

Files

Item Description
/usr/sbin/syncvg Contains the syncvg command.
/tmp Directory where the temporary files are stored and while the command is running.