Commands Reference, Volume 5

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 sycnvg 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

-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.

Examples

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

Files

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

Related Information

The varyonvg command.

The Logical Volumes in AIX 5L Version 5.2 System Management Guide: Operating System and Devices explains the Logical Volume Manager, physical volumes, logical volumes, volume groups, organization, ensuring data integrity, and allocation characteristics.

The System Management Interface Tool in AIX 5L Version 5.2 System Management Guide: Operating System and Devices explains the structure, main menus, and tasks that are done with SMIT.