From owner-svn-doc-head@FreeBSD.ORG Tue Dec 18 02:44:51 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id C7AE4C93; Tue, 18 Dec 2012 02:44:51 +0000 (UTC) (envelope-from linimon@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id A0A668FC1A; Tue, 18 Dec 2012 02:44:51 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id qBI2ipOF034915; Tue, 18 Dec 2012 02:44:51 GMT (envelope-from linimon@svn.freebsd.org) Received: (from linimon@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id qBI2ipsm034914; Tue, 18 Dec 2012 02:44:51 GMT (envelope-from linimon@svn.freebsd.org) Message-Id: <201212180244.qBI2ipsm034914@svn.freebsd.org> From: Mark Linimon Date: Tue, 18 Dec 2012 02:44:51 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Dec 2012 02:44:51 -0000 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 - - Configuring the portbuild volume + + Configuring the zfs volume + + The following steps need to be done as euid root. - Create /a. + Pick a zfs volume name and export + it. We have used a so far to date. + &prompt.root; export ZFS_VOLUME=a + + + + + Pick a mountpoint and export it. We have used + /a so far to date. + &prompt.root; export ZFS_MOUNTPOINT=/a + - Create a zfs volume named - a and mount it on - /a. + Create the mountpoint. + &prompt.root; mkdir -p /a + + + + Create the zfs volume + and mount it. Creating a <application>zfs</application> volume for portbuild -&prompt.root; zpool create a mirror da1 da2 mirror da3 da4 mirror da5 da6 mirror da7 da8 +&prompt.root; zpool create a mirror da1 da2 mirror da3 da4 mirror da5 da6 mirror da7 da8 + + + + + + Setting up and configuring the <application>portbuild</application> repository + + + Create the portbuild directory: -&prompt.root; mkdir -p /a/portbuild +&prompt.root; mkdir -p /a/portbuild @@ -2989,16 +3014,16 @@ sysutils/zfs-stats Create and mount a new zfs filesystem on it: - zfs create -o mountpoint=/a/portbuild a/portbuild + zfs create -o mountpoint=/a/portbuild a/portbuild Set up the directory: -&prompt.root; cd /a/portbuild -&prompt.root; chown portbuild:portbuild . +&prompt.root; cd /a/portbuild +&prompt.root; chown portbuild:portbuild . &prompt.root; chmod 775 . -&prompt.root; ln -sf /a/portbuild /var/portbuild +&prompt.root; ln -sf /a/portbuild /var/portbuild @@ -3008,15 +3033,6 @@ sysutils/zfs-stats - - - - - - Setting up and configuring the <application>portbuild</application> repository - - - Set up an account with subversion config files installed. Again, we generally use @@ -3025,7 +3041,7 @@ sysutils/zfs-stats As that user, set up the repository: -&prompt.user; svn checkout svn://svn.freebsd.org/base/projects/portbuild /a/portbuild +&prompt.user; svn checkout svn://svn.freebsd.org/base/projects/portbuild /a/portbuild @@ -3033,7 +3049,7 @@ sysutils/zfs-stats Configure how build slaves will talk to your server by making the following changes to - /var/portbuild/conf/client.conf: + /a/portbuild/conf/client.conf: @@ -3061,14 +3077,14 @@ sysutils/zfs-stats Most of the default values in - /var/portbuild/conf/common.conf + /a/portbuild/conf/common.conf should be fine. This file holds definitions used by both the server and all its clients. Configure the server by making the following changes to - /var/portbuild/conf/server.conf: + /a/portbuild/conf/server.conf: @@ -3087,6 +3103,12 @@ sysutils/zfs-stats + Set ZFS_VOLUME and + ZFS_MOUNTPOINT to whatever you + chose above. + + + Set UPLOAD_DIRECTORY, UPLOAD_TARGET, and UPLOAD_USER as approprite