From owner-svn-doc-all@FreeBSD.ORG Wed Feb 13 02:56:36 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id E216EB99; Wed, 13 Feb 2013 02:56:36 +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 D40FB3DB; Wed, 13 Feb 2013 02:56:36 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r1D2uahU089599; Wed, 13 Feb 2013 02:56:36 GMT (envelope-from linimon@svn.freebsd.org) Received: (from linimon@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id r1D2uaoP089598; Wed, 13 Feb 2013 02:56:36 GMT (envelope-from linimon@svn.freebsd.org) Message-Id: <201302130256.r1D2uaoP089598@svn.freebsd.org> From: Mark Linimon Date: Wed, 13 Feb 2013 02:56:36 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40961 - 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-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 13 Feb 2013 02:56:37 -0000 Author: linimon Date: Wed Feb 13 02:56:35 2013 New Revision: 40961 URL: http://svnweb.freebsd.org/changeset/doc/40961 Log: Add the contents of portbuild/tools/example_install as an example of how to quickly install portbuild. 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 Feb 12 20:36:46 2013 (r40960) +++ head/en_US.ISO8859-1/articles/portbuild/article.xml Wed Feb 13 02:56:35 2013 (r40961) @@ -2462,9 +2462,6 @@ zfs destroy -r a/snap/src-o jails. - - This document has not yet been updated with the latest changes. - @@ -2482,12 +2479,6 @@ zfs destroy -r a/snap/src-o - Export that value for a later initialization step: - - &prompt.root; export PORTBUILD_USER=portbuild - - - Similarly, create a user to own the administration functions and manage the svn repositories, such as srcbuild. It should have the @@ -2495,12 +2486,6 @@ zfs destroy -r a/snap/src-o - Export that value for a later initialization step: - - &prompt.root; export SRCBUILD_USER=srcbuild - - - Add the following to /boot/loader.conf: console="vidconsole,comconsole" @@ -2644,8 +2629,57 @@ sysutils/zfs-stats The following steps need to be done as euid root. + Here is a quick example: + + + The contents of example file <filename>portbuild/tools/example_install</filename> + + +#!/bin/sh +# +# example script to drive the "mkportbuild" kickstart file +# +export PORTBUILD_USER=portbuild +export SRCBUILD_USER=srcbuild +export ZFS_VOLUME=a +export ZFS_MOUNTPOINT=/a +export VCS_REPOSITORY=svn://svn0.us-east.FreeBSD.org + +# +# create the zpool. the examples here are just suggestions and need to be +# customized for your site. +# +# simple examples: +# zpool create ${ZFS_VOLUME} da1 +# zpool create ${ZFS_VOLUME} gprootfs +# more complex example: +# zpool create ${ZFS_VOLUME} mirror da1 da2 mirror da3 da4 mirror da5 da6 mirror da7 da8 + +# +# check out the kickstart file and run it +# +mkdir -p tmp +svn checkout ${VCS_REPOSITORY}/base/projects/portbuild/admin/tools tmp +sh -x ./tmp/mkportbuild + + + + Here is a detailed explanation of the example: + + Export the value of PORTBUILD_USER: + + &prompt.root; export PORTBUILD_USER=portbuild + + + + Export the value of SRCBUILD_USER: + + &prompt.root; export SRCBUILD_USER=srcbuild + + + Pick a zfs volume name and export it. We have used a so far to date. @@ -2670,9 +2704,11 @@ sysutils/zfs-stats - We will define a zfs - permission set below, so that the - srcbuild user may administer this + The kickstart script defines zfs + permission sets, so that the + srcbuild user and + portbuild user may administer + subdirectories of this volume without having to have root privileges. @@ -2890,7 +2926,7 @@ sysutils/zfs-stats - Copy the following files from + As root, copy the following files from /a/portbuild/admin/etc/rc.d/ to /usr/local/etc/rc.d/: