os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Bring device names up to date.

Browse source 
Correct ccd tutorial.

Correct typos.

MFC after:	2 weeks
This commit is contained in:
Greg Lehey 2001-06-04 03:04:38 +00:00
parent 006caeb4c3
commit 57f5fb5e58
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=9537
2 changed files with 162 additions and 96 deletions
Download patch file Download diff file Expand all files Collapse all files

129
en_US.ISO8859-1/articles/formatting-media/article.sgml
View file

@ -2,10 +2,10 @@
<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;
]>
<!-- $FreeBSD: doc/en_US.ISO_8859-1/articles/formatting-media/article.sgml,v 1.14 2000/07/26 18:24:38 jim Exp $ -->
<!-- $FreeBSD: doc/en_US.ISO_8859-1/articles/formatting-media/article.sgml,v 1.15 2001/04/17 15:53:38 nik Exp $ -->
<article>
<articleinfo>
<title>Formatting Media For Use With FreeBSD 2.2-RELEASE</title>
<title>Formatting Media For Use With FreeBSD</title>
<subtitle>A Tutorial</subtitle>
@ -29,7 +29,8 @@
<para>This document describes how to slice, partition, and
format hard disk drives and similar media for use with
FreeBSD. The examples given have been tested under FreeBSD
2.2-GAMMA and may work for other releases.</para>
2.2 and should work for other releases. The text has been updated
for FreeBSD version 4.</para>
</abstract>
</articleinfo>
@ -59,12 +60,13 @@
</listitem>
<listitem>
<para><firstterm>dangerously dedicated mode</firstterm>:
Formatting a disk with no slice table. This makes the
process of adding disks easier, however non-FreeBSD
operating systems may not accept the disk.</para>
</listitem>
</itemizedlist>
<para><firstterm>dedicated mode</firstterm>, sometimes called
<firstterm>dangerously dedicated mode</firstterm>: Formatting a disk
with no slice table. This makes the process of adding disks easier,
however non-FreeBSD operating systems may not accept the disk. The
term <emphasis>dangerously</emphasis> refers to the danger that the
system may not recognize a disk formatted in this manner.</para>
</listitem> </itemizedlist>
<para>For most cases, dedicated mode is the easiest to set up
and use in existing systems, as a new disk is usually
@ -80,7 +82,7 @@
allowing access to the Label and Partition editors and a Write
feature which will update just the selected disk and slice
without affecting other disks. The other method is running
the tools manually from a root command line. For dangerously
the tools manually from a root command line. For
dedicated mode, only three or four commands are involved while
<command>sysinstall</command> requires some
manipulation.</para>
@ -101,11 +103,11 @@ now. -->
<listitem>
<para>compatibility mode: Arranging a disk so that it has a
slice table for use with other operating systems. Oppose
dangerously dedicated mode.</para>
dedicated mode.</para>
</listitem>
<listitem>
<para>dangerously dedicated mode: Formatting a disk with no
<para>(dangerously) dedicated mode: Formatting a disk with no
slice table. This makes the process of adding disks
easier, however non-FreeBSD operating systems may not
accept the disk. Oppose compatibility mode.</para>
@ -189,8 +191,8 @@ now. -->
<title>Introduction</title>
<para>This section details how to make disks that are totally
dedicated to FreeBSD. Remember, dedicated mode disks cannot
be booted by the PC architecture.</para>
dedicated to FreeBSD. Remember, dedicated mode disks sometimes
cannot be booted by the PC architecture.</para>
</sect2>
<sect2>
@ -285,7 +287,7 @@ drive(s)?
do this!). You'll get the error:
<informalexample>
<screen>Error mounting /mnt/dev/wd2s1e on /mnt/blah : No such file or directory
<screen>Error mounting /mnt/dev/ad2s1e on /mnt/blah : No such file or directory
</screen>
</informalexample>
@ -302,14 +304,14 @@ drive(s)?
<sect2>
<title>Making Dedicated Mode Disks Using the Command Line</title>
<para>Execute the following commands, replacing wd2 with the
<para>Execute the following commands, replacing ad2 with the
disk name.</para>
<informalexample>
<screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/rwd2 count=2</userinput>
&prompt.root; <userinput>disklabel /dev/rwd2 | disklabel -B -R -r wd2 /dev/stdin</userinput>
<screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/ad2 count=2</userinput>
&prompt.root; <userinput>disklabel /dev/ad2 | disklabel -B -R -r ad2 /dev/stdin</userinput>
<lineannotation>We only want one partition, so using slice 'c' should be fine:</lineannotation>
&prompt.root; <userinput>newfs /dev/rwd2c</userinput>
&prompt.root; <userinput>newfs /dev/ad2c</userinput>
</screen>
</informalexample>
@ -317,11 +319,11 @@ drive(s)?
partitions (such as swap), use the following: </para>
<informalexample>
<screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/rwd2 count=2</userinput>
&prompt.root; <userinput>disklabel /dev/r$d > /tmp/label</userinput>
<screen>&prompt.root; <userinput>dd if=/dev/zero of=/dev/ad2 count=2</userinput>
&prompt.root; <userinput>disklabel /dev/$d > /tmp/label</userinput>
<lineannotation>Edit disklabel to add partitions:</lineannotation>
&prompt.root; <userinput>vi /tmp/label</userinput>
&prompt.root; <userinput>disklabel -B -R -r wd2 /tmp/label</userinput>
&prompt.root; <userinput>disklabel -B -R -r ad2 /tmp/label</userinput>
<lineannotation>newfs partitions appropriately</lineannotation>
</screen>
</informalexample>
@ -426,7 +428,7 @@ drive(s)?
this!). You'll get the error:
<informalexample>
<screen>Error mounting /mnt/dev/wd2s1e on /mnt/blah : No such file or directory
<screen>Error mounting /mnt/dev/ad2s1e on /mnt/blah : No such file or directory
</screen>
</informalexample>
@ -475,11 +477,11 @@ drive(s)?
follows:</para>
<informalexample>
<programlisting>/dev/wd0b none swap sw 0 0
<programlisting>/dev/ad0b none swap sw 0 0
</programlisting>
</informalexample>
<para>Change /dev/wd0b to the device of the newly added
<para>Change /dev/ad0b to the device of the newly added
space.</para>
</step>
@ -488,8 +490,8 @@ drive(s)?
<command>swapon</command> command.
<informalexample>
<screen>&prompt.root; <userinput>swapon /dev/sd0b</userinput>
swapon: added /dev/sd0b as swap space
<screen>&prompt.root; <userinput>swapon /dev/da0b</userinput>
swapon: added /dev/da0b as swap space
</screen>
</informalexample>
</para>
@ -508,11 +510,11 @@ swapon: added /dev/sd0b as swap space
one, do:
<informalexample>
<screen>&prompt.root; <userinput>mount /dev/wd2 /mnt</userinput>
<screen>&prompt.root; <userinput>mount /dev/ad2 /mnt</userinput>
&prompt.root; <userinput>pax -r -w -p e /usr/home /mnt</userinput>
&prompt.root; <userinput>umount /mnt</userinput>
&prompt.root; <userinput>rm -rf /usr/home/*</userinput>
&prompt.root; <userinput>mount /dev/wd2 /usr/home</userinput>
&prompt.root; <userinput>mount /dev/ad2 /usr/home</userinput>
</screen>
</informalexample>
</para>
@ -532,39 +534,70 @@ swapon: added /dev/sd0b as swap space
URL="http://stampede.cs.berkeley.edu/ccd/">CCD
Homepage</ulink> for further details.</para>
<para>To create a new CCD, execute the following commands. This
describes how to add three disks together; simply add or
remove devices as necessary. Remember that the disks to be
striped must be <emphasis>identical.</emphasis></para>
<para>You no longer need to build a special kernel to run ccd. When you
run <command>ccdconfig</command>, it will load the KLD for you if the
kernel does not contain CCD support.</para>
<para>Before executing these commands, make sure you add the line
<para>You build CCDs on disk partitions of type
<emphasis>4.2BSD</emphasis>. If you want to use the entire disk, you
still need to create a new partition. For example, <userinput>disklabel
-e</userinput> might show:
<userinput>pseudo-device ccd 4</userinput>
<informalexample>
<screen># size offset fstype [fsize bsize bps/cpg]
c: 60074784 0 unused 0 0 0 # (Cyl. 0 - 59597)
</screen>
</informalexample>
to your kernel.</para>
<para>You shouldn't use partition <emphasis>c</emphasis> for the CCD,
since it is of type <emphasis>unused</emphasis>. Instead, create a new
partition of exactly the same size, but with type
<emphasis>4.2BSD</emphasis>:</para>
<informalexample>
<screen># size offset fstype [fsize bsize bps/cpg]
c: 60074784 0 unused 0 0 0 # (Cyl. 0 - 59597)
<userinput> e: 60074784 0 4.2BSD 0 0 0 # (Cyl. 0 - 59597)</userinput>
</screen>
</informalexample>
<para>To create a new CCD, execute the following commands. This
describes how to add three disks together; simply add or remove devices
as necessary. Remember that the disks to be striped must be
<emphasis>identical.</emphasis></para>
<informalexample>
<screen>&prompt.root; <userinput>cd /dev ; sh MAKDEV ccd0</userinput>
&prompt.root; <userinput>disklabel -r -w sd0 auto</userinput>
&prompt.root; <userinput>disklabel -r -w sd1 auto</userinput>
&prompt.root; <userinput>disklabel -r -w sd2 auto</userinput>
&prompt.root; <userinput>disklabel -r -w da0 auto</userinput>
&prompt.root; <userinput>disklabel -r -w da1 auto</userinput>
&prompt.root; <userinput>disklabel -r -w da2 auto</userinput>
&prompt.root; <userinput>disklabel -e sd0c</userinput>
<lineannotation>change type to 4.2BSD</lineannotation>
&prompt.root; <userinput>disklabel -e sd1c</userinput>
<lineannotation>change type to 4.2BSD</lineannotation>
&prompt.root; <userinput>disklabel -e sd2c</userinput>
<lineannotation>change type to 4.2BSD</lineannotation>
&prompt.root; <userinput>disklabel -e da0</userinput>
<lineannotation>Add partition e with type 4.2BSD</lineannotation>
&prompt.root; <userinput>disklabel -e da1</userinput>
<lineannotation>Add partition e with type 4.2BSD</lineannotation>
&prompt.root; <userinput>disklabel -e da2</userinput>
<lineannotation>Add partition e with type 4.2BSD</lineannotation>
&prompt.root; <userinput>ccdconfig ccd0 32 0 /dev/sd0c /dev/sd1c /dev/sd2c</userinput>
&prompt.root; <userinput>ccdconfig ccd0 273 0 /dev/da0e /dev/da1e /dev/da2e</userinput>
&prompt.root; <userinput>newfs /dev/rccd0c</userinput>
&prompt.root; <userinput>newfs /dev/ccd0c</userinput>
</screen>
</informalexample>
<para>The value 273 is the stripe size. This is the number of disk
sectors (of 512 bytes each) in each block of data on the CCD. It should
be at least 128 kB, and it should not be not be a power of 2.</para>
<para>Now you can mount and use your CCD by referencing device
/dev/ccd0c.</para>
<para>
A more powerful and flexible alternative to CCD is Vinum. See the <ulink
URL="http://www.vinumvm.org/">Vinum Project home page</ulink> for further
details
</para>
</sect2>
</sect1>
@ -579,7 +612,7 @@ swapon: added /dev/sd0b as swap space
<para>Darryl Okahata
(<email>darrylo@hpnmhjw.sr.hp.com</email>) for his simple
dedicated mode setup documentation which I have used
repeatedly on freebsd-questions.</para>
repeatedly on FreeBSD-questions.</para>
</listitem>
<listitem>