HP-UX Reference (11i v2 07/12) - 1M System Administration Commands N-Z (vol 4)

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 that must
contain a character special file named
group
. Except for the group entry, the vg_name directory 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 installation continues 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. On PA-RISC systems, pv_path should be the path name for the
whole disk. For Itanium(R)-based system boot physical volumes, pv_path should
be the path name for the disk section containing the HP-UX partition. For
Itanium-based system non-boot physical volumes, pv_path can be the path name
for the whole disk or the disk section containing the HP-UX partition. 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, and 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 alter-
nate 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
614 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: December 2007 Update