From 46eee08f22263619843a83e21929f82a10ac0604 Mon Sep 17 00:00:00 2001
From: Mark Linimon <linimon@FreeBSD.org>
Date: Sat, 7 Jan 2012 00:15:52 +0000
Subject: [PATCH] Start adding notes about "setting up a new head node".

---
 .../articles/portbuild/article.sgml           | 109 +++++++++++++++++-
 1 file changed, 106 insertions(+), 3 deletions(-)

diff --git a/en_US.ISO8859-1/articles/portbuild/article.sgml b/en_US.ISO8859-1/articles/portbuild/article.sgml
index 6af8c3966e..eb91fb7987 100644
--- a/en_US.ISO8859-1/articles/portbuild/article.sgml
+++ b/en_US.ISO8859-1/articles/portbuild/article.sgml
@@ -2523,15 +2523,105 @@ ln -s ../<replaceable>arch</replaceable>/archive/errorlogs <replaceable>arch</re
 
     <para>This section is in progress.</para>
 
+    <para>Please talk to Mark Linimon before making any changes.</para>
+
+    <sect2 id="pointyhat-basics">
+      <title>Basic installation</title>
+
+      <procedure>
+
+	<step>
+	  <para>Install FreeBSD.</para>
+	</step>
+
+	<step>
+	  <para>For each supported arch, add a
+	    <literal>ports-<replaceable>${arch}</replaceable></literal>
+	    user and group.  Add them to the <literal>wheel</literal>
+	    group.  They should have the <literal>'*'</literal> password.
+	    Also, similarly, create the <literal>ports</literal> and
+	    <literal>portmgr</literal> users.</para>
+	</step>
+
+	<step>
+	  <para>For each supported arch, create
+	    <filename>/home/ports-<replaceable>${arch}/.ssh/</replaceable></filename>
+	    and populate <filename>authorized_keys</filename>.  </para>
+	</step>
+
+<!-- NOTYET
+	<step>
+	  <para>Also add the following users:<screen>
+squid:*:100:100::0:0:User &:/usr/local/squid:/bin/sh
+ganglia:*:102:102::0:0:User &:/usr/local/ganglia:/bin/sh</screen>
+	  </para>
+	  <para>Add them to <filename>/etc/group</filename> as well.</para>
+	</step>
+-->
+
+	<step>
+	  <para>Create the appropriate files in
+	    <filename>/etc/.ssh/</filename>.</para>
+	</step>
+
+	<step>
+	  <para>Add the following to <filename>/etc/sysctl.conf</filename>:<screen>
+kern.maxfiles=40000</screen>
+	  </para>
+	</step>
+
+	<step>
+	  <para>TBA</para>
+	</step>
+      </procedure>
+
+    </sect2>
+
+    <sect2 id="pointyhat-disk">
+      <title>Configuring the disk</title>
+
+      <procedure>
+
+	<step>
+	  <para>Create a <application>zfs</application> volume named
+	    <filename>a</filename> and mount it on
+	    <filename>/a</filename>.
+	  </para>
+	</step>
+
+	<step>
+	  <para>Create a <application>zfs</application> volume named
+	    <filename>a/portbuild</filename> and mount it on
+	    <filename>/a/portbuild</filename>.
+	  </para>
+	</step>
+
+	<step>
+	  <para><screen>
+# mkdir -p /a/portbuild
+# cd /a/portbuild
+#
+# chmod 775 .
+
+ln -s ../<replaceable>arch</replaceable>/archive/errorlogs <replaceable>arch</replaceable>-errorlogs</screen>
+	  </para>
+	</step>
+
+	<step>
+	  <para>TBA</para>
+	</step>
+
+      </procedure>
+
+    </sect2>
+
     <sect2 id="pointyhat-src">
       <title>Configuring <literal>src</literal></title>
 
       <procedure>
 
 	<step>
-	  <para>Add the following to <filename>etc/sysctl.conf</filename>:<screen>
-kern.maxfiles=40000</screen>
-	  </para>
+	  <para>TBA</para>
 	</step>
 
       </procedure>
@@ -2580,6 +2670,19 @@ sysutils/smartmontools</screen>
 
     </sect2>
 
+    <sect2 id="pointyhat-other">
+      <title>Other</title>
+
+      <procedure>
+
+	<step>
+	  <para>TBA</para>
+	</step>
+
+      </procedure>
+
+    </sect2>
+
   </sect1>
 
   <sect1 id="disk-failure">