From owner-svn-doc-head@FreeBSD.ORG Sun Nov 18 15:09:05 2012 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id E4D62D78; Sun, 18 Nov 2012 15:09:04 +0000 (UTC) (envelope-from linimon@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id C9D638FC08; Sun, 18 Nov 2012 15:09:04 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id qAIF94JA050286; Sun, 18 Nov 2012 15:09:04 GMT (envelope-from linimon@svn.freebsd.org) Received: (from linimon@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id qAIF94NV050285; Sun, 18 Nov 2012 15:09:04 GMT (envelope-from linimon@svn.freebsd.org) Message-Id: <201211181509.qAIF94NV050285@svn.freebsd.org> From: Mark Linimon Date: Sun, 18 Nov 2012 15:09:04 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 18 Nov 2012 15:09:05 -0000 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" How to configure a new &os; branch + + Steps necessary before <application>qmanager</application> is started + + + When a new branch is created, some work needs to be done to specify that the previous branch is no longer - equivalent to HEAD. The following - instructions apply to the previous - branch number: + equivalent to HEAD. @@ -2323,16 +2326,44 @@ ln -s ../arch - - Kick-start the build for the branch with - build create arch branch - + + + + + + + Steps necessary after <application>qmanager</application> is started + + + + + Again, as + ports-arch: + + - Create bindist.tar - . + For each branch that will be supported, do the following: + + + + + Kick-start the build for the branch with + build create arch branch + + + + Create + bindist.tar. + + + + + + + @@ -2462,6 +2493,11 @@ dopackages without -n How to configure a new architecture + + Steps necessary before <application>qmanager</application> is started + + + The initial steps need to be done using sudo. @@ -2497,6 +2533,7 @@ cd /var/portbuild/arch Create a directory for buildlogs and errorlogs: + (XXX MCL specific to pointyhat; fix this!) mkdir /dumpster/pointyhat/arch/archive @@ -2512,6 +2549,7 @@ cd /var/portbuild/arch Create a link to the above for the webserver: + (XXX MCL specific to pointyhat; fix this!) ln -s /dumpster/pointyhat/arch/archive archive @@ -2581,7 +2619,7 @@ cd /var/portbuild/arch - Make the private configuration directory: + If needed, make the private configuration directory: mkdir /var/portbuild/conf/arch @@ -2598,11 +2636,6 @@ cd /var/portbuild/arch - Tell qmanager about the arch: - python path/qmanager/qclient add_acl name=ports-arch uidlist=ports-arch gidlist=portmgr sense=1 - - - (Only necessary for new codebase): Add arch to SUPPORTED_ARCHS in /var/portbuild/arch/server.conf. @@ -2643,6 +2676,37 @@ ln -s ../arch + One last time using sudo: + + + + + Add an appropriate arch entry for + /var/portbuild/scripts/dologs to the root + crontab. (This is a hack and should go away.) + + + + + + + + Steps necessary after <application>qmanager</application> is started + + + + + Again using sudo: + + + + + Tell qmanager about the arch: + python path/qmanager/qclient add_acl name=ports-arch uidlist=ports-arch gidlist=portmgr sense=1 + + + + Again, as ports-arch: @@ -2679,19 +2743,20 @@ ln -s ../arch arch: add the arch to /var/portbuild/scripts/dopackagestats. - - - Add an appropriate arch entry for - /var/portbuild/scripts/dologs to the root - crontab. (This is a hack and should go away.) - - + + + + + How to configure a new head node (pointyhat instance) + This section only applies to the new codebase. New installations + using the old codebase are not supported. + This section is in progress. Please talk to Mark Linimon before making any changes.