Table of Contents | ||
---|---|---|
|
...
Note |
---|
As of Servoy 7.2 it is advised to use Jenkins instead of CruiseControl as Continous Build software. This page will no longer be maintained after the Servoy 7.2 release. |
The continuous build software CruiseControl is open source, has a no-cost license, and is well suited for Java applications.
Stoc |
---|
CruiseControl is a free continuous build software package released as open source software. It is managed by ThoughtWorks, whose employees created the original version. It is well suited for Java based projects, and some of the more notable features include:
Info |
---|
These instructions are for a Windows installation. |
...
Select all the components. Next, the installer will ask for a location. This location should have sufficient rights for read/write
Clicking install Install will start the installation. After the installation is complete, there should be a folder containing the program contents
...
Also, if you open the Local Services control panel for the machine, there should be a service named "'CruiseControl Service" ' available that has not been started yet. Go ahead and start the service to start CruiseControl.
CruiseControl ships with a default Java project named ConnectFour. When CruiseControl starts, it will try to build this project (using Ant) and return a result. To see if this has occurred, open the CruiseControl dashboard at the following location: http://
<serveraddress_or_localhost>{myHost}:8080/dashboard
. The application dashboard will launch and you should see a screen like below
...
As CruiseControl and Servoy are both Java driven applications, they share some Java technologies, and by default, share port configurations as well. If you plan to run CruiseControl and Servoy Application Server on the same machine, port changes will need to be made one application or the other in order for the applications to work properly.
...
Changing ports for a Servoy Application Server installation is detailed hereon Network Related Settings.
To change port configurations for CruiseControl instead, modify the wrapper.conf file found in the CruiseControl main folder. See the section below:
...
Note that parameter 3 and parameter 9 are conflicts with Servoy Application Server default ports. Change these ports to any other available port on the machine.
...
...
...
Create a folder for the software factory: c:/SoftwareFactory
Info |
---|
File structure for this folder can be found in SofwareFactory.zip |
Install CruiseControl into the c:/SoftwareFactory/CruiseControl
folder. (Instructions)
This is also a good time to make configuration changes to the wrapper.conf file (Instructions) To work in this environment, we need to change and add some lines to wrapper.conf for the run directory and classpath:
Add two lines right above the wrapper.java.classpath
lines in the wrapper.conf
...
Save the wrapper.conf file.
SVNAnt is a helper application used by ANT to update projects from the SVN. Download the application from: http://subclipse.tigris.org/files/documents/906/49042/svnant-1.3.1.zip. Extract the contents of the zip file into c:/SoftwareFactory/svnant-1.3.1
We need an installation of Servoy Developer. Install Servoy Developer with the following options set
c:/SoftwareFactory/Servoy
c:/SoftwareFactory/DeveloperWorkspace
...
...
SVNAnt works better with a command line client. Recommended: slikSVN
...
At this time, it is a good idea to create the workArea file structure, create a folder name workArea and build the following structure (note that some of the files needed are provided later in this document). This is where most of the work will occur during the operation. CruiseControl will be configured to run out of this folder.
...
Using the command line client installed, check out the solution (or solutions) from the SVN into the workspace file located at c:/SoftwareFactory/workArea/checkout/testrunner. For details on how to do this, please refer to the SVN client you have chosen.
...
...
If your SVN does not contain the solution yet, and you have the solution in a .servoy file, do the following:
c:/SoftwareFactory/DeveloperWorkspace
)As an alternative, you can use Servoy Developer to check out the solution. (NOTE: you will still need the command line client for operation of the software factory)
c:/SoftwareFactory/workArea/checkout/testrunner
.c:/SoftwareFactory/DeveloperWorkspace
Info |
---|
If you are using a SSL repository, the SVN server certificate must be trusted. Otherwise, the software factory will fail. |
A file structure should be started now (example files in SoftwareFactory.zip)
...
servoy.properties - a separate properties file for any db connections used to run unit tests, as well as a repository for the unit tests.
...
After making any changes to properties, the CruiseControl service must be restarted. After restarting, or starting if you have not started the service, try to make a build of the project. If everything succeeds, there should be a clean .servoy file in your passed exports folder.