Whitespace only: Fix several whitespace issues in Handbook's 'geom' chapter

This commit is contained in:
Manolis Kiagias 2008-11-26 12:21:48 +00:00
parent 237405f64b
commit f195ab2200
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=33302

View file

@ -50,8 +50,7 @@
<listitem> <listitem>
<para>How to use the base utilities to configure, maintain, <para>How to use the base utilities to configure, maintain,
and manipulate the various <acronym>RAID</acronym> and manipulate the various <acronym>RAID</acronym> levels.</para>
levels.</para>
</listitem> </listitem>
<listitem> <listitem>
@ -147,13 +146,15 @@
<procedure> <procedure>
<title>Creating a stripe of unformatted ATA disks</title> <title>Creating a stripe of unformatted ATA disks</title>
<step><para>Load the <filename>geom_stripe.ko</filename> <step>
<para>Load the <filename>geom_stripe.ko</filename>
module:</para> module:</para>
<screen>&prompt.root; <userinput>kldload geom_stripe</userinput></screen> <screen>&prompt.root; <userinput>kldload geom_stripe</userinput></screen>
</step> </step>
<step><para>Ensure that a suitable mount point exists. If this <step>
<para>Ensure that a suitable mount point exists. If this
volume will become a root partition, then temporarily use volume will become a root partition, then temporarily use
another mount point such as <filename another mount point such as <filename
class="directory">/mnt</filename>:</para> class="directory">/mnt</filename>:</para>
@ -161,7 +162,8 @@
<screen>&prompt.root; <userinput>mkdir /mnt</userinput></screen> <screen>&prompt.root; <userinput>mkdir /mnt</userinput></screen>
</step> </step>
<step><para>Determine the device names for the disks which will <step>
<para>Determine the device names for the disks which will
be striped, and create the new stripe device. For example, be striped, and create the new stripe device. For example,
to stripe two unused and unpartitioned <acronym>ATA</acronym> disks, to stripe two unused and unpartitioned <acronym>ATA</acronym> disks,
for example <filename>/dev/ad2</filename> and for example <filename>/dev/ad2</filename> and
@ -171,23 +173,23 @@
Metadata value stored on /dev/ad2. Metadata value stored on /dev/ad2.
Metadata value stored on /dev/ad3. Metadata value stored on /dev/ad3.
Done.</screen> Done.</screen>
</step> </step>
<step><para>Write a standard label, also known as a partition <step>
<para>Write a standard label, also known as a partition
table, on the new volume and install the default table, on the new volume and install the default
bootstrap code:</para> bootstrap code:</para>
<screen>&prompt.root; <userinput>bsdlabel -wB /dev/stripe/st0</userinput></screen> <screen>&prompt.root; <userinput>bsdlabel -wB /dev/stripe/st0</userinput></screen>
</step> </step>
<step><para>This process should have created two other devices <step>
<para>This process should have created two other devices
in the <filename class="directory">/dev/stripe</filename> in the <filename class="directory">/dev/stripe</filename>
directory in addition to the <devicename>st0</devicename> device. directory in addition to the <devicename>st0</devicename> device.
Those include <devicename>st0a</devicename> and Those include <devicename>st0a</devicename> and
<devicename>st0c</devicename>. At this point a file system may be created <devicename>st0c</devicename>. At this point a file system may be
on the <devicename>st0a</devicename> device with the created on the <devicename>st0a</devicename> device with the
<command>newfs</command> utility:</para> <command>newfs</command> utility:</para>
<screen>&prompt.root; <userinput>newfs -U /dev/stripe/st0a</userinput></screen> <screen>&prompt.root; <userinput>newfs -U /dev/stripe/st0a</userinput></screen>
@ -204,20 +206,19 @@ Done.</screen>
<para>To mount this striped file system automatically during the boot <para>To mount this striped file system automatically during the boot
process, place the volume information in process, place the volume information in
<filename>/etc/fstab</filename> file. For this purpose, a permanent mount <filename>/etc/fstab</filename> file. For this purpose, a permanent
point, named <filename class="directory">stripe</filename>, is mount point, named <filename class="directory">stripe</filename>, is
created:</para> created:</para>
<screen>&prompt.root; <userinput>mkdir /stripe</userinput> <screen>&prompt.root; <userinput>mkdir /stripe</userinput>
&prompt.root; <userinput>echo "/dev/stripe/st0a /stripe ufs rw 2 2" \</userinput> &prompt.root; <userinput>echo "/dev/stripe/st0a /stripe ufs rw 2 2" \</userinput>
<userinput>&gt;&gt; /etc/fstab</userinput></screen> <userinput>&gt;&gt; /etc/fstab</userinput></screen>
<para>The <filename>geom_stripe.ko</filename> module must also be automatically loaded during <para>The <filename>geom_stripe.ko</filename> module must also be
system initialization, by adding a line to automatically loaded during system initialization, by adding a line to
<filename>/boot/loader.conf</filename>:</para> <filename>/boot/loader.conf</filename>:</para>
<screen>&prompt.root; <userinput>echo 'geom_stripe_load="YES"' &gt;&gt; /boot/loader.conf</userinput></screen> <screen>&prompt.root; <userinput>echo 'geom_stripe_load="YES"' &gt;&gt; /boot/loader.conf</userinput></screen>
</sect1> </sect1>
<sect1 id="GEOM-mirror"> <sect1 id="GEOM-mirror">
@ -237,8 +238,7 @@ Done.</screen>
important aspect is that information on one disk or partition is important aspect is that information on one disk or partition is
being replicated. Later, that information could be more easily being replicated. Later, that information could be more easily
restored, backed up without causing service or access restored, backed up without causing service or access
interruption, and even be physically stored in a data interruption, and even be physically stored in a data safe.</para>
safe.</para>
<para>To begin, ensure the system has two disk drives of equal size, <para>To begin, ensure the system has two disk drives of equal size,
these exercises assume they are direct access (&man.da.4;) these exercises assume they are direct access (&man.da.4;)
@ -291,7 +291,8 @@ Done.</screen>
<para>Edit the <filename>/etc/fstab</filename> file, replacing <para>Edit the <filename>/etc/fstab</filename> file, replacing
references to the old <devicename>da0</devicename> with the references to the old <devicename>da0</devicename> with the
new device nodes of the <devicename>gm0</devicename> mirror device.</para> new device nodes of the <devicename>gm0</devicename> mirror
device.</para>
<note> <note>
<para>If &man.vi.1; is your preferred editor, the following is <para>If &man.vi.1; is your preferred editor, the following is
@ -368,6 +369,7 @@ mirror/gm0 COMPLETE da0
<sect2> <sect2>
<title>Troubleshooting</title> <title>Troubleshooting</title>
<sect3> <sect3>
<title>System refuses to boot</title> <title>System refuses to boot</title>
@ -682,9 +684,8 @@ devfs on /dev (devfs, local)
loss and inconsistencies of the file system. Unlike Soft Updates loss and inconsistencies of the file system. Unlike Soft Updates
which tracks and enforces meta-data updates and Snapshots which which tracks and enforces meta-data updates and Snapshots which
is an image of the file system, an actual log is stored in disk is an image of the file system, an actual log is stored in disk
space specifically reserved for this task, space specifically reserved for this task, and in some cases may be
and in some cases may be stored on another disk stored on another disk entirely.</para>
entirely.</para>
<para>Unlike other file system journaling implementations, the <para>Unlike other file system journaling implementations, the
<command>gjournal</command> method is block based and not <command>gjournal</command> method is block based and not
@ -720,8 +721,8 @@ devfs on /dev (devfs, local)
<para>At this point, there should be a <para>At this point, there should be a
<devicename>/dev/da4</devicename> device node and a <devicename>/dev/da4</devicename> device node and a
<devicename>/dev/da4.journal</devicename> device node. A <devicename>/dev/da4.journal</devicename> device node.
file system may now be created on this device:</para> A file system may now be created on this device:</para>
<screen>&prompt.root; <userinput>newfs -O 2 -J /dev/da4.journal</userinput></screen> <screen>&prompt.root; <userinput>newfs -O 2 -J /dev/da4.journal</userinput></screen>
@ -736,11 +737,12 @@ devfs on /dev (devfs, local)
<note> <note>
<para>In the case of several slices, a journal will be created <para>In the case of several slices, a journal will be created
for each individual slice. For instance, if <devicename>ad4s1</devicename> and <devicename>ad4s2</devicename> for each individual slice. For instance, if
<devicename>ad4s1</devicename> and <devicename>ad4s2</devicename>
are both slices, then <command>gjournal</command> will create are both slices, then <command>gjournal</command> will create
<devicename>ad4s1.journal</devicename> and <devicename>ad4s2.journal</devicename>. In the case of the command <devicename>ad4s1.journal</devicename> and
being run twice, the result will be <devicename>ad4s2.journal</devicename>. In the case of the command
<quote>journals</quote>.</para> being run twice, the result will be <quote>journals</quote>.</para>
</note> </note>
<para>Under some circumstances, keeping the journal on another disk <para>Under some circumstances, keeping the journal on another disk
@ -751,8 +753,7 @@ devfs on /dev (devfs, local)
before attempting to alter a file system. In most cases, the before attempting to alter a file system. In most cases, the
<command>gjournal</command> will fail if it is unable to create <command>gjournal</command> will fail if it is unable to create
the actual journal but this does not protect against data loss the actual journal but this does not protect against data loss
incurred as a result of misusing incurred as a result of misusing <command>tunefs</command>.</para>
<command>tunefs</command>.</para>
<para>It is also possible to journal the boot disk of a &os; system. <para>It is also possible to journal the boot disk of a &os; system.
Please refer to the article <ulink Please refer to the article <ulink