continuum-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From br...@apache.org
Subject svn commit: r1426423 [8/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/installation/standalone.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/installation/standalone.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/installation/standalone.html (original)
+++ continuum/site-publish/docs/latest/installation/standalone.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">
@@ -132,45 +135,27 @@ pageTracker._trackPageview();</script>
               
                 
               
-      
-            
-      
-            
             
             
       
-                  
-      
             
       
-              
-            <li class="expanded">
-                    <a href="../installation/index.html">Installation/Upgrade Guides</a>
-                  <ul>
-                  
-    <li class="none">
-                    <a href="../installation/requirements.html">System Requirements</a>
-          </li>
-                  
-                
-              
             
+      
             
       
               
             <li class="expanded">
-                    <a href="../installation/installation.html">Installation</a>
+                    <a href="../installation/index.html">Installation/Upgrade Guides</a>
                   <ul>
                   
     <li class="none">
-              <strong>Standalone</strong>
+              <strong>Installing Standalone</strong>
         </li>
                   
     <li class="none">
-                    <a href="../installation/tomcat.html">Tomcat</a>
+                    <a href="../installation/tomcat.html">Installing in Tomcat</a>
           </li>
-              </ul>
-        </li>
                   
     <li class="none">
                     <a href="../release-notes.html">Release Notes</a>
@@ -179,6 +164,10 @@ pageTracker._trackPageview();</script>
     <li class="none">
                     <a href="../installation/upgrade.html">Upgrade</a>
           </li>
+                  
+    <li class="none">
+                    <a href="../installation/build-agent.html">Installing a Build Agent</a>
+          </li>
               </ul>
         </li>
               
@@ -229,7 +218,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -277,8 +268,6 @@ pageTracker._trackPageview();</script>
       
             
       
-            
-      
                   
       
             
@@ -310,54 +299,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>
@@ -412,19 +401,11 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Installing Continuum Standalone</h2>
-<div class="section"><h3><a name="Basics__Fundamentals">Basics &amp; Fundamentals</a></h3>
-<ul><li>Download the standalone version from the <a class="externalLink" href="http://continuum.apache.org/download.html"> Download page</a></li>
-<li>Extract the file</li>
-<li>Set a <tt>JAVA_HOME</tt> environment variable which use a jdk &gt;= 1.5</li>
-</ul>
-<div class="section"><h4><a name="Defining_JNDI_Resources">Defining JNDI Resources</a></h4>
-<div class="section"><h5><a name="Mail_server_configuration">Mail server configuration</a></h5>
-<p>Before you start Continuum, you must configure your SMTP configuration for mail notification. The configuration is in <tt>$CONTINUUM_HOME/conf/jetty.xml</tt>:</p>
-<div class="source"><pre>&lt;New id=&quot;validation_mail&quot; class=&quot;org.mortbay.jetty.plus.naming.Resource&quot;&gt;
+        <div class="section"><h2>Installing Continuum Standalone<a name="Installing_Continuum_Standalone"></a></h2><!-- %{toc|section=0} --><div class="section"><h3><a name="Download_and_Configuration">Download and Configuration</a></h3><ul><li>Download the standalone version from the <a class="externalLink" href="http://continuum.apache.org/download.html"> Download page</a></li><li>Extract the file</li><li>Set a <tt>JAVA_HOME</tt> environment variable which use a jdk &gt;= 1.5</li></ul><div class="section"><h4><a name="Defining_JNDI_Resources">Defining JNDI Resources</a></h4><div class="section"><h5><a name="Mail_server_configuration">Mail server configuration</a></h5><p>Before you start Continuum, you must configure your SMTP configuration for mail notification. In many servers, the default of delivering to localhost with no authentication will be properly relayed. However, if you need to configure a different SMTP server, the configuration is in <tt>$CONTINUUM_HOME/contex
 ts/continuum.xml</tt>:</p><div class="source"><pre>&lt;New id=&quot;validation_mail&quot; class=&quot;org.eclipse.jetty.plus.jndi.Resource&quot;&gt;
+  &lt;Arg&gt;&lt;Ref id=&quot;wac&quot;/&gt;&lt;/Arg&gt;
   &lt;Arg&gt;mail/Session&lt;/Arg&gt;
   &lt;Arg&gt;
-    &lt;New class=&quot;org.mortbay.naming.factories.MailSessionReference&quot;&gt;
+    &lt;New class=&quot;org.eclipse.jetty.jndi.factories.MailSessionReference&quot;&gt;
       &lt;Set name=&quot;user&quot;&gt;&lt;/Set&gt;
       &lt;Set name=&quot;password&quot;&gt;&lt;/Set&gt;
       &lt;Set name=&quot;properties&quot;&gt;
@@ -435,163 +416,49 @@ pageTracker._trackPageview();</script>
     &lt;/New&gt;
   &lt;/Arg&gt;
 &lt;/New&gt;
-</pre>
-</div>
-</div>
-<div class="section"><h5><a name="Databases_configuration">Databases configuration</a></h5>
-<p>By default, Continuum use an embedded <a class="externalLink" href="http://db.apache.org/derby">Derby</a> database. If you want to use an other database, you can modify the JNDI configuration in <tt>$CONTINUUM_HOME/conf/jetty.xml</tt>:</p>
-<div class="source"><pre>  &lt;!-- continuum database --&gt;
-   
-  &lt;New id=&quot;continuum&quot; class=&quot;org.mortbay.jetty.plus.naming.Resource&quot;&gt;
+</pre></div></div><div class="section"><h5><a name="Database_configuration">Database configuration</a></h5><p>By default, Continuum use an embedded <a class="externalLink" href="http://db.apache.org/derby">Derby</a> database. If you want to use a different database, you can modify the JNDI configuration in <tt>$CONTINUUM_HOME/contexts/continuum.xml</tt>:</p><div class="source"><pre>  &lt;!-- continuum database --&gt;
+
+  &lt;New id=&quot;continuum&quot; class=&quot;org.eclipse.jetty.plus.jndi.Resource&quot;&gt;
+    &lt;Arg&gt;&lt;Ref id=&quot;wac&quot;/&gt;&lt;/Arg&gt;
     &lt;Arg&gt;jdbc/continuum&lt;/Arg&gt;
     &lt;Arg&gt;
-      &lt;New class=&quot;org.apache.derby.jdbc.EmbeddedDataSource&quot;&gt;
-        &lt;Set name=&quot;DatabaseName&quot;&gt;&lt;SystemProperty name=&quot;appserver.base&quot; default=&quot;..&quot;/&gt;/data/databases/continuum&lt;/Set&gt;
-        &lt;Set name=&quot;user&quot;&gt;sa&lt;/Set&gt;
-        &lt;Set name=&quot;createDatabase&quot;&gt;create&lt;/Set&gt;
+      &lt;New class=&quot;org.apache.commons.dbcp.BasicDataSource&quot;&gt;
+        &lt;Set name=&quot;driverClassName&quot;&gt;org.apache.derby.jdbc.EmbeddedDriver&lt;/Set&gt;
+        &lt;Set name=&quot;url&quot;&gt;jdbc:derby:&lt;Property name=&quot;appserver.base&quot; default=&quot;.&quot;/&gt;/data/databases/continuum;create=true&lt;/Set&gt;
+        &lt;Set name=&quot;username&quot;&gt;SA&lt;/Set&gt;
+        &lt;Set name=&quot;password&quot;&gt;&lt;/Set&gt;
+        &lt;Set name=&quot;testOnBorrow&quot;&gt;true&lt;/Set&gt;
+        &lt;Set name=&quot;validationQuery&quot;&gt;SELECT count(*) FROM SYS.SYSTABLES&lt;/Set&gt;
       &lt;/New&gt;
     &lt;/Arg&gt;
   &lt;/New&gt;
 
-  &lt;New id=&quot;continuumShutdown&quot; class=&quot;org.mortbay.jetty.plus.naming.Resource&quot;&gt;
-    &lt;Arg&gt;jdbc/continuumShutdown&lt;/Arg&gt;
-    &lt;Arg&gt;
-      &lt;New class=&quot;org.apache.derby.jdbc.EmbeddedDataSource&quot;&gt;
-        &lt;Set name=&quot;DatabaseName&quot;&gt;&lt;SystemProperty name=&quot;appserver.base&quot; default=&quot;..&quot;/&gt;/data/databases/continuum&lt;/Set&gt;
-        &lt;Set name=&quot;user&quot;&gt;sa&lt;/Set&gt;
-        &lt;Set name=&quot;shutdownDatabase&quot;&gt;shutdown&lt;/Set&gt;
-      &lt;/New&gt;
-    &lt;/Arg&gt;
-  &lt;/New&gt;
- 
   &lt;!-- Users / Security Database --&gt;
-  
-  &lt;New id=&quot;users&quot; class=&quot;org.mortbay.jetty.plus.naming.Resource&quot;&gt;
-    &lt;Arg&gt;jdbc/users&lt;/Arg&gt;
-    &lt;Arg&gt;
-      &lt;New class=&quot;org.apache.derby.jdbc.EmbeddedDataSource&quot;&gt;
-        &lt;Set name=&quot;DatabaseName&quot;&gt;&lt;SystemProperty name=&quot;appserver.base&quot; default=&quot;..&quot;/&gt;/data/databases/users&lt;/Set&gt;
-        &lt;Set name=&quot;user&quot;&gt;sa&lt;/Set&gt;
-        &lt;Set name=&quot;createDatabase&quot;&gt;create&lt;/Set&gt;
-      &lt;/New&gt;
-    &lt;/Arg&gt;
-  &lt;/New&gt;
 
-  &lt;New id=&quot;usersShutdown&quot; class=&quot;org.mortbay.jetty.plus.naming.Resource&quot;&gt;
-    &lt;Arg&gt;jdbc/usersShutdown&lt;/Arg&gt;
+  &lt;New id=&quot;users&quot; class=&quot;org.eclipse.jetty.plus.jndi.Resource&quot;&gt;
+    &lt;Arg&gt;&lt;Ref id=&quot;wac&quot;/&gt;&lt;/Arg&gt;
+    &lt;Arg&gt;jdbc/users&lt;/Arg&gt;
     &lt;Arg&gt;
-      &lt;New class=&quot;org.apache.derby.jdbc.EmbeddedDataSource&quot;&gt;
-        &lt;Set name=&quot;DatabaseName&quot;&gt;&lt;SystemProperty name=&quot;appserver.base&quot; default=&quot;..&quot;/&gt;/data/databases/users&lt;/Set&gt;
-        &lt;Set name=&quot;user&quot;&gt;sa&lt;/Set&gt;
-        &lt;Set name=&quot;shutdownDatabase&quot;&gt;shutdown&lt;/Set&gt;
+      &lt;New class=&quot;org.apache.commons.dbcp.BasicDataSource&quot;&gt;
+        &lt;Set name=&quot;driverClassName&quot;&gt;org.apache.derby.jdbc.EmbeddedDriver&lt;/Set&gt;
+        &lt;Set name=&quot;url&quot;&gt;jdbc:derby:&lt;Property name=&quot;appserver.base&quot; default=&quot;.&quot;/&gt;/data/databases/users;create=true&lt;/Set&gt;
+        &lt;Set name=&quot;username&quot;&gt;SA&lt;/Set&gt;
+        &lt;Set name=&quot;password&quot;&gt;&lt;/Set&gt;
+        &lt;Set name=&quot;testOnBorrow&quot;&gt;true&lt;/Set&gt;
+        &lt;Set name=&quot;validationQuery&quot;&gt;SELECT count(*) FROM SYS.SYSTABLES&lt;/Set&gt;
       &lt;/New&gt;
     &lt;/Arg&gt;
   &lt;/New&gt;
-  
-</pre>
-</div>
-</div>
-</div>
-</div>
-<div class="section"><h3><a name="Installing_as_a_Windows_Service">Installing as a Windows Service</a></h3>
-<ul><li>Go to <tt>$CONTINUUM_HOME/bin/</tt> and run the following command:<div class="source"><pre>continuum.bat install</pre>
-</div>
-</li>
-<li>Edit the <b>Apache Continuum</b> service<ul><li>To see the services that are on your computer go to Start|Run and enter <tt>services.msc</tt>.</li>
-</ul>
-</li>
-<li>Select the <b>Startup Type</b></li>
-<li>Go to the <b>Log On</b> tab and select a real user. A real user is required because you'll need a home directory for Maven repository and some other things</li>
-<li>Validate your changes</li>
-</ul>
-</div>
-<div class="section"><h3><a name="Installing_as_a_Linux_Service">Installing as a Linux Service</a></h3>
-<p>Since the Continuum Linux script <tt>bin/continuum</tt> understands the same arguments as Linux boot scripts, there is no need to write a particular startup script to add Continuum to the Linux boot process. All you need to do, as root, is:</p>
-<div class="section"><h4><a name="Basic_script_in_etcinit.d">Basic script in /etc/init.d</a></h4>
-<ul><li>Create a <tt>continuum</tt> file under <tt>/etc/init.d/</tt> with the following content. Replace <tt>continuum_user</tt> with the name of an account you have already created.<div class="source"><pre>#!/bin/sh
 
-CONTINUUM_HOME=/opt/continuum-1.3
-su - continuum_user -c &quot;$CONTINUUM_HOME/bin/continuum console $@ &amp;&quot;</pre>
-</div>
-</li>
-</ul>
-</div>
-<div class="section"><h4><a name="On_a_Debian-based_system">On a Debian-based system</a></h4>
-<div class="source"><pre>ln -s /usr/local/continuum-[VERSION]/bin/continuum /etc/init.d/continuum</pre>
-</div>
-<p>At this point you have Continuum ready to be symlinked from different runlevels. This might sound a bit esoteric, but it is not. You will find these words very fast as soon as you start reading about the init process. Fortunately, Debian GNU/Linux comes with a very handy utility to create these links, just run as root:</p>
-<div class="source"><pre>update-rc.d -n continuum defaults 80</pre>
-</div>
-<p>If you run this command, you will see something like this:</p>
-<div class="source"><pre> Adding system startup for /etc/init.d/continuum ...
+</pre></div><p>Please refer to the documentation for your JDBC driver for the correct settings to use. You may need to alter the <tt>validationQuery</tt> to one that can successfully execute on your database (or remove the setting if you do not want to validate connections before using them).</p><p>Refer to the <a class="externalLink" href="http://commons.apache.org/dbcp/"> Commons DBCP</a> documentation for more advanced configuration of the connection pool.</p></div></div><div class="section"><h4>Testing the Configuration<a name="Testing_the_Configuration"></a></h4><p>Start Continuum from the console in the <tt>$CONTINUUM_HOME/bin/</tt> directory:</p><div><pre>continuum console</pre></div><p>If it appears to be working correctly, it is a good idea to set it up as a service so that it will run in the background under a suitable role account, and can be set to start whenever the server has started.</p></div></div><div class="section"><h3><a name="Installing_as_a_Windows_Serv
 ice">Installing as a Windows Service</a></h3><ul><li>Go to <tt>$CONTINUUM_HOME/bin/</tt> and run the following command:<div><pre>continuum.bat install</pre></div></li><li>Edit the <b>Apache Continuum</b> service<ul><li>To see the services that are on your computer go to <i>Start</i>|<i>Run</i> and enter <tt>services.msc</tt>.</li></ul></li><li>Select the <b>Startup Type</b></li><li>Go to the <b>Log On</b> tab and select a real user. A real user is required because you'll need a home directory for Maven repository and some other things</li><li>Validate your changes</li></ul></div><div class="section"><h3><a name="Installing_as_a_Linux_Service">Installing as a Linux Service</a></h3><p>Since the Continuum Linux script <tt>bin/continuum</tt> understands the same arguments as Linux boot scripts, there is no need to write a particular startup script to add Continuum to the Linux boot process. All you need to do, as root, is:</p><div><pre>ln -s /usr/local/continuum-[VERSION]/bin/co
 ntinuum /etc/init.d/continuum</pre></div><p>This will allow you to run <tt>service continuum start</tt> and other commands.</p><p>To have the service start on boot, follow the instructions below for your particular family of operating system.</p><div class="section"><h4><a name="On_a_Debian-based_system">On a Debian-based system</a></h4><p>At this point you have Continuum ready to be symlinked from different runlevels. Debian GNU/Linux comes with a very handy utility to create these links, just run as root:</p><div><pre>update-rc.d continuum defaults 80</pre></div><p>If you run this command, you will see something like this:</p><div><pre> Adding system startup for /etc/init.d/continuum ...
    /etc/rc0.d/K80continuum -&gt; ../init.d/continuum
    /etc/rc1.d/K80continuum -&gt; ../init.d/continuum
    /etc/rc6.d/K80continuum -&gt; ../init.d/continuum
    /etc/rc2.d/S80continuum -&gt; ../init.d/continuum
    /etc/rc3.d/S80continuum -&gt; ../init.d/continuum
    /etc/rc4.d/S80continuum -&gt; ../init.d/continuum
-   /etc/rc5.d/S80continuum -&gt; ../init.d/continuum</pre>
-</div>
-<p>What you see is the symlinks that would be created. The above command didn't actually create anything because of the -n switch. Remove that switch and run the command again to have the real links created.</p>
-</div>
-<div class="section"><h4><a name="On_a_RedHat-based_system">On a RedHat-based system</a></h4>
-<p>Configuring Continuum on a RedHat-based system (like Fedora Core) is slightly different. Instead of running <tt>update-rc.d</tt>, you need to add a new service using the <tt>chkconfig</tt> command. In order to add Continuum using <tt>chkconfig</tt>, it is necessary to add some comments to the <tt>/etc/rc.d/init.d/continuum</tt> script and run a couple of commands. These tasks are executed by running the <tt>chkconfig_install.sh</tt> script below. Note that <tt>_continuum_user_</tt> needs to be replaced by the name of an account you have already created.</p>
-<div class="source"><pre>#! /bin/sh
-#
-# chkconfig_install.sh - install Continuum on a chkconfig-based system
-#
-# Author: Felipe Leme &lt;felipeal at apache.org&gt;
-#
-
-# figure out what's Continuum's directory
-CONTINUUM_HOME=`dirname $0`
-cd ${CONTINUUM_HOME}
-CONTINUUM_HOME=`pwd`
-
-INITD_SCRIPT=/etc/rc.d/init.d/continuum
-
-if [ -f ${INITD_SCRIPT} ]
-then
-  echo &quot;File ${INITD_SCRIPT} already exists. Please remove it and try again.&quot;
-  exit 1
-fi
-
-echo &quot;Creating file ${INITD_SCRIPT}&quot;
-cat &gt;&gt; ${INITD_SCRIPT} &lt;&lt;EOF
-#! /bin/sh
-# chkconfig: 345 90 10
-# description: Apache Continuum server
-
-# uncoment to set JAVA_HOME as the value present when Continuum installed
-#export JAVA_HOME=${JAVA_HOME}
-
-if [ -z &quot;\${JAVA_HOME}&quot; ]
-then
-  echo &quot;Cannot manage Continuum without variable JAVA_HOME set&quot;
-  echo &quot;  (try to set it on file ${INITD_SCRIPT})&quot;
-  exit 1
-fi
-# run Continuum as root
-cd ${CONTINUUM_HOME}
-./bin/continuum \$*
-# run Continuum as user _continuum_user_
-#su - _continuum_user_ -c &quot;cd ${CONTINUUM_HOME}; ./bin/continuum \$*&quot;
-EOF
-chmod +x ${INITD_SCRIPT}
-
-echo &quot;Adding Continuum to chkconfig&quot;
-chkconfig --add continuum
-
-echo &quot;Enabling Continuum on chkconfig&quot;
-chkconfig continuum on
-echo &quot;Continuum set to start on run levels 3, 4 and 5.&quot;
-echo &quot;To start Continuum now, run 'service continuum start'&quot;
-</pre>
-</div>
-</div>
-</div>
-</div>
-
+   /etc/rc5.d/S80continuum -&gt; ../init.d/continuum</pre></div><p>What you see is the symlinks that would be created.</p></div><div class="section"><h4><a name="On_a_RedHat-based_system">On a RedHat-based system</a></h4><p>Configuring Continuum on a RedHat-based system (like Fedora Core) is slightly different. Instead of running <tt>update-rc.d</tt>, you need to add a new service using the <tt>chkconfig</tt> command.</p><div><pre>chkconfig --add continuum
+chkconfig continuum on</pre></div></div></div><div class="section"><h3><a name="Installing_with_Puppet">Installing with Puppet</a></h3><p>If you use Puppet to manage your infrastructure, you can use a third-party Puppet module to install Continuum. This will take care of adding the required users, databases and configuration based on official release tarballs.</p><ul><li><a class="externalLink" href="https://github.com/maestrodev/puppet-continuum"> Puppet module for Apache Continuum and Continuum build agents</a></li></ul></div></div>
       </div>
     </div>
     <div class="clear">
@@ -599,7 +466,7 @@ echo &quot;To start Continuum now, run '
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -616,4 +483,4 @@ echo &quot;To start Continuum now, run '
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/installation/tomcat.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/installation/tomcat.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/installation/tomcat.html (original)
+++ continuum/site-publish/docs/latest/installation/tomcat.html Fri Dec 28 07:10:12 2012
@@ -21,7 +21,7 @@
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
           <meta name="author" content="Joakim Erdfelt
 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>
@@ -34,7 +34,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">
@@ -60,10 +60,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">      
   
@@ -73,7 +76,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -93,15 +96,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">
@@ -109,11 +112,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">
@@ -135,12 +138,10 @@ pageTracker._trackPageview();</script>
               
       
             
-      
             
-      
             
+      
             
-                  
       
             
       
@@ -150,27 +151,11 @@ pageTracker._trackPageview();</script>
                   <ul>
                   
     <li class="none">
-                    <a href="../installation/requirements.html">System Requirements</a>
-          </li>
-                  
-                
-              
-      
-            
-            
-              
-            <li class="expanded">
-                    <a href="../installation/installation.html">Installation</a>
-                  <ul>
-                  
-    <li class="none">
-                    <a href="../installation/standalone.html">Standalone</a>
+                    <a href="../installation/standalone.html">Installing Standalone</a>
           </li>
                   
     <li class="none">
-              <strong>Tomcat</strong>
-        </li>
-              </ul>
+              <strong>Installing in Tomcat</strong>
         </li>
                   
     <li class="none">
@@ -180,6 +165,10 @@ pageTracker._trackPageview();</script>
     <li class="none">
                     <a href="../installation/upgrade.html">Upgrade</a>
           </li>
+                  
+    <li class="none">
+                    <a href="../installation/build-agent.html">Installing a Build Agent</a>
+          </li>
               </ul>
         </li>
               
@@ -230,7 +219,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -278,8 +269,6 @@ pageTracker._trackPageview();</script>
       
             
       
-            
-      
                   
       
             
@@ -311,54 +300,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>
@@ -413,172 +402,10 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Guide to Install Continuum on Tomcat</h2>
-<p>Instructions for installing, deploying, configuring Continuum for the Apache Tomcat web container.</p>
-<p>Sections:</p>
-<div class="section"><h3><a name="Basics__Fundamentals">Basics &amp; Fundamentals</a></h3>
-<p>With every Tomcat version you will need a few things before you can deploy Continuum.</p>
-<ol type="1"><li>Use at least Java JDK 1.5.0_11 to run Tomcat with Continuum.</li>
-<li>A defined &lt;Context&gt; xml section to define the JNDI resources.</li>
-<li>The JavaMail / Activation JAR files.</li>
-<li>The Apache Derby JAR files.</li>
-<li>Configure ${appserver.base} java property.</li>
-</ol>
-<div class="section"><h4><a name="Defining_JNDI_Resources">Defining JNDI Resources</a>.</h4>
-<p>Continuum will, on startup, ask the web container for a few JNDI configured resources, two JDBC DataSources, and one JavaMail session.</p>
-<p>To configure these JNDI resources in the Tomcat Web Container, you will need to specify a &lt;Context&gt; section that Tomcat can utilize for those requests coming from Continuum.</p>
-<p>Tomcat has 3 main ways to accomplish this (ordered by most recommended to least recommended)</p>
-<ol type="1"><li>Creating a $CATALINA_HOME/webapps/continuum/META-INF/context.xml containing a &lt;Context&gt; element.</li>
-<li>Creating a $CATALINA_HOME/conf/Catalina/localhost/continuum.xml containing a &lt;Context&gt; element.</li>
-<li>Adding a &lt;Context&gt; Section into the $CATALINA_HOME/conf/server.xml<p>The following are the JNDI names you will need to provide:</p>
-<ul><li><tt>mail/Session</tt></li>
-<li><tt>jdbc/continuum</tt></li>
-<li><tt>jdbc/users</tt><p>The individual techniques for describing these resources, and the parameters associated with them are specific to the Tomcat version, resource type, and even JDBC implementation type.</p>
-<p>For the purposes of this document, the following assumptions are made.</p>
-<ol type="1"><li>You are an Apache Tomcat administrator.</li>
-<li>You have an SMTP Server on localhost, port 25, with no login / password.</li>
-<li>You will be using the embedded Apache Derby database. (not an external database, that's another show)</li>
-<li>Details specific to Apache Tomcat, JavaMail, or Apache Derby are left for the reader to research on those projects websites.</li>
-</ol>
-</li>
-</ul>
-</li>
-</ol>
-</div>
-<div class="section"><h4><a name="The_JavaMail__Activation_JAR_files">The JavaMail / Activation JAR files</a></h4>
-<p><b>Note:</b> Continuum requires JavaMail 1.4 (or later)</p>
-<p>Apache Tomcat does not typically ship with a copy of the JavaMail or Activation JAR files. In your role as the Apache Tomcat administrator of your installation, you will need to obtain these JAR files and place it into your preferred <tt>lib</tt> directory.</p>
-<p>The appropriate lib directory to choose is a personal preference, and we do not encourage or enforce a specific location for it, as all installations of Apache Tomcat are different.</p>
-<p>For the record, we personally put them in the <tt>$CATALINA_HOME/common/lib/</tt> directory.</p>
-<p>Direct download links for these JAR files.</p>
-<ul><li>JavaMail 1.4 - <a class="externalLink" href="http://repo1.maven.org/maven2/javax/mail/mail/1.4/mail-1.4.jar">mail-1.4.jar</a></li>
-<li>Java Activation Framework 1.1 - <a class="externalLink" href="http://repo1.maven.org/maven2/javax/activation/activation/1.1/activation-1.1.jar">activation-1.1.jar</a></li>
-</ul>
-</div>
-<div class="section"><h4><a name="The_Apache_Derby_JAR_files">The Apache Derby JAR files</a></h4>
-<p><b>Note:</b>Continuum 1.2 has been tested with Apache Derby 10.1.3.1</p>
-<p>The default installation of Continuum uses the Apache Derby 100% Java database to maintain Continuum-specific information, and also the Users / Security Database.</p>
-<p>You will need to obtain the <tt>derby.jar</tt> and <tt>derbytools.jar</tt> and place them into your preferred lib directory.</p>
-<p>We put them into the <tt>$CATALINA_HOME/common/lib/</tt> directory.</p>
-<p>Direct download links for these JAR files:</p>
-<ul><li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/derby/derby/10.1.3.1/derby-10.1.3.1.jar">derby-10.1.3.1.jar</a></li>
-<li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/derby/derbytools/10.1.3.1/derbytools-10.1.3.1.jar">derbytools-10.1.3.1.jar</a></li>
-</ul>
-</div>
-<div class="section"><h4><a name="Configure_the_appserver.base_java_property">Configure the appserver.base java property</a></h4>
-<p>The <tt>${appserver.base}</tt> java property is used by the Continuum internal logging configuration to determine where to output its logs to. It is important to define this property either in the <tt>$CATALINA_OPTS</tt> system environment variable (if Tomcat is being launched via the command line) or the service properties (if being launched as a service or daemon).</p>
-<p>The format typically expected is <tt>-Dappserver.base=&lt;SOMEWHERE&gt;</tt></p>
-<p>You can utilize the <tt>$CATALINA_HOME/bin/setenv.sh</tt> script to set this value in a Tomcat specific way.</p>
-<div class="source"><pre>#!/bin/bash
+        <div class="section"><h2>Guide to Install Continuum on Tomcat<a name="Guide_to_Install_Continuum_on_Tomcat"></a></h2><p>Instructions for installing, deploying, configuring Continuum for the Apache Tomcat web container.</p><!-- %{toc|section=0} --><div class="section"><h3><a name="Server_Configuration">Server Configuration</a></h3><p>With every Tomcat version you will need a few things before you can deploy Continuum.</p><ol style="list-style-type: decimal"><li>Use at least Java JDK 1.5.0_11 to run Tomcat with Continuum.</li><li>A defined <tt>&lt;Context&gt;</tt> xml section to define the JNDI resources.</li><li>The JavaMail / Activation JAR files.</li><li>The Apache Derby JAR files.</li><li>Configure <tt>${appserver.base}</tt> Java system property.</li></ol><div class="section"><h4><a name="Defining_JNDI_Resources">Defining JNDI Resources</a></h4><p>Continuum will, on startup, ask the web container for a few JNDI configured resources, two JDBC DataSources, and one Ja
 vaMail session.</p><p>To configure these JNDI resources in the Tomcat Web Container, you will need to specify a <tt>&lt;Context&gt;</tt> section that Tomcat can utilize for those requests coming from Continuum.</p><p>Tomcat has several ways to accomplish this, with the most practical being to create a <tt>$CATALINA_HOME/conf/Catalina/localhost/continuum.xml</tt> file containing a <tt>&lt;Context&gt;</tt> element.</p><p>The following are the JNDI names you will need to provide:</p><ul><li><tt>mail/Session</tt></li><li><tt>jdbc/continuum</tt></li><li><tt>jdbc/users</tt></li></ul><p>The individual techniques for describing these resources, and the parameters associated with them are specific to the Tomcat version, resource type, and even JDBC implementation type.</p><p>For the purposes of this document, the following assumptions are made.</p><ol style="list-style-type: decimal"><li>You are an Apache Tomcat administrator.</li><li>You have an SMTP Server on localhost, port 25, wi
 th no login / password.</li><li>You will be using the embedded Apache Derby database, rather than an external database.</li><li>Details specific to Apache Tomcat, JavaMail, or Apache Derby are left for the reader to research on those projects websites.</li></ol></div><div class="section"><h4><a name="The_JavaMail__Activation_JAR_files">The JavaMail / Activation JAR files</a></h4><p><b>Note:</b> Continuum requires JavaMail 1.4 (or later)</p><p>Apache Tomcat does not typically ship with a copy of the JavaMail or Activation JAR files. In your role as the Apache Tomcat administrator of your installation, you will need to obtain these JAR files and place it into your preferred <tt>lib</tt> directory.</p><p>The appropriate <tt>lib</tt> directory to choose is a personal preference, and we do not encourage or enforce a specific location for it, as all installations of Apache Tomcat are different.</p><p>For the record, we personally put them in the <tt>$CATALINA_HOME/common/lib/</tt>
  directory.</p><p>Direct download links for these JAR files.</p><ul><li>JavaMail 1.4 - <a class="externalLink" href="http://repo1.maven.org/maven2/javax/mail/mail/1.4/mail-1.4.jar">mail-1.4.jar</a></li><li>Java Activation Framework 1.1 - <a class="externalLink" href="http://repo1.maven.org/maven2/javax/activation/activation/1.1/activation-1.1.jar">activation-1.1.jar</a></li></ul></div><div class="section"><h4><a name="The_Apache_Derby_JAR_files">The Apache Derby JAR files</a></h4><p><b>Note:</b>Continuum has been tested with Apache Derby 10.1.3.1</p><p>The default installation of Continuum uses the Apache Derby 100% Java database to maintain Continuum-specific information, and also the Users / Security Database.</p><p>You will need to obtain <tt>derby.jar</tt> and place it into your preferred <tt>lib</tt> directory.</p><p>We put them into the <tt>$CATALINA_HOME/common/lib/</tt> directory.</p><p>Direct download links for this JAR file:</p><ul><li>Derby 10.1.3.1 - <a class="ex
 ternalLink" href="http://repo1.maven.org/maven2/org/apache/derby/derby/10.1.3.1/derby-10.1.3.1.jar">derby-10.1.3.1.jar</a></li></ul></div><div class="section"><h4><a name="Configure_the_appserver.base_Java_system_property">Configure the appserver.base Java system property</a></h4><p>The <tt>${appserver.base}</tt> system property is used by the Continuum internal logging configuration to determine where to output its logs to. It is important to define this property either in the <tt>$CATALINA_OPTS</tt> system environment variable (if Tomcat is being launched via the command line) or the service properties (if being launched as a service or daemon).</p><p>The format typically expected is <tt>-Dappserver.base=/path/to/continuum-base</tt></p><p>You can utilize the <tt>$CATALINA_HOME/bin/setenv.sh</tt> script to set this value in a Tomcat specific way.</p><div><pre>#!/bin/bash
 # Keep the appserver.home and appserver.base values the same when running under Tomcat
 
-export CATALINA_OPTS=&quot;-Dappserver.home=$CATALINA_HOME -Dappserver.base=$CATALINA_HOME&quot;</pre>
-</div>
-</div>
-</div>
-<div class="section"><h3><a name="Tomcat_5.0.x_Specifics">Tomcat 5.0.x Specifics</a></h3>
-<p>Tested on Tomcat v5.0.28.</p>
-<p>These instructions explain how to deploy the Continuum 1.2 web application in an existing installation of Tomcat 5.0.x.</p>
-<p><b>Extra Jars:</b></p>
-<ul><li>You will need the <a class="externalLink" href="http://repo1.maven.org/maven2/xalan/xalan/2.7.0/xalan-2.7.0.jar">xalan-2.7.0.jar</a> copied into your <tt>$CATALINA_HOME/common/lib/</tt> directory.</li>
-<li>The Xerces XML Implementation provided in Tomcat 5.0.x is old and will cause problems with Continuum and the internal JAXP implementation in JDK 1.5, we recommend that you remove the files in <tt>$CATALINA_HOME/common/endorsed/</tt>.<div class="source"><pre>&lt;Context path=&quot;/continuum&quot; docBase=&quot;/path/to/continuum-webapp-1.2.war&quot; debug=&quot;0&quot;&gt;
-
-  &lt;!-- JNDI Datasource for User/Security Database (REQUIRED) --&gt;
-  &lt;Resource name=&quot;jdbc/users&quot; auth=&quot;Container&quot; type=&quot;javax.sql.DataSource&quot;/&gt;
-  &lt;ResourceParams name=&quot;jdbc/users&quot;&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;driverClassName&lt;/name&gt;
-      &lt;value&gt;org.apache.derby.jdbc.EmbeddedDriver&lt;/value&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;factory&lt;/name&gt;
-      &lt;value&gt;org.apache.commons.dbcp.BasicDataSourceFactory&lt;/value&gt; &lt;!-- Sets up Database Connection Pooling --&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;url&lt;/name&gt;
-      &lt;value&gt;jdbc:derby:database/users;create=true&lt;/value&gt; &lt;!-- Adjust path to suit --&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;username&lt;/name&gt;
-      &lt;value&gt;sa&lt;/value&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;password&lt;/name&gt;
-      &lt;value&gt;&lt;/value&gt;
-    &lt;/parameter&gt;
-  &lt;/ResourceParams&gt;
-
-  &lt;!-- JNDI Datasource for Continuum Database (REQUIRED) --&gt;
-  &lt;Resource name=&quot;jdbc/continuum&quot; auth=&quot;Container&quot; type=&quot;javax.sql.DataSource&quot;/&gt;
-  &lt;ResourceParams name=&quot;jdbc/continuum&quot;&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;driverClassName&lt;/name&gt;
-      &lt;value&gt;org.apache.derby.jdbc.EmbeddedDriver&lt;/value&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;factory&lt;/name&gt;
-      &lt;value&gt;org.apache.commons.dbcp.BasicDataSourceFactory&lt;/value&gt; &lt;!-- Sets up Database Connection Pooling --&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;url&lt;/name&gt;
-      &lt;value&gt;jdbc:derby:database/continuum;create=true&lt;/value&gt; &lt;!-- Adjust path to suit --&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;username&lt;/name&gt;
-      &lt;value&gt;sa&lt;/value&gt;
-    &lt;/parameter&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;password&lt;/name&gt;
-      &lt;value&gt;&lt;/value&gt;
-    &lt;/parameter&gt;
-  &lt;/ResourceParams&gt;
-
-  &lt;Resource name=&quot;mail/Session&quot; auth=&quot;Container&quot; type=&quot;javax.mail.Session&quot;/&gt;
-  &lt;ResourceParams name=&quot;mail/Session&quot;&gt;
-    &lt;parameter&gt;
-      &lt;name&gt;mail.smtp.host&lt;/name&gt;
-      &lt;value&gt;localhost&lt;/value&gt;
-    &lt;/parameter&gt;
- &lt;/ResourceParams&gt;
-&lt;/Context&gt;</pre>
-</div>
-</li>
-</ul>
-</div>
-<div class="section"><h3><a name="Tomcat_5.5.x_Specifics">Tomcat 5.5.x Specifics</a></h3>
-<p>Tested on Tomcat v5.5.17 and v5.5.25.</p>
-<p>This example &lt;Context&gt; assumes technique #2 in the <a href="#Defining_JNDI_Resources">Define JNDI Resource</a> list. (This example lists out the <tt>docBase</tt> to the WAR file itself.)</p>
-<div class="source"><pre>&lt;Context path=&quot;/continuum&quot;
-         docBase=&quot;/path/to/continuum-webapp-1.2.war&quot;&gt;
-
-  &lt;Resource name=&quot;jdbc/users&quot;
-            auth=&quot;Container&quot;
-            type=&quot;javax.sql.DataSource&quot;
-            username=&quot;sa&quot;
-            password=&quot;&quot;
-            driverClassName=&quot;org.apache.derby.jdbc.EmbeddedDriver&quot;
-            url=&quot;jdbc:derby:database/users;create=true&quot; /&gt;
-
-  &lt;Resource name=&quot;jdbc/continuum&quot;
-            auth=&quot;Container&quot;
-            type=&quot;javax.sql.DataSource&quot;
-            username=&quot;sa&quot;
-            password=&quot;&quot;
-            driverClassName=&quot;org.apache.derby.jdbc.EmbeddedDriver&quot;
-            url=&quot;jdbc:derby:database/continuum;create=true&quot; /&gt;
-
-  &lt;Resource name=&quot;mail/Session&quot;
-            auth=&quot;Container&quot;
-            type=&quot;javax.mail.Session&quot;
-            mail.smtp.host=&quot;localhost&quot;/&gt;
-&lt;/Context&gt;</pre>
-</div>
-<p><b>Warning:</b> The Tomcat 5.5.20 and 5.5.23 releases are missing MailSessionFactory and a few other classes. JNDI mail sessions will <b>not</b> work. Use Tomcat 5.5.17 or see the workaround on <a class="externalLink" href="http://issues.apache.org/bugzilla/show_bug.cgi?id=40668">Bug 40668</a>.</p>
-</div>
-<div class="section"><h3><a name="Tomcat_6.0.x_Specifics">Tomcat 6.0.x Specifics</a></h3>
-<p>Tested on Tomcat v6.0.14.</p>
-<div class="source"><pre>&lt;Context path=&quot;/continuum&quot;
-         docBase=&quot;/path/to/continuum-webapp-1.2.war&quot;&gt;
+export CATALINA_OPTS=&quot;-Dappserver.home=$CATALINA_HOME -Dappserver.base=$CATALINA_HOME&quot;</pre></div></div><div class="section"><h4><a name="Context_XML_Example">Context XML Example</a></h4><p>The following context.xml has been tested on Tomcat v5.5.25 and Tomcat v6.0.14.</p><div><pre>&lt;Context path=&quot;/continuum&quot; docBase=&quot;/path/to/continuum-webapp-1.4.1-SNAPSHOT.war&quot;&gt;
 
   &lt;Resource name=&quot;jdbc/users&quot;
             auth=&quot;Container&quot;
@@ -600,11 +427,7 @@ export CATALINA_OPTS=&quot;-Dappserver.h
             auth=&quot;Container&quot;
             type=&quot;javax.mail.Session&quot;
             mail.smtp.host=&quot;localhost&quot;/&gt;
-&lt;/Context&gt;</pre>
-</div>
-</div>
-</div>
-
+&lt;/Context&gt;</pre></div></div></div></div>
       </div>
     </div>
     <div class="clear">
@@ -612,7 +435,7 @@ export CATALINA_OPTS=&quot;-Dappserver.h
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -629,4 +452,4 @@ export CATALINA_OPTS=&quot;-Dappserver.h
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/installation/upgrade.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/installation/upgrade.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/installation/upgrade.html (original)
+++ continuum/site-publish/docs/latest/installation/upgrade.html Fri Dec 28 07:10:12 2012
@@ -21,7 +21,7 @@
     <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
           <meta name="author" content="Olivier Lamy
 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>
@@ -34,7 +34,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">
@@ -60,10 +60,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">      
   
@@ -73,7 +76,7 @@ pageTracker._trackPageview();</script>
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             </div>
       <div class="clear">
         <hr/>
@@ -93,15 +96,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">
@@ -109,11 +112,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,29 +142,21 @@ pageTracker._trackPageview();</script>
             
       
             
-      
-                  
-      
             
             
+      
               
             <li class="expanded">
                     <a href="../installation/index.html">Installation/Upgrade Guides</a>
                   <ul>
                   
     <li class="none">
-                    <a href="../installation/requirements.html">System Requirements</a>
+                    <a href="../installation/standalone.html">Installing Standalone</a>
           </li>
                   
-                
-              
-      
-            
-      
-              
-        <li class="collapsed">
-                    <a href="../installation/installation.html">Installation</a>
-                </li>
+    <li class="none">
+                    <a href="../installation/tomcat.html">Installing in Tomcat</a>
+          </li>
                   
     <li class="none">
                     <a href="../release-notes.html">Release Notes</a>
@@ -170,6 +165,10 @@ pageTracker._trackPageview();</script>
     <li class="none">
               <strong>Upgrade</strong>
         </li>
+                  
+    <li class="none">
+                    <a href="../installation/build-agent.html">Installing a Build Agent</a>
+          </li>
               </ul>
         </li>
               
@@ -220,7 +219,9 @@ pageTracker._trackPageview();</script>
       
             
       
-                    
+                  
+      
+              
         <li class="collapsed">
                     <a href="../user_guides/index.html">User's Guides</a>
                 </li>
@@ -268,8 +269,6 @@ pageTracker._trackPageview();</script>
       
             
       
-            
-      
                   
       
             
@@ -301,54 +300,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>
@@ -403,60 +402,41 @@ pageTracker._trackPageview();</script>
     </div>
     <div id="bodyColumn">
       <div id="contentBox">
-        <div class="section"><h2>Upgrading Continuum</h2>
-<p>This document will help you upgrade Continuum from 1.2.x to 1.3.3 and above.</p>
-<p>When upgrading Continuum, it could have some database model changes. Usually these changes will be migrated for you, but in some cases you may need to use a backup from the previous version and restore that data into the new version. The Data Management tool exports data from the old database model and imports the data into the new database model.</p>
-<p>If you had used the <tt>APP_BASE</tt> environment variable in Continuum 1.2 to differentiate your configuration from the installation, you should rename it to <tt>CONTINUUM_BASE</tt> in Continuum 1.3.</p>
-<div class="section"><h3>Changes to Take Note of in Continuum 1.3.x</h3>
-<p>The Jetty version in Continuum 1.3.4 and above has been upgraded to 6.1.19. When upgrading to Continuum 1.3.4 or higher, there is a need to update the library contents listed in <tt>$CONTINUUM_BASE/conf/wrapper.conf</tt> with the ones included in the new distribution especially if the <tt>$CONTINUUM_BASE</tt> directory is separate from the installation.</p>
-<p>In Continuum 1.3.6, configuration for local repositories in build agents were added. This is used to match the local repository in the build agent to that of the local repository (used by the project to be built) set in the master. So if you are upgrading from a lower version, you might need to add the <tt>localRepositories</tt> configuration in your build agent's configuration file. For more details, read <a href="./build-agent.html">Installing and Configuring a Build Agent</a>. </p>
-</div>
-<div class="section"><h3>Using Backup and Restore to upgrade</h3>
-<p>There are 2 databases that need to be considered: one for the builds and one for the users.</p>
-<p>There were no changes in the users database from 1.2.x to 1.3.2, so you can simply point Continuum 1.3.2 at your existing user database.</p>
-<p>The builds database has had model changes, and will need to be exported and imported.</p>
-<p>First, download the Data Management tools you will need. The tool is a standalone JAR that you can download from the central repo.</p>
-<p>You will need to download two versions of the tool, one for the export out of the old version and one for the import into the new version:</p>
-<p><b>Note:</b> The 1.2, 1.2.2 and 1.2.3 released versions of this tool have a bug. To export databases from 1.2.2 or 1.2.3, you will need to use version 1.2.3.1 of the tool. To export databases from 1.2, you may use the 1.1 version of the tool.</p>
-<ul><li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.3.2/data-management-cli-1.3.2-app.jar">http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.3.2/data-management-cli-1.3.2-app.jar</a></li>
-<li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.2.3.1/data-management-cli-1.2.3.1-app.jar">http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.2.3.1/data-management-cli-1.2.3.1-app.jar</a></li>
-<li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/maven/continuum/data-management-cli/1.1/data-management-cli-1.1-app.jar">http://repo1.maven.org/maven2/org/apache/maven/continuum/data-management-cli/1.1/data-management-cli-1.1-app.jar</a></li>
-</ul>
-<p>Next, follow these steps to export data from the old version</p>
-<ul><li>Stop the old version of Continuum</li>
-<li>Execute this command to create the builds.xml export file<div class="source"><pre>java -Xmx512m -jar data-management-cli-1.2.x-app.jar -buildsJdbcUrl jdbc:derby:${old.continuum.home}/data/databases/continuum -mode EXPORT -directory backups</pre>
-</div>
-</li>
-</ul>
-<p>Then, follow these steps to import the data to the new version</p>
-<ul><li>Start the new version of Continuum to create the new data model, but do not configure it.</li>
-<li>Stop Continuum</li>
-<li>Execute this command to import the builds data from the xml file you created earlier:<div class="source"><pre>java -Xmx512m -jar data-management-cli-1.3.2-app.jar -buildsJdbcUrl jdbc:derby:${new.continuum.home}/data/databases/continuum -mode IMPORT -directory backups -strict</pre>
-</div>
-</li>
-</ul>
-<p><b>Note:</b> Remove <tt>-strict</tt> when importing data from 1.3.1 to 1.3.x to ignore unrecognized tags due to model changes.</p>
-<p>Finally, be aware that sometimes the NEXT_VAL values in the SEQUENCE_TABLE need to be adjusted.</p>
-<ul><li>Before starting Continuum for the first time after the import, connect to the db with a client like <a class="externalLink" href="http://squirrel-sql.sourceforge.net/">Squirrel SQL</a> and check the values in the <b>NEXT_VAL</b> column of the SEQUENCE_TABLE.</li>
-<li>Values must be greater than the max id value in each table.</li>
-<li>For example, the next value of &quot;org.apache.maven.continuum.model.Project&quot; must be greater than the greatest id in Project table.</li>
-<li>Here are some example SQL statements. You may need to add or remove lines depending on the contents of your database.<div class="source"><pre>UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(systemconfiguration_id)+1 from SYSTEMCONFIGURATION) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.system.SystemConfiguration';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from BUILDQUEUE) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.BuildQueue';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from SCHEDULE) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.Schedule';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from BUILDDEFINITION) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.BuildDefinition';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from LOCALREPOSITORY) WHERE SEQUENCE_NAME='org.apache.continuum.model.repository.LocalRepository';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from PROJECTGROUP) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.ProjectGroup';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(scmresult_id)+1 from SCMRESULT) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.scm.ScmResult';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(projectdependency_id)+1 from PROJECTDEPENDENCY) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.ProjectDependency';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from BUILDDEFINITIONTEMPLATE) WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.BuildDefinitionTemplate';
-UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from ABSTRACTPURGECONFIGURATION) WHERE SEQUENCE_NAME='org.apache.continuum.model.repository.AbstractPurgeConfiguration';</pre>
-</div>
-</li>
-</ul>
-<p>Now you can start your new version of Continuum.</p>
-</div>
-</div>
+        <div class="section"><h2>Upgrading Continuum<a name="Upgrading_Continuum"></a></h2><p>This document will help you upgrade Continuum from 1.2.x to 1.3.3 and above.</p><p>When upgrading Continuum, it could have some database model changes. Usually these changes will be migrated for you, but in some cases you may need to use a backup from the previous version and restore that data into the new version. The Data Management tool exports data from the old database model and imports the data into the new database model.</p><p>If you had used the <tt>APP_BASE</tt> environment variable in Continuum 1.2 to differentiate your configuration from the installation, you should rename it to <tt>CONTINUUM_BASE</tt> in Continuum 1.3.</p><div class="section"><h3>Changes to Take Note of in Continuum 1.4.x<a name="Changes_to_Take_Note_of_in_Continuum_1.4.x"></a></h3><p>The Jetty version in Continuum 1.4.1 and above has been upgraded to 8.1.7. When upgrading to Continuum 1.4.1 or higher, 
 there is a need to update the contents of <tt>$CONTINUUM_BASE/conf/wrapper.conf</tt> to match the one included in the new distribution if any copies or modifications have been made. The <tt>jetty.xml</tt> format has also changed, and should be re-added from the distribution with any modifications previously made. It is no longer read from <tt>$CONTINUUM_BASE</tt>, and JNDI connections can now be managed via the files in the <tt>contexts</tt> directory.</p></div><div class="section"><h3>Changes to Take Note of in Continuum 1.3.x<a name="Changes_to_Take_Note_of_in_Continuum_1.3.x"></a></h3><p>The Jetty version in Continuum 1.3.4 and above has been upgraded to 6.1.19. When upgrading to Continuum 1.3.4 or higher, there is a need to update the library contents listed in <tt>$CONTINUUM_BASE/conf/wrapper.conf</tt> with the ones included in the new distribution especially if the <tt>$CONTINUUM_BASE</tt> directory is separate from the installation.</p><p>In Continuum 1.3.6, configura
 tion for local repositories in build agents were added. This is used to match the local repository in the build agent to that of the local repository (used by the project to be built) set in the master. So if you are upgrading from a lower version, you might need to add the <tt>localRepositories</tt> configuration in your build agent's configuration file. For more details, read <a href="./build-agent.html">Installing and Configuring a Build Agent</a>.</p></div><div class="section"><h3>Using Backup and Restore to upgrade<a name="Using_Backup_and_Restore_to_upgrade"></a></h3><p>There are 2 databases that need to be considered: one for the builds and one for the users.</p><p>While the databases typically auto-upgrade across releases, you may wish to perform an export and import to have full control of the upgrade, make modifications to the data, or retain a backup in case a downgrade is needed.</p><p>First, download the Data Management tools you will need. The tool is a standal
 one JAR that you can download from the central repo.</p><p>You will need to download two versions of the tool, one for the export out of the old version and one for the import into the new version:</p><p><b>Note:</b> The 1.2, 1.2.2 and 1.2.3 released versions of this tool have a bug. To export databases from 1.2.2 or 1.2.3, you will need to use version 1.2.3.1 of the tool. To export databases from 1.2, you may use the 1.1 version of the tool.</p><ul><li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.4.1-SNAPSHOT/data-management-cli-1.4.1-SNAPSHOT-app.jar"> Data Management CLI for Continuum 1.4.1-SNAPSHOT</a></li><li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.3.8/data-management-cli-1.3.8-app.jar"> Data Management CLI for Continuum 1.3.8</a></li><li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/continuum/data-management-cli/1.2.3.1/data-
 management-cli-1.2.3.1-app.jar"> Data Management CLI for Continuum 1.2.x</a></li><li><a class="externalLink" href="http://repo1.maven.org/maven2/org/apache/maven/continuum/data-management-cli/1.1/data-management-cli-1.1-app.jar"> Data Management CLI for Continuum 1.1</a></li></ul><p>Next, follow these steps to export data from the old version</p><ul><li>Stop the old version of Continuum</li><li>Execute this command to create the <tt>builds.xml</tt> export file<div class="source"><pre>java -Xmx512m -jar data-management-cli-1.2.3.1-app.jar \
+  -buildsJdbcUrl jdbc:derby:${old.continuum.home}/data/databases/continuum \
+  -mode EXPORT \
+  -directory backups</pre></div></li></ul><p>Then, follow these steps to import the data to the new version</p><ul><li>Start the new version of Continuum to create the new data model, but do not configure it.</li><li>Stop Continuum</li><li>Execute this command to import the builds data from the XML file you created earlier:<div class="source"><pre>java -Xmx512m -jar data-management-cli-1.4.1-SNAPSHOT-app.jar \
+  -buildsJdbcUrl jdbc:derby:${new.continuum.home}/data/databases/continuum \
+  -mode IMPORT \
+  -directory backups -strict</pre></div></li></ul><p><b>Note:</b> Remove <tt>-strict</tt> when importing data from 1.3.1 to 1.3.x to ignore unrecognized tags due to model changes.</p><p>Finally, be aware that sometimes the <tt>NEXT_VAL</tt> values in the <tt>SEQUENCE_TABLE</tt> need to be adjusted. Before starting Continuum for the first time after the import, connect to the database with a client like <a class="externalLink" href="http://squirrel-sql.sourceforge.net/">Squirrel SQL</a> and check the values in the <tt>NEXT_VAL</tt> column of the <tt>SEQUENCE_TABLE</tt>.</p><p>Values must be greater than the max ID value in each table. For example, the next value of <tt>org.apache.maven.continuum.model.Project</tt> must be greater than the greatest ID in <tt>Project</tt> table.</p><p>Here are some example SQL statements. You may need to add or remove lines depending on the contents of your database.</p><div class="source"><pre>UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(s
 ystemconfiguration_id)+1 from SYSTEMCONFIGURATION)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.system.SystemConfiguration';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from BUILDQUEUE)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.BuildQueue';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from SCHEDULE)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.Schedule';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from BUILDDEFINITION)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.BuildDefinition';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from LOCALREPOSITORY)
+  WHERE SEQUENCE_NAME='org.apache.continuum.model.repository.LocalRepository';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from PROJECTGROUP)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.ProjectGroup';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(scmresult_id)+1 from SCMRESULT)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.scm.ScmResult';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(projectdependency_id)+1 from PROJECTDEPENDENCY)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.ProjectDependency';
+
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from BUILDDEFINITIONTEMPLATE)
+  WHERE SEQUENCE_NAME='org.apache.maven.continuum.model.project.BuildDefinitionTemplate';
 
+UPDATE SEQUENCE_TABLE set NEXT_VAL = (select max(id)+1 from ABSTRACTPURGECONFIGURATION)
+  WHERE SEQUENCE_NAME='org.apache.continuum.model.repository.AbstractPurgeConfiguration';</pre></div><p>Now you can start your new version of Continuum.</p></div></div>
       </div>
     </div>
     <div class="clear">
@@ -464,7 +444,7 @@ UPDATE SEQUENCE_TABLE set NEXT_VAL = (se
     </div>
     <div id="footer">
       <div class="xright">&#169;  
-          2003-2010
+          2003-2012
     
           The Apache Software Foundation
           
@@ -481,4 +461,4 @@ UPDATE SEQUENCE_TABLE set NEXT_VAL = (se
       </div>
     </div>
   </body>
-</html>
+</html>
\ No newline at end of file



Mime
View raw message