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

Clarify the section on testing and enabling a package building node.

Browse source
This commit is contained in:
Mark Linimon 2009-07-18 18:56:54 +00:00
parent 1b9038492d
commit 4a5a82d903
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=34543
1 changed files with 65 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -1659,20 +1659,12 @@ touch /tmp/.boot_finished</screen>
directories:
<screen><userinput>squid -z</userinput></screen></para>
</step>
<step>
<para>Test each of the TCP ports by executing
<command>telnet <replaceable>hostname</replaceable> <replaceable>portnumber</replaceable></command>.
<literal>414</literal> (or its tunnel) should give you a few lines of status
information; <literal>8649</literal> should give you an
<literal>XML</literal> response.</para>
</step>
</procedure>
</sect2>
<sect2 id="node-enabling">
<title>Enabling the node</title>
<sect2 id="pointyhat-configuration">
<title>Configuration on <literal>pointyhat</literal></title>
<para>These steps need to be taken by a <literal>portmgr</literal>
acting as <literal>root</literal> on <hostid>pointyhat</hostid>.
@ -1694,13 +1686,6 @@ touch /tmp/.boot_finished</screen>
information.</para>
</step>
<step>
<para>Test each of the TCP ports by executing
<command>telnet <replaceable>hostname</replaceable> <replaceable>portnumber</replaceable></command>,
where <literal>portnumber</literal> is either the native
portnumber or its tunnelled equivalent.</para>
</step>
<step>
<para>Add the public IP address to
<filename>/etc/hosts.allow</filename>. (Remember, multiple
@ -1763,13 +1748,74 @@ ssh_cmd="/usr/local/bin/ssh"
</step>
<step>
<para>Add an appropriate entry to
<filename>/usr/local/etc/gmetad.conf</filename>.</para>
<para>Add an appropriate <literal>data_source</literal> entry to
<filename>/usr/local/etc/gmetad.conf</filename>:</para>
<para>
<literal>data_source "<replaceable>arch</replaceable>/<replaceable>location</replaceable> Package Build Cluster" 30 <replaceable>hostname</replaceable></literal>
</para>
</step>
</procedure>
</sect2>
<sect2 id="node-enabling">
<title>Enabling the node</title>
<para>These steps need to be taken by a <literal>portmgr</literal>
acting as <literal>ports-<replaceable>arch</replaceable></literal>
on <hostid>pointyhat</hostid>.
</para>
<procedure>
<step>
<para>Ensure that <literal>ssh</literal> is working by executing
<command>ssh <replaceable>hostname</replaceable></command>.
</para>
</step>
<step>
<para>Populate <filename>/var/portbuild/scripts/</filename>
by something like
<command>/var/portbuild/dosetupnode <replaceable>arch</replaceable> <replaceable>major</replaceable> <replaceable>latest</replaceable> <replaceable>hostname</replaceable></command>.
Verify that you now have files in that directory.
</para>
</step>
<step>
<para>Test the other TCP ports by executing
<command>telnet <replaceable>hostname</replaceable> <replaceable>portnumber</replaceable></command>.
<literal>414</literal> (or its tunnel) should give you a few lines of status
information including <literal>arch</literal> and
<literal>osversion</literal>; <literal>8649</literal> should
give you an <literal>XML</literal> response from
<literal>ganglia</literal>.</para>
</step>
</procedure>
<para>This step needs to be taken by a <literal>portmgr</literal>
acting as <literal>root</literal> on <hostid>pointyhat</hostid>.
</para>
<procedure>
<step>
<para>Tell <filename>qmanager</filename> about the node. Example:
</para>
<para><command>python /var/portbuild/evil/qmanager/qclient add
name=<replaceable>uniquename</replaceable>
arch=<replaceable>arch</replaceable>
osversion=<replaceable>osversion</replaceable>
numcpus=<replaceable>number</replaceable>
haszfs=0
online=1
domain=<replaceable>domain</replaceable>
primarypool=package
pools="package all" maxjobs=1
acl="ports-<replaceable>arch</replaceable>,deny_all"
</command></para>
</step>
</procedure>
</sect1>
<sect1 id="disk-failure">