1. Changes since version 1.1.1
* Maven builder support
* Command shell builder support
* ACL based Security (thanks Johannes Plachy)
* Quiet period can be set before check out code for build
* File system based Vcs adaptor
* Vcs Aadaptor for AccuRev (thanks Jason Carreira)
* User password encryption
* A new notification strategy: "Notify when build status changed"
* Be able to notify about build status using Jabber (thanks Johannes Plachy)
* Project/schedule dependency
* Ability to stop running build
* Data can be exported to XML file or imported from an XML file
* Display summary of [http://junit.org JUnit] test results on build page
* Supported more servlet containers, application servers:
Tomcat, Jetty, Resin, JBoss
* Hide password from log
* Add the ability to clone/copy a project
* Easier way to specify properties for Ant and Maven builder,
separate properties text area
* Be able to configure "build cleanup strategy" which gives user
the option to only keep a specified number of builds, or to keep
specified build days for particular schedules
* For HSQLDB, changed build table definition to be a cached table
in Hsql database. This way, rows of build table will be swapped
to disk when they become too large
* Be able to define multiple builders, VCS adaptors, and schedules for
a project
* Be able to associate different builders with different schedules
* New User's Guide and FAQ documentation
* Upgraded Hsql/Spring and some other 3rd party libraries
* Started Luntbuild Wiki at
http://luntbuild.sourceforge.net/cgi-bin/moin.cgi/FrontPage2. Supported application servers/servlet containers
* Tomcat 4.x
* Tomcat 5.5
* Jetty 4.2.23
* Jetty 5.1.12
* Resin 3.0.12
* JBoss 4.0.1RC2
* JBoss 3.2.7
* JOnAS 4.3.3
* SunOne 6.1Luntbuild may work with other application servers/servlet containers but
it is not tested with them.3. Install from Luntbuild installer (with GUI)
NOTE: This is clean installation of Luntbuild. For upgrades from version 1.1.1,
please refer to section 6 of this file.1) Make sure you have jdk1.4 or jdk1.5 installed, and add the directory which
contains the java and jar executable into your system path.
Go to "http://java.sun.com/" for JDK download if you didn't install it yet.2) Make sure you get one of Luntbuild supported servlet container or application
server installed, and make sure it has been stopped if you want to deploy
the war during the installation.3) Download Luntbuild installer from "http://sourceforge.net/projects/luntbuild/".
This file is normally named as "luntbuild-xxx-installer.jar", where xxx denotes
current version.4) Run command "java -jar luntbuild-xxx-installer.jar". A GUI will display to
guide you through the installation, and Luntbuild will install into the selected
directory, let's say "/opt/luntbuild".5) Deploy luntbuild.war (located in "/opt/luntbuild" directory) into your servlet
container or application server. Note, that if you selected the deployment
directory of your servlet container or application server during installation,
the installer will deploy luntbuild.war for you.6) Access the Luntbuild web application and you should be able to start your
Luntbuild adventure, :D4. Install from zip distribution (without GUI)
NOTE: This is clean installation of Luntbuild. For upgrades from version 1.1.1,
please refer to section 6 of this file.1) Make sure you get one of Luntbuild supported servlet container or application
server installed, and make sure it has been stopped if you want to deploy the war
during the installation.3) Download the Luntbuild zip distribution from "http://sourceforge.net/projects/luntbuild/".
This file is normally named as "luntbuild-xxx.zip", where xxx denotes current version.4) Extract the zip file into the directory where you want to install Luntbuild, say
"/opt/luntbuild". And edit the following files with your text editor:
* Edit file "/opt/luntbuild/web/WEB-INF/web.xml":
Replace "$INSTALL_PATH" with your Luntbuild installation path (/opt/luntbuild here).
Replace "${sessionTimeout}" with your desired session timeout value (normally 30).
* Edit file "/opt/luntbuild/web/WEB-INF/applicationContext.xml":
Replace "${luntbuildPassword}" with your desired site administrator password.5) Take all contents under "/opt/luntbuild/web", and deploy it as a web application of
your selected application server, or servlet container.6) Access the Luntbuild web application and you should be able to start your
Luntbuild adventure, :D5. Build from source distribution
1) Make sure you have jdk1.4 or jdk1.5 installed, and add the directory which
contains the java and jar executable into your system path.
Go to "http://java.sun.com/" for JDK download if you didn't install it yet.2) Make sure you have Apache ant 1.6.1 (or higher) installed.
Goto "http://ant.apache.org" for Ant download.3) Download the source distribution from "http://sourceforge.net/projects/luntbuild/".
This file is normally named as "luntbuild-xxx-src.zip", where xxx denotes
current version.4) Extract the source distribution into a directory, let's say
"/yourhome/luntbuild-src". Change to directory
"/yourhome/luntbuild-src/build", and run command "ant clean installer zip".
Then Luntbuild installer and zip distribution will both be generated into directory
"/yourhome/luntbuild-src/distribute".6. Upgrade from version 1.1.1
1) Assuming you've installed luntbuild-1.1.1 under "/opt/luntbuild". Backup
the directory "/opt/luntbuild/db" which contains your db files to another location.
Backup all important build artifacts.2) Upgrade your 1.1.1 web application with war file from:
http://sourceforge.net/project/showfiles.php?group_id=113344&package_id=122604&release_id=319662
NOTE: This only upgrades web application, and should not change anything
under "/opt/luntbuild".3) Access Luntbuild web application again, a new tab "Administration"
should be displayed. Select this tab, and export data into your specified
file, let's say "/yourhome/luntbuild-1.1.1-data.xml". This file will be stored
on the machine that runs your servlet container or application server
hosting your Luntbuild application.4) Follow the instructions of section 2 of this file to install Luntbuild 1.2
into your Luntbuild 1.1.1 installation directory, that is "/opt/luntbuild"
in this case.
5) Access the Luntbuild web application, click on "Administration" tab, and
import from previously exported data file "/yourhome/luntbuild-1.1.1-data.xml".
That will migrate the luntbuild-1.1.1 data to Luntbuild 1.2 distribution.
However, some settings of Luntbuild 1.1.1 needs to be re-configured:
* The property "environment file" has been removed in 1.2. If you are using
this property in 1.1.1, you need to extract contents of the environment
file, and enter them as "Environment variables" property.* All build success condition has been reset for 1.2 format.
* All build necessary condition has been reset for 1.2 format.
* Format of property "Next build version" has been changed, please verify
your version string.* Build properties passed to Ant build script has been changed, thus your
Ant build script need to be changed to use new build properties.* Ant builder command has been reset to default value. You may need to change
it based on your Ant installation directory.