Creating a Hudson/Jenkins build engine

You can create a Hudson/Jenkins build engine to identify the build system that performs the build.

Before you begin

Create a Hudson/Jenkins project, such as a free-style project that runs the Windows dir command through a Windows batch command.


  1. In the Team Artifacts view, in the project area, expand the Builds folder.
  2. Right-click Build Engines and then click New Build Engine.
  3. On the New Build Engine page, ensure that Create a new build engine is selected, and then click Next.
  4. On the General Information page, in the ID field, type a build engine identifier.
  5. In the Available build engine types pane, select Hudson/Jenkins Engine, and then click Finish.
  6. In the Build Engine editor, click the Hudson/Jenkins tab at the bottom of the window.
    Figure 1. Build engine editor
    Build engine editor
  7. To configure the connection settings, in the Hudson/Jenkins URL field, enter the host name and the port.
  8. If your server is secured with SSL, ensure that the Validate Hostname check box is selected.
  9. If access to the server requires authorization, click the Authorization Required check box, and then enter the following information:
    1. In the User Id field, enter the user name.
    2. In the Password/API Token field, enter the password for the user.
      Tip: For authentication, you can provide either a password or an API token.
  10. Click Test Connection.
  11. Optional: To change the maximum amount of time the RTC server waits for a response to a query or request, click the Overview tab. On the Overview page, in the Properties section, change the value of The default value is 30 seconds. Increase the time if the Hudson/Jenkins server is slow to respond.
  12. Click Save.
  13. Optional: If numerous builds use the same build engine, the Engineering Workflow Management server polls the builds in Jenkins to monitor their status. To reduce the load on the server, set the property to true:
    1. In the Properties section of the Overview tab, click Add.
    2. In the Add Build Property window, select String, then click OK.
    3. In the Name field, enter, and in the Value field, enter true. Click OK.
    4. On the Build Engine page, click Save.

What to do next

Create a Hudson/Jenkins build definition. See Creating a Hudson/Jenkins build definition.