Date: Sun, 18 Nov 2012 15:09:04 +0000 (UTC) From: Mark Linimon <linimon@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40067 - head/en_US.ISO8859-1/articles/portbuild Message-ID: <201211181509.qAIF94NV050285@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: linimon Date: Sun Nov 18 15:09:04 2012 New Revision: 40067 URL: http://svnweb.freebsd.org/changeset/doc/40067 Log: Refactor the "new branch" and "new arch" sections into pre- and post- qmanager-startup. This is needed for the rewrite of the "new pointyhat" section that will be committed next. I am aware that this commit breaks whitespace; this is done simply for diff reduction. Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml Modified: head/en_US.ISO8859-1/articles/portbuild/article.xml ============================================================================== --- head/en_US.ISO8859-1/articles/portbuild/article.xml Sun Nov 18 15:03:24 2012 (r40066) +++ head/en_US.ISO8859-1/articles/portbuild/article.xml Sun Nov 18 15:09:04 2012 (r40067) @@ -2220,11 +2220,14 @@ ssh_cmd="/usr/local/bin/ssh" <sect1 id="new-branch"> <title>How to configure a new &os; branch</title> + <sect2 id="new-branch-pre-qmanager"> + <title>Steps necessary before <application>qmanager</application> is started</title> + +<!-- start of whitespace-broken area --> + <para>When a new branch is created, some work needs to be done to specify that the previous branch is no longer - equivalent to <literal>HEAD</literal>. The following - instructions apply to the <emphasis>previous</emphasis> - branch number:</para> + equivalent to <literal>HEAD</literal>.</para> <itemizedlist> <listitem> @@ -2323,16 +2326,44 @@ ln -s ../<replaceable>arch</replaceable> </para> </listitem> - <listitem> - <para>Kick-start the build for the branch with - <screen>build create <replaceable>arch</replaceable> <replaceable>branch</replaceable></screen></para> - </listitem> + </itemizedlist> + +<!-- end of whitespace-broken area --> + </sect2> + + <sect2 id="new-branch-post-qmanager"> + <title>Steps necessary after <application>qmanager</application> is started</title> + +<!-- start of whitespace-broken area --> + + <note> + <para>Again, as + <literal>ports-<replaceable>arch</replaceable></literal>:</para> + </note> + <itemizedlist> <listitem> - <para><link linkend="setup">Create <filename>bindist.tar</filename> - </link>.</para> + <para>For each branch that will be supported, do the following: + </para> + + <itemizedlist> + <listitem> + <para>Kick-start the build for the branch with + <screen>build create <replaceable>arch</replaceable> <replaceable>branch</replaceable></screen> + </listitem> + + <listitem> + <para><link linkend="setup">Create + <filename>bindist.tar</filename></link>.</para> + </listitem> + </itemizedlist> + </listitem> </itemizedlist> + +<!-- end of whitespace-broken area --> + </sect2> + </sect1> <sect1 id="old-branch"> @@ -2462,6 +2493,11 @@ dopackages</command> without <literal>-n <sect1 id="new-arch"> <title>How to configure a new architecture</title> + <sect2 id="new-arch-pre-qmanager"> + <title>Steps necessary before <application>qmanager</application> is started</title> + +<!-- start of whitespace-broken area --> + <note> <para>The initial steps need to be done using <application>sudo</application>.</para> @@ -2497,6 +2533,7 @@ cd /var/portbuild/<replaceable>arch</rep <listitem> <para>Create a directory for buildlogs and errorlogs: + (XXX MCL specific to pointyhat; fix this!) <screen>mkdir /dumpster/pointyhat/<replaceable>arch</replaceable>/archive</screen> </para> @@ -2512,6 +2549,7 @@ cd /var/portbuild/<replaceable>arch</rep <listitem> <para>Create a link to the above for the webserver: + (XXX MCL specific to pointyhat; fix this!) <screen>ln -s /dumpster/pointyhat/<replaceable>arch</replaceable>/archive archive</screen> </para> </listitem> @@ -2581,7 +2619,7 @@ cd /var/portbuild/<replaceable>arch</rep </listitem> <listitem> - <para>Make the private configuration directory: + <para>If needed, make the private configuration directory: <screen>mkdir /var/portbuild/conf/<replaceable>arch</replaceable></screen> </para> </listitem> @@ -2598,11 +2636,6 @@ cd /var/portbuild/<replaceable>arch</rep <itemizedlist> <listitem> - <para>Tell <application>qmanager</application> about the arch: - <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> @@ -2643,6 +2676,37 @@ ln -s ../<replaceable>arch</replaceable> </itemizedlist> <note> + <para>One last time using <application>sudo</application>:</para> + </note> + + <itemizedlist> + <listitem> + <para>Add an appropriate <replaceable>arch</replaceable> entry for + <filename>/var/portbuild/scripts/dologs</filename> to the root + <filename>crontab</filename>. (This is a hack and should go away.) + </para> + </itemizedlist> + +<!-- end of whitespace-broken area --> + </sect2> + + <sect2 id="new-arch-post-qmanager"> + <title>Steps necessary after <application>qmanager</application> is started</title> + +<!-- start of whitespace-broken area --> + + <note> + <para>Again using <application>sudo</application>:</para> + </note> + + <itemizedlist> + <listitem> + <para>Tell <application>qmanager</application> about the arch: + <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> + </itemizedlist> + + <note> <para>Again, as <literal>ports-<replaceable>arch</replaceable></literal>:</para> </note> @@ -2679,19 +2743,20 @@ ln -s ../<replaceable>arch</replaceable> arch: add the arch to <filename>/var/portbuild/scripts/dopackagestats</filename>.</para> </listitem> - - <listitem> - <para>Add an appropriate <replaceable>arch</replaceable> entry for - <filename>/var/portbuild/scripts/dologs</filename> to the root - <filename>crontab</filename>. (This is a hack and should go away.) - </para> - </listitem> </itemizedlist> + +<!-- end of whitespace-broken area --> + + </sect2> + </sect1> <sect1 id="new-head-node"> <title>How to configure a new head node (pointyhat instance)</title> + <para>This section only applies to the new codebase. New installations + using the old codebase are <emphasis>not</emphasis> supported.</para> + <para>This section is in progress.</para> <para>Please talk to Mark Linimon before making any changes.</para>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201211181509.qAIF94NV050285>