HP-UX Reference (11i v1 00/12) - 1M System Administration Commands N-Z (vol 4)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/naaagt.1m
________________________________________________________________
___ ___
v
vgcreate(1M) vgcreate(1M)
NAME
vgcreate - create LVM volume group
SYNOPSIS
/usr/sbin/vgcreate [-f][-A autobackup][-x extensibility][-e max_pe][-l max_lv]
[-p max_pv][-s pe_size][-g pvg_name] vg_name pv_path ...
DESCRIPTION
The vgcreate command creates a new volume group. vg_name is a symbolic name for the volume group
and must be used in all references to it. vg_name is the path to a directory entry under /dev which must
contain a character special file named group. Except for the group entry, the directory vg_name should
be empty. The vg_name directory and the group file have to be created by the user (see lvm(7)).
vgcreate leaves the volume group in an active state.
Before assigning a physical volume to a volume group, the physical volume has to be created using the
pvcreate command (see pvcreate(1M)).
If vgcreate fails to install the first specified physical volume into the volume group, the volume group is
not created. If, for any reason, one of the remaining specified physical volumes cannot be installed into the
volume group, an error message is printed, but the installationcontinues until the end of the list of physical
volumes.
Options and Arguments
vgcreate recognizes the following options and arguments:
pv_path The block device path name of a physical volume that will be assigned to the new
volume group. You can specify physical volume links (pv-links) for a physical
volume providing different paths that reference the same physical volume in the
pv_path list. The order in which the paths are listed is important. The first
path becomes the primary link to the physical volume, the second becomes
an alternate link to the physical volume. The primary link is the
default path used to access the physical volume. If the primary link
becomes unavailable, LVM automatically switches to the
alternate link to
access the physical volume. Currently LVM supports a maximum of 8 paths to a
physical volume (7 alternate and one primary).
vg_name The path name of a subdirectory of the
/dev directory. vg_name must be
empty except for a character special file named group. Typically, this directory
name is in the form /dev/vgNN, where NN numbers sequentially from 00.
-A autobackup Set automatic backup for this invocation of this command. autobackup can have
one of the following values:
y Automatically back up configuration changes made to the volume
group. This is the default.
After this command executes, the vgcfgbackup command (see
vgcfgbackup(1M)) is executed for the volume group.
n Do not back up configuration changes this time.
-e max_pe Set the maximum number of physical extents that can be allocated from any of
the physical volumes in the volume group. The default value for max_pe is
1016. However, if the size of any physical volume exceeds 1016 times the
pe_size, the default value for max_pe is adjusted to match the physical volume
size. The maximum number of physical extents can be a value in the range 1 to
65535.
-f This option will force a volume group to be created with a physical volume which
has alternate block(s) already allocated, (i.e. this physical volume was not initial-
ized using pvcreate -f.) This option should be used with extreme caution.
If the volume group to be created has a different physical extent size, the alter-
nate block(s) might be inside the user data area. Potential data corruption could
occur.
-g pvg_name Create a new physical volume group with the name pvg_name. All physical
volumes specified in the pv_path parameter become a member of the newly
HP-UX Release 11i: December 2000 − 1 − Section 1M−−1015
___
___