Control-M Client Installation

The Control-M client installation option enables you to install additional Control-M clients on different computers throughout your organization. Additional clients enable multiple users in your organization to access Control-M.

Verify that your operating system meets all requirements, as described in Control-M Client System Requirements.

To install the Control-M client on a Windows computer, see one of the following:

  • To deploy and install Control-M clients, BMC recommends using Client Distribution. However, If you installed the Control-M client manually, you cannot use Client Distribution. If you want to use this feature, you must uninstall the Control-M client and then reinstall using the Client Distribution URL.

  • By default, the Control-M client is configured to work with HTTP. To secure your environment, BMC recommends to change your configuration to HTTPS, as described in Zone 1 SSL Configuration.

Control-M Client System Requirements

The following table lists the prerequisite requirements for the Control-M client on Windows. These values represent the minimum requirement for an entry level deployment. For a full list of requirements, see the Control-M 9.0.21.300 Release Notes.

The specific resource requirements vary based on the number of jobs that are loaded in the viewpoints, and the frequency of job executions.

Resource

Requirement

Operating System
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022

Compatible Processors

x86_64

Display

16-bit (65,536) colors or higher.

Memory

4 GB

BMC recommends 16 GB for high volume.

Disk Space

12 GB

Related Software

  • Google Chrome (version 78 or higher) or Microsoft Edge (version 80 or higher).

  • Microsoft .NET Framework 4.7.2.

  • Java 1.8 (64-bit) or higher (Install, uninstall, and upgrade only).

Installing Control-M Client from the Control-M Welcome Page

This procedure describes how to install the Control-M client on Windows from the Control-M Welcome Page. The Control-M/EM server and port are automatically configured during the installation.

Before You Begin

  • Ensure that your operating system are compatible with the current version of the Control-M client, as described in Control-M Client System Requirements.

  • Verify one of the following:

    • Java 1.8 (64-bit) or higher is available in your Path Environment Variable.

    • The Java path is on a network, which is accessible from all Control-M clients.

      To enable users to upgrade their clients without installing Java, you can place Java 1.8 (64-bit) or higher on a network location that is accessible by all Control-M client machines and define the path in the following file:

      <EM_HOME>/Client_Updates/conf/client_deploy_java.properties

      java_home_path=/network/java_home_directory

Begin

  1. Open a new browser window before you download and install.

  2. Go to <Control-M/EM_Host>:<port>/Welcome/ and from the Control-M Client section, click Download.

  3. Run the installation and continue with the on-screen instructions until the installation is complete.

    The installation log can be found at the following location:

    <installFolder>\BMCINSTALL\log\BMC_Control-M_client_<date-time>.log

Installing Control-M Client from the Control-M Client Installation Package

This procedure describes how to install the Control-M client on Windows from the Control-M Client installation package. If you want to install multiple instances of the Control-M client on several computers using the same configuration, use the automatic installation, as described in this procedure.

Before You Begin

  • Ensure that your operating system are compatible with the current version of the Control-M client, as described in Control-M Client System Requirements.

  • Verify one of the following:

    • Java 1.8 (64-bit) or higher is available in your Path Environment Variable.

    • The Java path is on a network, which is accessible from all Control-M clients.

      To enable users to upgrade their clients without installing Java, you can place Java 1.8 (64-bit) or higher on a network location that is accessible by all Control-M client machines and define the path in the following file:

      <EM_HOME>/Client_Updates/conf/client_deploy_java.properties

      java_home_path=/network/java_home_directory

Begin

  1. Copy the installation files from the temporary directory that you created in Obtaining Control-M installation files, to the home directory.

  2. From the same command line, run the following command:

    <source_path>\Setup.bat

    If Java is not available, run the following command:

    setup.bat -BMC_INST_JAVA_HOME <Java installation directory>

    The Java installation directory must contain the bin directory and the Release file.

  3. Do one of the following:

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

    • Automatic Install: Create a parameter 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 parameter 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. Run the installation script, as follows:

        <Source_Path>\setup.bat -silent <xml_path>\<filename.xml>

        The installation log can be found at the following location:

        <Install_Folder>\BMCINSTALL\log\BMC_Control-M_client_<date-time>.log

Installing Control-M Client from the Full Installation Package

This procedure describes how to install the Control-M client on Windows from the Full installation package. If you want to install multiple instances of the Control-M client on several computers using the same configuration, use the automatic installation, as described in this procedure.

Before You Begin

Begin

  1. Log in to the computer using a user ID that has Administrator permissions.

  2. Copy the installation files from the temporary directory that you created in Obtaining Control-M installation files, to the home directory.

  3. Do one of the following:

    • Interactive Install: Select the Control-M client option and continue with the on-screen instructions until the installation is complete.

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

      1. Select the Control-M client option and continue with the on-screen instructions until the Summary window.

      2. Click Generate and select the location to create the XML parameter 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 script, as follows:

        <Source_Path>\Setup_files\components\clientem\setup.bat -silent <xml_path>\<filename.xml>

        The installation log can be found at the following location:

        <Install_Folder>\BMCINSTALL\log\BMC_Control-M_client_<date-time>.log

Uninstalling Control-M Client from Windows

This procedure describes how to uninstall the Control-M client from Windows.

Begin

  1. From the Start menu, select Control Panel.

  2. Double-click Programs and Features.

  3. Select Control-M 9.0.21.300 and click Uninstall.

  4. Click OK to continue.

    Control-M is successfully removed from your computer. If you performed a downgrade, Control-M components are up and running.

Performing an Automatic Control-M Client Uninstall on Windows

This procedure describes how to uninstall Control-M client from Windows via an automatic uninstall.

Begin

  1. Log in to the computer using a user ID that has Administrator permissions.

  2. Navigate to the following directory:

    <EM_Install_Folder>\BMCINSTALL\uninstall\DRNFT.9.0.21.300

  3. Type the following command:

    Uninstall.exe -silent

    Control-M is successfully removed from your computer.