vgimport(8)

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

NAME

6       vgimport - Register exported volume group with system
7

SYNOPSIS

9       vgimport option_args position_args
10           [ option_args ]
11

DESCRIPTION

13       vgimport  makes  exported  VGs known to the system again, perhaps after
14       moving the PVs from a different system.
15
16       vgexport clears the VG system ID, and vgimport sets the VG system ID to
17       match the host running vgimport (if the host has a system ID).
18

USAGE

20       Import specified VGs.
21
22       vgimport VG|Tag|Select ...
23           [ -S|--select String ]
24           [ COMMON_OPTIONS ]
25
26       Import all VGs.
27
28       vgimport -a|--all
29           [ COMMON_OPTIONS ]
30
31       Common options for command:
32           [ -f|--force ]
33           [    --reportformat basic|json ]
34
35       Common options for lvm:
36           [ -d|--debug ]
37           [ -h|--help ]
38           [ -q|--quiet ]
39           [ -t|--test ]
40           [ -v|--verbose ]
41           [ -y|--yes ]
42           [    --commandprofile String ]
43           [    --config String ]
44           [    --driverloaded y|n ]
45           [    --lockopt String ]
46           [    --longhelp ]
47           [    --profile String ]
48           [    --version ]
49

OPTIONS

51       -a|--all
52              Import all visible VGs.
53
54       --commandprofile String
55              The command profile to use for command configuration.  See
56              lvm.conf(5) for more information about profiles.
57
58       --config String
59              Config settings for the command. These override lvm.conf set‐
60              tings.  The String arg uses the same format as lvm.conf, or may
61              use section/field syntax.  See lvm.conf(5) for more information
62              about config.
63
64       -d|--debug ...
65              Set debug level. Repeat from 1 to 6 times to increase the detail
66              of messages sent to the log file and/or syslog (if configured).
67
68       --driverloaded y|n
69              If set to no, the command will not attempt to use device-mapper.
70              For testing and debugging.
71
72       -f|--force ...
73              Override various checks, confirmations and protections.  Use
74              with extreme caution.
75
76       -h|--help
77              Display help text.
78
79       --lockopt String
80              Used to pass options for special cases to lvmlockd.  See lvm‐
81              lockd(8) for more information.
82
83       --longhelp
84              Display long help text.
85
86       --profile String
87              An alias for --commandprofile or --metadataprofile, depending on
88              the command.
89
90       -q|--quiet ...
91              Suppress output and log messages. Overrides --debug and --ver‐
92              bose.  Repeat once to also suppress any prompts with answer
93              'no'.
94
95       --reportformat basic|json
96              Overrides current output format for reports which is defined
97              globally by the report/output_format setting in lvm.conf.  basic
98              is the original format with columns and rows.  If there is more
99              than one report per command, each report is prefixed with the
100              report name for identification. json produces report output in
101              JSON format. See lvmreport(7) for more information.
102
103       -S|--select String
104              Select objects for processing and reporting based on specified
105              criteria.  The criteria syntax is described by --select help and
106              lvmreport(7).  For reporting commands, one row is displayed for
107              each object matching the criteria.  See --options help for
108              selectable object fields.  Rows can be displayed with an addi‐
109              tional "selected" field (-o selected) showing 1 if the row
110              matches the selection and 0 otherwise.  For non-reporting com‐
111              mands which process LVM entities, the selection is used to
112              choose items to process.
113
114       -t|--test
115              Run in test mode. Commands will not update metadata.  This is
116              implemented by disabling all metadata writing but nevertheless
117              returning success to the calling function. This may lead to
118              unusual error messages in multi-stage operations if a tool
119              relies on reading back metadata it believes has changed but
120              hasn't.
121
122       -v|--verbose ...
123              Set verbose level. Repeat from 1 to 4 times to increase the
124              detail of messages sent to stdout and stderr.
125
126       --version
127              Display version information.
128
129       -y|--yes
130              Do not prompt for confirmation interactively but always assume
131              the answer yes. Use with extreme caution.  (For automatic no,
132              see -qq.)
133

VARIABLES

135       VG
136              Volume Group name.  See lvm(8) for valid names.
137
138       Tag
139              Tag  name.  See lvm(8) for information about tag names and using
140              tags in place of a VG, LV or PV.
141
142       Select
143              Select indicates that a required  positional  parameter  can  be
144              omitted  if the --select option is used.  No arg appears in this
145              position.
146
147       String
148              See the option description for information about the string con‐
149              tent.
150
151       Size[UNIT]
152              Size  is  an  input number that accepts an optional unit.  Input
153              units are always treated as base two values, regardless of capi‐
154              talization,  e.g.  'k'  and 'K' both refer to 1024.  The default
155              input unit is specified by letter, followed by |UNIT.  UNIT rep‐
156              resents  other  possible  input units: bBsSkKmMgGtTpPeE.  b|B is
157              bytes, s|S is sectors of 512 bytes, k|K  is  kilobytes,  m|M  is
158              megabytes, g|G is gigabytes, t|T is terabytes, p|P is petabytes,
159              e|E is exabytes.  (This should not be confused with  the  output
160              control --units, where capital letters mean multiple of 1000.)
161

ENVIRONMENT VARIABLES

163       See  lvm(8)  for  information  about environment variables used by lvm.
164       For example, LVM_VG_NAME can generally be substituted for a required VG
165       parameter.
166