Versions Compared

Old Version 12

changes.mady.by.user Wendy Smoak

Saved on

compared with

New Version Current

changes.mady.by.user Brett Porter

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Continuum is installed in /opt/apache-continuum-1.2X.Y.Z, but its configuration is in /home/continuum/services/continuum. It is run using the Java Service Wrapper, and is started by the system init scripts.

Continuum's data is stored in /home/continuum/services/continuum/data:

Subdirectory

Description

build-output-directory

Individual build results for each project

working-directory

Project checkouts. Can be safely deleted if a build is not in progress

continuum

The Continuum build database (Derby)

useres

The Continuum users and security roles (Derby)

Continuum's path is configured in the /etc/init.d/continuum script to include Maven 2.0.7 9 and Java 6 (which is also used to run Continuum). These will be the defaults used by individual builds - all other Installed Software can be accessed through Continuum profiles and installations in the web interface.

Update the Change History if you make configuration or other changes.

Managing Continuum

Starting/Stopping Continuum

To stop Continuum:

Info

Always run Continuum using these scripts to ensure the proper user and configuration is in place. Do not run Continuum as root!

Code Block
sudo /etc/init.d/continuum stop

...

Continuum is to be run under the continuum user account only.

...

.

...

System Startup

Continuum is started/stopped via the following links to /etc/init.d/continuum:

...

Continuum Log Files

You can review these in /home/optcontinuum/services/continuum-1.1-beta-2/logs/wrapper.$DATE.log

Continuum Monitoring

Continuum is monitored by Nagios. See Monitoring.

...

The Java Service Wrapper should ensure that if Continuum has hung, it gets restarted in a timely manner. If it has been unresponsive for 10 minutes, or if HTTPD has been returning a 503 error for 5 minutes, use the scripts above to restart Continuum.

The restart script may rarely get stuck repeating the following line:

Code Block

Waiting for Apache Continuum to exit...
Waiting for Apache Continuum to exit...
Waiting for Apache Continuum to exit...
...

If this happens more than 5 times, the Wrapper itself has hung. Press Ctrl-C and kill the wrapper by identifying it's PID from /home/continuum/services/continuum/logs/continuum.pid, then run the restart script again.

Maven Settings

The default Maven settings in ~/.m2/settings.xml.

...

Upgrading Continuum

Currently the steps are:

  • stop continuum
  • move old snapshot out of the way if necessary
  • unpack the new installation into /optchmod -R continuum:continuum with tar -xzvf /path/to/apache-continuum-1.2 (or other install dir)update conf/jetty.xml to point the two databases to /home/continuum/data instead of ${appserver.base}/dataX.Y.Z-SNAPSHOT.tar.gz
  • update apps/continuum/WEB-INF/classes/META-INF/plexus/application.xml to set the from-mailbox to continuum@apache.org
  • copy conf/security.properties from the previous installation
  • update conf/wrapper.conf to set max memory to 512m
  • edit /etc/init.d/continuum to the new installation location
  • start continuum
  • update the Upgrade History pagedepending on the upgrade path, you may need to upgrade the Continuum database. Please check the Continuum release notes.

Ideally, these steps will be better isolated from the installation and/or automated in future.