Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 18 Dec 2012 02:44:51 +0000 (UTC)
From:      Mark Linimon <linimon@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r40414 - head/en_US.ISO8859-1/articles/portbuild
Message-ID:  <201212180244.qBI2ipsm034914@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201212180244.qBI2ipsm034914>