metaimport(1m)

1metaimport(1M)          System Administration Commands          metaimport(1M)
2
3
4

NAME

6       metaimport  -  imports  disk  sets into existing Solaris Volume Manager
7       configurations
8

SYNOPSIS

10       metaimport -s setname [-n] [-f] [-v] [disks]...
11
12
13       metaimport -r [-v] [disks]...
14
15
16       metaimport -V
17
18
19       metaimport -?
20
21

DESCRIPTION

23       The metaimport command allows the importing  of  disk  sets,  including
24       replicated  disk sets, into an existing Solaris Volume Manager configu‐
25       ration. Replicated disk sets are disk sets created using remote  repli‐
26       cation software.
27
28
29       The  default  Solaris  Volume Manager configuration specifies a maximum
30       number of disk sets that can  be  configured.  The  metaimport  command
31       fails if importing the disk set would result in exceeding the number of
32       disk sets configured on the system. To increase the number of disk sets
33       allowed on a system, see the .
34
35
36       Use  metaset(1M)  or  metastat(1M)  to  view  the  configuration of the
37       imported set.
38
39
40       You must run metaimport as root.
41
42
43       metaimport requires a functional Solaris Volume  Manager  configuration
44       before it runs.
45

OPTIONS

47       The following options are supported:
48
49       -f            Force  the  import, even if a quorum of replicas from the
50                     imported disk set is not  available.  This  option  could
51                     result  in corrupt configurations and should only be used
52                     when  metaimport  fails  with  the  "Insufficient  quorum
53                     detected;  exiting"  error. If only a partial disk set is
54                     available, this option might be necessary to successfully
55                     import.  Some  or all data could be corrupted or unavail‐
56                     able when importing a partial set  or  a  set  lacking  a
57                     replica quorum.
58
59
60       -n            Does  not  actually  perform the operation, but shows the
61                     output or errors that would have resulted from the opera‐
62                     tion, had it been run.
63
64
65       -r            Report  on the non-configured disk sets found on the sys‐
66                     tem. If no disk device or LUN  is  specified,  metaimport
67                     reports  on  all non-configured disk sets attached to the
68                     system. When the name of one disk is  specified,  metaim‐
69                     port  reports on the disk set (or virtual LUN) containing
70                     the specified disk. If two or more disks  are  specified,
71                     metaimport reports on the set (or sets, if they belong to
72                     different disk sets) containing the specified  disks.  If
73                     two  or  more  disks are specified, metaimport reports on
74                     the set (or sets, if they belong to different disk  sets)
75                     containing the specified disks.
76
77                     This option can be used in conjunction with the -v option
78                     to give verbose output on each disk set reported.
79
80
81       -s setname    Specify the disk set name  to  use  when  importing.  The
82                     imported  disk set will be called setname, without regard
83                     to the name it may have had on a different system.
84
85
86       -v            Verbose. Provides detailed information about  the  metadb
87                     replica  location  and  status. It also provides detailed
88                     information about the disk set configuration  and  status
89                     similar to the "metastat -c" output.
90
91
92       -V            Version information.
93
94
95       -?            Display a help message.
96
97

EXAMPLES

99       Example 1 Importing a Disk Set
100
101
102       The  following  example  creates  a disk set called blue and identifies
103       c1t5d0 as a disk containing a state database replica from the disk  set
104       being imported.
105
106
107         # metaimport -s blue c1t5d0
108
109
110
111       Example 2 Reporting Disk Sets to Import
112
113
114       The  following  example scans all disks and LUNs attached to the system
115       and configured as part of the system. It scans for disks that could  be
116       part  of a disk set to be imported. Components that are already part of
117       the Solaris Volume Manager configuration are ignored.
118
119
120
121       This use of metaimport provides suggested forms of the metaimport  com‐
122       mand  to use to actually import the disk sets that have been found. You
123       can specify a component on the command line to reduce the scope of  the
124       scan and generate results more quickly.
125
126
127          # metaimport -r
128
129
130

EXIT STATUS

132       0     Successful completion.
133
134
135       >0    An error occurred.
136
137

ATTRIBUTES

139       See attributes(5) for descriptions of the following attributes:
140
141
142
143
144       ┌─────────────────────────────┬─────────────────────────────┐
145       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
146       ├─────────────────────────────┼─────────────────────────────┤
147       │Availability                 │SUNWmdu                      │
148       ├─────────────────────────────┼─────────────────────────────┤
149       │Interface Stability          │Stable                       │
150       └─────────────────────────────┴─────────────────────────────┘
151