Here is how I set up a Continuum server to run Apache Tuscany builds.
Download the latest Continuum. I used version 1.0.3
- Expand the archive somewhere. Ex: I expanded it to "d:\tools\continuum-1.0.3\"
You will need to run the Continnum server once for it to create its configuration files for you to edit. Do this by executing the proper run command in the <continuum home>\bin\<your platform>\ directory. Ex: I ran "d:\tools\continuum-1.0.3\bin\win32\run.bat" NOTE: JAVA_HOME environment variable must be defined
Wait a bit while it expands the application and creates the derby database. When you see a message that says "The application server has started.", you can Ctrl-C that process and go modify the <continuum home>\apps\continuum\conf\application.xml to configure Continuum system settings. Things you may want to modify are the Jetty port number for the server (search for "8080"), and the SMTP server used for email build notifications (search for "smtp-host").
Start the server again using the run command from step 3. When the server has started, point a web browser to "http://localhost:<your port>/continuum/". You will be presented with a page that will let you set up an administrator user account as well as some other server configuration options. The other options can be reconfigured later.
- After this screen you will be prompted to login using the account you just created.
- After logging in you may add a project to the server. Now, I had trouble with adding a Maven 2.0 project, and after doing a little reading it sounds like Continuum has difficulty with large multiproject Maven projects. So, I found that what was easiest was to add a "Shell Project".
- Here are the settings I used for the Shell Project:
- Project Name: Apache Tuscany Java
- Version: 1.0-SNAPSHOT
SCM Url: scm:svn:http://svn.apache.org/repos/asf/incubator/tuscany/java
other fields left blank
- After adding the project, the system will spend some time checking out the files from the URL provided. You should then be able to click on the project and modify it and add a build definition. This allows you to specify an executable to run (and arguments) for a build. It also allows you to specify a schedule that SCM should be checked for changes and builds executed. So, here are the settings I used for just a regular maven build of the entire Tuscany tree:
- Shell Executable: mvn
Arguments: I left this blank, but arguments could be added here to set profiles or any other maven command line parameters
- Is It Default?: Yes
- Schedules: DEFAULT_SCHEDULE (The default schedule checks the source tree every hour)
- You may also add notifiers, Continuum supports Mail, IRC, Jabber, and MSN notifiers. I have only tried the Mail one, but the IRC one would also be useful.
- At this point the build will run at the next hour mark, or you can force a build to run by clicking on the "Gear+Play" icon next to the project.
That is the extent of my research into this topic thus far. I believe if we can have this set up on a machine accessible by everyone on the project then it should greatly help improve the stability of the project.