aboutsummaryrefslogtreecommitdiff
path: root/sbin/vinum
diff options
context:
space:
mode:
authorGreg Lehey <grog@FreeBSD.org>1999-05-07 07:11:01 +0000
committerGreg Lehey <grog@FreeBSD.org>1999-05-07 07:11:01 +0000
commit8fea704025e15e426b364e5096cdd4b2a77209ad (patch)
treea87f777c2a21e9ed15332c2e30d09c04b6853af5 /sbin/vinum
parentc48d17750f93a0c73afe5ac7d5ec2ce0093a4407 (diff)
downloadsrc-8fea704025e15e426b364e5096cdd4b2a77209ad.tar.gz
src-8fea704025e15e426b364e5096cdd4b2a77209ad.zip
Arrange the "CONFIGURATION FILE" section in the order in which the
entries go into the config file. Clarify what names can be used for Vinum drives, and what will happen to you if you use other names. Forcibly-demonstrated-by: Thomas Stromberg <tstromberg@rtci.com> Peter K Campbell <PCampbel@vtrlmel1.telstra.com.au> George Cox <george.cox@sophos.com> many others, but those were the only three today.
Notes
Notes: svn path=/head/; revision=46626
Diffstat (limited to 'sbin/vinum')
-rw-r--r--sbin/vinum/vinum.869
1 files changed, 45 insertions, 24 deletions
diff --git a/sbin/vinum/vinum.8 b/sbin/vinum/vinum.8
index a68ec51674cb..51f21cf1a760 100644
--- a/sbin/vinum/vinum.8
+++ b/sbin/vinum/vinum.8
@@ -1093,6 +1093,30 @@ dependent on the context.
The configuration file can contain the following entries:
.Pp
.Bl -hang -width 4n
+.It Nm drive Ar name option
+.Pp
+Define a drive. The option must be:
+.Pp
+.Bl -hang -width 18n
+.It Nm device Ar devicename
+Specify the device on which the drive resides.
+.Ar devicename
+must be the name of a disk compatibility partition, for example
+.Pa /dev/da1e
+or
+.Pa /dev/wd3h ,
+and it should be of type
+.Nm vinum .
+Do not use the
+.Nm c
+partition, which is reserved for the complete disk, and should be of type
+.Nm unused .
+It is currently possible to create drives on other disk devices, for example
+.Pa /dev/da0s1
+or
+.Pa /dev/da0s1e ,
+but it will not be possible to start these drives after a reboot.
+.El
.It Nm volume
.Ar name
.Op options
@@ -1254,14 +1278,6 @@ on the last drive specified.
.br
.fi
.El
-.It Nm drive Ar name Op options
-.Pp
-Define a drive. The option must be:
-.Pp
-.Bl -hang -width 18n
-.It Nm device Ar devicename
-Specify the device on which the drive resides.
-.El
.El
.Sh EXAMPLE CONFIGURATION FILE
.Bd -literal
@@ -1389,23 +1405,28 @@ system.
The first choice you need to make is where to put the data. You need dedicated
disk partitions for
.Nm vinum .
-See the example under DRIVE LAYOUT CONSIDERATIONS above. Choose partition type
-.Nm
-unless your version of
-.Xr disklabel 8
-does not understand this partition type, in which case you will need to use
-partition type
-.Nm unused
-until you update your version of
-.Xr disklabel 8 .
-Use the compatibility partition (for example,
-.Pa /dev/da0g )
-rather than the true partition name (such as
-.Pa /dev/da0s1g ).
-.Nm
-currently uses the compatibility partition only for the
+They should be compatibility partitions, not devices or partition
+.Nm c
+of a slice. For example, good names are
+.Pa /dev/da0e
+or
+.Pa /dev/wd3a .
+Bad names are
+.Pa /dev/da0
+and
+.Pa /dev/da0s1 ,
+both of which represent a device, not a partition,
+.Pa /dev/wd1c ,
+which represents a complete disk and should be of type
+.Nm unused ,
+and
+.Pa /dev/da3s0e ,
+which is not a compatibility partition.
+.Nm
+currently allows you to create drives with these names, but the
.Nm start
-command, so this way you can avoid problems.
+command will not find them. See the example under DRIVE LAYOUT CONSIDERATIONS
+above.
.Ss Designing volumes
The way you set up
.Nm