continuum-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From br...@apache.org
Subject svn commit: r1426423 [2/15] - in /continuum/site-publish/docs/latest: ./ administrator_guides/ administrator_guides/security/ css/ developer_guides/ images/ installation/ user_guides/ user_guides/building_project/ user_guides/cancelling_build/ user_gui...
Date Fri, 28 Dec 2012 07:10:14 GMT
Modified: continuum/site-publish/docs/latest/administrator_guides/builddefTemplate.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/builddefTemplate.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/builddefTemplate.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/builddefTemplate.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     </style>
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
           <meta name="author" content="Emmanuel Venisse" />
-        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
                                                     
 <script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
@@ -33,7 +33,7 @@ pageTracker._trackPageview();</script>
     <div id="banner">
                   <a href="../../" id="bannerLeft">
     
-                                            <img src="../../../images/continuum_logo_75.gif" alt="" />
+                                            <img src="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/images/continuum_logo_75.gif" alt="" />
     
             </a>
                         <a href="http://www.apache.org/" id="bannerRight">
@@ -59,10 +59,13 @@ pageTracker._trackPageview();</script>
                 <a href="http://www.apache.org/" class="externalLink">Apache</a>
                 &gt;
       
-                <a href="../../../">Continuum</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum</a>
                 &gt;
       
-                <a href="../">1.4.0</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum :: Project</a>
+                &gt;
+      
+                <a href="../">1.4.1-SNAPSHOT</a>
                   </div>
             <div class="xright">      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -92,15 +95,15 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../index.html">Home</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/index.html">Home</a>
           </li>
               
     <li class="none">
-                    <a href="../../../download.html">Download</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/download.html">Download</a>
           </li>
               
     <li class="none">
-                    <a href="../../../change-log.html">Change Log</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/change-log.html">Change Log</a>
           </li>
               
     <li class="none">
@@ -108,11 +111,11 @@ pageTracker._trackPageview();</script>
           </li>
               
     <li class="none">
-                    <a href="../../../articles.html">Articles</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/articles.html">Articles</a>
           </li>
               
     <li class="none">
-                    <a href="../../../features.html">Features</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/features.html">Features</a>
           </li>
               
     <li class="none">
@@ -139,8 +142,6 @@ pageTracker._trackPageview();</script>
       
             
       
-                  
-      
             
       
               
@@ -195,7 +196,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -243,8 +246,6 @@ pageTracker._trackPageview();</script>
       
             
       
-            
-      
                   
       
             
@@ -273,11 +274,7 @@ pageTracker._trackPageview();</script>
           </li>
                   
     <li class="none">
-                    <a href="../administrator_guides/builder.html">Managing Builders</a>
-          </li>
-                  
-    <li class="none">
-                    <a href="../administrator_guides/jdk.html">Managing JDKs</a>
+                    <a href="../administrator_guides/builder.html">Managing Installations</a>
           </li>
                   
     <li class="none">
@@ -376,54 +373,54 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../community.html">Community Overview</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/community.html">Community Overview</a>
           </li>
               
     <li class="none">
-                    <a href="../../../guide-helping.html">How to Contribute</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/guide-helping.html">How to Contribute</a>
           </li>
               
     <li class="none">
-                    <a href="../../../getting-help.html">Getting Help</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/getting-help.html">Getting Help</a>
           </li>
               
     <li class="none">
-                    <a href="../../../issue-tracking.html">Issue Tracking</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/issue-tracking.html">Issue Tracking</a>
           </li>
               
     <li class="none">
-                    <a href="../../../team-list.html">The Continuum Team</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/team-list.html">The Continuum Team</a>
           </li>
               
     <li class="none">
-                    <a href="../../../mail-lists.html">Mailing Lists</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/mail-lists.html">Mailing Lists</a>
           </li>
               
     <li class="none">
-                    <a href="../../../source-repository.html">Source Repository</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/source-repository.html">Source Repository</a>
           </li>
               
     <li class="none">
-                    <a href="../../../license.html">License</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/license.html">License</a>
           </li>
           </ul>
               <h5>Continuum Development</h5>
             <ul>
               
     <li class="none">
-                    <a href="../../../development/building.html">Build Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/building.html">Build Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/debugging.html">Debugging Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/debugging.html">Debugging Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/guide-continuum-development.html">Development Convention</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/guide-continuum-development.html">Development Convention</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/release.html">Release Procedure</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/release.html">Release Procedure</a>
           </li>
           </ul>
               <h5>Project Documentation</h5>
@@ -478,12 +475,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Build Definition Template</h2>
-<p>From the menu, choose the 'Build Definition Templates' entry</p>
-<img src="../images/builddefinition-templates.png" alt="Build Definition Templates" /><p>You will see all build definition templates and the build definitions which can be added in templates. In this screen you can add/edit/update/delete a build definition (<b>the Continuum defaults can be deleted</b>)</p>
-<img src="../images/builddefinition-templates-list.png" alt="Build Definition Templates" /><p>In the build definition template edit screen, you can easily one or more build definitions.</p>
-<img src="../images/builddefinition-template-edit.png" alt="Build Definition Template Edit " /></div>
-
+        <div class="section"><h2>Build Definition Template<a name="Build_Definition_Template"></a></h2><p>From the menu, choose the 'Build Definition Templates' entry</p><img src="../images/builddefinition-templates.png" alt="Build Definition Templates" /><p>You will see all build definition templates and the build definitions which can be added in templates. In this screen you can add/edit/update/delete a build definition (<b>the Continuum defaults can be deleted</b>)</p><img src="../images/builddefinition-templates-list.png" alt="Build Definition Templates" /><p>In the build definition template edit screen, you can easily one or more build definitions.</p><img src="../images/builddefinition-template-edit.png" alt="Build Definition Template Edit " /></div>
       </div>
     </div>
     <div class="clear">
@@ -491,7 +483,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -508,4 +500,4 @@ pageTracker._trackPageview();</script>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/builder.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/builder.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/builder.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/builder.html Fri Dec 28 07:10:12 2012
@@ -12,7 +12,7 @@
 
 <html xmlns="http://www.w3.org/1999/xhtml">
   <head>
-    <title>Apache Continuum - Managing Building Tool</title>
+    <title>Apache Continuum - Managing Installations</title>
     <style type="text/css" media="all">
       @import url("../css/maven-base.css");
       @import url("../css/maven-theme.css");
@@ -20,7 +20,7 @@
     </style>
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
           <meta name="author" content="Olivier Lamy" />
-        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
                                                     
 <script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
@@ -33,7 +33,7 @@ pageTracker._trackPageview();</script>
     <div id="banner">
                   <a href="../../" id="bannerLeft">
     
-                                            <img src="../../../images/continuum_logo_75.gif" alt="" />
+                                            <img src="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/images/continuum_logo_75.gif" alt="" />
     
             </a>
                         <a href="http://www.apache.org/" id="bannerRight">
@@ -59,10 +59,13 @@ pageTracker._trackPageview();</script>
                 <a href="http://www.apache.org/" class="externalLink">Apache</a>
                 &gt;
       
-                <a href="../../../">Continuum</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum</a>
                 &gt;
       
-                <a href="../">1.4.0</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum :: Project</a>
+                &gt;
+      
+                <a href="../">1.4.1-SNAPSHOT</a>
                   </div>
             <div class="xright">      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -92,15 +95,15 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../index.html">Home</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/index.html">Home</a>
           </li>
               
     <li class="none">
-                    <a href="../../../download.html">Download</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/download.html">Download</a>
           </li>
               
     <li class="none">
-                    <a href="../../../change-log.html">Change Log</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/change-log.html">Change Log</a>
           </li>
               
     <li class="none">
@@ -108,11 +111,11 @@ pageTracker._trackPageview();</script>
           </li>
               
     <li class="none">
-                    <a href="../../../articles.html">Articles</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/articles.html">Articles</a>
           </li>
               
     <li class="none">
-                    <a href="../../../features.html">Features</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/features.html">Features</a>
           </li>
               
     <li class="none">
@@ -139,8 +142,6 @@ pageTracker._trackPageview();</script>
       
             
       
-                  
-      
             
       
               
@@ -195,7 +196,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -243,8 +246,6 @@ pageTracker._trackPageview();</script>
       
             
       
-            
-      
                   
       
             
@@ -273,14 +274,10 @@ pageTracker._trackPageview();</script>
           </li>
                   
     <li class="none">
-              <strong>Managing Builders</strong>
+              <strong>Managing Installations</strong>
         </li>
                   
     <li class="none">
-                    <a href="../administrator_guides/jdk.html">Managing JDKs</a>
-          </li>
-                  
-    <li class="none">
                     <a href="../administrator_guides/buildEnvironment.html">Managing Build Environments</a>
           </li>
                   
@@ -376,54 +373,54 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../community.html">Community Overview</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/community.html">Community Overview</a>
           </li>
               
     <li class="none">
-                    <a href="../../../guide-helping.html">How to Contribute</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/guide-helping.html">How to Contribute</a>
           </li>
               
     <li class="none">
-                    <a href="../../../getting-help.html">Getting Help</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/getting-help.html">Getting Help</a>
           </li>
               
     <li class="none">
-                    <a href="../../../issue-tracking.html">Issue Tracking</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/issue-tracking.html">Issue Tracking</a>
           </li>
               
     <li class="none">
-                    <a href="../../../team-list.html">The Continuum Team</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/team-list.html">The Continuum Team</a>
           </li>
               
     <li class="none">
-                    <a href="../../../mail-lists.html">Mailing Lists</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/mail-lists.html">Mailing Lists</a>
           </li>
               
     <li class="none">
-                    <a href="../../../source-repository.html">Source Repository</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/source-repository.html">Source Repository</a>
           </li>
               
     <li class="none">
-                    <a href="../../../license.html">License</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/license.html">License</a>
           </li>
           </ul>
               <h5>Continuum Development</h5>
             <ul>
               
     <li class="none">
-                    <a href="../../../development/building.html">Build Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/building.html">Build Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/debugging.html">Debugging Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/debugging.html">Debugging Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/guide-continuum-development.html">Development Convention</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/guide-continuum-development.html">Development Convention</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/release.html">Release Procedure</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/release.html">Release Procedure</a>
           </li>
           </ul>
               <h5>Project Documentation</h5>
@@ -478,23 +475,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Managing Building Tool</h2>
-<p>From the menu, choose the 'Installations' entry </p>
-<img src="../images/installations.png" alt="Installations" /><p>Here you must choose the Installation Type you want to add (here a Tool)</p>
-<img src="../images/installation-type-choice.png" alt="Installation Type Choice" /><p>You must configure the tool you want to add</p>
-<img src="../images/installation-tool-edit.png" alt="Tool Setup" /><p>You can use the checkbox if you want to add a Profile with the same name as your tool name.</p>
-<p>The value 'Value/Path' field must contains the path to the tool :</p>
-<ul><li>For maven2 : it must be similar to your M2_HOME</li>
-<li>For maven1 : it must be similar to your MAVEN_HOME</li>
-<li>For ant : it must be similar to your ANT_HOME<p>A control will be made to validate the path value :</p>
-</li>
-<li>For maven2 : path/bin/mvn -v will be tested</li>
-<li>For maven1 : path/bin/maven -v will be tested</li>
-<li>For ant : path/bin/ant -v will be tested<p>It the the test, the following error will be displayed </p>
-<img src="../images/installation-validation-failed.png" alt="Installation validation failed " /></li>
-</ul>
-</div>
-
+        <div class="section"><h2>Managing Installations<a name="Managing_Installations"></a></h2><p>Continuum allows you to configure the build tools it uses to build projects by defining <a href="./buildEnvironment.html">Build Environments</a>. Installations allow defining environment settings and are the basic unit of a Build Environment.</p><p>For example, say you need to maintain two build environments. One using JDK 5 and Maven 2.0.9 and another using JDK 6 and Maven 2.1.0-M1. To achieve this, you would need to do the following:</p><ol style="list-style-type: decimal"><li>Create Installations for the versions of Java and Maven.</li><li>Create Installations for any environment variables you want to set such as MAVEN_OPTS and ANT_OPTS.</li><li>Create the desired Build Environments, specifying the combination of Installations to use. </li><li>Assign the Build Environments to your Build Definition Templates or project-specific Build Definitions.</li></ol><div class="section
 "><h3>Installations<a name="Installations"></a></h3><p>Installations are essentially named environment variables. There are currently two types of Installations: Tools and Environment Variables. </p><div class="section"><h4>Tools<a name="Tools"></a></h4><p>Tools are meant to provide locations to pre-defined tool types. Currently, continuum allows you to define locations for the JDK, Maven 2, Maven 1 and Ant. When you create a tool installation, you specify a human-friendly name, the tool type, and the path to tool. Continuum verifies that the specified tool type resides in that location or fails to create the Installation.</p><div class="section"><h5>Example: Defining a Maven2 Installation<a name="Example:_Defining_a_Maven2_Installation"></a></h5><p>From the menu, choose the 'Installations' entry </p><img src="../images/installations.png" alt="Installations" /><p>Here you must choose the Installation Type you want to add (here a Tool)</p><img src="../images/installation-type
 -choice.png" alt="Installation Type Choice" /><p>You must configure the tool you want to add</p><img src="../images/installation-tool-edit.png" alt="Tool Setup" /><p>The value 'Value/Path' field must specify the path to the tool:</p><ul><li>For maven2 : it must be similar to your M2_HOME</li><li>For maven1 : it must be similar to your MAVEN_HOME</li><li>For ant : it must be similar to your ANT_HOME</li></ul><p>Continuum validates the path specified depending on the type of Tool:</p><ul><li>For maven2 : &lt;path&gt;/bin/mvn -v will be tested</li><li>For maven1 : &lt;path&gt;/bin/maven -v will be tested</li><li>For ant : &lt;path&gt;/bin/ant -v will be tested</li></ul><p>If the path you specify fails the test, the following error will be displayed:</p><img src="../images/installation-validation-failed.png" alt="Installation validation failed " /><p>You can use the checkbox if you want to create a Build Environment with the same name as your Tool name. </p></div></div><div clas
 s="section"><h4>Environment Variables<a name="Environment_Variables"></a></h4><p>Environment Variables are simply a means to store environment settings using a human-friendly name. Once defined, they can be used to affect the build tools used to build your projects. They consist of a human-friendly name, the name of the environment variable to set and the value. Unlike Tools, Environment Variables are not constrained by continuum. No validation is performed to validate the values. </p><div class="section"><h5>Example: Defining a Java Heap size Environment Variable for Maven2 Tools<a name="Example:_Defining_a_Java_Heap_size_Environment_Variable_for_Maven2_Tools"></a></h5><p>From the menu, choose the 'Installations' entry</p><img src="../images/installations.png" alt="Installations" /><p>Select the Environment Variable Installation type</p><img src="../images/installation-type-choice-envvar.png" alt="Select env var as tool type" /><p>And finally, specify the human-friendly nam
 e, the environment variable name and the corresponding value. Here we define MAVEN_OPTS that will set the Java heap size to 256 Megabytes.</p><img src="../images/installation-envvar-edit.png" alt="Define the env var name and value" /></div></div></div></div>
       </div>
     </div>
     <div class="clear">
@@ -502,7 +483,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -519,4 +500,4 @@ pageTracker._trackPageview();</script>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/chroot.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/chroot.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/chroot.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/chroot.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     </style>
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
           <meta name="author" content="Carlos Sanchez" />
-        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
                                                     
 <script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
@@ -33,7 +33,7 @@ pageTracker._trackPageview();</script>
     <div id="banner">
                   <a href="../../" id="bannerLeft">
     
-                                            <img src="../../../images/continuum_logo_75.gif" alt="" />
+                                            <img src="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/images/continuum_logo_75.gif" alt="" />
     
             </a>
                         <a href="http://www.apache.org/" id="bannerRight">
@@ -59,10 +59,13 @@ pageTracker._trackPageview();</script>
                 <a href="http://www.apache.org/" class="externalLink">Apache</a>
                 &gt;
       
-                <a href="../../../">Continuum</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum</a>
                 &gt;
       
-                <a href="../">1.4.0</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum :: Project</a>
+                &gt;
+      
+                <a href="../">1.4.1-SNAPSHOT</a>
                   </div>
             <div class="xright">      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -92,15 +95,15 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../index.html">Home</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/index.html">Home</a>
           </li>
               
     <li class="none">
-                    <a href="../../../download.html">Download</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/download.html">Download</a>
           </li>
               
     <li class="none">
-                    <a href="../../../change-log.html">Change Log</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/change-log.html">Change Log</a>
           </li>
               
     <li class="none">
@@ -108,11 +111,11 @@ pageTracker._trackPageview();</script>
           </li>
               
     <li class="none">
-                    <a href="../../../articles.html">Articles</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/articles.html">Articles</a>
           </li>
               
     <li class="none">
-                    <a href="../../../features.html">Features</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/features.html">Features</a>
           </li>
               
     <li class="none">
@@ -139,8 +142,6 @@ pageTracker._trackPageview();</script>
       
             
       
-                  
-      
             
       
               
@@ -195,7 +196,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -243,8 +246,6 @@ pageTracker._trackPageview();</script>
       
             
       
-            
-      
                   
       
             
@@ -276,54 +277,54 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../community.html">Community Overview</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/community.html">Community Overview</a>
           </li>
               
     <li class="none">
-                    <a href="../../../guide-helping.html">How to Contribute</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/guide-helping.html">How to Contribute</a>
           </li>
               
     <li class="none">
-                    <a href="../../../getting-help.html">Getting Help</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/getting-help.html">Getting Help</a>
           </li>
               
     <li class="none">
-                    <a href="../../../issue-tracking.html">Issue Tracking</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/issue-tracking.html">Issue Tracking</a>
           </li>
               
     <li class="none">
-                    <a href="../../../team-list.html">The Continuum Team</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/team-list.html">The Continuum Team</a>
           </li>
               
     <li class="none">
-                    <a href="../../../mail-lists.html">Mailing Lists</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/mail-lists.html">Mailing Lists</a>
           </li>
               
     <li class="none">
-                    <a href="../../../source-repository.html">Source Repository</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/source-repository.html">Source Repository</a>
           </li>
               
     <li class="none">
-                    <a href="../../../license.html">License</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/license.html">License</a>
           </li>
           </ul>
               <h5>Continuum Development</h5>
             <ul>
               
     <li class="none">
-                    <a href="../../../development/building.html">Build Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/building.html">Build Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/debugging.html">Debugging Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/debugging.html">Debugging Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/guide-continuum-development.html">Development Convention</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/guide-continuum-development.html">Development Convention</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/release.html">Release Procedure</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/release.html">Release Procedure</a>
           </li>
           </ul>
               <h5>Project Documentation</h5>
@@ -378,20 +379,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Running builds in chroot jail</h2>
-<p>Feature not yet finished! See <a class="externalLink" href="http://jira.codehaus.org/browse/CONTINUUM-1731">CONTINUUM-1731</a></p>
-<p>You could make continuum run the builds in each project group in a separate chroot jail so they don't interfere with each other for security and stability issues. It requires a fair amount of work to setup the system.</p>
-<p>There are still some security concerns. The user could escape the chroot jail.</p>
-</div>
-<div class="section"><h2>Creating a chroot jail</h2>
-<p>Installed <a class="externalLink" href="http://olivier.sessink.nl/jailkit/jailkit-2.5.tar.bz2">jailkit</a> ( <a class="externalLink" href="http://olivier.sessink.nl/jailkit/howtos_chroot_shell.html">howto</a> )</p>
-<p>Add chroot to /etc/sudoers and comment out requiretty</p>
-<div class="source"><pre> jetty ALL=NOPASSWD:/usr/sbin/chroot</pre>
-</div>
-<p>Add /usr/sbin to the PATH in /home/jetty/.bash_profile</p>
-</div>
-<div class="section"><h2>Create the jail</h2>
-<div class="source"><pre>export JAIL=/home/jail/org.apache.continuum
+        <div class="section"><h2>Running builds in chroot jail<a name="Running_builds_in_chroot_jail"></a></h2><p>Feature not yet finished! See <a class="externalLink" href="http://jira.codehaus.org/browse/CONTINUUM-1731">CONTINUUM-1731</a></p><p>You could make continuum run the builds in each project group in a separate chroot jail so they don't interfere with each other for security and stability issues. It requires a fair amount of work to setup the system.</p><p>There are still some security concerns. The user could escape the chroot jail.</p></div><div class="section"><h2>Creating a chroot jail<a name="Creating_a_chroot_jail"></a></h2><p>Installed <a class="externalLink" href="http://olivier.sessink.nl/jailkit/jailkit-2.5.tar.bz2">jailkit</a> ( <a class="externalLink" href="http://olivier.sessink.nl/jailkit/howtos_chroot_shell.html">howto</a> )</p><p>Add chroot to /etc/sudoers and comment out requiretty</p><div class="source"><pre> jetty ALL=NOPASSWD:/usr/sbin/chroot</p
 re></div><p>Add /usr/sbin to the PATH in /home/jetty/.bash_profile</p></div><div class="section"><h2>Create the jail<a name="Create_the_jail"></a></h2><div class="source"><pre>export JAIL=/home/jail/org.apache.continuum
 jk_init -v -j $JAIL basicshell netbasics
 jk_cp -j $JAIL /bin/uname
 jk_cp -j $JAIL /usr/bin/expr
@@ -430,20 +418,12 @@ sudo /usr/sbin/chroot $JAIL /bin/bash
 # env
 export M2_HOME=/usr/share/apache-maven-2.0.9
 export JAVA_HOME=/usr/java/default
-</pre>
-</div>
-</div>
-<div class="section"><h2>Configuring continuum webapp</h2>
-<p>Uncomment the following lines in WEB-INF/applicationContext.xml</p>
-<div class="source"><pre>  &lt;!-- to run builds in a chroot jail environment
+</pre></div></div><div class="section"><h2>Configuring continuum webapp<a name="Configuring_continuum_webapp"></a></h2><p>Uncomment the following lines in WEB-INF/applicationContext.xml</p><div class="source"><pre>  &lt;!-- to run builds in a chroot jail environment
        note this is not secure yet, see http://jira.codehaus.org/browse/CONTINUUM-1731 
   &lt;bean name=&quot;chrootJailDirectory&quot; class=&quot;java.io.File&quot;&gt;
     &lt;constructor-arg value=&quot;/home/jail&quot;/&gt;
   &lt;/bean&gt;
-  &lt;bean id=&quot;workingDirectoryService&quot; class=&quot;org.apache.maven.continuum.utils.ChrootJailWorkingDirectoryService&quot; autowire=&quot;byName&quot;/&gt;</pre>
-</div>
-</div>
-
+  &lt;bean id=&quot;workingDirectoryService&quot; class=&quot;org.apache.maven.continuum.utils.ChrootJailWorkingDirectoryService&quot; autowire=&quot;byName&quot;/&gt;</pre></div></div>
       </div>
     </div>
     <div class="clear">
@@ -451,7 +431,7 @@ export JAVA_HOME=/usr/java/default
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -468,4 +448,4 @@ export JAVA_HOME=/usr/java/default
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/configuration.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/configuration.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/configuration.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/configuration.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     </style>
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
           <meta name="author" content="Emmanuel Venisse" />
-        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
                                                     
 <script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
@@ -33,7 +33,7 @@ pageTracker._trackPageview();</script>
     <div id="banner">
                   <a href="../../" id="bannerLeft">
     
-                                            <img src="../../../images/continuum_logo_75.gif" alt="" />
+                                            <img src="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/images/continuum_logo_75.gif" alt="" />
     
             </a>
                         <a href="http://www.apache.org/" id="bannerRight">
@@ -59,10 +59,13 @@ pageTracker._trackPageview();</script>
                 <a href="http://www.apache.org/" class="externalLink">Apache</a>
                 &gt;
       
-                <a href="../../../">Continuum</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum</a>
                 &gt;
       
-                <a href="../">1.4.0</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum :: Project</a>
+                &gt;
+      
+                <a href="../">1.4.1-SNAPSHOT</a>
                   </div>
             <div class="xright">      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -92,15 +95,15 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../index.html">Home</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/index.html">Home</a>
           </li>
               
     <li class="none">
-                    <a href="../../../download.html">Download</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/download.html">Download</a>
           </li>
               
     <li class="none">
-                    <a href="../../../change-log.html">Change Log</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/change-log.html">Change Log</a>
           </li>
               
     <li class="none">
@@ -108,11 +111,11 @@ pageTracker._trackPageview();</script>
           </li>
               
     <li class="none">
-                    <a href="../../../articles.html">Articles</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/articles.html">Articles</a>
           </li>
               
     <li class="none">
-                    <a href="../../../features.html">Features</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/features.html">Features</a>
           </li>
               
     <li class="none">
@@ -139,8 +142,6 @@ pageTracker._trackPageview();</script>
       
             
       
-                  
-      
             
       
               
@@ -195,7 +196,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -216,8 +219,6 @@ pageTracker._trackPageview();</script>
             
       
             
-      
-            
             
             
       
@@ -273,11 +274,7 @@ pageTracker._trackPageview();</script>
           </li>
                   
     <li class="none">
-                    <a href="../administrator_guides/builder.html">Managing Builders</a>
-          </li>
-                  
-    <li class="none">
-                    <a href="../administrator_guides/jdk.html">Managing JDKs</a>
+                    <a href="../administrator_guides/builder.html">Managing Installations</a>
           </li>
                   
     <li class="none">
@@ -376,54 +373,54 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../community.html">Community Overview</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/community.html">Community Overview</a>
           </li>
               
     <li class="none">
-                    <a href="../../../guide-helping.html">How to Contribute</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/guide-helping.html">How to Contribute</a>
           </li>
               
     <li class="none">
-                    <a href="../../../getting-help.html">Getting Help</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/getting-help.html">Getting Help</a>
           </li>
               
     <li class="none">
-                    <a href="../../../issue-tracking.html">Issue Tracking</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/issue-tracking.html">Issue Tracking</a>
           </li>
               
     <li class="none">
-                    <a href="../../../team-list.html">The Continuum Team</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/team-list.html">The Continuum Team</a>
           </li>
               
     <li class="none">
-                    <a href="../../../mail-lists.html">Mailing Lists</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/mail-lists.html">Mailing Lists</a>
           </li>
               
     <li class="none">
-                    <a href="../../../source-repository.html">Source Repository</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/source-repository.html">Source Repository</a>
           </li>
               
     <li class="none">
-                    <a href="../../../license.html">License</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/license.html">License</a>
           </li>
           </ul>
               <h5>Continuum Development</h5>
             <ul>
               
     <li class="none">
-                    <a href="../../../development/building.html">Build Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/building.html">Build Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/debugging.html">Debugging Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/debugging.html">Debugging Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/guide-continuum-development.html">Development Convention</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/guide-continuum-development.html">Development Convention</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/release.html">Release Procedure</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/release.html">Release Procedure</a>
           </li>
           </ul>
               <h5>Project Documentation</h5>
@@ -478,41 +475,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Managing General Configuration</h2>
-<p>The first time you start Continuum, you will see the 'General Configuration' page. This page is preconfigured with default values.</p>
-<img src="../images/configuration.png" alt="General Configuration" /><table class="bodyTable"><tbody><tr class="a"><td align="left">Working Directory</td>
-<td align="left">The directory where all projects will be checked out</td>
-</tr>
-<tr class="b"><td align="left">Build Output Directory</td>
-<td align="left">The directory where all build output will be stored</td>
-</tr>
-<tr class="a"><td align="left">Release Output Directory</td>
-<td align="left">The directory where all release output will be stored</td>
-</tr>
-<tr class="b"><td align="left">Deployment Repository Directory</td>
-<td align="left">The directory where generated maven2 artifacts will be stored. This directory will be respect a repository structure. It is independant of the maven deploy phase</td>
-</tr>
-<tr class="a"><td align="left">Base URL</td>
-<td align="left">The base Continuum URL. This URL is used in notifications</td>
-</tr>
-<tr class="b"><td align="left">Number of Allowed Builds in Parallel</td>
-<td align="left">The number of build queues that will be utilized to build projects. This allows concurrent checkouts and builds of multiple projects. Available since version 1.3.1.</td>
-</tr>
-<tr class="a"><td align="left">Enable Distributed Builds</td>
-<td align="left">When checked, this Continuum instance will delegate all builds to configured agents.</td>
-</tr>
-</tbody>
-</table>
-<p>You can modify values or keep defaults then save. </p>
-<p>Although Continuum defaults to storing its data within the installation, it is a best practice to separate the installation and data directories.</p>
-<p>These values can be pre-configured in continuum.xml. Make sure that Continuum is not running when editing this file.</p>
-<p>You can modify values at a later time with the following steps:</p>
-<ol type="1"><li>Login to Continuum with an Administrator account</li>
-<li>Click the <b>Configuration</b> link under the <b>Administration</b> section<img src="../images/configuration-menu.png" alt="General Configuration Menu" /></li>
-<li>Click the <b>Edit</b> button</li>
-</ol>
-</div>
-
+        <div class="section"><h2>Managing General Configuration<a name="Managing_General_Configuration"></a></h2><p>The first time you start Continuum, you will see the 'General Configuration' page. This page is preconfigured with default values.</p><img src="../images/configuration.png" alt="General Configuration" /><table border="1" class="bodyTable"><tr class="a"><td align="left">Working Directory</td><td align="left">The directory where all projects will be checked out</td></tr><tr class="b"><td align="left">Build Output Directory</td><td align="left">The directory where all build output will be stored</td></tr><tr class="a"><td align="left">Release Output Directory</td><td align="left">The directory where all release output will be stored</td></tr><tr class="b"><td align="left">Deployment Repository Directory</td><td align="left">The directory where generated maven2 artifacts will be stored. This directory will be respect a repository structure. It is independant of the
  maven deploy phase</td></tr><tr class="a"><td align="left">Base URL</td><td align="left">The base Continuum URL. This URL is used in notifications</td></tr><tr class="b"><td align="left">Number of Allowed Builds in Parallel</td><td align="left">The number of build queues that will be utilized to build projects. This allows concurrent checkouts and builds of multiple projects. Available since version 1.3.1.</td></tr><tr class="a"><td align="left">Enable Distributed Builds</td><td align="left">When checked, this Continuum instance will delegate all builds to configured agents.</td></tr><tr class="b"><td align="left">Shared Secret Password</td><td align="left">The pre-shared key (PSK) between the master and all configured agents. The PSK will need to be copied to all configured agents.</td></tr></table><p>You can modify values or keep defaults then save. </p><p>Although Continuum defaults to storing its data within the installation, it is a best practice to separate the instal
 lation and data directories.</p><p>These values can be pre-configured in continuum.xml. Make sure that Continuum is not running when editing this file.</p><p>You can modify values at a later time with the following steps:</p><ol style="list-style-type: decimal"><li>Login to Continuum with an Administrator account</li><li>Click the <b>Configuration</b> link under the <b>Administration</b> section<img src="../images/configuration-menu.png" alt="General Configuration Menu" /></li><li>Click the <b>Edit</b> button</li></ol></div>
       </div>
     </div>
     <div class="clear">
@@ -520,7 +483,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -537,4 +500,4 @@ pageTracker._trackPageview();</script>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/continuum-logs.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/continuum-logs.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/continuum-logs.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/continuum-logs.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     </style>
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
           <meta name="author" content="Jevica Arianne B. Zurbano" />
-        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
                                                     
 <script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
@@ -33,7 +33,7 @@ pageTracker._trackPageview();</script>
     <div id="banner">
                   <a href="../../" id="bannerLeft">
     
-                                            <img src="../../../images/continuum_logo_75.gif" alt="" />
+                                            <img src="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/images/continuum_logo_75.gif" alt="" />
     
             </a>
                         <a href="http://www.apache.org/" id="bannerRight">
@@ -59,10 +59,13 @@ pageTracker._trackPageview();</script>
                 <a href="http://www.apache.org/" class="externalLink">Apache</a>
                 &gt;
       
-                <a href="../../../">Continuum</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum</a>
                 &gt;
       
-                <a href="../">1.4.0</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum :: Project</a>
+                &gt;
+      
+                <a href="../">1.4.1-SNAPSHOT</a>
                   </div>
             <div class="xright">      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -92,15 +95,15 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../index.html">Home</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/index.html">Home</a>
           </li>
               
     <li class="none">
-                    <a href="../../../download.html">Download</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/download.html">Download</a>
           </li>
               
     <li class="none">
-                    <a href="../../../change-log.html">Change Log</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/change-log.html">Change Log</a>
           </li>
               
     <li class="none">
@@ -108,11 +111,11 @@ pageTracker._trackPageview();</script>
           </li>
               
     <li class="none">
-                    <a href="../../../articles.html">Articles</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/articles.html">Articles</a>
           </li>
               
     <li class="none">
-                    <a href="../../../features.html">Features</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/features.html">Features</a>
           </li>
               
     <li class="none">
@@ -139,8 +142,6 @@ pageTracker._trackPageview();</script>
       
             
       
-                  
-      
             
       
               
@@ -195,7 +196,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -240,8 +243,6 @@ pageTracker._trackPageview();</script>
             
       
             
-      
-            
             
             
       
@@ -273,11 +274,7 @@ pageTracker._trackPageview();</script>
           </li>
                   
     <li class="none">
-                    <a href="../administrator_guides/builder.html">Managing Builders</a>
-          </li>
-                  
-    <li class="none">
-                    <a href="../administrator_guides/jdk.html">Managing JDKs</a>
+                    <a href="../administrator_guides/builder.html">Managing Installations</a>
           </li>
                   
     <li class="none">
@@ -390,54 +387,54 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../community.html">Community Overview</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/community.html">Community Overview</a>
           </li>
               
     <li class="none">
-                    <a href="../../../guide-helping.html">How to Contribute</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/guide-helping.html">How to Contribute</a>
           </li>
               
     <li class="none">
-                    <a href="../../../getting-help.html">Getting Help</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/getting-help.html">Getting Help</a>
           </li>
               
     <li class="none">
-                    <a href="../../../issue-tracking.html">Issue Tracking</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/issue-tracking.html">Issue Tracking</a>
           </li>
               
     <li class="none">
-                    <a href="../../../team-list.html">The Continuum Team</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/team-list.html">The Continuum Team</a>
           </li>
               
     <li class="none">
-                    <a href="../../../mail-lists.html">Mailing Lists</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/mail-lists.html">Mailing Lists</a>
           </li>
               
     <li class="none">
-                    <a href="../../../source-repository.html">Source Repository</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/source-repository.html">Source Repository</a>
           </li>
               
     <li class="none">
-                    <a href="../../../license.html">License</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/license.html">License</a>
           </li>
           </ul>
               <h5>Continuum Development</h5>
             <ul>
               
     <li class="none">
-                    <a href="../../../development/building.html">Build Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/building.html">Build Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/debugging.html">Debugging Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/debugging.html">Debugging Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/guide-continuum-development.html">Development Convention</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/guide-continuum-development.html">Development Convention</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/release.html">Release Procedure</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/release.html">Release Procedure</a>
           </li>
           </ul>
               <h5>Project Documentation</h5>
@@ -492,10 +489,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Continuum Logs</h2>
-<p>Continuum's <tt>logs</tt> directory contains an continuum log file named <tt>continuum.log</tt>, which logs all the startup information of Continuum.</p>
-<p>A typical record looks like this:</p>
-<div class="source"><pre>2009-07-22 11:57:48,397 [WrapperSimpleAppMain] INFO  org.apache.maven.continuum.DefaultContinuum  - Initializing Continuum.
+        <div class="section"><h2>Continuum Logs<a name="Continuum_Logs"></a></h2><p>Continuum's <tt>logs</tt> directory contains an continuum log file named <tt>continuum.log</tt>, which logs all the startup information of Continuum.</p><p>A typical record looks like this:</p><div><pre>2009-07-22 11:57:48,397 [WrapperSimpleAppMain] INFO  org.apache.maven.continuum.DefaultContinuum  - Initializing Continuum.
 2009-07-22 11:57:48,397 [WrapperSimpleAppMain] INFO  org.apache.maven.continuum.DefaultContinuum  - Showing all groups:
 2009-07-22 11:57:48,912 [WrapperSimpleAppMain] INFO  org.apache.maven.continuum.DefaultContinuum  - Showing all projects: 
 2009-07-22 11:57:49,081 [WrapperSimpleAppMain] INFO  org.apache.maven.continuum.DefaultContinuum  - Starting Continuum.
@@ -519,10 +513,7 @@ pageTracker._trackPageview();</script>
 2009-07-22 11:57:49,186 [WrapperSimpleAppMain] INFO  org.apache.maven.continuum.build.settings.DefaultSchedulesActivator  -
   Activating schedules ...
 2009-07-22 11:57:49,236 [WrapperSimpleAppMain] INFO  org.apache.maven.continuum.build.settings.DefaultSchedulesActivator  -
-  DEFAULT_SCHEDULE: next fire time -&gt;Wed Jul 22 12:00:00 PHT 2009</pre>
-</div>
-</div>
-
+  DEFAULT_SCHEDULE: next fire time -&gt;Wed Jul 22 12:00:00 PHT 2009</pre></div></div>
       </div>
     </div>
     <div class="clear">
@@ -530,7 +521,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -547,4 +538,4 @@ pageTracker._trackPageview();</script>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/distributed-builds.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/distributed-builds.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/distributed-builds.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/distributed-builds.html Fri Dec 28 07:10:12 2012
@@ -19,7 +19,7 @@
       @import url("../css/site.css");
     </style>
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
-        <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
                                                     
 <script type="text/javascript">var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
 document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));</script>
@@ -32,7 +32,7 @@ pageTracker._trackPageview();</script>
     <div id="banner">
                   <a href="../../" id="bannerLeft">
     
-                                            <img src="../../../images/continuum_logo_75.gif" alt="" />
+                                            <img src="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/images/continuum_logo_75.gif" alt="" />
     
             </a>
                         <a href="http://www.apache.org/" id="bannerRight">
@@ -58,10 +58,13 @@ pageTracker._trackPageview();</script>
                 <a href="http://www.apache.org/" class="externalLink">Apache</a>
                 &gt;
       
-                <a href="../../../">Continuum</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum</a>
                 &gt;
       
-                <a href="../">1.4.0</a>
+                <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/">Continuum :: Project</a>
+                &gt;
+      
+                <a href="../">1.4.1-SNAPSHOT</a>
                   </div>
             <div class="xright">      
   
@@ -71,7 +74,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -91,15 +94,15 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../index.html">Home</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/index.html">Home</a>
           </li>
               
     <li class="none">
-                    <a href="../../../download.html">Download</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/download.html">Download</a>
           </li>
               
     <li class="none">
-                    <a href="../../../change-log.html">Change Log</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/change-log.html">Change Log</a>
           </li>
               
     <li class="none">
@@ -107,11 +110,11 @@ pageTracker._trackPageview();</script>
           </li>
               
     <li class="none">
-                    <a href="../../../articles.html">Articles</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/articles.html">Articles</a>
           </li>
               
     <li class="none">
-                    <a href="../../../features.html">Features</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/features.html">Features</a>
           </li>
               
     <li class="none">
@@ -138,8 +141,6 @@ pageTracker._trackPageview();</script>
       
             
       
-                  
-      
             
       
               
@@ -194,7 +195,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -242,8 +245,6 @@ pageTracker._trackPageview();</script>
       
             
       
-            
-      
                   
       
             
@@ -272,11 +273,7 @@ pageTracker._trackPageview();</script>
           </li>
                   
     <li class="none">
-                    <a href="../administrator_guides/builder.html">Managing Builders</a>
-          </li>
-                  
-    <li class="none">
-                    <a href="../administrator_guides/jdk.html">Managing JDKs</a>
+                    <a href="../administrator_guides/builder.html">Managing Installations</a>
           </li>
                   
     <li class="none">
@@ -375,54 +372,54 @@ pageTracker._trackPageview();</script>
             <ul>
               
     <li class="none">
-                    <a href="../../../community.html">Community Overview</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/community.html">Community Overview</a>
           </li>
               
     <li class="none">
-                    <a href="../../../guide-helping.html">How to Contribute</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/guide-helping.html">How to Contribute</a>
           </li>
               
     <li class="none">
-                    <a href="../../../getting-help.html">Getting Help</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/getting-help.html">Getting Help</a>
           </li>
               
     <li class="none">
-                    <a href="../../../issue-tracking.html">Issue Tracking</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/issue-tracking.html">Issue Tracking</a>
           </li>
               
     <li class="none">
-                    <a href="../../../team-list.html">The Continuum Team</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/team-list.html">The Continuum Team</a>
           </li>
               
     <li class="none">
-                    <a href="../../../mail-lists.html">Mailing Lists</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/mail-lists.html">Mailing Lists</a>
           </li>
               
     <li class="none">
-                    <a href="../../../source-repository.html">Source Repository</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/source-repository.html">Source Repository</a>
           </li>
               
     <li class="none">
-                    <a href="../../../license.html">License</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/license.html">License</a>
           </li>
           </ul>
               <h5>Continuum Development</h5>
             <ul>
               
     <li class="none">
-                    <a href="../../../development/building.html">Build Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/building.html">Build Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/debugging.html">Debugging Continuum</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/debugging.html">Debugging Continuum</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/guide-continuum-development.html">Development Convention</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/guide-continuum-development.html">Development Convention</a>
           </li>
               
     <li class="none">
-                    <a href="../../../development/release.html">Release Procedure</a>
+                    <a href="../../../../../../../../scp:/people.apache.org/www/continuum.apache.org/ref/1.4.1-SNAPSHOT/development/release.html">Release Procedure</a>
           </li>
           </ul>
               <h5>Project Documentation</h5>
@@ -477,66 +474,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Understanding Distributed Builds</h2>
-<div class="section"><h3>Introduction</h3>
-<p>The Distributed Builds is an extension to the base Continuum functionalities that gives us the ability to process multiple independent builds beyond the capacity of a single server's processing power. It also enables us to execute builds on multiple different platforms while retaining a unified view of all project builds.</p>
-</div>
-<div class="section"><h3>Architecture</h3>
-<p>Continuum follows a Client-Server model using XML-RPC as the protocol. However, since it uses a bi-directional XML-RPC implementation, we instead distinguish the components by calling them Master and Build Agent.</p>
-<p>The Master is a Continuum instance that has the ability to delegate the builds to registered Build Agents.</p>
-<p>The Build Agent is a standalone Jetty-bundled webapp that listens for any build requests from the Master it is assigned to.</p>
-<p>There is a one-to-many relationship between the Master and the Build Agents. A Master may have many Build Agents, but each Build Agent can only have one Master.</p>
-</div>
-<div class="section"><h3>Behavior</h3>
-<p>Distributed Builds happen at the project group level of Continuum. When the entire project group is built in the Master, independent projects (single project or multi-module project) are distributed to a single registered Build Agent.</p>
-<p>In a project group containing a mix of projects, the distribution of work goes through the following steps:</p>
-<ol type="1"><li>In the Master, a build in the project group is triggered.</li>
-<li>Every independent project within the project group is identified, whether as a single project or a multi-module project. Projects with inter-dependencies cannot be distributed separately, so multi-module projects are delegated to a Build Agent as one build.</li>
-<li>For each independent project, the Master iterates over the list of registered Build Agents and queries each if available. The query is an XML-RPC <tt>ping()</tt> followed by a <tt>getBuildSizeOfAgent()</tt> invocation.</li>
-<li>If there is a Build Agent available, the Master collects the information necessary for the build (SCM URL, project id, etc.) and passes it when invoking <tt>buildProjects()</tt> to the Build Agent with the smallest number of tasks in its queue. The Master also passes the <tt>name</tt> of the local repository of the project's project group. Make sure that a local repository with the same <tt>name</tt> is configured in the Build Agent's configuration file since that is what will be used when the project is built in the build agent. Otherwise, it will use the local repository set in the build agent's <tt>settings.xml</tt> file.</li>
-<li>In the Build Agent, the build request is processed: the build is queued and executed. Upon execution, the Build Agent first performs an SCM checkout or an SCM update followed by an SCM changelog to get the latest update date, then the actual build follows.</li>
-<li>At this point, when the build is running, the Master can invoke <tt>cancelBuild()</tt> which returns a transient build result, and <tt>getBuildResult()</tt> that updates the build output viewed in the Master.</li>
-<li>After the build, the Build Agent returns the complete build result to the Master by invoking the callback method <tt>returnBuildResult()</tt>, which the Master aggregates to provide a unified view of projects.<p>A <tt>ping()</tt> is always called before each XML-RPC invocation to check if the agent is available. If it's not, the agent will be disabled.</p>
-</li>
-</ol>
-</div>
-<div class="section"><h3>Setup</h3>
-<ul><li><a href="../installation/build-agent.html">Install and Configure</a> one or more Build Agents.</li>
-<li><a href="./configuration.html">Enable</a> the Distributed Builds option in the General Configuration.</li>
-<li><a href="./build-agents.html">Add</a> your Build Agents to the Continuum Master.</li>
-<li><a href="./build-agent-groups.html">Add</a> your Build Agents to a Build Agent Group.</li>
-<li><a href="./buildEnvironment.html"> Add</a> your Build Agent Group to a Build Environment.</li>
-<li>Configure a project to use that Build Environment.</li>
-<li>Make sure that the <a href="./localRepository.html"> local repository</a> of the <a href="./projectgroup.html"> project group</a> is properly configured. In this case, it should point to the path of the repository where the Build Agent is installed/running.</li>
-</ul>
-<p><b>Warning:</b> You need to have a central remote repository to store the artifacts created from the Build Agent so that other agents will be able to use the new artifacts.</p>
-</div>
-<div class="section"><h3>Limitations</h3>
-<ul><li>Only system administrator can enable/disable distributed builds</li>
-<li>Credentials (i.e. svn credentials) are passed along if specified, but if server cache is used it will need to be done individually on the Build Agents</li>
-<li>There is no tracking of SCM changes</li>
-<li>The Build Agent needs a configuration web interface</li>
-<li>All projects in a project group will be distributed to the same Build Agent</li>
-</ul>
-</div>
-<div class="section"><h3>Future Enhancements</h3>
-<ul><li>Remote builders<ul><li>Builders can be installed on remote machines, a Continuum manager will send actions to run to builders. An action can be something to run on all builders, on some of them or eventually only to an available builder if we don't want to run more than one build. Actions can be sent with JMS and builders can apply some filters if they don't want to receive all actions. With that, we can do some parallel builds but the dependency tree must be respected for the build order. To work correctly with dependencies, each builder must use a central local repository. Maybe we can use an internal Archiva.</li>
-<li>With Continuum builders configured to receive all commands, users can run multi-platform build for each build definition execution.</li>
-<li>With Continuum builders configured to receive only some project types, users can use a different builder by project group. In this case, the build of all projects will be done quickly because commands are balanced on several servers.</li>
-<li>With Continuum builders configured to build something when it is available, users can install builders on several machine to balance the charge. In this case, it will be possible to run some parallel builds.</li>
-<li>When the builders work is done, a message will be sent to the manager to notify the end of the process.</li>
-<li>With JMS used for the communication, we can add some listeners to create reports/statistics, log some information.</li>
-</ul>
-</li>
-<li>Policy-based distribution<ul><li>Next available</li>
-<li>Load balanced</li>
-<li>Targeted environment matching</li>
-</ul>
-</li>
-</ul>
-</div>
-</div>
-
+        <div class="section"><h2>Understanding Distributed Builds<a name="Understanding_Distributed_Builds"></a></h2><div class="section"><h3>Introduction<a name="Introduction"></a></h3><p>The Distributed Builds is an extension to the base Continuum functionalities that gives us the ability to process multiple independent builds beyond the capacity of a single server's processing power. It also enables us to execute builds on multiple different platforms while retaining a unified view of all project builds.</p></div><div class="section"><h3>Architecture<a name="Architecture"></a></h3><p>Continuum follows a Client-Server model using XML-RPC as the protocol. However, since it uses a bi-directional XML-RPC implementation, we instead distinguish the components by calling them Master and Build Agent.</p><p>The Master is a Continuum instance that has the ability to delegate the builds to registered Build Agents.</p><p>The Build Agent is a standalone Jetty-bundled webapp that liste
 ns for any build requests from the Master it is assigned to.</p><p>There is a one-to-many relationship between the Master and the Build Agents. A Master may have many Build Agents, but each Build Agent can only have one Master.</p><!-- TODO: insert image here --></div><div class="section"><h3>Behavior<a name="Behavior"></a></h3><p>Distributed Builds happen at the project group level of Continuum. When the entire project group is built in the Master, independent projects (single project or multi-module project) are distributed to a single registered Build Agent.</p><p>In a project group containing a mix of projects, the distribution of work goes through the following steps:</p><ol style="list-style-type: decimal"><li>In the Master, a build in the project group is triggered.</li><li>Every independent project within the project group is identified, whether as a single project or a multi-module project. Projects with inter-dependencies cannot be distributed separately, so multi-
 module projects are delegated to a Build Agent as one build.</li><li>For each independent project, the Master iterates over the list of registered Build Agents and queries each if available. The query is an XML-RPC <tt>ping()</tt> followed by a <tt>getBuildSizeOfAgent()</tt> invocation.</li><li>If there is a Build Agent available, the Master collects the information necessary for the build (SCM URL, project id, etc.) and passes it when invoking <tt>buildProjects()</tt> to the Build Agent with the smallest number of tasks in its queue. The Master also passes the <tt>name</tt> of the local repository of the project's project group. Make sure that a local repository with the same <tt>name</tt> is configured in the Build Agent's configuration file since that is what will be used when the project is built in the build agent. Otherwise, it will use the local repository set in the build agent's <tt>settings.xml</tt> file.</li><li>In the Build Agent, the build request is processed: 
 the build is queued and executed. Upon execution, the Build Agent first performs an SCM checkout or an SCM update followed by an SCM changelog to get the latest update date, then the actual build follows.</li><li>At this point, when the build is running, the Master can invoke <tt>cancelBuild()</tt> which returns a transient build result, and <tt>getBuildResult()</tt> that updates the build output viewed in the Master.</li><li>After the build, the Build Agent returns the complete build result to the Master by invoking the callback method <tt>returnBuildResult()</tt>, which the Master aggregates to provide a unified view of projects.<p>A <tt>ping()</tt> is always called before each XML-RPC invocation to check if the agent is available. If it's not, the agent will be disabled.</p></li></ol><!-- TODO: insert sequence diagram here --></div><div class="section"><h3>Setup<a name="Setup"></a></h3><ul><li><a href="./configuration.html">Enable</a> the Distributed Builds option and set
  the Shared Secret Password in the General Configuration.</li><li><a href="../installation/build-agent.html">Install and Configure</a> one or more Build Agents.</li><li><a href="./build-agents.html">Add</a> your Build Agents to the Continuum Master.</li><li><a href="./build-agent-groups.html">Add</a> your Build Agents to a Build Agent Group.</li><li><a href="./buildEnvironment.html"> Add</a> your Build Agent Group to a Build Environment.</li><li>Configure a project to use that Build Environment.</li><li>Make sure that the <a href="./localRepository.html"> local repository</a> of the <a href="./projectgroup.html"> project group</a> is properly configured. In this case, it should point to the path of the repository where the Build Agent is installed/running.</li></ul><p><b>Warning:</b> You need to have a central remote repository to store the artifacts created from the Build Agent so that other agents will be able to use the new artifacts.</p></div><div class="section"><h3>Lim
 itations<a name="Limitations"></a></h3><ul><li>Only system administrator can enable/disable distributed builds</li><li>Credentials (i.e. svn credentials) are passed along if specified, but if server cache is used it will need to be done individually on the Build Agents</li><li>There is no tracking of SCM changes</li><li>The Build Agent needs a configuration web interface</li><li>All projects in a project group will be distributed to the same Build Agent</li></ul></div><div class="section"><h3>Future Enhancements<a name="Future_Enhancements"></a></h3><ul><li>Remote builders<ul><li>Builders can be installed on remote machines, a Continuum manager will send actions to run to builders. An action can be something to run on all builders, on some of them or eventually only to an available builder if we don't want to run more than one build. Actions can be sent with JMS and builders can apply some filters if they don't want to receive all actions. With that, we can do some parallel 
 builds but the dependency tree must be respected for the build order. To work correctly with dependencies, each builder must use a central local repository. Maybe we can use an internal Archiva.</li><li>With Continuum builders configured to receive all commands, users can run multi-platform build for each build definition execution.</li><li>With Continuum builders configured to receive only some project types, users can use a different builder by project group. In this case, the build of all projects will be done quickly because commands are balanced on several servers.</li><li>With Continuum builders configured to build something when it is available, users can install builders on several machine to balance the charge. In this case, it will be possible to run some parallel builds.</li><li>When the builders work is done, a message will be sent to the manager to notify the end of the process.</li><li>With JMS used for the communication, we can add some listeners to create rep
 orts/statistics, log some information.</li></ul></li><li>Policy-based distribution<ul><li>Next available</li><li>Load balanced</li><li>Targeted environment matching</li></ul></li></ul></div></div>
       </div>
     </div>
     <div class="clear">
@@ -544,7 +482,7 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -561,4 +499,4 @@ pageTracker._trackPageview();</script>
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file



Mime
View raw message