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 62F28DCB9 for ; Wed, 28 Nov 2012 06:48:04 +0000 (UTC) Received: (qmail 34590 invoked by uid 500); 28 Nov 2012 06:48:04 -0000 Delivered-To: apmail-continuum-commits-archive@continuum.apache.org Received: (qmail 34517 invoked by uid 500); 28 Nov 2012 06:48:03 -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 34415 invoked by uid 99); 28 Nov 2012 06:48:01 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 28 Nov 2012 06:48:01 +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; Wed, 28 Nov 2012 06:47:57 +0000 Received: from eris.apache.org (localhost [127.0.0.1]) by eris.apache.org (Postfix) with ESMTP id 913F32388A5E; Wed, 28 Nov 2012 06:47:37 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r1414546 [2/7] - in /continuum/site-publish/docs: ./ 1.1/ 1.1/administrator_guides/ 1.1/administrator_guides/security/ 1.1/developer_guides/ 1.1/installation/ 1.1/knowledge_base/ 1.1/user_guides/ 1.1/user_guides/building_project/ 1.1/user_g... Date: Wed, 28 Nov 2012 06:47:32 -0000 To: commits@continuum.apache.org From: brett@apache.org X-Mailer: svnmailer-1.0.8-patched Message-Id: <20121128064737.913F32388A5E@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Added: continuum/site-publish/docs/1.1/administrator_guides/monitoring.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/1.1/administrator_guides/monitoring.html?rev=1414546&view=auto ============================================================================== --- continuum/site-publish/docs/1.1/administrator_guides/monitoring.html (added) +++ continuum/site-publish/docs/1.1/administrator_guides/monitoring.html Wed Nov 28 06:47:27 2012 @@ -0,0 +1,419 @@ + + + + + + + + + + + + + + + Apache Maven Continuum - Monitoring a Continuum instance + + + + + + + + +
+ +
+
+
+

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
+   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]
+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]
+421.067: [GC 62883K->60885K(65104K), 0.0107248 secs]
+421.140: [GC 65045K->62114K(66384K), 0.0122194 secs]
+421.153: [Full GC 62114K->32136K(66384K), 0.3591207 secs]
+421.655: [GC 36296K->32242K(65104K), 0.0037377 secs]
+421.754: [GC 36402K->33061K(65104K), 0.0037182 secs]
+421.835: [GC 37221K->33120K(65104K), 0.0028722 secs]
+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]
    • +
+
+
+ +
+
+
+
+
+ + + Added: continuum/site-publish/docs/1.1/administrator_guides/profiles.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/1.1/administrator_guides/profiles.html?rev=1414546&view=auto ============================================================================== --- continuum/site-publish/docs/1.1/administrator_guides/profiles.html (added) +++ continuum/site-publish/docs/1.1/administrator_guides/profiles.html Wed Nov 28 06:47:27 2012 @@ -0,0 +1,430 @@ + + + + + + + + + + + + + + + Apache Maven Continuum - Continuum :: Build Profile + + + + + + + + +
+ +
+
+
+

Build Profile

+ +

Goal

+

The main goal is to compile/test sources against the targeted jvm, mvn/maven version, ant version and to add defined envvar (MAVEN_OPTS, ANT_OPTS ...). This is now possible at the build definition level (in 1.1).

+
+

Setup Profile/Installations

+

Creating a profile +

+

From the menu, choose the 'Profiles' entry

+Profile

Enter a profile name (the name is free)

+Add Profile
+

Attach jdk to a Profile +

+

The list box contains all availables installations (jdk, mvn etc..). The installation's type is automatically recognized. In the modification mode of a profile, adding an already attached type will override the existing one.

+Add Profile
+

Link profile to build definition +

+

The list box contains all availables installations (jdk, mvn etc..). The installation's type is automatically recognized. In the modification mode of a profile, adding an already attached type will override the existing one.

+Setup Build Profile
+

Installations used in Notification mail +

+

The notification mail contains the following informations :

+
  • Java Home version : coming from $JAVA_HOME/bin/java -version.
    • +
  • Builder version : coming from builder used version arg (mvn used -v, ant use -version).
    • +
+
  Java Home version : 
+          java version "1.4.2_06"
+          Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_06-b03)
+          Java HotSpot(TM) Client VM (build 1.4.2_06-b03, mixed mode)
+        
+  Builder version :
+          Maven version: 2.0.5
+
+
+
+
+ +
+
+
+
+
+ + + Added: continuum/site-publish/docs/1.1/administrator_guides/projectgroup.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/1.1/administrator_guides/projectgroup.html?rev=1414546&view=auto ============================================================================== --- continuum/site-publish/docs/1.1/administrator_guides/projectgroup.html (added) +++ continuum/site-publish/docs/1.1/administrator_guides/projectgroup.html Wed Nov 28 06:47:27 2012 @@ -0,0 +1,386 @@ + + + + + + + + + + + + + + + Apache Maven Continuum - Adding Project Group + + + + + + + + +
+ +
+
+
+

Adding Project Group

+

From the home page (Group Summary) Use the the 'Add Project Group' button

+Add Project Group

Then You will have the project Group detail.

+Edit Project Group detail

Some fields are mandatory :

+
  • Project Group Name
    • +
  • Project Group Id
    • +
+
+ +
+
+
+
+
+ + + Added: continuum/site-publish/docs/1.1/administrator_guides/schedules.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/1.1/administrator_guides/schedules.html?rev=1414546&view=auto ============================================================================== --- continuum/site-publish/docs/1.1/administrator_guides/schedules.html (added) +++ continuum/site-publish/docs/1.1/administrator_guides/schedules.html Wed Nov 28 06:47:27 2012 @@ -0,0 +1,381 @@ + + + + + + + + + + + + + + + Apache Maven Continuum - Managing Schedules + + + + + + + + +
+ +
+
+
+

Managing Schedules

+

Coming Soon

+
+ +
+
+
+
+
+ + + Added: continuum/site-publish/docs/1.1/administrator_guides/security/index.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/1.1/administrator_guides/security/index.html?rev=1414546&view=auto ============================================================================== --- continuum/site-publish/docs/1.1/administrator_guides/security/index.html (added) +++ continuum/site-publish/docs/1.1/administrator_guides/security/index.html Wed Nov 28 06:47:27 2012 @@ -0,0 +1,387 @@ + + + + + + + + + + + + + + + Apache Maven Continuum - Managing Users and Security + + + + + + + + +
+ +
+
+
+

Managing Users and Security

+

To write

+
+ +
+
+
+
+
+ + + Added: continuum/site-publish/docs/1.1/administrator_guides/security/ldap.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/1.1/administrator_guides/security/ldap.html?rev=1414546&view=auto ============================================================================== --- continuum/site-publish/docs/1.1/administrator_guides/security/ldap.html (added) +++ continuum/site-publish/docs/1.1/administrator_guides/security/ldap.html Wed Nov 28 06:47:27 2012 @@ -0,0 +1,554 @@ + + + + + + + + + + + + + + + Apache Maven Continuum - LDAP Configuration + + + + + + + + +
+ +
+
+
+

LDAP Configuration

+

Continuum support LDAP for authentication. To configure it, you should follow these steps:

+
  • Shutdown Continuum
    • +
  • Open apps/continuum/webapp/WEB-INF/classes/META-INF/plexus/application.xml + and uncomment the following xml
    • +
+
    <!-- 
+       Ldap Authentication can be enabled by setting enabling these components and setting the following configuration options in your security.properties file
+      
+       user.manager.impl=ldap
+       ldap.bind.authenticator.enabled=true
+       redback.default.admin=admin
+       redback.default.guest=guest
+       security.policy.password.expiration.enabled=false
+      
+       until this process is better documented, the following is the document for configuration ldap with redback
+      
+       http://redback.codehaus.org/integration/ldap.html
+    -->
+
+    <!--
+    
+    this component manages the connection to the ldap server
+    
+     * hostname - The hostname of the ldap server
+     * port - The port of the ldap server
+     * baseDn - The baseDn of the ldap system
+     * contextFactory - context factory for ldap connections
+     * password - password for the bindDn for the root ldap connection
+     * bindDn - the core user used for authentication the ldap server, must be able to perform the necessary searches, etc.
+     -->
+
+    <!-- component>
+      <role>org.codehaus.plexus.redback.common.ldap.connection.LdapConnectionFactory</role>
+      <role-hint>configurable</role-hint>
+      <implementation>org.codehaus.plexus.redback.common.ldap.connection.ConfigurableLdapConnectionFactory</implementation>
+      <description></description>
+      <configuration>
+        <hostname></hostname>
+        <port></port>
+        <baseDn></baseDn>
+        <contextFactory>com.sun.jndi.ldap.LdapCtxFactory</contextFactory>
+        <password></password>
+        <bindDn></bindDn>
+      </configuration>
+    </component-->
+    
+    <!-- 
+    
+    this component manages the mapping of attributes in ldap to user information in redback
+    
+     * email-attribute - The name of the attribute on a user that contains the email address
+     * full-name-attribute - The name of the attribute on a user that contains the users fullName
+     * password-attribute - The name of the attribute containing the users password, used for the authentiction using the user manager and not the ldap bind authenticator
+     * user-id-attribute - The name of the attribute containing the users userId, most commonly cn or sn.
+     * user-base-dn - The base dn that will be subtree searched for users.
+     * user-object-class - the objectClass used in the ldap server for indentifying users, most commonly inetOrgPerson.
+     -->
+    
+    <!-- component>
+      <role>org.codehaus.plexus.redback.common.ldap.UserMapper</role>
+      <role-hint>ldap</role-hint>
+      <implementation>org.codehaus.plexus.redback.common.ldap.LdapUserMapper</implementation>
+      <description></description>
+      <configuration>
+        <email-attribute>email</email-attribute>
+        <full-name-attribute>givenName</full-name-attribute>
+        <password-attribute>userPassword</password-attribute>
+        <user-id-attribute>cn</user-id-attribute>
+        <user-base-dn>o=com</user-base-dn>
+        <user-object-class>inetOrgPerson</user-object-class>
+      </configuration>
+    </component-->
+    
+    <!--
+     
+    If caching is desired then make uncomment this and make sure the following configuration parameter is in the security.properties
+     
+    user.manager.impl=cached
+    -->
+     
+    <!-- component>
+      <role>org.codehaus.plexus.redback.users.UserManager</role>
+      <role-hint>cached</role-hint>
+      <implementation>org.codehaus.plexus.redback.users.cached.CachedUserManager</implementation>
+      <description>CachedUserManager</description>
+      <requirements>
+        <requirement>
+          <role>org.codehaus.plexus.redback.users.UserManager</role>
+          <role-hint>ldap</role-hint>
+          <field-name>userImpl</field-name>
+        </requirement>
+        <requirement>
+          <role>org.codehaus.plexus.ehcache.EhcacheComponent</role>
+          <role-hint>users</role-hint>
+          <field-name>usersCache</field-name>
+        </requirement>
+      </requirements>
+    </component-->
+    
+    <!-- 
+    
+    if using the user manager authenticator to authenticate the user and not the ldap bind authenticator make sure
+    this definition has the correct password encoder
+    
+    Note: you should probably just use the ldap bind authenticator which is enabled by putting
+    
+    ldap.bind.authenticator.enabled=true
+    
+    in the security.properties
+    -->
+    
+    <!-- component>
+      <role>org.codehaus.plexus.redback.policy.UserSecurityPolicy</role>
+      <role-hint>default</role-hint>
+      <implementation>org.codehaus.plexus.redback.policy.DefaultUserSecurityPolicy</implementation>
+      <description>User Security Policy.</description>
+      <requirements>
+        <requirement>
+          <role>org.codehaus.plexus.redback.configuration.UserConfiguration</role>
+          <field-name>config</field-name>
+        </requirement>
+        <requirement>
+          <role>org.codehaus.plexus.redback.policy.PasswordEncoder</role>
+          <role-hint>sha1</role-hint>
+          <field-name>passwordEncoder</field-name>
+        </requirement>
+        <requirement>
+          <role>org.codehaus.plexus.redback.policy.UserValidationSettings</role>
+          <field-name>userValidationSettings</field-name>
+        </requirement>
+        <requirement>
+          <role>org.codehaus.plexus.redback.policy.CookieSettings</role>
+          <role-hint>rememberMe</role-hint>
+          <field-name>rememberMeCookieSettings</field-name>
+        </requirement>
+        <requirement>
+          <role>org.codehaus.plexus.redback.policy.CookieSettings</role>
+          <role-hint>signon</role-hint>
+          <field-name>signonCookieSettings</field-name>
+        </requirement>
+        <requirement>
+          <role>org.codehaus.plexus.redback.policy.PasswordRule</role>
+          <field-name>rules</field-name>
+        </requirement>
+      </requirements>
+    </component-->
+
+
+

All you need to configure is the ConfigurableLdapConnectionFactory and LdapUserMapper components

+
  • Add a security.properties files under $CONTINUUM_HOME/conf/ with the following content:
    user.manager.impl=ldap
+ldap.bind.authenticator.enabled=true
+redback.default.admin=adminuser
+redback.default.guest=guestuser
+security.policy.password.expiration.enabled=false
+user.manager.impl=cached
+ldap.bind.authenticator.enabled=true
    +
    +

    adminuser + is a LDAP user and will be the default Continuum admin. guestuser + is a LDAP user and will be used for the guest + role, generally, it is an utility LDAP account.

    +
    • +
  • Restart Continuum
    • +
+

Other resources

+

Redback LDAP page +

+
+
+ +
+
+
+
+
+ + + Added: continuum/site-publish/docs/1.1/administrator_guides/shutdown.html URL: http://svn.apache.org/viewvc/continuum/site-publish/docs/1.1/administrator_guides/shutdown.html?rev=1414546&view=auto ============================================================================== --- continuum/site-publish/docs/1.1/administrator_guides/shutdown.html (added) +++ continuum/site-publish/docs/1.1/administrator_guides/shutdown.html Wed Nov 28 06:47:27 2012 @@ -0,0 +1,390 @@ + + + + + + + + + + + + + + + Apache Maven Continuum - Shutdown Continuum + + + + + + + + +
+ +
+
+
+

Shutdown Continuum

+

To Shutdown correctly Continuum, you should look at the build queue. It isn't recommended to shutdown Continuum when a project is building or in the queue.

+

Queues view

+

From the menu, choose the 'Queues' link

+Queues

Then you'll get the Queues page

+Queues

In this page you can see the current build, projects in the build queue, the current checkout and projects in the checkout queue. For each line, you can cancel the process

+
+

Shutdown

+

To shutdown Continuum, the queue must be empty, so when you want to shutdown it, you can wait the end of all processes or cancel them.

+

If you don't want to have new projects added in the build queue before you shutdown Continuum, you can disable all schedules (Note: You'll need to enable them on the next startup). In future, you'll have an action to automate the disable/enable schedules process.

+
+
+ +
+
+
+
+
+ + +