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
92              unusual error messages in multi-stage operations if a tool
93              relies on reading back metadata it believes has changed but
94              hasn't.
95
96       -v|--verbose ...
97              Set verbose level. Repeat from 1 to 4 times to increase the
98              detail of messages sent to stdout and stderr.
99
100       --version
101              Display version information.
102
103       -y|--yes
104              Do not prompt for confirmation interactively but always assume
105              the answer yes. Use with extreme caution.  (For automatic no,
106              see -qq.)
107

VARIABLES

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

ENVIRONMENT VARIABLES

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

EXAMPLES

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