Date: Wed, 13 Jun 2012 02:41:10 +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: r39040 - head/en_US.ISO8859-1/articles/portbuild Message-ID: <201206130241.q5D2fAQv090150@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: linimon Date: Wed Jun 13 02:41:10 2012 New Revision: 39040 URL: http://svn.freebsd.org/changeset/doc/39040 Log: - make the "new arch" section reflect reality. - remove the pathname for qmanager invocations. What was there was only true for the old codebase. - tune up the "required ports for a head node" section. Modified: head/en_US.ISO8859-1/articles/portbuild/article.sgml Modified: head/en_US.ISO8859-1/articles/portbuild/article.sgml ============================================================================== --- head/en_US.ISO8859-1/articles/portbuild/article.sgml Tue Jun 12 23:11:31 2012 (r39039) +++ head/en_US.ISO8859-1/articles/portbuild/article.sgml Wed Jun 13 02:41:10 2012 (r39040) @@ -762,7 +762,7 @@ PKG_BIN=/usr/local/sbin/pkg</screen> package set. This can be accomplished with the following invocation:</para> - <para><command>/var/portbuild/evil/qmanager/packagebuild <replaceable>amd64</replaceable> <replaceable>7-exp</replaceable> <replaceable>20080904212103</replaceable> <replaceable>aclock-0.2.3_2.tbz</replaceable></command></para> + <para><command><replaceable>path</replaceable>/qmanager/packagebuild <replaceable>amd64</replaceable> <replaceable>7-exp</replaceable> <replaceable>20080904212103</replaceable> <replaceable>aclock-0.2.3_2.tbz</replaceable></command></para> </sect2> </sect1> @@ -1002,8 +1002,8 @@ umount: Cleanup of /x/tmp/8-exp/chroot/5 <para>You can use <command>qclient</command> command to monitor the status of build nodes, and to list the currently scheduled jobs:</para> - <para><command>python /var/portbuild/evil/qmanager/qclient jobs</command></para> - <para><command>python /var/portbuild/evil/qmanager/qclient status</command></para> + <para><command>python <replaceable>path</replaceable>/qmanager/qclient jobs</command></para> + <para><command>python <replaceable>path</replaceable>/qmanager/qclient status</command></para> <para>The <command>scripts/stats <replaceable>${branch}</replaceable></command> @@ -2190,7 +2190,7 @@ ssh_cmd="/usr/local/bin/ssh" <para>Tell <filename>qmanager</filename> about the node. Example: </para> - <para><command>python /var/portbuild/evil/qmanager/qclient add + <para><command>python <replaceable>path</replaceable>/qmanager/qclient add name=<replaceable>uniquename</replaceable> arch=<replaceable>arch</replaceable> osversion=<replaceable>osversion</replaceable> @@ -2451,6 +2451,11 @@ dopackages</command> without <literal>-n <sect1 id="new-arch"> <title>How to configure a new architecture</title> + <note> + <para>The initial steps need to be done using + <application>sudo</application>.</para> + </note> + <itemizedlist> <listitem> <para>Create a new @@ -2459,7 +2464,7 @@ dopackages</command> without <literal>-n </listitem> <listitem> - <screen>mkdir /var/portbuild/<replaceable>arch</replaceable>; cd /var/portbuild/<replaceable>arch</replaceable></screen> + <screen>mkdir /var/portbuild/<replaceable>arch</replaceable></screen> </listitem> <listitem> @@ -2469,6 +2474,17 @@ dopackages</command> without <literal>-n </listitem> <listitem> + <screen> +chown ports-<replaceable>arch</replaceable>:portmgr /var/portbuild/<replaceable>arch</replaceable>; +chmod 755 /var/portbuild/<replaceable>arch</replaceable>; +cd /var/portbuild/<replaceable>arch</replaceable></screen> + </listitem> + + <listitem> + <para>Create and populate the <filename>.ssh</filename> directory.</para> + </listitem> + + <listitem> <para>Create a directory for buildlogs and errorlogs: <screen>mkdir /dumpster/pointyhat/<replaceable>arch</replaceable>/archive</screen> </para> @@ -2488,7 +2504,14 @@ dopackages</command> without <literal>-n <screen>ln -s /dumpster/pointyhat/<replaceable>arch</replaceable>/archive archive</screen> </para> </listitem> + </itemizedlist> + <note> + <para>The next steps are most easily done as user + <literal>ports-<replaceable>arch</replaceable></literal>.</para> + </note> + + <itemizedlist> <listitem> <para>In the <filename>/var/portbuild/<replaceable>arch</replaceable></filename> @@ -2518,7 +2541,7 @@ dopackages</command> without <literal>-n </listitem> <listitem> - <para>Create + <para>(Only necessary for old codebase) Create <filename>pnohang.<replaceable>arch</replaceable></filename>. (The easiest way may be to do the following on a client, and then copy it back): @@ -2556,10 +2579,22 @@ dopackages</command> without <literal>-n <para>In that directory: create any <filename>dotunnel.*</filename> scripts needed.</para> </listitem> + </itemizedlist> + + <note> + <para>Once again using <application>sudo</application>:</para> + </note> + <itemizedlist> <listitem> <para>Tell <application>qmanager</application> about the arch: - <screen>python /var/portbuild/evil/qmanager/qclient add_acl name=ports-<replaceable>arch</replaceable> uidlist=ports-<replaceable>arch</replaceable> gidlist=portmgr sense=1</screen></para> + <screen>python <replaceable>path</replaceable>/qmanager/qclient add_acl name=ports-<replaceable>arch</replaceable> uidlist=ports-<replaceable>arch</replaceable> gidlist=portmgr sense=1</screen></para> + </listitem> + + <listitem> + <para>(Only necessary for new codebase): + Add <replaceable>arch</replaceable> to <makevar>SUPPORTED_ARCHS</makevar> in + <filename>/var/portbuild/<replaceable>arch</replaceable>/server.conf</filename>.</para> </listitem> <listitem> @@ -2594,7 +2629,14 @@ ln -s ../<replaceable>arch</replaceable> ln -s ../<replaceable>arch</replaceable>/archive/buildlogs <replaceable>arch</replaceable>-buildlogs ln -s ../<replaceable>arch</replaceable>/archive/errorlogs <replaceable>arch</replaceable>-errorlogs</screen> </listitem> + </itemizedlist> + + <note> + <para>Again, as + <literal>ports-<replaceable>arch</replaceable></literal>:</para> + </note> + <itemizedlist> <listitem> <para>For each branch that will be supported, do the following: </para> @@ -2612,7 +2654,13 @@ ln -s ../<replaceable>arch</replaceable> </itemizedlist> </listitem> + </itemizedlist> + + <note> + <para>One last time using <application>sudo</application>:</para> + </note> + <itemizedlist> <listitem> <para>(Only necessary for old codebase): Only after the first time a @@ -2736,32 +2784,36 @@ kern.maxfiles=40000</screen> <procedure> <step> - <para>The following ports are required:<screen> -archivers/xz -archivers/unzip + <para>The following ports (or their latest successors) are required:<screen> databases/py-pysqlite23 databases/py-sqlalchemy devel/git (WITH_SVN) devel/py-configobj devel/py-setuptools -devel/subversion-freebsd -mail/postfix +devel/subversion net/nc net/rsync -security/sudo sysutils/ganglia-monitor-core (with GMETAD off) sysutils/ganglia-webfrontend (WITHOUT_X11) www/apache22 (with EXT_FILTER and THREADS)</screen> </para> - <para>The following ports are suggested:<screen> + <para>Expect those to bring in:<screen> +databases/sqlite3 +lang/perl-5.12 +lang/python27</screen> + </para> + + <para>The following ports (or their latest successors) are strongly suggested:<screen> benchmarks/bonnie++ devel/ccache +mail/postfix net/isc-dhcp41-server ports-mgmt/pkg_cutleaves ports-mgmt/pkg_tree ports-mgmt/portaudit ports-mgmt/portmaster +security/sudo shells/bash shells/zsh sysutils/screen @@ -2769,6 +2821,10 @@ sysutils/smartmontools</screen> </para> </step> + <step> + <para>Configure mail by doing the following: TBA. + </para> + </step> </procedure> </sect2>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201206130241.q5D2fAQv090150>