1VGMERGE(8) System Manager's Manual VGMERGE(8)
2
6 vgmerge — Merge volume groups
7
9 vgmerge position_args
10 [ option_args ]
11
13 vgmerge merges two existing VGs. The inactive source VG is merged into
14 the destination VG if physical extent sizes are equal and PV and LV
15 summaries of both VGs fit into the destination VG's limits.
16
18 vgmerge VG VG
19 [ -A|--autobackup y|n ]
20 [ -l|--list ]
21 [ --poolmetadataspare y|n ]
22 [ COMMON_OPTIONS ]
23 Common options for lvm:
25 [ -d|--debug ]
26 [ -h|--help ]
27 [ -q|--quiet ]
28 [ -t|--test ]
29 [ -v|--verbose ]
30 [ -y|--yes ]
31 [ --commandprofile String ]
32 [ --config String ]
33 [ --devices PV ]
34 [ --devicesfile String ]
35 [ --driverloaded y|n ]
36 [ --journal String ]
37 [ --lockopt String ]
38 [ --longhelp ]
39 [ --nohints ]
40 [ --nolocking ]
41 [ --profile String ]
42 [ --version ]
43
45 -A|--autobackup y|n
46 Specifies if metadata should be backed up automatically after a
47 change. Enabling this is strongly advised! See vgcfgbackup(8)
48 for more information.
49 --commandprofile String
51 The command profile to use for command configuration. See
52 lvm.conf(5) for more information about profiles.
53 --config String
55 Config settings for the command. These override lvm.conf(5) set‐
56 tings. The String arg uses the same format as lvm.conf(5), or
57 may use section/field syntax. See lvm.conf(5) for more informa‐
58 tion about config.
59 -d|--debug ...
61 Set debug level. Repeat from 1 to 6 times to increase the detail
62 of messages sent to the log file and/or syslog (if configured).
63 --devices PV
65 Restricts the devices that are visible and accessible to the
66 command. Devices not listed will appear to be missing. This op‐
67 tion can be repeated, or accepts a comma separated list of de‐
68 vices. This overrides the devices file.
69 --devicesfile String
71 A file listing devices that LVM should use. The file must exist
72 in /etc/lvm/devices/ and is managed with the lvmdevices(8) com‐
73 mand. This overrides the lvm.conf(5) devices/devicesfile and
74 devices/use_devicesfile settings.
75 --driverloaded y|n
77 If set to no, the command will not attempt to use device-mapper.
78 For testing and debugging.
79 -h|--help
81 Display help text.
82 --journal String
84 Record information in the systemd journal. This information is
85 in addition to information enabled by the lvm.conf log/journal
86 setting. command: record information about the command. out‐
87 put: record the default command output. debug: record full com‐
88 mand debugging.
89 -l|--list
91 Display merged destination VG like vgdisplay -v.
92 --lockopt String
94 Used to pass options for special cases to lvmlockd. See lvm‐
95 lockd(8) for more information.
96 --longhelp
98 Display long help text.
99 --nohints
101 Do not use the hints file to locate devices for PVs. A command
102 may read more devices to find PVs when hints are not used. The
103 command will still perform standard hint file invalidation where
104 appropriate.
105 --nolocking
107 Disable locking. Use with caution, concurrent commands may pro‐
108 duce incorrect results.
109 --poolmetadataspare y|n
111 Enable or disable the automatic creation and management of a
112 spare pool metadata LV in the VG. A spare metadata LV is re‐
113 served space that can be used when repairing a pool.
114 --profile String
116 An alias for --commandprofile or --metadataprofile, depending on
117 the command.
118 -q|--quiet ...
120 Suppress output and log messages. Overrides --debug and --ver‐
121 bose. Repeat once to also suppress any prompts with answer
122 'no'.
123 -t|--test
125 Run in test mode. Commands will not update metadata. This is
126 implemented by disabling all metadata writing but nevertheless
127 returning success to the calling function. This may lead to un‐
128 usual error messages in multi-stage operations if a tool relies
129 on reading back metadata it believes has changed but hasn't.
130 -v|--verbose ...
132 Set verbose level. Repeat from 1 to 4 times to increase the de‐
133 tail of messages sent to stdout and stderr.
134 --version
136 Display version information.
137 -y|--yes
139 Do not prompt for confirmation interactively but always assume
140 the answer yes. Use with extreme caution. (For automatic no,
141 see -qq.)
142
144 VG Volume Group name. See lvm(8) for valid names.
145 String See the option description for information about the string con‐
147 tent.
148 Size[UNIT]
150 Size is an input number that accepts an optional unit. Input
151 units are always treated as base two values, regardless of capi‐
152 talization, e.g. 'k' and 'K' both refer to 1024. The default
153 input unit is specified by letter, followed by |UNIT. UNIT rep‐
154 resents other possible input units: b|B is bytes, s|S is sectors
155 of 512 bytes, k|K is KiB, m|M is MiB, g|G is GiB, t|T is TiB,
156 p|P is PiB, e|E is EiB. (This should not be confused with the
157 output control --units, where capital letters mean multiple of
158 1000.)
159
161 See lvm(8) for information about environment variables used by lvm.
162 For example, LVM_VG_NAME can generally be substituted for a required VG
163 parameter.
164
166 Merge an inactive VG named "vg00" into the active or inactive VG named
167 "databases", giving verbose runtime information.
168 vgmerge -v databases vg00
169
171 lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),
172 pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8),
174 pvremove(8), pvresize(8), pvs(8), pvscan(8),
175 vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8),
177 vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8),
178 vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8),
179 vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),
180 lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8),
182 lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),
183 lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),
185 dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8),
187 lvmdbusd(8), fsadm(8),
188 lvmsystemid(7), lvmreport(7), lvmraid(7), lvmthin(7), lvmcache(7)
190Red Hat, Inc. LVM TOOLS 2.03.18(2)-git (2022-11-10) VGMERGE(8)