Skip to Content

Control-M for Jenkins

Jenkins enables you to automate building, testing, and deploying code for repetitive tasks in software deployment process.

Control-M for Jenkins enables you to do the following:

  • Execute Jenkins pipelines.
  • Manage Jenkins credentials in a secure connection profile.
  • Connect to any Jenkins endpoint.
  • Introduce all Control-M capabilities to Control-M for Jenkins, including advanced scheduling criteria, complex dependencies, Resource Pools, Lock Resources, and variables.
  • Integrate Jenkins jobs with other Control-M jobs into a single scheduling environment.
  • Monitor the job status, results, and output of Jenkins jobs.
  • Attach an SLA job to the Jenkins jobs.

Setting Up Control-M for Jenkins

This procedure describes how to install the Jenkins plug-in, create a connection profile, and define an Jenkins job in Helix Control-M and Automation API.

Before You Begin

  • Verify that Jenkins 2.387.1 or higher is installed.
  • Verify that Automation API is installed, as described in Setting up the API.
  • Verify that Agent version 9.0.21.080 or later is installed.

Begin

  1. On the Agent host, set the Java environment variable by running one of the following commands through a command line:
    • Linux:
      • Bourne Shell/Bash: export BMC_INST_JAVA_HOME=<java_11_directory>
      • csh/tcsh: setenv BMC_INST_JAVA_HOME <java_11_directory>
    • Windows: set BMC_INST_JAVA_HOME="<java_11_directory>"
  2. Run one of the following API commands:
    • For a fresh installation, run the following provision image command:
      • Linux: ctm provision image Jenkins_plugin.Linux
      • Windows: ctm provision image Jenkins_plugin.Windows
    • To upgrade, run the following command:
      ctm provision agent::update
  3. Create a Jenkins connection profile in Helix Control-M or Automation API, as follows:
  4. Define a Jenkins job in Helix Control-M or Automation API, as follows:
Warning

Note

To remove this plug-in from an Agent, see Removing a Plug-in. The plug-in ID is JEN022024.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Control-M