...................................................................................................................................... Apache Continuum 1.3.8 v. ...................................................................................................................................... The Apache Continuum Project Documentation i Documentation ....................................................................................................................................... 1 Index (category) ............................................................. 1 2 Getting Started .............................................................. 2 3 Installation/Upgrade Guides ................................................ 3 4 System Requirements ...................................................... 4 5 Installation ................................................................... 5 6 Standalone .................................................................. 6 7 Tomcat ...................................................................... 10 8 Upgrade ..................................................................... 15 9 User's Guides .............................................................. 17 10 Managing Projects ......................................................... 18 11 Add a Project .............................................................. 19 12 Edit a Project ............................................................... 24 13 Remove a Project .......................................................... 27 14 Managing Build Definitions ............................................... 28 15 Project Build Definition .................................................... 29 16 Project Group Build Definition ............................................ 31 17 Managing Notification ..................................................... 33 18 Mail Notification ............................................................ 35 19 IRC Notification ............................................................ 36 20 Jabber Notification ........................................................ 38 21 MSN Notification ........................................................... 40 22 Wagon Notification ........................................................ 41 23 Building a project .......................................................... 43 24 Scheduled Build ........................................................... 44 25 Forced Build ............................................................... 45 26 Build Results Management ............................................... 46 26 Release Management ...................................................... 48 26 Prepare Project Release ................................................... 50 26 Perform Project Release .................................................. 53 26 Release Results Management ............................................ 55 26 Administrator's Guides .................................................... 56 26 Managing Users and Security ............................................ 57 26 Security Configuration .................................................... 58 26 LDAP Configuration ....................................................... 59 26 Managing Project Groups ................................................. 60 26 Managing Builders ......................................................... 63 26 Managing JDKs ............................................................ 65 26 Managing Build Environments ......................................... ©2011, • ALL RIGHTS RESERVED. Documentation ii 26 Managing Schedules ...................................................... 66 26 Managing General Configuration ......................................... 69 26 Managing Local Repositories ............................................. 71 26 Managing Purge Configuration ........................................... 72 26 Managing Parallel Builds .................................................. 74 26 Managing Build Queues ................................................... 75 26 Managing Build Agents ................................................... 77 26 Managing Build Agent Groups ............................................ 78 26 Managing Project Queues ................................................. 79 26 External databases ........................................................ 81 26 Monitoring Continuum ..................................................... 84 26 Log Files ................................................................... 87 26 Audit Logs .................................................................. 88 26 Continuum Logs ........................................................... 89 26 Security Logs .............................................................. 90 26 Appearance Configuration ................................................ 91 26 Build Definition Template ................................................. 93 26 Shutdown Continuum ..................................................... 94 26 Understanding Distributed Builds ........................................ 95 26 Developer's Guides ........................................................ 97 26 Building Continuum ....................................................... 98 26 XML-RPC ................................................................... 99 ©2011, • ALL RIGHTS RESERVED. 1 Index (category) 1 1 Index (category) ....................................................................................................................................... 1.1 Welcome to Apache Continuum Apache Continuum is an enterprise-ready continuous integration server with features such as automated builds, release management, role-based security and integration with popular build tools and source control management systems. Whether you have a centralized build team or want to put control of releases in the hands of developers, Continuum can help you improve quality and maintain a consistent build environment. 1.1.1 Documentation • Release Notes • Installation/Upgrade Guides • Installation • Standalone version: Standard (Linux, Mac OSX, Solaris, Windows, others) as a service or not • Webapp: Tomcat • How to upgrade from a previous version • User's Guide • Administrator's Guide • Developer's Guide to building Continuum • Knowledge Base Frequently Asked Questions Wiki Old Wiki Blog This documentation is also available in PDF format. ©2011, • ALL RIGHTS RESERVED. 2 Getting Started 2 2 Getting Started ....................................................................................................................................... 2.1 Getting Started When you start Continuum for the first time (without an existing database), the first thing you will do is create the admin account and perform the General Configuration. Admin account creation After the admin account has been created, you can log as the admin user. The next thing you will see is the General Configuration page. General Configuration You may also create more users, add projects, etc. ©2011, • ALL RIGHTS RESERVED. 3 Installation/Upgrade Guides 3 3 Installation/Upgrade Guides ....................................................................................................................................... 3.1 Installation/Upgrade Guides In this section, you'll find information about Continuum installations: • System Requirements • Installation in different environments (standalone, webapp, service) • Release Notes • How to upgrade from a previous version? • Installation of Build Agent for Distributed Builds ©2011, • ALL RIGHTS RESERVED. 4 System Requirements 4 4 System Requirements ....................................................................................................................................... 4.1 System Requirements JDK 1.5 or above Memory No minimum requirement Disk The Continuum application package is less than 30MB but will use more disk space when it's checking out and building sources Operating System No minimum requirement. Tested on Windows XP, Debian, Fedora Core, Solaris and Mac OS X ©2011, • ALL RIGHTS RESERVED. 5 Installation 5 5 Installation ....................................................................................................................................... 5.1 Continuum Installation In this section, you'll find information about Continuum installations: • Standalone • Tomcat ©2011, • ALL RIGHTS RESERVED. 6 Standalone 6 6 Standalone ....................................................................................................................................... 6.1 Installing Continuum Standalone 6.1.1 Basics & Fundamentals • Download the standalone version from the Download page • Extract the file • Set a JAVA_HOME environment variable which use a jdk >= 1.5 6.1.1.1 Defining JNDI Resources 6. Mail server configuration Before you start Continuum, you must configure your SMTP configuration for mail notification. The configuration is in $CONTINUUM_HOME/conf/jetty.xml: <New id="validation_mail" class="org.mortbay.jetty.plus.naming.Resource"> <Arg>mail/Session</Arg> <Arg> <New class="org.mortbay.naming.factories.MailSessionReference"> <Set name="user"></Set> <Set name="password"></Set> <Set name="properties"> <New class="java.util.Properties"> <Put name="mail.smtp.host">localhost</Put> </New> </Set> </New> </Arg> </New> 6. Databases configuration By default, Continuum use an embedded Derby database. If you want to use an other database, you can modify the JNDI configuration in $CONTINUUM_HOME/conf/jetty.xml: ©2011, • ALL RIGHTS RESERVED.