Return-Path: X-Original-To: apmail-continuum-commits-archive@www.apache.org Delivered-To: apmail-continuum-commits-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 18EA4DCF1 for ; Fri, 28 Dec 2012 07:10:57 +0000 (UTC) Received: (qmail 81289 invoked by uid 500); 28 Dec 2012 07:10:57 -0000 Delivered-To: apmail-continuum-commits-archive@continuum.apache.org Received: (qmail 81179 invoked by uid 500); 28 Dec 2012 07:10:56 -0000 Mailing-List: contact commits-help@continuum.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@continuum.apache.org Delivered-To: mailing list commits@continuum.apache.org Received: (qmail 81116 invoked by uid 99); 28 Dec 2012 07:10:54 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 28 Dec 2012 07:10:54 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=5.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 28 Dec 2012 07:10:41 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id AC4BA238899C; Fri, 28 Dec 2012 07:10:18 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1426423 [3/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 -0000 To: commits@continuum.apache.org From: brett@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20121228071018.AC4BA238899C@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: continuum/site-publish/docs/latest/administrator_guides/external-db.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/external-db.html?rev=1426423&r1=1426422&r2=1426423&view=diff ============================================================================== --- continuum/site-publish/docs/latest/administrator_guides/external-db.html (original) +++ continuum/site-publish/docs/latest/administrator_guides/external-db.html Fri Dec 28 07:10:12 2012 @@ -20,7 +20,7 @@ - + @@ -33,7 +33,7 @@ pageTracker._trackPageview();
@@ -72,7 +75,7 @@ pageTracker._trackPageview(); - Last Published: 06 May 2010 + Last Published: 28 Dec 2012
@@ -92,15 +95,15 @@ pageTracker._trackPageview();
-

How to use an external database?

-

Supported databases

-
  • Derby
    • -
  • MySQL
    • -
  • MS SQL Server
    • -
  • Oracle (not yet, but coming soon)
    • -
-
-

Configure Continuum

-

Standalone version

-

To use an external database with Continuum standalone, you must configure DataSources in $CONTINUUM_HOME/conf/jetty.xml

-
  <!-- continuum database -->
-   
-  <New id="continuum" class="org.mortbay.jetty.plus.naming.Resource">
-    <Arg>jdbc/continuum</Arg>
-    <Arg>
-      <New class="org.apache.derby.jdbc.EmbeddedDataSource">
-        <Set name="DatabaseName"><SystemProperty name="appserver.base" default=".."/>/data/databases/continuum</Set>
-        <Set name="user">sa</Set>
-        <Set name="createDatabase">create</Set>
-      </New>
-    </Arg>
-  </New>
-
-  <New id="continuumShutdown" class="org.mortbay.jetty.plus.naming.Resource">
-    <Arg>jdbc/continuumShutdown</Arg>
-    <Arg>
-      <New class="org.apache.derby.jdbc.EmbeddedDataSource">
-        <Set name="DatabaseName"><SystemProperty name="appserver.base" default=".."/>/data/databases/continuum</Set>
-        <Set name="user">sa</Set>
-        <Set name="shutdownDatabase">shutdown</Set>
-      </New>
-    </Arg>
-  </New>
- 
-  <!-- Users / Security Database -->
-  
-  <New id="users" class="org.mortbay.jetty.plus.naming.Resource">
-    <Arg>jdbc/users</Arg>
-    <Arg>
-      <New class="org.apache.derby.jdbc.EmbeddedDataSource">
-        <Set name="DatabaseName"><SystemProperty name="appserver.base" default=".."/>/data/databases/users</Set>
-        <Set name="user">sa</Set>
-        <Set name="createDatabase">create</Set>
-      </New>
-    </Arg>
-  </New>
-
-  <New id="usersShutdown" class="org.mortbay.jetty.plus.naming.Resource">
-    <Arg>jdbc/usersShutdown</Arg>
-    <Arg>
-      <New class="org.apache.derby.jdbc.EmbeddedDataSource">
-        <Set name="DatabaseName"><SystemProperty name="appserver.base" default=".."/>/data/databases/users</Set>
-        <Set name="user">sa</Set>
-        <Set name="shutdownDatabase">shutdown</Set>
-      </New>
-    </Arg>
-  </New>
-  
-
-
-
-

Webapp

-

To use an external database with the Continuum webapp, you should configure the DataSource in your container.

-
-
-

Shutdown Procedure

-

When using an external database, it is very important to stop Continuum prior to stopping or restarting the database. Continuum may exhibit unpredictable behavior if the database disappears while it is running, and may not recover once the database comes back up. If this happens, you must re-start Continuum. If you experience errors after re-starting, the data may be corrupted and may need to be fixed by editing records directly in the database.

-
-
- +

How to use an external database?

Supported databases

  • Derby
  • MySQL
  • MS SQL Server
  • Oracle (not yet, but coming soon)

Configure Continuum

Standalone version

To use an external database with Continuum standalone, you must configure DataSources in $CONTINUUM_HOME/conf/jetty.xml

Webapp
To use an external database with the Continuum webapp, you should configure the DataSource in your container.
Shutdown Procedure
When using an external database, it is very important to stop Continuum 
 prior to stopping or restarting the database. Continuum may exhibit unpredictable behavior if the database disappears while it is running, and may not recover once the database comes back up. If this happens, you must re-start Continuum. If you experience errors after re-starting, the data may be corrupted and may need to be fixed by editing records directly in the database.

       

     

     

@@ -556,7 +483,7 @@ pageTracker._trackPageview();
     

     
   
-
+
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/index.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/index.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/index.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/index.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     
     
           
-        
+        
                                                     
 
@@ -33,7 +33,7 @@ pageTracker._trackPageview();
     
             
      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             

       

         

@@ -92,15 +95,15 @@ pageTracker._trackPageview();
             

     
     

@@ -510,7 +483,7 @@ pageTracker._trackPageview();
     

     
   
-
+
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/jdk.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/jdk.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/jdk.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/jdk.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     
     
           
-        
+        
                                                     
 
@@ -33,7 +33,7 @@ pageTracker._trackPageview();
     
             
      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             

       

         

@@ -92,15 +95,15 @@ pageTracker._trackPageview();
             

     

       

-        
Managing JDKs

-
From the menu, choose the 'Installations' entry 

-Installations
Here you must choose the Installation Type you want to add (here a Tool)

-Installation Type Choice
You must configure the tool you want to add

-Tool Setup
You can use the checkbox if you want to add a Profile with the same name as your jdk name.

-
The value 'Value/Path' field must contain the jdk path (as a JAVA_HOME value).

-
The value will validated by testing path/bin/java -version

-
If the test fails, the following error will be displayed

-Jdk validation failed 

-
+        
Managing JDKs
From the menu, choose the 'Installations' entry 
Installations
Here you must choose the Installation Type you want to add (here a Tool)
Installation Type Choice
You must configure the tool you want to add
Tool Setup
You can use the checkbox if you want to add a Profile with the same name as your jdk name.
The value 'Value/Path' field must contain the jdk path (as a JAVA_HOME value).
The value will validated by testing path/bin/java -version
If the test fails, the following error will be displayed
Jdk validation failed 

       

     

     

@@ -495,7 +387,7 @@ pageTracker._trackPageview();
     

     
   
-
+
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/localRepository.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/localRepository.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/localRepository.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/localRepository.html Fri Dec 28 07:10:12 2012
@@ -19,7 +19,7 @@
       @import url("../css/site.css");
     
     
-        
+        
                                                     
 
@@ -32,7 +32,7 @@ pageTracker._trackPageview();
     
             
      
   
@@ -71,7 +74,7 @@ pageTracker._trackPageview();
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             

       

         

@@ -91,15 +94,15 @@ pageTracker._trackPageview();
             

     

       

-        
Local Repository

-
Local repositories can be configured for a specific project group's use. This is where the artifacts used for building the projects can be found instead of the default ($USER_HOME/.m2/repository).

-
Click the Local Repositories link under the Administration section

-Local Repositories
You will see all the local repositories that have been created.

-
To display:

-
In this screen you can add/edit/delete/purge a local repository.

-
You can purge a repository if it has a default  Purge Configuration, otherwise the purge icon is disabled.

-disabled purge icon
Adding / Editing a Local Repository

-
All fields are mandatory.

-
  • Name: must be a unique repository name.
    • 
-
  • Location: must be the absolute path of a unique repository location.
    • 
-
  • Layout: "default" or "legacy". Default layout is for maven2, while legacy layout is for maven1.
    Adding a local repository will automatically create a default  Purge Configuration for that repository.
    
-
    If you're using distributed builds, you must configure a localRepository with the same name in the build agent's configuration file where the location is the local path to the local repository in the build agent machine. See Distributed Builds for more details.
    
-
    • 
-

-

-
Default

-
The default local repository location comes from the settings of the user running Continuum. The location cannot be edited within Continuum, but can be changed by specifying it in ~/.m2/settings.xml.

-

-

-
+        
Local Repository
Local repositories can be configured for a specific project group's use. This is where the artifacts used for building the projects can be found instead of the default ($USER_HOME/.m2/repository).
Click the Local Repositories link under the Administration section
Local Repositories
You will see all the local repositories that have been created.
To display:
In this screen you can add/edit/delete/purge a local repository.
You can purge a repository if it has a default  Purge Configuration, otherwise the purge icon is disabled.
disabled purge icon
Adding / Editing a Local Repository
All fields are mandatory.
  • Name: must be a unique repository name.
  • Location: must be the absolute path of a unique repository location.
  • Layout: "default" or "legacy". Default layout is for maven2, while legacy layout is for maven1.
    Adding a local repository will automatically create a default  Purge Configuration for that repository.
    If you're using distributed builds, you must configure a localRepository with the same name in the build agent's configuration file where the location is the local path to the local repository in the build agent machine. See Distributed Builds for more details.
Default
The default local repository location comes from the settings of the user running Continuum. The location cannot be edited within Continuum, but can be changed by specifying it in ~/.m2/settings.xml.
On Windows 7, you can pass the argument -Duser.home=C:\Users\<Username>\ to the JVM explicitly. Since running Continuum as an Administrator will give you a different user.home value.

       

     

     

@@ -505,7 +482,7 @@ pageTracker._trackPageview();
     

     
   
-
+
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/logging.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/logging.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/logging.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/logging.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     
     
           
-        
+        
                                                     
 
@@ -33,7 +33,7 @@ pageTracker._trackPageview();
     
             
      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             

       

         

@@ -92,15 +95,15 @@ pageTracker._trackPageview();
             

     

       

-        
Log Files

-
To keep track of the Continuum performance and problems, log files are created during runtime. These files can be found in the logs/ directory.

-
  •  continuum.log - contains all the start-up information for Continuum.
    • 
-
  •  continuum-audit.log - contains information regarding the project operations and configurations being modified. For example, projects added are logged here, with date and timestamp, userId of who performed the deploy, and the project that was built. For security measure, passwords are masked behind asterisks.
    • 
-
  •  continuum-security-audit.log - contains information regarding Continuum's security. For example, a successful login of a user or a user account is created.
    • 
-

-

-
+        
Log Files
To keep track of the Continuum performance and problems, log files are created during runtime. These files can be found in the logs/ directory.
  •  continuum.log - contains all the start-up information for Continuum.
  •  continuum-audit.log - contains information regarding the project operations and configurations being modified. For example, projects added are logged here, with date and timestamp, userId of who performed the deploy, and the project that was built. For security measure, passwords are masked behind asterisks.
  •  continuum-security-audit.log - contains information regarding Continuum's security. For example, a successful login of a user or a user account is created.

       

     

     

@@ -507,7 +497,7 @@ pageTracker._trackPageview();
     

     
   
-
+
\ No newline at end of file

Modified: continuum/site-publish/docs/latest/administrator_guides/monitoring.html
URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/latest/administrator_guides/monitoring.html?rev=1426423&r1=1426422&r2=1426423&view=diff
==============================================================================
--- continuum/site-publish/docs/latest/administrator_guides/monitoring.html (original)
+++ continuum/site-publish/docs/latest/administrator_guides/monitoring.html Fri Dec 28 07:10:12 2012
@@ -20,7 +20,7 @@
     
     
           
-        
+        
                                                     
 
@@ -33,7 +33,7 @@ pageTracker._trackPageview();
     
             
      
   
@@ -72,7 +75,7 @@ pageTracker._trackPageview();
   
   
     
-             Last Published: 06 May 2010
+             Last Published: 28 Dec 2012
             

       

         

@@ -92,15 +95,15 @@ pageTracker._trackPageview();
             

     

       

-        
Monitoring a Continuum instance

-
JConsole

-
  • Edit $CONTINUUM_HOME/bin/[platform]/wrapper.conf to add:
    wrapper.java.additional.9=-Dcom.sun.management.jmxremote
    
-
    
-
    • 
-
  • Start Continuum
    • 
-
  • Start jconsole, (included with Sun JDK 1.5 and later,) select the 'WrapperSimpleApp' line, and click Connect
    The following image shows starting Continuum 1.1, adding a project group, then adding and building the trunk of the Shale Framework (14 modules):
    
-
    The following image shows the same Continuum instance running for several hours:
    
-
    • 
-

-

-
Garbage Collection and Heap Size

-
Edit $CONTINUUM_HOME/bin/[platform]/wrapper.conf to add:

-
wrapper.java.additional.10=-verbose:gc
+        
Monitoring a Continuum instance
JConsole
  • Edit $CONTINUUM_HOME/bin/[platform]/wrapper.conf to add:
    wrapper.java.additional.9=-Dcom.sun.management.jmxremote
  • Start Continuum
  • Start jconsole, (included with Sun JDK 1.5 and later,) select the 'WrapperSimpleApp' line, and click Connect
    The following image shows starting Continuum 1.1, adding a project group, then adding and building the trunk of the Shale Framework (14 modules):
    The following image shows the same Continuum instance running for several hours:
Garbage Collection and Heap Size
Edit $CONTINUUM_HOME/bin/[platform]/wrapper.conf to add:
wrapp
 er.java.additional.10=-verbose:gc
    or
-wrapper.java.additional.10=-Xloggc:gc.txt

-

-
The first sends to the console (and wrapper log) while the second sends to the filename that you tell it to.

-
Example output:

-
420.568: [GC 62459K->58474K(65104K), 0.0074933 secs]
+wrapper.java.additional.10=-Xloggc:gc.txt
The first sends to the console (and wrapper log) while the second sends to the filename that you tell it to.
Example output:
420.568: [GC 62459K->58474K(65104K), 0.0074933 secs]
 420.778: [GC 62634K->58733K(65104K), 0.0060762 secs]
 420.919: [GC 62893K->58832K(65104K), 0.0034433 secs]
 421.015: [GC 62992K->58723K(65104K), 0.0026420 secs]
@@ -510,16 +490,7 @@ wrapper.java.additional.10=-Xloggc:gc.tx
 421.930: [GC 37280K->34582K(65104K), 0.0056601 secs]
 422.074: [GC 38742K->35150K(65104K), 0.0072451 secs]
 
-             before->after (total),  time

-

-
This shows the heap size before and after garbage collection as well as the total heap size and the time for the GC run.

-

-
References

-
  • [http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html]
    • 
-

-

-

-
+             before->after (total),  time
This shows the heap size before and after garbage collection as well as the total heap size and the time for the GC run.
References
  • [http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html]

       

     

     

@@ -527,7 +498,7 @@ wrapper.java.additional.10=-Xloggc:gc.tx
     

     
   
-
+
\ No newline at end of file