os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

- make the "new arch" section reflect reality.

Browse source 
- 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
1 changed files with 70 additions and 14 deletions

84
en_US.ISO8859-1/articles/portbuild/article.sgml
View file

@ -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/53837/compat/linux/proc failed!
<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>-nobuild</literal>.</para>
<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>-nobuild</literal>.</para>
</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>
@ -2468,6 +2473,17 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
</para>
</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>
@ -2488,7 +2504,14 @@ dopackages</command> without <literal>-nobuild</literal>.</para>
<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>-nobuild</literal>.</para>
</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>-nobuild</literal>.</para>
<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>/<replaceable>branch</replaceable>/build
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>/archive/errorlogs <replaceable>arch</re
</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>