Date: Wed, 13 Feb 2013 02:56:36 +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: r40961 - head/en_US.ISO8859-1/articles/portbuild Message-ID: <201302130256.r1D2uaoP089598@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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-<replaceable>o jails.</para> </listitem> </itemizedlist> - - <para>This document has not yet been updated with the latest changes. - </para> </sect2> <sect2 id="pointyhat-basics"> @@ -2482,12 +2479,6 @@ zfs destroy -r a/snap/src-<replaceable>o </step> <step> - <para>Export that value for a later initialization step:</para> - - <screen>&prompt.root; export PORTBUILD_USER=<replaceable>portbuild</replaceable></screen> - </step> - - <step> <para>Similarly, create a user to own the administration functions and manage the <application>svn</application> repositories, such as <literal>srcbuild</literal>. It should have the @@ -2495,12 +2486,6 @@ zfs destroy -r a/snap/src-<replaceable>o </step> <step> - <para>Export that value for a later initialization step:</para> - - <screen>&prompt.root; export SRCBUILD_USER=<replaceable>srcbuild</replaceable></screen> - </step> - - <step> <para>Add the following to <filename>/boot/loader.conf</filename>:</para> <programlisting>console="vidconsole,comconsole"</programlisting> @@ -2644,8 +2629,57 @@ sysutils/zfs-stats</programlisting> <para>The following steps need to be done as euid root.</para> + <para>Here is a quick example:</para> + + <example> + <title>The contents of example file <filename>portbuild/tools/example_install</filename></title> + + <screen> +#!/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 +</screen> + </example> + + <para>Here is a detailed explanation of the example:</para> + <procedure> <step> + <para>Export the value of <makevar>PORTBUILD_USER</makevar>:</para> + + <screen>&prompt.root; export PORTBUILD_USER=<replaceable>portbuild</replaceable></screen> + </step> + + <step> + <para>Export the value of <makevar>SRCBUILD_USER</makevar>:</para> + + <screen>&prompt.root; export SRCBUILD_USER=<replaceable>srcbuild</replaceable></screen> + </step> + + <step> <para>Pick a <application>zfs</application> volume name and export it. We have used <replaceable>a</replaceable> so far to date.</para> @@ -2670,9 +2704,11 @@ sysutils/zfs-stats</programlisting> </example> <note> - <para>We will define a <application>zfs</application> - <literal>permission set</literal> below, so that the - <replaceable>srcbuild</replaceable> user may administer this + <para>The kickstart script defines <application>zfs</application> + <literal>permission sets</literal>, so that the + <replaceable>srcbuild</replaceable> user and + <replaceable>portbuild</replaceable> user may administer + subdirectories of this volume without having to have root privileges.</para> </note> </step> @@ -2890,7 +2926,7 @@ sysutils/zfs-stats</programlisting> <procedure> <step> - <para>Copy the following files from + <para>As <literal>root</literal>, copy the following files from <filename>/a/portbuild/admin/etc/rc.d/</filename> to <filename>/usr/local/etc/rc.d/</filename>:</para>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201302130256.r1D2uaoP089598>