Installing an Agent

This procedure describes how to install an Agent on a Windows or Linux host. The installation includes a default JRE package. You can use your own JRE package during or after the installation.

Before You Begin

Begin

  1. From the Configuration domain, click and then select Agents.

  2. Click Install Agent.

  3. Select the operating system where you want to install the Agent.

  4. Do one of the following:

    • Windows: Log into the target host with Administrative privileges, download the installation file and save it on the target host.

    • Linux: Copy the cURL or wget command to the clipboard by clicking one of them and run it on the Agent host to download the installation file.

  5. From the Copy token of the selected Agent's authorization tag drop-down list, select the tag that this Agent must be assigned to.

    A tag is a logical name that is used to label specific Agents into a group with a specific authorization level. You can only define one tag per Agent. You can apply a specific tag to an Agent or you can define your own tag with the asterisk character if you have the correct authorizations. For example, if users have been assigned the Agent tag with the value Fin*, they can define their own tag names when they install Agents, such as FinDev or FinOps.

  6. Do one of the following:

    You need this token key to perform the installation and connect the Agent to the Control-M environment. The token is based on the Agent tag and can be reused for additional installations with the same tag.

  7. Run one of the following installation files:

    • Windows: <file_path >/KAI.9.0.20.080_windows_x86_64.exe

    • Linux: <file_path >/KAI.9.0.20.080_Linux-x86_64.BIN

      Verify that the file has execute permissions.

  8. Do one of the following:

    • Interactive install: Follow the on-screen instructions until the installation is complete.

    • Automatic install: Create an xml installation file and then run the automatic install in a non-interactive mode, as follows:

      1. Follow the on-screen instructions until the Summary window.
      2. Click Generate and select the location to create the XML installation file.

      3. Click Yes to quit the installation.

        A confirmation message appears.

      4. Click Yes.
      5. Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic installation.

      6. Log in using a user ID that has Administrator permissions on the current computer.
      7. Run the installation file, as follows:

        <installation_file> -silent <xml_path>\<filename.xml> -token <value>

        The installation log can be found at the following location:

        <installFolder>\BMCINSTALL\log\

    • Automation API Automatic install: Follow the on-screen instructions until the installation is complete, as described in Automation API Automatic install.

    After the installation is complete, the Agent appears in the Agents tab

  9. Verify that installation was successful by opening the installed-versions.txt file in the Agent home directory and check that the correct product code appears.

    For a list of product codes, see Installation Product Codes.

  10. For a list of frequently asked questions about Agent installation, see Agent Installation FAQ.

Upgrading an Agent

This procedure describes how to upgrade an Agent on a Windows or Linux host. The installation includes a default JRE package. You can use your own JRE package after the upgrade completes.

Before You Begin

Begin

  1. From the Configuration domain, click and then select Agents.

  2. Click Install Agent.

  3. Select the operating system of the Agent.

  4. Do one of the following:

    • Windows: Log into the target host with Administrative privileges, download the installation file and save it on the target host.

    • Linux: Copy the cURL or wget command to the clipboard by clicking one of them and run it on the Agent host to download the installation file.

  5. Run one of the following installation files:

    • Windows: <file_path >/KAI.9.0.20.180_windows_x86_64.exe

    • Linux: <file_path >/KAI.9.0.20.180_Linux-x86_64.BIN

      Verify that the file has execute permissions.

  6. Do one of the following:

    • Interactive upgrade: Follow the on-screen instructions until the upgrade is complete.

    • Automatic upgrade: Create an xml installation file and then run the automatic upgrade in a non-interactive mode, as follows:

      1. Follow the on-screen instructions until the upgrade completes.
      2. Click Generate and select the location to create the XML installation file.

      3. Click Yes to quit the installation.

        A confirmation message appears.

      4. Click Yes.
      5. Copy the automatic installation parameters file to a network location that is accessible to all computers where you want to perform an automatic upgrade.

      6. Log in using a user ID that has Administrator permissions on the current computer.
      7. Run the installation file, as follows:

        <installation_file> -silent <xml_path>\<filename.xml>

        The upgrade log is save to the following location:

        <installFolder>\BMCINSTALL\log\

    • Automation API Automatic install: Follow the on-screen instructions until the installation is complete, as described in Automation API Automatic install.

  7. Verify that upgrade was successful by opening the installed-versions.txt file in the Agent home directory and check that the correct product code appears.

    For a list of product codes, see Installation Product Codes.

  8. For a list of frequently asked questions about Agent installation, see Agent Installation FAQ.

Installation Product Codes

The following table lists the components and products that you can install on an Agent and their matching product codes. These codes appear in the installed-versions.txt file located in the Agent home directory. After installing an Agent or plug-inClosedA Control-M component that extends functionality to third-party applications like Hadoop or SAP and integrates plug-in jobs with other jobs into a single workflow, BMC recommends that you open this file to verify that the installation product code appears.

Product

Code

Agent
  • DRKAI.9.0.20.080

  • DRKAI.9.0.20.180

Databases plug-in
  • DRMQL.9.0.20.080

  • DRMQL.9.0.20.080

Application Integrator
  • DRAIT.9.0.20.080

  • DRAIT.9.0.20.180

Hadoop plug-in
  • DRCBD.9.0.20.080

  • DRCBD.9.0.20.180

AWS plug-in
  • DRAMZ.9.0.20.080

  • DRAMZ.9.0.20.180

Azure plug-in
  • DRAZR.9.0.20.080

  • DRAZR.9.0.20.180

MFT plug-in

  • DRAFP.9.0.20.080

  • DRAFP.9.0.20.180

SAP plug-in
  • DRRMC.9.0.20.080

  • DRRMC.9.0.20.180

Informatica plug-in

  • DRINF.9.0.20.080

  • DRINF.9.0.20.180