vgreduce(8)

1VGREDUCE(8)                 System Manager's Manual                VGREDUCE(8)
2
3
4

NAME

6       vgreduce - Remove physical volume(s) from a volume group
7

SYNOPSIS

9       vgreduce option_args position_args
10           [ option_args ]
11
12        -a|--all
13        -A|--autobackup y|n
14           --commandprofile String
15           --config String
16        -d|--debug
17           --driverloaded y|n
18        -f|--force
19        -h|--help
20           --lockopt String
21           --longhelp
22           --mirrorsonly
23           --profile String
24        -q|--quiet
25           --removemissing
26           --reportformat basic|json
27        -t|--test
28        -v|--verbose
29           --version
30        -y|--yes
31

DESCRIPTION

33       vgreduce removes one or more unused PVs from a VG.
34

USAGE

36       Remove a PV from a VG.
37
38       vgreduce VG PV ...
39           [ COMMON_OPTIONS ]
40       -
41
42       Remove all unused PVs from a VG.
43
44       vgreduce -a|--all VG
45           [ COMMON_OPTIONS ]
46       -
47
48       Remove all missing PVs from a VG.
49
50       vgreduce --removemissing VG
51           [    --mirrorsonly ]
52           [ COMMON_OPTIONS ]
53       -
54
55       Common options for command:
56           [ -A|--autobackup y|n ]
57           [ -f|--force ]
58           [    --reportformat basic|json ]
59
60       Common options for lvm:
61           [ -d|--debug ]
62           [ -h|--help ]
63           [ -q|--quiet ]
64           [ -t|--test ]
65           [ -v|--verbose ]
66           [ -y|--yes ]
67           [    --commandprofile String ]
68           [    --config String ]
69           [    --driverloaded y|n ]
70           [    --lockopt String ]
71           [    --longhelp ]
72           [    --profile String ]
73           [    --version ]
74

OPTIONS

76       -a|--all
77              Removes all empty PVs if none are named on the command line.
78
79       -A|--autobackup y|n
80              Specifies if metadata should be backed up automatically after a
81              change.  Enabling this is strongly advised! See vgcfgbackup(8)
82              for more information.
83
84       --commandprofile String
85              The command profile to use for command configuration.  See
86              lvm.conf(5) for more information about profiles.
87
88       --config String
89              Config settings for the command. These override lvm.conf set‐
90              tings.  The String arg uses the same format as lvm.conf, or may
91              use section/field syntax.  See lvm.conf(5) for more information
92              about config.
93
94       -d|--debug ...
95              Set debug level. Repeat from 1 to 6 times to increase the detail
96              of messages sent to the log file and/or syslog (if configured).
97
98       --driverloaded y|n
99              If set to no, the command will not attempt to use device-mapper.
100              For testing and debugging.
101
102       -f|--force ...
103              Override various checks, confirmations and protections.  Use
104              with extreme caution.
105
106       -h|--help
107              Display help text.
108
109       --lockopt String
110              Used to pass options for special cases to lvmlockd.  See lvm‐
111              lockd(8) for more information.
112
113       --longhelp
114              Display long help text.
115
116       --mirrorsonly
117              Only remove missing PVs from mirror LVs.
118
119       --profile String
120              An alias for --commandprofile or --metadataprofile, depending on
121              the command.
122
123       -q|--quiet ...
124              Suppress output and log messages. Overrides --debug and --ver‐
125              bose.  Repeat once to also suppress any prompts with answer
126              'no'.
127
128       --removemissing
129              Removes all missing PVs from the VG, if there are no LVs allo‐
130              cated on them. This resumes normal operation of the VG (new LVs
131              may again be created, changed and so on).  If this is not possi‐
132              ble because LVs are referencing the missing PVs, this option can
133              be combined with --force to have the command remove any partial
134              LVs. In this case, any LVs and dependent snapshots that were
135              partly on the missing disks are removed completely, including
136              those parts on disks that are still present.  If LVs spanned
137              several disks, including ones that are lost, salvaging some data
138              first may be possible by activating LVs in partial mode.
139
140       --reportformat basic|json
141              Overrides current output format for reports which is defined
142              globally by the report/output_format setting in lvm.conf.  basic
143              is the original format with columns and rows.  If there is more
144              than one report per command, each report is prefixed with the
145              report name for identification. json produces report output in
146              JSON format. See lvmreport(7) for more information.
147
148       -t|--test
149              Run in test mode. Commands will not update metadata.  This is
150              implemented by disabling all metadata writing but nevertheless
151              returning success to the calling function. This may lead to
152              unusual error messages in multi-stage operations if a tool
153              relies on reading back metadata it believes has changed but
154              hasn't.
155
156       -v|--verbose ...
157              Set verbose level. Repeat from 1 to 4 times to increase the
158              detail of messages sent to stdout and stderr.
159
160       --version
161              Display version information.
162
163       -y|--yes
164              Do not prompt for confirmation interactively but always assume
165              the answer yes. Use with extreme caution.  (For automatic no,
166              see -qq.)
167

VARIABLES

169       VG
170              Volume Group name.  See lvm(8) for valid names.
171
172       PV
173              Physical Volume name, a device path under  /dev.   For  commands
174              managing physical extents, a PV positional arg generally accepts
175              a suffix indicating a range (or  multiple  ranges)  of  physical
176              extents  (PEs). When the first PE is omitted, it defaults to the
177              start of the device, and when the last PE is omitted it defaults
178              to  end.   Start and end range (inclusive): PV[:PE-PE]...  Start
179              and length range (counting from 0): PV[:PE+PE]...
180
181       String
182              See the option description for information about the string con‐
183              tent.
184
185       Size[UNIT]
186              Size  is  an  input number that accepts an optional unit.  Input
187              units are always treated as base two values, regardless of capi‐
188              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
189              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
190              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
191              bytes, s|S is sectors of 512 bytes, k|K  is  kilobytes,  m|M  is
192              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
193              e|E is exabytes.  (This should not be confused with  the  output
194              control --units, where capital letters mean multiple of 1000.)
195

ENVIRONMENT VARIABLES

197       See  lvm(8)  for  information  about environment variables used by lvm.
198       For example, LVM_VG_NAME can generally be substituted for a required VG
199       parameter.
200