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

Add text explaining what is actually in bindist-<hostname>.tar, and why.

Browse source 
Split some instruction into "as ports-<arch>" and "as root".  Fix the
bogus use of replaceable around "latest".
This commit is contained in:
Mark Linimon 2011-01-23 04:07:34 +00:00
parent 5d785a72b2
commit 5577365f06
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=36824
1 changed files with 39 additions and 13 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -22,6 +22,7 @@
<year>2008</year>
<year>2009</year>
<year>2010</year>
<year>2011</year>
<holder role="mailto:portmgr@FreeBSD.org">The &os; Ports
Management Team</holder>
</copyright>
@ -1840,14 +1841,15 @@ touch /tmp/.boot_finished</screen>
<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>.
acting as <literal>ports-<replaceable>${arch}</replaceable></literal>
on <hostid>pointyhat</hostid>.
</para>
<procedure>
<step>
<para>If any of the default TCP ports is not available (see
above), you will need to create an <command>ssh</command>
tunnel for it and include it in the appropriate
tunnel for it and include it in the
<filename>crontab</filename>.</para>
</step>
@ -1859,12 +1861,6 @@ touch /tmp/.boot_finished</screen>
information.</para>
</step>
<step>
<para>Add the public IP address to
<filename>/etc/hosts.allow</filename>. (Remember, multiple
machines can be on the same IP address.)</para>
</step>
<step>
<para>Create
<filename>/var/portbuild/<replaceable>${arch}</replaceable>/clients/bindist-<replaceable>${hostname}</replaceable>.tar</filename>.
@ -1876,8 +1872,24 @@ touch /tmp/.boot_finished</screen>
in a temporary directory.</para>
</listitem>
<listitem>
<para>Customize <filename>etc/resolv.conf</filename> and
<filename>etc/make.conf</filename> for the local site.</para>
<para>Customize <filename>etc/resolv.conf</filename>
for the local site.</para>
</listitem>
<listitem>
<para>Customize <filename>etc/make.conf</filename> for
FTP fetches for the local site. Note: the nulling-out
of <makevar>MASTER_SITE_BACKUP</makevar> must be common
to all nodes, but the first entry in
<makevar>MASTER_SITE_OVERRIDE</makevar> should be the
nearest local FTP mirror. Example:<screen><command>
.if defined(FETCH_ORIGINAL)
MASTER_SITE_BACKUP=
.else
MASTER_SITE_OVERRIDE= \
ftp://<replaceable>friendly-local-ftp-mirror</replaceable>/pub/FreeBSD/ports/distfiles/${DIST_SUBDIR}/ \
ftp://${BACKUP_FTP_SITE}/pub/FreeBSD/distfiles/${DIST_SUBDIR}/
.endif</command></screen>
</para>
</listitem>
<listitem>
<para><command>tar</command> it up and move it to the right
@ -1886,8 +1898,10 @@ touch /tmp/.boot_finished</screen>
</itemizedlist>
<para>Hint: you will need one of these for each machine;
however, if you have multiple machines at one site, you may
be able to create a site-specific one and symlink to it.</para>
however, if you have multiple machines at one site, you
should create a site-specific one (e.g. in
<filename>/var/portbuild/conf/clients/</filename>)
and symlink to it.</para>
</step>
<step>
@ -1919,6 +1933,18 @@ ssh_cmd="/usr/local/bin/ssh"
</screen>
</para>
</step>
</procedure>
<para>These steps need to be taken by a <literal>portmgr</literal>
acting as <literal>root</literal> on <hostid>pointyhat</hostid>.
</para>
<procedure>
<step>
<para>Add the public IP address to
<filename>/etc/hosts.allow</filename>. (Remember, multiple
machines can be on the same IP address.)</para>
</step>
<step>
<para>Add an appropriate <literal>data_source</literal> entry to
@ -1952,7 +1978,7 @@ ssh_cmd="/usr/local/bin/ssh"
<step>
<para>Populate <filename>/var/portbuild/scripts/</filename>
by something like
<command>/var/portbuild/scripts/dosetupnode <replaceable>arch</replaceable> <replaceable>major</replaceable> <replaceable>latest</replaceable> <replaceable>hostname</replaceable></command>.
<command>/var/portbuild/scripts/dosetupnode <replaceable>arch</replaceable> <replaceable>major</replaceable> latest <replaceable>hostname</replaceable></command>.
Verify that you now have files in that directory.
</para>
</step>