Imports a new volume group definition from a set of physical volumes.
importvg [ -V MajorNumber ] [ -y VolumeGroup ] [ -f ] [ -c ] [ -x ] | [ -L VolumeGroup ] [ -n ] [ -F ] [ -R ]PhysicalVolume
Attention: When you issue the importvg command to a previously defined volume group, the QUORUM and AUTO ON values will be reset to volume group default values. You should verify the parameters of the newly imported volume group with the lsvg command and change any values with the chvg command.
The importvg command makes the previously exported volume group known to the system. The PhysicalVolume parameter specifies only one physical volume to identify the volume group; any remaining physical volumes (those belonging to the same volume group) are found by the importvg command and included in the import. An imported volume group is automatically varied unless the volume group is Concurrent Capable. You must use the varyonvg command to activate Concurrent Capable volume groups before you access them.
When a volume group with file systems is imported, the /etc/filesystems file is updated with values for the new logical volumes and mount points. After importing the volume group and activating it with the varyonvg command, you must run the fsck command before the file systems can be mounted. However, the mount point information would be missing from the LVCB (logical volume control block) if it is longer than 128 characters. In this case, the importvg command will not be able to update the /etc/filesystems file with the stanza for the newly imported logical volume. You should manually edit the /etc/filesystems file to add a new stanza for this logical volume.
The importvg command changes the name of a logical volume if the name already exists in the system. It prints a message and the new name to standard error, and updates the /etc/filesystems file to include the new logical volume name.
- To use this command, you must either have root user authority or be a member of the system group.
- AIX Version 4 changed the behavior of importvg so that as part of the importvg process, the volume group is automatically varied on by the system after it is imported. However, if the volume group is Concurrent Capable or was imported with the -c flag, then the importvg command prompts you to varyonvg the imported volume group manually.
- A volume group with a mirrored striped logical volume cannot be back ported into a version older than AIX 4.3.3.
You can use the Volumes application in Web-based System Manager (wsm) to change volume characteristics. You could also use the System Management Interface Tool (SMIT) smit importvg fast path to run this command.
|-c||Imports the volume group and creates it as a Concurrent Capable volume group. Only use the -c flag with the HACMP. It has no effect on volume groups and systems not using the HACMP product. This flag only applies to AIX 4.2 or later.|
|-f||Forces the volume group to be varied online.|
|-LVolumeGroup||Takes a volume group and learns about possible changes performed to that
volume group. Any new logical volumes created as a result of this
command emulate the ownership, group identification, and permissions of the
/dev special file for the volume group listed in the -y
flag. The -L flag performs the functional equivalent of the
-F and -n flags during execution.
|-F||Provides a fast version of importvg that checks the Volume Group Descriptor Areas of only the disks that are members of the same volume group. As a result, if a user exercises this flag, they must ensure that all physical volumes in the volume group are in a good and known state. If this flag is used on a volume group where a disk may be in missing or removed state, the command may fail or the results may be inconsistent.|
|-n||Causes the volume not to be varied at the completion of the volume group
import into the system.
The volume group name can only contain the following characters: A through Z, a through z, 0 through 9, or _ (the underscore), - (the minus sign), or . (the period). All other characters are considered invalid.
|-R||Restores the ownership, group ID, and permissions of the logical volume special device files. These values will be restored only if they were set using U, G and P flags of mklv and chlv commands. This flag is applicable only for big vg format volume groups only.|
|-V MajorNumber||Specifies the major number of the imported volume group.|
|-x||When used with the -c flag, sets the Concurrent Capable volume
group to be autovaried on in concurrent mode. When used without the
-c flag, does nothing. Only use the -c flag with
the HACMP. It has no effect on volume groups and systems not using the
HACMP product. This flag only applies to AIX 4.2 or
In order for this auto-varyon into concurrency of the volume group to take effect, you must enter the following line into the /etc/inittab file:
Attention: This entry must be added after the entry used to initiate srcmstr.
|-y VolumeGroup||Specifies the name to use for the new volume group. If this flag
is not used, the system automatically generates a new name.
The volume group name can only contain the following characters: "A" through "Z," "a" through "z," "0" through "9," or "_" (the underscore), "-" (the minus sign), or "." (the period). All other characters are considered invalid.
The volume group bkvg is made known to the system.
Node A has the volume group datavg varied on. Node B is aware of datavg, but it is not varied on. Node A: varyonvg -b -u datavg Node B: importvg -L datavg hdisk07 Node A: varyonvg datavg
|/usr/sbin||Directory where the importvg command resides.|
|/tmp||Directory where the temporary files are stored while the command is running.|
The exportvg command, varyonvg command.
The Logical Volume Storage Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices explains the Logical Volume Manager, physical volumes, logical volumes, volume groups, organization, ensuring data integrity, and allocation characteristics.
For information on installing the Web-based System Manager, see Chapter 2: Installation and System Requirements in AIX 5L Version 5.1 Web-based System Manager Administration Guide.
The System Management Interface Tool (SMIT): Overview in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices explains the structure, main menus, and tasks that are done with SMIT.