vgcreate.1m (2010 09)

v
vgcreate(1M) vgcreate(1M)
NAME
vgcreate - create LVM volume group
SYNOPSIS
/usr/sbin/vgcreate
[-V 1.0][-f][
-A autobackup ][-x extensibility][
-e max_pe]
[
-l max_lv ][-p max_pv][
-s pe_size ][-g pvg_name] vg_name pv_path ...
/usr/sbin/vgcreate -V 2.
n -s pe_size -S vg_size [
-A autobackup ][-x extensibility]
[
-g pvg_name ] vg_name pv_path ...
/usr/sbin/vgcreate -V 2.2 -s
pe_size -S vg_size [
-A autobackup ][-x extensibility]
[
-g pvg_name ][-U unshare_unit ] vg_name pv_path ...
/usr/sbin/vgcreate -V 2.
n -E {-s pe_size |
-S vg_size}
DESCRIPTION
The
vgcreate command without the -E option creates a new volume group, as shown by the first three
forms in SYNOPSIS above.
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. A user may explicitly create the
vg_name directory and the
group file before creating the volume group. If absent, the vgcreate com-
mand will automatically create the directory and the
group file, assigning the minor number. If the
group file is automatically created, any available minor number may be assigned to the
group file.
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.
The
vgcreate command with the -E option displays information which may be useful in deciding on
parameters for use in creating a volume group version 2.0 and higher.
The
-E option (only for volume groups versions 2.0 and higher) displays the relationship between physi-
cal extent size (pe_size ) and maximum volume group size (vg_size ). See lvm(7) for more on this topic. A
pe_size or a vg_size must be supplied on the command line. If pe_size is specified, then the maximum
volume group size which can be created using that extent size is displayed using the suffix notation
explained in the description of the
-S option. If the vg_size is specified then the minimum extent size
required to support the given maximum volume group size is displayed in megabytes.
Options and Arguments
vgcreate recognizes the following options and arguments:
-V vg_version Specify the version of the volume group. Currently only 1.0, 2.0, 2.1, and
2.2 are supported.
Different versions represent significant changes in LVM software and data lay-
out and may have compatibility implications when volume groups are shared
or moved from system to system. See lvm(7) for more details.
The default version is 1.0.
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 HP Integrity system boot physical volumes, pv_path should be the path
name for the disk section containing the HP-UX partition (see model(1) and
getconf (1)). For HP Integrity 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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1