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           [    --profile String ]
36           [    --version ]
37

OPTIONS

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

VARIABLES

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

ENVIRONMENT VARIABLES

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

EXAMPLES

129       Merge an inactive VG named "vg00" into the active or inactive VG  named
130       "databases", giving verbose runtime information.
131       vgmerge -v databases vg00
132