Configuring Jenkins System Properties

Preliminary Steps

1. Open a web browser and go to the following URL:

http://<server>:8080/jenkins

NOTE  Your server name and port number may be different.

2. Click Manage Jenkins.

3. Click Configure System.

Configuring a JDK

1. Click Add JDK.

2. Enter a name for the JDK, for example: My JDK 1.7

3. Unselect Install automatically.

4. Enter your JDK_HOME value, for example: C:\Program Files\Java\jdk1.7.0_45

Configuring Apache Ant

1. Click Add Ant.

2. Enter a name for the Ant installation, for example: My Ant

3. Unselect Install automatically.

4. Enter your ANT_HOME value, for example: C:\apache-ant-1.9.2

5. Click Save.

Configuring a New Build Job

1. Click New Job.

2. Enter a name for this project, for example: Qlarius

3. Select a project type, for example, Build a free-style software project.

4. Click OK.

Adding Parameters

1. Select the option This build is parameterized.

2. Optionally add the following parameters:

• String Parameter, Name: cmkey

This parameter identifies a build run to a Jenkins Expert in Dimensions CM Pulse. You can configure Jenkins Expert to automatically add cmkey to your Jenkins jobs, if not you must add it manually. For details see the Pulse online help.

• String Parameter, Name: repo

• String Parameter, Name: changeset

• String Parameter, Name: stream

• String Parameter, Name: version

Selecting the JDK

If you have more than one installed JDK you may need to select the JDK you created earlier.

Adding the Dimensions CM Plugin as SCM

1. In Source Code Management select Dimensions.

2. In the Project Name box enter the stream name.

NOTE  You can also specify "${stream}" if you are using a CM plugin that supports this variable. This makes copying jobs easier and allows a job to be triggered from more than one stream, but ties the job to Serena Pulse.

3. In the Folder box enter: /

4. Select Clear the contents of the workspace.

5. To show all Dimensions fields click Advanced.

6. Enter your Dimensions CM connection details, for example:

• Login Name: dmsys

• Password: dmsys_test

• Server: myserver

• Database: cm_typical@dim12

7. Select Use Update.

Adding a Build Step

This example is for Ant builds. You may have different build steps that are unique to your build process.

1. Click Add build step.

2. Select Invoke Ant.

3. Select the Ant installation you created earlier.

4. Click Advanced and enter the location of your build.xml file in the Build File box, for example:

Qlarius Underwriter/build.xml

Saving the Build Job

Click Save.

Testing the Build Job

1. To test the build job click Build Now.

2. Enter dummy values for:

• key

• repo

• changeset

• stream

3. Click Build.

4. Check that the build was successful.