svn commit: r39040 - head/en_US.ISO8859-1/articles/portbuild

[Mark Linimon]

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>