This guide shows DDSteps 1.0.
This getting started guide is currently for Windows only.
Prerequisites
Only the software listed here is needed. If you read the old guide, this is a much shorter list now...
- Java 1.5
- make sure you have Java 1.5 and JAVA_HOME pointing to the installation.
- Subversion 1.2.3 - Install it and put it in your PATH (environment variable). If you can execute "svn help" from your command line, you are good to go.
- Eclipse 3.1.1 - if you want to use the included workspace.
- Subclipse - Eclipse plugin for Subversion. Use the update site: http://springide.org/updatesite/
- Winamp - for the nice demo effect... Should go in "C:\Program Files\Winamp".
 | JAVA_HOME
Double-check that your JAVA_HOME is pointing to a Java 1.5 (aka 5.0) JVM. |
Optional
You may want these too...
- Spring IDE Plugin for Eclipse
Installation
- Download the (rather large) zip file ddsteps-demo-cruisecontrol-0.3.zip.
- Unzip to "C:\". Use "unzip here" or similar if you are using WinZip. Make sure the demo is in the folder "C:\ddsteps" and not in "C:\ddsteps-demo-0.3\ddsteps" or anything like that.
Running Cruise Control
- Double-click on "c:\ddsteps\startDemo.bat"
- Four console windows will appear:
- Subversion
- Hypersoniq
- Tomcat (acually, this opens two windows, but you can close the one with the prompt)
- CruiseControl
- Open a browser to see
The first time you start, CruiseControl will automatically build and deploy the PetClinic and run all tests. The CruiseControl Web GUI may look a bit weird before the first build is done.
Cruise Control is tuned for a DEMO so it will build check the SVN repo every 10 seconds and build after almost no quiet period. This is good in a demo, but should be increased when you run for real.
Making Changes
- Make sure the subversion server is started (either because you started the demo with startDemo.bat or you can run the "C:\ddsteps\svn\subversion.bat" script).
- Open Eclipse
- Create a new workspace, anywhere you like. A good place may be "C:\ddsteps\workspace".
- Choose "Import..." and select "Team Project Set". Select the file "C:\ddsteps\projectSet.psf".
- Now Eclipse will pull in the projects from the subversion server.
- Edit some file, like "PetFTest.xls". Remember to do "refresh" (select the project and hit F5) so that Eclipse detects your changes.
- Check in the file.
- Watch as cruise control builds.
Running tests from Eclipse
- Just Right-click on the test (like PetFTest) and choose "Run As JUnit...".
- Make sure the pet clinic webapp is running.
- When CruiseControl builds, it will deploy petclinic on the tomcat and leave it running there.
FAQ
- The Spring Plugin in Eclipse lists some problems in the "ddstesp-config.xml". This is a bug in the Spring IDE plugin - it does not understand that you are using autowire to inject stuff into the constructor arguments.
- The first build (0.0.1) is successful, but in the Web GUI there is a red warning: "FAIL - No context exists for path /petclinic". This is ok, it just means that there was no previous petclinic webapp in tomcat to undeploy. It's a silly Ant bug, but we cannot get rid of it...
URLs
