- 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.
This commit is contained in:
Mark Linimon 2012-06-13 02:41:10 +00:00
parent 55d1e9eebe
commit d83c486ad3
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=39040

View file

@ -762,7 +762,7 @@ PKG_BIN=/usr/local/sbin/pkg</screen>
package set. This can be accomplished with the following package set. This can be accomplished with the following
invocation:</para> 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> </sect2>
</sect1> </sect1>
@ -1002,8 +1002,8 @@ umount: Cleanup of /x/tmp/8-exp/chroot/53837/compat/linux/proc failed!
<para>You can use <command>qclient</command> command to monitor the status <para>You can use <command>qclient</command> command to monitor the status
of build nodes, and to list the currently scheduled jobs:</para> 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 <replaceable>path</replaceable>/qmanager/qclient jobs</command></para>
<para><command>python /var/portbuild/evil/qmanager/qclient status</command></para> <para><command>python <replaceable>path</replaceable>/qmanager/qclient status</command></para>
<para>The <para>The
<command>scripts/stats <replaceable>${branch}</replaceable></command> <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>Tell <filename>qmanager</filename> about the node. Example:
</para> </para>
<para><command>python /var/portbuild/evil/qmanager/qclient add <para><command>python <replaceable>path</replaceable>/qmanager/qclient add
name=<replaceable>uniquename</replaceable> name=<replaceable>uniquename</replaceable>
arch=<replaceable>arch</replaceable> arch=<replaceable>arch</replaceable>
osversion=<replaceable>osversion</replaceable> osversion=<replaceable>osversion</replaceable>
@ -2451,6 +2451,11 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
<sect1 id="new-arch"> <sect1 id="new-arch">
<title>How to configure a new architecture</title> <title>How to configure a new architecture</title>
<note>
<para>The initial steps need to be done using
<application>sudo</application>.</para>
</note>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para>Create a new <para>Create a new
@ -2459,7 +2464,7 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
</listitem> </listitem>
<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>
<listitem> <listitem>
@ -2468,6 +2473,17 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
</para> </para>
</listitem> </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> <listitem>
<para>Create a directory for buildlogs and errorlogs: <para>Create a directory for buildlogs and errorlogs:
<screen>mkdir /dumpster/pointyhat/<replaceable>arch</replaceable>/archive</screen> <screen>mkdir /dumpster/pointyhat/<replaceable>arch</replaceable>/archive</screen>
@ -2488,7 +2504,14 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
<screen>ln -s /dumpster/pointyhat/<replaceable>arch</replaceable>/archive archive</screen> <screen>ln -s /dumpster/pointyhat/<replaceable>arch</replaceable>/archive archive</screen>
</para> </para>
</listitem> </listitem>
</itemizedlist>
<note>
<para>The next steps are most easily done as user
<literal>ports-<replaceable>arch</replaceable></literal>.</para>
</note>
<itemizedlist>
<listitem> <listitem>
<para>In the <para>In the
<filename>/var/portbuild/<replaceable>arch</replaceable></filename> <filename>/var/portbuild/<replaceable>arch</replaceable></filename>
@ -2518,7 +2541,7 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
</listitem> </listitem>
<listitem> <listitem>
<para>Create <para>(Only necessary for old codebase) Create
<filename>pnohang.<replaceable>arch</replaceable></filename>. <filename>pnohang.<replaceable>arch</replaceable></filename>.
(The easiest way may be to do the following on a client, and (The easiest way may be to do the following on a client, and
then copy it back): then copy it back):
@ -2556,10 +2579,22 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
<para>In that directory: create any <filename>dotunnel.*</filename> <para>In that directory: create any <filename>dotunnel.*</filename>
scripts needed.</para> scripts needed.</para>
</listitem> </listitem>
</itemizedlist>
<note>
<para>Once again using <application>sudo</application>:</para>
</note>
<itemizedlist>
<listitem> <listitem>
<para>Tell <application>qmanager</application> about the arch: <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>
<listitem> <listitem>
@ -2594,7 +2629,14 @@ ln -s ../<replaceable>arch</replaceable>/<replaceable>branch</replaceable>/build
ln -s ../<replaceable>arch</replaceable>/archive/buildlogs <replaceable>arch</replaceable>-buildlogs ln -s ../<replaceable>arch</replaceable>/archive/buildlogs <replaceable>arch</replaceable>-buildlogs
ln -s ../<replaceable>arch</replaceable>/archive/errorlogs <replaceable>arch</replaceable>-errorlogs</screen> ln -s ../<replaceable>arch</replaceable>/archive/errorlogs <replaceable>arch</replaceable>-errorlogs</screen>
</listitem> </listitem>
</itemizedlist>
<note>
<para>Again, as
<literal>ports-<replaceable>arch</replaceable></literal>:</para>
</note>
<itemizedlist>
<listitem> <listitem>
<para>For each branch that will be supported, do the following: <para>For each branch that will be supported, do the following:
</para> </para>
@ -2612,7 +2654,13 @@ ln -s ../<replaceable>arch</replaceable>/archive/errorlogs <replaceable>arch</re
</itemizedlist> </itemizedlist>
</listitem> </listitem>
</itemizedlist>
<note>
<para>One last time using <application>sudo</application>:</para>
</note>
<itemizedlist>
<listitem> <listitem>
<para>(Only necessary for old codebase): <para>(Only necessary for old codebase):
Only after the first time a Only after the first time a
@ -2736,32 +2784,36 @@ kern.maxfiles=40000</screen>
<procedure> <procedure>
<step> <step>
<para>The following ports are required:<screen> <para>The following ports (or their latest successors) are required:<screen>
archivers/xz
archivers/unzip
databases/py-pysqlite23 databases/py-pysqlite23
databases/py-sqlalchemy databases/py-sqlalchemy
devel/git (WITH_SVN) devel/git (WITH_SVN)
devel/py-configobj devel/py-configobj
devel/py-setuptools devel/py-setuptools
devel/subversion-freebsd devel/subversion
mail/postfix
net/nc net/nc
net/rsync net/rsync
security/sudo
sysutils/ganglia-monitor-core (with GMETAD off) sysutils/ganglia-monitor-core (with GMETAD off)
sysutils/ganglia-webfrontend (WITHOUT_X11) sysutils/ganglia-webfrontend (WITHOUT_X11)
www/apache22 (with EXT_FILTER and THREADS)</screen> www/apache22 (with EXT_FILTER and THREADS)</screen>
</para> </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++ benchmarks/bonnie++
devel/ccache devel/ccache
mail/postfix
net/isc-dhcp41-server net/isc-dhcp41-server
ports-mgmt/pkg_cutleaves ports-mgmt/pkg_cutleaves
ports-mgmt/pkg_tree ports-mgmt/pkg_tree
ports-mgmt/portaudit ports-mgmt/portaudit
ports-mgmt/portmaster ports-mgmt/portmaster
security/sudo
shells/bash shells/bash
shells/zsh shells/zsh
sysutils/screen sysutils/screen
@ -2769,6 +2821,10 @@ sysutils/smartmontools</screen>
</para> </para>
</step> </step>
<step>
<para>Configure mail by doing the following: TBA.
</para>
</step>
</procedure> </procedure>
</sect2> </sect2>