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>