diff options
Diffstat (limited to 'en_US.ISO8859-1/articles/gjournal-desktop/article.xml')
| -rw-r--r-- | en_US.ISO8859-1/articles/gjournal-desktop/article.xml | 92 |
1 files changed, 42 insertions, 50 deletions
diff --git a/en_US.ISO8859-1/articles/gjournal-desktop/article.xml b/en_US.ISO8859-1/articles/gjournal-desktop/article.xml index aadd5cf22c..7d8af3fcd8 100644 --- a/en_US.ISO8859-1/articles/gjournal-desktop/article.xml +++ b/en_US.ISO8859-1/articles/gjournal-desktop/article.xml @@ -1,18 +1,13 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN" - "../../../share/xml/freebsd45.dtd"> +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" + "../../../share/xml/freebsd50.dtd"> +<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> + <info><title>Implementing UFS Journaling on a Desktop PC</title> + -<article lang="en"> - <articleinfo> - <title>Implementing UFS Journaling on a Desktop PC</title> - - <author> - <firstname>Manolis</firstname> - <surname>Kiagias</surname> - <affiliation> + <author><personname><firstname>Manolis</firstname><surname>Kiagias</surname></personname><affiliation> <address><email>manolis@FreeBSD.org</email></address> - </affiliation> - </author> + </affiliation></author> <copyright> <year>2008</year> @@ -23,7 +18,7 @@ <releaseinfo>$FreeBSD$</releaseinfo> - <legalnotice id="trademarks" role="trademarks"> + <legalnotice xml:id="trademarks" role="trademarks"> &tm-attrib.freebsd; &tm-attrib.general; </legalnotice> @@ -42,9 +37,9 @@ explains how to implement UFS journaling on a typical desktop PC scenario.</para> </abstract> - </articleinfo> + </info> - <sect1 id="introduction"> + <sect1 xml:id="introduction"> <title>Introduction</title> <para>While professional servers are usually well protected from @@ -120,7 +115,7 @@ </warning> </sect1> - <sect1 id="understanding-journaling"> + <sect1 xml:id="understanding-journaling"> <title>Understanding Journaling in &os;</title> <para>The journaling provided by GEOM in &os; 7.<replaceable>X</replaceable> is not file system @@ -151,20 +146,19 @@ <itemizedlist> <listitem> <para>You wish to journal your <filename>/usr</filename> file system, - stored in <filename class="devicefile">/dev/ad0s1f</filename> (which + stored in <filename>/dev/ad0s1f</filename> (which already contains data).</para> </listitem> <listitem> <para>You reserved some free disk space in a partition in - <filename class="devicefile">/dev/ad0s1g</filename>.</para> + <filename>/dev/ad0s1g</filename>.</para> </listitem> <listitem> - <para>Using <command>gjournal</command>, a new <filename - class="devicefile">/dev/ad0s1f.journal</filename> device is created - where <filename class="devicefile">/dev/ad0s1f</filename> is the data - provider, and <filename class="devicefile">/dev/ad0s1g</filename> is + <para>Using <command>gjournal</command>, a new <filename>/dev/ad0s1f.journal</filename> device is created + where <filename>/dev/ad0s1f</filename> is the data + provider, and <filename>/dev/ad0s1g</filename> is the journal provider. This new device is then used for all subsequent file operations.</para> </listitem> @@ -194,7 +188,7 @@ page of &man.gjournal.8;.</para> </sect1> - <sect1 id="reserve-space"> + <sect1 xml:id="reserve-space"> <title>Steps During the Installation of &os;</title> <sect2> @@ -325,7 +319,7 @@ (packages) until you have completely setup journaling.</para> </sect2> - <sect2 id="first-boot"> + <sect2 xml:id="first-boot"> <title>Booting for the first time</title> <para>Your system will come up normally, but you will need to edit @@ -340,15 +334,15 @@ </sect2> </sect1> - <sect1 id="configure-journal"> + <sect1 xml:id="configure-journal"> <title>Setting Up Journaling</title> - <sect2 id="running-gjournal"> + <sect2 xml:id="running-gjournal"> <title>Executing <command>gjournal</command></title> <para>Having prepared all the required partitions, it is quite easy to configure journaling. We will need to switch to single user - mode, so login as <username>root</username> and type:</para> + mode, so login as <systemitem class="username">root</systemitem> and type:</para> <screen>&prompt.root; <userinput>shutdown now</userinput></screen> @@ -364,11 +358,10 @@ <para>Now, use your notes to determine which partition will be used for each journal. In our example, <filename>/usr</filename> is - <filename class="devicefile">ad0s1f</filename> and its journal will be - <filename class="devicefile">ad0s1g</filename>, while - <filename>/var</filename> is <filename - class="devicefile">ad0s1d</filename> and will - be journaled to <filename class="devicefile">ad0s1h</filename>. + <filename>ad0s1f</filename> and its journal will be + <filename>ad0s1g</filename>, while + <filename>/var</filename> is <filename>ad0s1d</filename> and will + be journaled to <filename>ad0s1h</filename>. The following commands are required:</para> <screen>&prompt.root; <userinput>gjournal label ad0s1f ad0s1g</userinput> @@ -393,8 +386,8 @@ GEOM_JOURNAL: Journal 3193218002: ad0s1h contains journal.</screen> anything will be actually overwritten.</para></note> <para>At this point, two new devices are created, namely - <filename class="devicefile">ad0s1d.journal</filename> and - <filename class="devicefile">ad0s1f.journal</filename>. These represent + <filename>ad0s1d.journal</filename> and + <filename>ad0s1f.journal</filename>. These represent the <filename>/var</filename> and <filename>/usr</filename> partitions we have to mount. Before mounting, we must however set the journal flag on them and clear the Soft Updates flag:</para> @@ -456,14 +449,14 @@ GEOM_JOURNAL: Journal ad0s1f clean.</screen> state.</para> </sect2> - <sect2 id="gjournal-new"> + <sect2 xml:id="gjournal-new"> <title>Journaling Newly Created Partitions</title> <para>While the above procedure is necessary for journaling partitions that already contain data, journaling an empty partition is somewhat easier, since both the data and the journal provider can be stored in the same partition. For example, assume a new disk was installed, - and a new partition <filename class="devicefile">/dev/ad1s1d</filename> + and a new partition <filename>/dev/ad1s1d</filename> was created. Creating the journal would be as simple as:</para> <screen>&prompt.root; <userinput>gjournal label ad1s1d</userinput></screen> @@ -486,7 +479,7 @@ GEOM_JOURNAL: Journal ad0s1f clean.</screen> <screen>&prompt.root; <userinput>newfs -J /dev/ad1s1d.journal</userinput></screen> </sect2> - <sect2 id="configure-kernel"> + <sect2 xml:id="configure-kernel"> <title>Building Journaling into Your Custom Kernel</title> <para>If you do not wish to load <literal>geom_journal</literal> as a @@ -499,8 +492,8 @@ GEOM_JOURNAL: Journal ad0s1f clean.</screen> options GEOM_JOURNAL # You will have to add this one</programlisting> <para>Rebuild and reinstall your kernel following the relevant - <ulink url="&url.books.handbook;/kernelconfig.html">instructions in - the &os; Handbook.</ulink></para> + <link xlink:href="&url.books.handbook;/kernelconfig.html">instructions in + the &os; Handbook.</link></para> <para>Do not forget to remove the relevant <quote>load</quote> entry from <filename>/boot/loader.conf</filename> if you have previously @@ -508,7 +501,7 @@ options GEOM_JOURNAL # You will have to add this one</programlisting> </sect2> </sect1> - <sect1 id="troubleshooting-gjournal"> + <sect1 xml:id="troubleshooting-gjournal"> <title>Troubleshooting Journaling</title> <para>The following section covers frequently asked questions regarding @@ -516,7 +509,7 @@ options GEOM_JOURNAL # You will have to add this one</programlisting> <qandaset> <qandaentry> - <question id="kernel-panic"> + <question xml:id="kernel-panic"> <para>I am getting kernel panics during periods of high disk activity. How is this related to journaling?</para> </question> @@ -526,13 +519,12 @@ options GEOM_JOURNAL # You will have to add this one</programlisting> committed (flushed) to disk. Keep in mind the size of the journal depends on the usage load, and not the size of the data provider. If your disk activity is high, you need a larger - partition for the journal. See the note in the <link - linkend="understanding-journaling">Understanding Journaling</link> section.</para> + partition for the journal. See the note in the <link linkend="understanding-journaling">Understanding Journaling</link> section.</para> </answer> </qandaentry> <qandaentry> - <question id="unable-boot"> + <question xml:id="unable-boot"> <para>I made some mistake during configuration, and I cannot boot normally now. Can this be fixed some way?</para> </question> @@ -572,7 +564,7 @@ GEOM_JOURNAL: Journal ad0s1f clean. </qandaentry> <qandaentry> - <question id="remove-journaling"> + <question xml:id="remove-journaling"> <para>Can I remove journaling and return to my standard file system with Soft Updates?</para> </question> @@ -582,7 +574,7 @@ GEOM_JOURNAL: Journal ad0s1f clean. changes. The partitions you created for the journal providers can then be used for other purposes, if you so wish.</para> - <para>Login as <username>root</username> and switch to single user mode:</para> + <para>Login as <systemitem class="username">root</systemitem> and switch to single user mode:</para> <screen>&prompt.root; <userinput>shutdown now</userinput></screen> @@ -639,7 +631,7 @@ tunefs: soft updates set</screen> </qandaset> </sect1> - <sect1 id="further-reading"> + <sect1 xml:id="further-reading"> <title>Further Reading</title> <para>Journaling is a fairly new feature of &os;, and as such, it is @@ -648,17 +640,17 @@ tunefs: soft updates set</screen> <itemizedlist> <listitem> - <para>A <ulink url="&url.books.handbook;/geom-gjournal.html">new section on journaling</ulink> + <para>A <link xlink:href="&url.books.handbook;/geom-gjournal.html">new section on journaling</link> is now part of the &os; Handbook.</para> </listitem> <listitem> - <para><ulink url="http://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html">This post</ulink> + <para><link xlink:href="http://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html">This post</link> in &a.current.name; by &man.gjournal.8;'s developer, &a.pjd.email;.</para> </listitem> <listitem> - <para><ulink url="http://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html">This post</ulink> + <para><link xlink:href="http://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html">This post</link> in &a.questions.name; by &a.ivoras.email;.</para> </listitem> |