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           --nolocking
24           --profile String
25        -q|--quiet
26           --removemissing
27           --reportformat basic|json
28        -t|--test
29        -v|--verbose
30           --version
31        -y|--yes
32

DESCRIPTION

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

USAGE

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

OPTIONS

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

VARIABLES

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

ENVIRONMENT VARIABLES

201       See lvm(8) for information about environment  variables  used  by  lvm.
202       For example, LVM_VG_NAME can generally be substituted for a required VG
203       parameter.
204