Creating and managing build engines

The build engine identifies the build system that performs builds. The build engine identifier (engine ID) is typically the same as the build machine name, so it's easier to determine the build machine associated with the engine ID. You can create a build engine to support one or more build definitions.

About this task

The following list describes the types of build engines and definitions that you can create and use with Engineering Workflow Management Build:

  • Rational® Build Forge®: Use this build engine and definition with its corresponding projects. For more information, see Creating Build Forge build engines.
  • Rational Build Agent: Use this build engine and its related definitions for various types of builds; for example, command-line or enterprise build projects, such as iSeries or z/OS projects.
  • Jazz Build Engine: Use this build engine and its related definitions for various types of builds, such as Ant, command-line, or Maven.
  • Hudson/Jenkins Engine: Use this build engine together with a Hudson/Jenkins Build. For more information, see Creating a Hudson/Jenkins build engine.


  1. Open a project, and click Builds > Create Build Engine.
  2. In the New Build Engine dialog box, complete these steps:
    1. In the Project or team area in which to create the build engine: field, select the project or the team area to create the build for.
    2. To create a new build engine, click Create New. To use an existing build engine as the basis for the new one, click Copy Existing.
    3. in the ID field, type a build engine identifier..
    4. in the Description field, type a description for the build engine.
    5. Select a build engine type:
      • Hudson/Jenkins Engine
      • Jazz Build Engine
      • Rational Build Agent
      • Rational Build Forge
  3. Click OK.
  4. On the Build Engine editor page, in the Supported Build Definitions pane, click Add to add the supported build definitions.
  5. To activate the build engine, in the Activation pane, select the Active check box.
  6. Optional: You can configure build request processing for the engine if you use the Jazz® Build Engine, or if your build engine processes requests:
    1. To enable the build engine process to poll for requests, select the Build engine process polls for requests check box.
    2. To display a warning when the build engine is idle and has not contacted the repository within a specified threshold, select the Monitor the last contact time check box. In the Threshold field, type a value for the monitoring threshold (in minutes).
  7. Optional: To define properties for the build engine, in the Properties pane, click Add and select a property type.
  8. Optional: If you selected Rational Build Agent as the build engine type, click the Build Agent tab.
    1. If you set up the Rational Build Agent with secure communication in the bfagent.conf file, select Connect securely to Build Agent. Select the type of secure protocol for which the Rational Build Agent is configured. If you select "default" as the protocol, the protocol that the Engineering Workflow Management Build server uses is used. If you are configuring a build agent for the z/OS build, you need to add the certificate from z/OS to the appropriate keystore that the Engineering Workflow Management Build server uses.
    2. Enter the following information to connect to Rational Build Agent:
      The name of the system that uses the Rational Build Agent.
      The port that communicates with Rational Build Agent. The default is port 5555.
      User name
      The name of the user who is connecting to the Rational Build Agent.
      Note: This user name is used to authenticate the connection to the system. It does not have to be the same user name that started the agent.
      The password for the specified user name.
      Confirm Password
      Enter the password for the specified user name again.
    3. Click Test Connection.
      The results of the connection test are displayed in the Rational Build Agent Connection Test Results dialog box.
  9. Click Save.
    Tip: To edit or delete a build engine, click Builds and, under Browse, click Build Engines. A list of build engines that are available in the current project is displayed. To edit a build engine, hover over the build engine and click the Edit icon Edit icon. After you make changes, click Save. To delete a build engine, hover over the build engine and click the Delete icon Delete icon.