vgmerge(8)

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

NAME

6       vgmerge - Merge volume groups
7

SYNOPSIS

9       vgmerge position_args
10           [ option_args ]
11

DESCRIPTION

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

USAGE

18       vgmerge VG VG
19           [ -A|--autobackup y|n ]
20           [ -l|--list ]
21           [ COMMON_OPTIONS ]
22
23       Common options for lvm:
24           [ -d|--debug ]
25           [ -h|--help ]
26           [ -q|--quiet ]
27           [ -t|--test ]
28           [ -v|--verbose ]
29           [ -y|--yes ]
30           [    --commandprofile String ]
31           [    --config String ]
32           [    --driverloaded y|n ]
33           [    --lockopt String ]
34           [    --longhelp ]
35           [    --nolocking ]
36           [    --profile String ]
37           [    --version ]
38

OPTIONS

40       -A|--autobackup y|n
41              Specifies if metadata should be backed up automatically after a
42              change.  Enabling this is strongly advised! See vgcfgbackup(8)
43              for more information.
44
45       --commandprofile String
46              The command profile to use for command configuration.  See
47              lvm.conf(5) for more information about profiles.
48
49       --config String
50              Config settings for the command. These override lvm.conf set‐
51              tings.  The String arg uses the same format as lvm.conf, or may
52              use section/field syntax.  See lvm.conf(5) for more information
53              about config.
54
55       -d|--debug ...
56              Set debug level. Repeat from 1 to 6 times to increase the detail
57              of messages sent to the log file and/or syslog (if configured).
58
59       --driverloaded y|n
60              If set to no, the command will not attempt to use device-mapper.
61              For testing and debugging.
62
63       -h|--help
64              Display help text.
65
66       -l|--list
67              Display merged destination VG like vgdisplay -v.
68
69       --lockopt String
70              Used to pass options for special cases to lvmlockd.  See lvm‐
71              lockd(8) for more information.
72
73       --longhelp
74              Display long help text.
75
76       --nolocking
77              Disable locking.
78
79       --profile String
80              An alias for --commandprofile or --metadataprofile, depending on
81              the command.
82
83       -q|--quiet ...
84              Suppress output and log messages. Overrides --debug and --ver‐
85              bose.  Repeat once to also suppress any prompts with answer
86              'no'.
87
88       -t|--test
89              Run in test mode. Commands will not update metadata.  This is
90              implemented by disabling all metadata writing but nevertheless
91              returning success to the calling function. This may lead to un‐
92              usual error messages in multi-stage operations if a tool relies
93              on reading back metadata it believes has changed but hasn't.
94
95       -v|--verbose ...
96              Set verbose level. Repeat from 1 to 4 times to increase the de‐
97              tail of messages sent to stdout and stderr.
98
99       --version
100              Display version information.
101
102       -y|--yes
103              Do not prompt for confirmation interactively but always assume
104              the answer yes. Use with extreme caution.  (For automatic no,
105              see -qq.)
106

VARIABLES

108       VG
109              Volume Group name.  See lvm(8) for valid names.
110
111       String
112              See the option description for information about the string con‐
113              tent.
114
115       Size[UNIT]
116              Size  is  an  input number that accepts an optional unit.  Input
117              units are always treated as base two values, regardless of capi‐
118              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
119              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
120              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
121              bytes, s|S is sectors of 512 bytes, k|K is KiB, m|M is MiB,  g|G
122              is GiB, t|T is TiB, p|P is PiB, e|E is EiB.  (This should not be
123              confused with the output control --units, where capital  letters
124              mean multiple of 1000.)
125

ENVIRONMENT VARIABLES

127       See  lvm(8)  for  information  about environment variables used by lvm.
128       For example, LVM_VG_NAME can generally be substituted for a required VG
129       parameter.
130

EXAMPLES

132       Merge  an inactive VG named "vg00" into the active or inactive VG named
133       "databases", giving verbose runtime information.
134       vgmerge -v databases vg00
135