Creating 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 that it is easier to determine the build machine that is associated with the engine ID. You can create a build engine to support one or more build definitions. When you create a build definition, if a build engine does not exist, the system automatically creates a default build engine. You can use the default build engine, or create a new one.

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 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 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. In the Team Artifacts view, in the project area, expand the Builds folder.
  2. Right-click Build Engines; then click New Build Engine.
  3. In the New Build Engine wizard, on the General Information page, in the ID field, type a build engine identifier. Select the build engine type from the list.
  4. Click Finish.
  5. In the Build Engine editor, in the Build Definitions pane, select the supported build definitions.
  6. To activate the build engine, in the Activation pane, select the Active check box.
  7. 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).
  8. Optional: To define properties for the build engine, in the Properties pane, complete the following steps:
    1. Click Add.
    2. In the Add Build Property dialog box, select a property type and click OK.
  9. 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 used by the EWM server will be 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 used by the EWM server.
    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 given user name.
      Confirm Password
      Enter again the password for the given user name.
    3. Click Test Connection.
      The results of the connection test are displayed in the Rational Build Agent Connection Test Results box.
  10. Click Save.