metaroot(1m)

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

NAME

6       metaroot - setup system files for root (/) metadevice
7

SYNOPSIS

9       /usr/sbin/metaroot -h
10
11
12       /usr/sbin/metaroot [-n] [-k system-name] [-v vfstab-name]
13            [-c mddb.cf-name] [-m md.conf-name] [-R root-path] device
14
15

DESCRIPTION

17       The  metaroot  command  edits  the /etc/vfstab and /etc/system files so
18       that the system may be booted with the  root  file  system  (/)  on  an
19       appropriate metadevice. The only metadevices that support the root file
20       system are a stripe with only a single slice or a mirror on  a  single-
21       slice stripe.
22
23
24       If  necessary,  the  metaroot  command can reset a system that has been
25       configured to boot the root file system (/) on a metadevice so that  it
26       uses a physical slice.
27

OPTIONS

29       Root  privileges  are  required for all of the following options except
30       -h.
31
32
33       The following options are supported:
34
35       -c mddb.cf-name    Use   mddb.cf-name   instead    of    the    default
36                          /etc/lvm/mddb.cf  file  as  a  source  of metadevice
37                          database locations.
38
39
40       -h                 Display a usage message.
41
42
43       -k system-name     Edit a  user-supplied  system-name  instead  of  the
44                          default /etc/system system configuration information
45                          file.
46
47
48       -m md.conf-name    Edit the configuration file  specified  by  md.conf-
49                          name rather than the default, /kernel/drv/md.conf.
50
51
52       -n                 Print what would be done without actually doing it.
53
54
55       -R root-path       When  metaroot  modifies  system  files, it accesses
56                          them in their relative location under root-path.
57
58                          The -R option cannot be used in combination with the
59                          -c, -k,-m, or -v options.
60
61                          Note -
62
63                            The  root file system of any non-global zones must
64                            not be referenced with the  -R  option.  Doing  so
65                            might  damage the global zone's file system, might
66                            compromise the security of the  global  zone,  and
67                            might  damage  the  non-global zone's file system.
68                            See zones(5).
69
70
71       -v vfstab-name     Edit vfstab-name instead of the default  /etc/vfstab
72                          table of file system defaults.
73
74

OPERANDS

76       The following operands are supported:
77
78       device    Specifies  either  the  metadevice  or  the conventional disk
79                 device (slice) used for the root file system (/).
80
81

EXAMPLES

83       Example 1 Specifying Root File System on Metadevice
84
85
86       The following command edits /etc/system and /etc/vfstab to specify that
87       the root file system is now on metadevice d0.
88
89
90         # metaroot d0
91
92
93
94
95       The  following  example  shows the same command using a desriptive name
96       for the metadevice.
97
98
99         # metaroot newrootfilesystem
100
101
102
103       Example 2 Specifying Root File System on SCSI Disk
104
105
106       The following command edits /etc/system and /etc/vfstab to specify that
107       the root file system is now on the SCSI disk device /dev/dsk/c0t3d0s0.
108
109
110         # metaroot /dev/dsk/c0t3d0s0
111
112
113

FILES

115       /etc/system            System  configuration information file. See sys‐
116                              tem(4).
117
118
119       /etc/vfstab            File system defaults.
120
121
122       /etc/lvm/mddb.cf       Metadevice state database locations.
123
124
125       /kernel/drv/md.conf    Configuration file for  the  metadevice  driver,
126                              md.
127
128

EXIT STATUS

130       The following exit values are returned:
131
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