~ubuntu-branches/debian/sid/lvm2/sid

« back to all changes in this revision

Viewing changes to man/vgchange.8.in

  • Committer: Package Import Robot
  • Author(s): Bastian Blank
  • Date: 2014-08-19 15:37:06 UTC
  • mfrom: (1.1.18)
  • Revision ID: package-import@ubuntu.com-20140819153706-i1gaio8lg534dara
Tags: 2.02.109-1
New upstream version.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.TH VGCHANGE 8 "LVM TOOLS #VERSION#" "Sistina Software UK" \" -*- nroff -*-
2
2
.SH NAME
3
 
vgchange \- change attributes of a volume group
 
3
vgchange \(em change attributes of a volume group
4
4
.SH SYNOPSIS
5
5
.B vgchange
6
6
.RB [ \-\-addtag
12
12
.RB [ \-a | \-\-activate
13
13
.RI [ a | e | l ]
14
14
.RI { y | n }]
 
15
.RB [ \-\-activationmode
 
16
.IR { complete | degraded | partial } ]
15
17
.RB [ \-K | \-\-ignoreactivationskip ]
16
18
.RB [ \-\-monitor
17
19
.RI { y | n }]
20
22
.RB [ \-c | \-\-clustered
21
23
.RI { y | n }]
22
24
.RB [ \-u | \-\-uuid ]
 
25
.RB [ \-\-commandprofile
 
26
.IR ProfileName ]
23
27
.RB [ \-d | \-\-debug ]
24
28
.RB [ \-\-deltag
25
29
.IR Tag ]
26
 
.RB [ \-\-profile
27
 
.IR ProfileName ]
28
30
.RB [ \-\-detachprofile ]
29
31
.RB [ \-h | \-\-help ]
30
32
.RB [ \-\-ignorelockingfailure ]
34
36
.RB [ \-\-noudevsync ]
35
37
.RB [ \-l | \-\-logicalvolume
36
38
.IR MaxLogicalVolumes ]
37
 
.RB [ -p | \-\-maxphysicalvolumes
 
39
.RB [ \-p | \-\-maxphysicalvolumes
38
40
.IR MaxPhysicalVolumes ]
 
41
.RB [ \-\-metadataprofile
 
42
.IR ProfileName ]
39
43
.RB [ \-\- [ vg ] metadatacopies ]
40
44
.IR NumberOfCopies | unmanaged | all ]
41
45
.RB [ \-P | \-\-partial ]
42
46
.RB [ \-s | \-\-physicalextentsize
43
47
.IR PhysicalExtentSize [ bBsSkKmMgGtTpPeE ]]
44
48
.RB [ \-\-refresh ]
45
 
.RB [ -t | \-\-test ]
 
49
.RB [ \-t | \-\-test ]
46
50
.RB [ \-v | \-\-verbose ]
47
51
.RB [ \-\-version ]
48
52
.RB [ \-x | \-\-resizeable
81
85
possible to select which volumes to activate using the
82
86
activation/auto_activation_volume_list settting.
83
87
.IP
 
88
Activation of a logical volume creates a symbolic link 
 
89
/dev/VolumeGroupName/LogicalVolumeName pointing to the device node.
 
90
This link is removed on deactivation.
 
91
All software and scripts should access the device through
 
92
this symbolic link and present this as the name of the device.
 
93
The location and name of the underlying device node may depend on   
 
94
the distribution and configuration (e.g. udev) and might change 
 
95
from release to release.
 
96
.IP
84
97
If clustered locking is enabled, add 'e' to activate/deactivate
85
98
exclusively on one node or 'l' to activate/deactivate only
86
99
on the local node.
87
100
Logical volumes with single-host snapshots are always activated
88
101
exclusively because they can only be used on one node at once.
89
102
.TP
 
103
.BR \-\-activationmode " {" \fIcomplete | \fIdegraded | \fIpartial }
 
104
The activation mode determines whether logical volumes are allowed to
 
105
activate when there are physical volumes missing (e.g. due to a device
 
106
failure).  \fIcomplete is the most restrictive; allowing only those
 
107
logical volumes to be activated that are not affected by the missing
 
108
PVs.  \fIdegraded allows RAID logical volumes to be activated even if
 
109
they have PVs missing.  (Note that the "mirror" segment type is not
 
110
considered a RAID logical volume.  The "raid1" segment type should
 
111
be used instead.)  Finally, \fIpartial allows any logical volume to
 
112
be activated even if portions are missing due to a missing or failed
 
113
PV.  This last option should only be used when performing recovery or
 
114
repair operations.  \fIdegraded is the default mode.  To change it, modify
 
115
.B activation_mode
 
116
in
 
117
.BR lvm.conf (5).
 
118
.TP
90
119
.BR \-K ", " \-\-ignoreactivationskip
91
120
Ignore the flag to skip Logical Volumes during activation.
92
121
.TP
99
128
are not marked as clustered.
100
129
.TP
101
130
.BR \-\-detachprofile
102
 
Detach any configuration profiles attached to given Volume Groups.
103
 
See also \fBlvm\fP(8) and \fBlvm.conf\fP(5) for more
104
 
information about configuration profiles.
 
131
Detach any metadata configuration profiles attached to given
 
132
Volume Groups. See \fBlvm.conf\fP(5) for more information
 
133
about \fBmetadata profiles\fP.
105
134
.TP
106
135
.BR \-u ", " \-\-uuid
107
136
Generate new random UUID for specified Volume Groups.
166
195
If the metadata uses lvm2 format, the value 0 removes this restriction:
167
196
there is then no limit.  If you have a large number of physical volumes in
168
197
a volume group with metadata in lvm2 format, for tool performance reasons,
169
 
you should consider some use of \fB--pvmetadatacopies 0\fP as described in
170
 
\fBpvcreate(8)\fP, and/or use \fB--vgmetadatacopies\fP.
 
198
you should consider some use of \fB\-\-pvmetadatacopies 0\fP as described in
 
199
\fBpvcreate(8)\fP, and/or use \fB\-\-vgmetadatacopies\fP.
 
200
.TP
 
201
.BR \-\-metadataprofile " " \fIProfileName
 
202
Uses and attaches ProfileName configuration profile to the volume group
 
203
metadata. Whenever the volume group is processed next time, the profile
 
204
is automatically applied. The profile is inherited by all logical volumes
 
205
in the volume group unless the logical volume itself has its own profile
 
206
attached. See \fBlvm.conf\fP(5) for more information about \fBmetadata profiles\fP.
171
207
.TP
172
208
.BR \-\- [ vg ] metadatacopies " " \fINumberOfCopies | \fIunmanaged | \fIall
173
209
Sets the desired number of metadata copies in the volume group.  If set to
174
210
a non-zero value, LVM will automatically manage the 'metadataignore'
175
 
flags on the physical volumes (see \fBpvchange\fP or \fBpvcreate --metadataignore\fP) in order
 
211
flags on the physical volumes (see \fBpvchange\fP or \fBpvcreate \-\-metadataignore\fP) in order
176
212
to achieve \fINumberOfCopies\fP copies of metadata.  If set to \fIunmanaged\fP,
177
213
LVM will not automatically manage the 'metadataignore' flags.  If set to
178
214
\fIall\fP, LVM will first clear all of the 'metadataignore' flags on all
216
252
.SH Examples
217
253
To activate all known volume groups in the system:
218
254
.sp
219
 
.B vgchange -a y
 
255
.B vgchange \-a y
220
256
 
221
257
To change the maximum number of logical volumes of inactive volume group
222
258
vg00 to 128.
223
259
.sp
224
 
.B vgchange -l 128 /dev/vg00
 
260
.B vgchange \-l 128 /dev/vg00
225
261
 
226
262
 
227
263
.SH SEE ALSO