= Hudson Notes =

== Quick Start ==

Use the following steps to set up a quick Hudson build that pulls bzrp4
from a local filesystem path and runs its selftest.

1. Download Hudson 1.255 from
   https://hudson.dev.java.net/servlets/ProjectDocumentList?folderID=2761&expandFolder=2761&folderID=0

2. Download/install Bazaar 1.8 Windows installer from
   https://launchpad.net/bzr/+download .  Add Bazaar to PATH.

3. Download/install bzr-xmloutput from lp:bzr-xmloutput via bzr branch.
   See http://bazaar-vcs.org/XMLOutput .

4. java -jar hudson.war . Point browser at http://localhost:8080/ .

    Note: maybe need larger heap size.  -Xmx1024m ?

5. Download Bazaar plugin for Hudson, bazaar.hpi, from
   http://verterok.com.ar/bzr-hudson/ .  I used the version in the
   subdirectory 20081027-1.  Install via Hudson web UI.

6. Verify Hudson finds Bazaar; no errors are displayed at Manage Hudson >
   Configure System > Bazaar.  On Windows, using the Python (non-EXE)
   version of Bazaar, Bazaar command line executable = bzr.bat.

7. New Job in Hudson.  Job name = bzrp4, e.g.  Build a
   free-style software project.

8. Source Code Management > Bazaar.  Branch URL =
   /home/mlm/sandbox/bzr-p4/bzr/continuous.integration.windows .  I tried
   C:\home\... but it didn't work because Hudson's URL parsing rejected the
   URL containing backslashes.

9. Local branch directory = bzrp4 so that Bazaar can find the plugin with
   the right name.  bzr selftest relies on loading the bzrp4 plugin from a
   path ending in "bzrp4".

10. Advanced > Clean copy.  Select "If checked, Hudson will delete the
   directory and all its contents before downloading the files from the
   repository for every build."

11. Build Triggers > Poll SCM.  Schedule = */3 * * * * .

12. Build > Add build step > Execute Windows batch command .  Command =

    cd bzrp4
    ci.selftest.bat