svn commit: r40414 - head/en_US.ISO8859-1/articles/portbuild
Mark Linimon
linimon at FreeBSD.org
Tue Dec 18 02:44:51 UTC 2012
Author: linimon
Date: Tue Dec 18 02:44:51 2012
New Revision: 40414
URL: http://svnweb.freebsd.org/changeset/doc/40414
Log:
Start explaining the steps to creating the zfs volume in far more detail.
Also move the heading "Setting up and configuring the portbuild repository".
Nothin' up my sleeve! (Not this again.)
Modified:
head/en_US.ISO8859-1/articles/portbuild/article.xml
Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/portbuild/article.xml Tue Dec 18 01:43:28 2012 (r40413)
+++ head/en_US.ISO8859-1/articles/portbuild/article.xml Tue Dec 18 02:44:51 2012 (r40414)
@@ -2958,30 +2958,55 @@ sysutils/zfs-stats</screen>
</sect2>
- <sect2 id="pointyhat-portbuild-volume">
- <title>Configuring the portbuild volume</title>
+ <sect2 id="pointyhat-zfs-volume">
+ <title>Configuring the zfs volume</title>
+
+ <para>The following steps need to be done as euid root.</para>
<procedure>
<step>
- <para>Create <filename>/a</filename>.</para>
+ <para>Pick a <application>zfs</application> volume name and export
+ it. We have used <replaceable>a</replaceable> so far to date.
+ <programlisting>&prompt.root; export ZFS_VOLUME=<replaceable>a</replaceable></programlisting>
+ </para>
+ </step>
+
+ <step>
+ <para>Pick a mountpoint and export it. We have used
+ <filename>/<replaceable>a</replaceable></filename> so far to date.
+ <programlisting>&prompt.root; export ZFS_MOUNTPOINT=/<replaceable>a</replaceable></programlisting>
+ </para>
</step>
<step>
- <para>Create a <application>zfs</application> volume named
- <filename>a</filename> and mount it on
- <filename>/a</filename>.</para>
+ <para>Create the mountpoint.</para>
+ <programlisting>&prompt.root; mkdir -p /<replaceable>a</replaceable></programlisting>
+ </step>
+
+ <step>
+ <para>Create the <application>zfs</application> volume
+ and mount it.</para>
<example>
<title>Creating a <application>zfs</application> volume for portbuild</title>
-<screen>&prompt.root; zpool create a mirror da1 da2 mirror da3 da4 mirror da5 da6 mirror da7 da8</screen>
+<screen>&prompt.root; zpool create <replaceable>a</replaceable> mirror da1 da2 mirror da3 da4 mirror da5 da6 mirror da7 da8</screen>
</example>
</step>
+ </procedure>
+
+ </sect2>
+
+ <sect2 id="pointyhat-repo">
+ <title>Setting up and configuring the <application>portbuild</application> repository</title>
+
+ <procedure>
+
<step>
<para>Create the <filename>portbuild</filename> directory:<screen>
-&prompt.root; mkdir -p /a/portbuild
+&prompt.root; mkdir -p /<replaceable>a</replaceable>/portbuild
</screen>
</para>
</step>
@@ -2989,16 +3014,16 @@ sysutils/zfs-stats</screen>
<step>
<para>Create and mount a new <application>zfs</application>
filesystem on it:
- <screen>zfs create -o mountpoint=/a/portbuild a/portbuild</screen>
+ <screen>zfs create -o mountpoint=/<replaceable>a</replaceable>/portbuild <replaceable>a</replaceable>/portbuild</screen>
</para>
</step>
<step>
<para>Set up the directory:<screen>
-&prompt.root; cd /a/portbuild
-&prompt.root; chown portbuild:portbuild .
+&prompt.root; cd /<replaceable>a</replaceable>/portbuild
+&prompt.root; chown <replaceable>portbuild</replaceable>:<replaceable>portbuild</replaceable> .
&prompt.root; chmod 775 .
-&prompt.root; ln -sf /a/portbuild /var/portbuild
+&prompt.root; ln -sf /<replaceable>a</replaceable>/portbuild /var/portbuild
</screen>
</para>
@@ -3008,15 +3033,6 @@ sysutils/zfs-stats</screen>
</note>
</step>
- </procedure>
-
- </sect2>
-
- <sect2 id="pointyhat-repo">
- <title>Setting up and configuring the <application>portbuild</application> repository</title>
-
- <procedure>
-
<step>
<para>Set up an account with subversion config files
installed. Again, we generally use
@@ -3025,7 +3041,7 @@ sysutils/zfs-stats</screen>
<step>
<para>As that user, set up the repository:<screen>
-&prompt.user; svn checkout svn://svn.freebsd.org/base/projects/portbuild /a/portbuild
+&prompt.user; svn checkout svn://svn.freebsd.org/base/projects/portbuild /<replaceable>a</replaceable>/portbuild
</screen>
</para>
</step>
@@ -3033,7 +3049,7 @@ sysutils/zfs-stats</screen>
<step>
<para>Configure how build slaves will talk to your server
by making the following changes to
- <filename>/var/portbuild/conf/client.conf</filename>:</para>
+ <filename>/<replaceable>a</replaceable>/portbuild/conf/client.conf</filename>:</para>
<itemizedlist>
@@ -3061,14 +3077,14 @@ sysutils/zfs-stats</screen>
<step>
<para>Most of the default values in
- <filename>/var/portbuild/conf/common.conf</filename>
+ <filename>/<replaceable>a</replaceable>/portbuild/conf/common.conf</filename>
should be fine. This file holds definitions used by
both the server and all its clients.</para>
</step>
<step>
<para>Configure the server by making the following changes to
- <filename>/var/portbuild/conf/server.conf</filename>:</para>
+ <filename>/<replaceable>a</replaceable>/portbuild/conf/server.conf</filename>:</para>
<itemizedlist>
@@ -3087,6 +3103,12 @@ sysutils/zfs-stats</screen>
</listitem>
<listitem>
+ <para>Set <makevar>ZFS_VOLUME</makevar> and
+ <makevar>ZFS_MOUNTPOINT</makevar> to whatever you
+ chose above.</para>
+ </listitem>
+
+ <listitem>
<para>Set <makevar>UPLOAD_DIRECTORY</makevar>,
<makevar>UPLOAD_TARGET</makevar>, and
<makevar>UPLOAD_USER</makevar> as approprite
More information about the svn-doc-all
mailing list