forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r321266 - in /forrest/trunk/site-author/content/xdocs: site.xml zone.xml
Date Sat, 15 Oct 2005 00:38:56 GMT
Author: crossley
Date: Fri Oct 14 17:38:50 2005
New Revision: 321266

URL: http://svn.apache.org/viewcvs?rev=321266&view=rev
Log:
Notes for committers to manage forrest.zones.apache.org

Added:
    forrest/trunk/site-author/content/xdocs/zone.xml   (with props)
Modified:
    forrest/trunk/site-author/content/xdocs/site.xml

Modified: forrest/trunk/site-author/content/xdocs/site.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/site.xml?rev=321266&r1=321265&r2=321266&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Fri Oct 14 17:38:50 2005
@@ -46,6 +46,7 @@
     <guidelines label="Project guidelines" href="guidelines.html"/>
     <committed label="Being committed" href="committed.html"/>
     <forrest-tuesday label="ForrestTuesday" description="ForrestTuesday monthly get-together"
href="forrest-tuesday.html"/>
+    <zone label="Zone notes" description="Notes for committers to manage forrest.zones.apache.org"
href="zone.html"/>
     <plan label="Planning notes" href="plan/">
       <overview label="Overview" href="index.html"/>
       <internal-xhtml label="Internal XHTML" href="internal-xhtml.html"/>
@@ -99,6 +100,8 @@
          </versions>
       </docs>
     </forrest>
+    <forrest-zone href="http://forrest.zones.apache.org/">
+    </forrest-zone>
     
     <java href="http://java.sun.com/">
       <j2ee href="j2ee/">

Added: forrest/trunk/site-author/content/xdocs/zone.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/zone.xml?rev=321266&view=auto
==============================================================================
--- forrest/trunk/site-author/content/xdocs/zone.xml (added)
+++ forrest/trunk/site-author/content/xdocs/zone.xml Fri Oct 14 17:38:50 2005
@@ -0,0 +1,186 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Copyright 2002-2005 The Apache Software Foundation or its licensors,
+  as applicable.
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd">
+<document>
+  <header>
+    <title>Notes for forrest.zones.apache.org</title>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Overview</title>
+      <p>
+        The server
+        <a href="ext:forrest-zone">forrest.zones.apache.org</a>
+        provides our testing and demonstration area.
+        It is managed by Apache Forrest committers.
+      </p>
+    </section>
+
+    <section id="configuration">
+      <title>Configuration</title>
+      <p>
+        Configuration files and directory structures are stored in SVN at
+        <code>https://svn.apache.org/repos/asf/forrest/zone</code>
+      </p>
+
+      <p>
+        <strong>config</strong>
+      </p>
+<!-- FIXME: create better layout for notes, just dumping text inside source elements for
now. -->
+<source>
+creates /export/home/config ... $CONFIG
+directories /forrestbot-*/ are the forrestbot homes, see below.
+setenv*.sh ... these are sourced by the forrestbots and other
+  cronjobs and user configs, to set the environment.
+</source>
+
+      <p>
+        <strong>htdocs</strong>
+      </p>
+<source>
+creates /var/apache2/htdocs ... $DOC_ROOT
+directories /ft/ and /fts/ are the forrestbot config and results, see below.
+</source>
+
+      <p>
+        Files here are owned in the group "other" so any one of us can
+        edit/update. Make sure that your 'umask' is set properly so that
+        new files have group write permissions. FIXME: Add a proper group.
+      </p>
+      <p>
+        Cron runs the various Forrestbots and management tasks, such as
+        updating the forrest-trunk software; cleaning up old logfiles, etc.
+        FIXME: These are not yet managed under SVN, see ~crossley/my-crontab.txt
+      </p>
+    </section>
+
+    <section id="software">
+      <title>Software</title>
+        <p>
+          Global zone software is as described in
+          <a href="http://www.apache.org/dev/solaris-zones.html">zone administration</a>.
+        </p>
+        <p>
+          Various local software is installed in
+          <code>/export/opt/</code> (not managed with SVN) ...
+        </p>
+
+      <section id="s-forrest">
+        <title>Forrest</title>
+
+        <p>
+          <strong>forrest-trunk</strong>
+        </p>
+<source>
+svn checkout of trunk.
+automatically 'svn update' and 'build' via cron: $CONFIG/update-forrest-trunk.sh
+</source>
+
+        <p>
+          <strong>forrest-trunk-stable</strong>
+        </p>
+<source>
+svn checkout of trunk, manually updated as needed.
+</source>
+
+        <p>
+          <strong>forrest-release</strong>
+        </p>
+<source>
+svn checkout of current release branch, manually updated as needed.
+FIXME: Not yet done.
+</source>
+
+        <p>
+          To manually update -stable or -release do this:
+        </p>
+        <source><![CDATA[
+source $CONFIG/setenv-java-14.sh
+cd /export/opt/forrest-trunk-stable
+svn up
+cd main
+./build.sh clean; ./build.sh
+]]></source>
+      </section>
+    </section>
+
+    <section id="fb">
+      <title>The forrestbots</title>
+      <p>
+        There are various forrestbots operating with different versions
+        of forrest.
+        Their home is at $CONFIG
+      </p>
+
+      <p>
+        <strong>$CONFIG/forrestbot-trunk</strong>
+      </p>
+<source>
+forrestbot operating with trunk.
+builds various sites automatically, triggered via cron.
+Configuration files and the generated results are at $DOC_ROOT/ft/
+FIXME: The web interface is coming soon.
+</source>
+
+      <p>
+        <strong>$CONFIG/forrestbot-trunk-stable</strong>
+      </p>
+<source>
+forrestbot operating with trunk-stable.
+builds various sites, only runs when needed, triggered via cron.
+Configuration files and the generated results are at $DOC_ROOT/fts/
+</source>
+
+      <p>
+        Forrestbot logs are at
+        $CONFIG/forrestbot-trunk*/logs/
+        and old ones are cleaned up by the crontab.
+      </p>
+    </section>
+
+    <section id="admin">
+      <title>Administration</title>
+      <p>
+        See the general notes for the
+        <a href="http://www.apache.org/dev/solaris-zones.html">zone administration</a>.
+      </p>
+      <p>
+        The project chair is the root user.
+        Committers can ask on the dev list to get a user account. 
+      </p>
+      <p>
+        Follow Leo's config ideas at
+        <a href="http://wiki.apache.org/gump/GumpZonesConfig">GumpZonesConfig</a>.
+      </p>
+      <p>
+        Also keep an occasional eye on
+        $CONFIG/update-forrest-trunk.log
+        This is the output of the cronjob to do svn update to trunk
+        and re-build.
+      </p>
+      <p>
+        FIXME:
+        Start apache2 on boot (using new Solaris init.d replacement called smf).
+        At the moment we need to realise that it is down and manually
+        restart as per http://www.apache.org/dev/solaris-zones.html
+        Also it seems that /var/run/apache2 is wiped out on reboot,
+        so need to mkdir again.
+      </p>
+    </section>
+  </body>
+</document>

Propchange: forrest/trunk/site-author/content/xdocs/zone.xml
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message