mirror of
git://sourceware.org/git/lvm2.git
synced 2024-12-22 17:35:59 +03:00
138 lines
5.0 KiB
Groff
138 lines
5.0 KiB
Groff
.TH PVCREATE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
|
|
.SH NAME
|
|
pvcreate \- initialize a disk or partition for use by LVM
|
|
.SH SYNOPSIS
|
|
.B pvcreate
|
|
.RB [ \-d | \-\-debug ]
|
|
.RB [ \-f [ f ]| \-\-force " [" \-\-force ]]
|
|
.RB [ \-y | \-\-yes ]
|
|
.RB [ \-h | \-\-help ]
|
|
.RB [ \-t | \-\-test ]
|
|
.RB [ \-v | \-\-verbose ]
|
|
.RB [ \-\-labelsector ]
|
|
.RB [ \-M | \-\-metadatatype type ]
|
|
.RB [ \-\-metadatacopies #copies ]
|
|
.RB [ \-\-metadatasize size ]
|
|
.RB [ \-\-restorefile file ]
|
|
.RB [ \-\-setphysicalvolumesize size ]
|
|
.RB [ \-u | \-\-uuid uuid ]
|
|
.RB [ \-\-version ]
|
|
.RB [ \-Z | \-\-zero y|n ]
|
|
.IR PhysicalVolume " [" PhysicalVolume ...]
|
|
.SH DESCRIPTION
|
|
.B pvcreate
|
|
initializes
|
|
.I PhysicalVolume
|
|
for later use by the Logical Volume Manager (LVM). Each
|
|
.I PhysicalVolume
|
|
can be a disk partition, whole disk, meta device, or loopback file.
|
|
For DOS disk partitions, the partition id should be set to 0x8e using
|
|
.BR fdisk "(8), " cfdisk "(8), "
|
|
or a equivalent. For
|
|
.B whole disk devices only
|
|
the partition table must be erased, which will effectively destroy all
|
|
data on that disk. This can be done by zeroing the first sector with:
|
|
.sp
|
|
.BI "dd if=/dev/zero of=" PhysicalVolume " bs=512 count=1"
|
|
.sp
|
|
Continue with
|
|
.BR vgcreate (8)
|
|
to create a new volume group on
|
|
.IR PhysicalVolume ,
|
|
or
|
|
.BR vgextend (8)
|
|
to add
|
|
.I PhysicalVolume
|
|
to an existing volume group.
|
|
.SH OPTIONS
|
|
See \fBlvm\fP(8) for common options.
|
|
.TP
|
|
.BR \-f ", " \-\-force
|
|
Force the creation without any confirmation. You can not recreate
|
|
(reinitialize) a physical volume belonging to an existing volume group.
|
|
In an emergency you can override this behaviour with -ff.
|
|
.TP
|
|
.BR \-u ", " \-\-uuid " uuid"
|
|
Specify the uuid for the device.
|
|
Without this option, \fBpvcreate\fP generates a random uuid.
|
|
All of your physical volumes must have unique uuids.
|
|
You need to use this option before restoring a backup of LVM metadata
|
|
onto a replacement device - see \fBvgcfgrestore\fP(8).
|
|
.TP
|
|
.BR \-y ", " \-\-yes
|
|
Answer yes to all questions.
|
|
.TP
|
|
.BR \-Z ", " \-\-zero " y|n"
|
|
Whether or not the first 4 sectors (2048 bytes) of the device should be
|
|
wiped.
|
|
If this option is not given, the
|
|
default is to wipe these sectors unless either or both of the --restorefile
|
|
or --uuid options were specified.
|
|
.SH NEW METADATA OPTIONS
|
|
LVM2 introduces a new format for storing metadata on disk.
|
|
This new format is more efficient and resilient than the format the
|
|
original version of LVM used and offers the advanced user greater
|
|
flexibility and control.
|
|
.sp
|
|
The new format may be selected on the command line with \fB-M2\fP or by
|
|
setting \fBformat = "lvm2"\fP in the \fBglobal\fP section of \fBlvm.conf\fP.
|
|
Each physical volume in the same volume group must use the same format, but
|
|
different volume groups on a machine may use different formats
|
|
simultaneously: the tools can handle both formats.
|
|
Additional formats can be added as shared libraries.
|
|
.sp
|
|
Additional tools for manipulating the locations and sizes of metadata areas
|
|
will be written in due course. Use the verbose/debug options on the tools
|
|
to see where the metadata areas are placed.
|
|
.TP
|
|
.BR \-\-metadatasize " size"
|
|
The approximate amount of space to be set aside for each metadata area.
|
|
(The size you specify may get rounded.)
|
|
.TP
|
|
.BR \-\-metadatacopies " copies"
|
|
The number of metadata areas to set aside on each PV. Currently
|
|
this can be 0, 1 or 2.
|
|
If set to 2, two copies of the volume group metadata
|
|
are held on the PV, one at the front of the PV and one at the end.
|
|
If set to 1 (the default), one copy is kept at the front of the PV
|
|
(starting in the 5th sector).
|
|
If set to 0, no copies are kept on this PV - you might wish to use this
|
|
with VGs containing large numbers of PVs. But if you do this and
|
|
then later use \fBvgsplit\fP you must ensure that each VG is still going
|
|
to have a suitable number of copies of the metadata after the split!
|
|
.TP
|
|
.BR \-\-restorefile " file"
|
|
In conjunction with \fB--uuid\fP, this extracts the location and size
|
|
of the data on the PV from the file (produced by \fBvgcfgbackup\fP)
|
|
and ensures that the metadata that the program produces is consistent
|
|
with the contents of the file i.e. the physical extents will be in
|
|
the same place and not get overwritten by new metadata. This provides
|
|
a mechanism to upgrade the metadata format or to add/remove metadata
|
|
areas. Use with care. See also \fBvgconvert\fP(8).
|
|
.TP
|
|
.BR \-\-labelsector " sector"
|
|
By default the PV is labelled with an LVM2 identifier in its second
|
|
sector (sector 1). This lets you use a different sector near the
|
|
start of the disk (between 0 and 3 inclusive - see LABEL_SCAN_SECTORS
|
|
in the source). Use with care.
|
|
.TP
|
|
.BR \-\-setphysicalvolumesize " size"
|
|
Overrides the automatically-detected size of the PV. Use with care.
|
|
.SH Example
|
|
Initialize partition #4 on the third SCSI disk and the entire fifth
|
|
SCSI disk for later use by LVM:
|
|
.sp
|
|
.B pvcreate /dev/sdc4 /dev/sde
|
|
.sp
|
|
.SH SEE ALSO
|
|
.BR lvm (8),
|
|
.BR vgcreate (8),
|
|
.BR vgextend (8),
|
|
.BR lvcreate (8),
|
|
.BR cfdisk (8),
|
|
.BR fdisk (8),
|
|
.BR losetup (8),
|
|
.BR mdadm (8),
|
|
.BR vgcfgrestore (8),
|
|
.BR vgconvert (8)
|