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 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 2012
  • Windows Server 2012 R2
  • Windows Server 2016
  • Windows Server 2019
  • Windows Server 2022

Compatible processors

x86_64

Display

16-bit (65536) colors or higher

Memory

4 GB

BMC recommends 16 GB for high volume.

Diskspace

12 GB

Related software

  • Google Chrome (version 78 or later) or Microsoft Edge (version 80 or later)

  • Microsoft .Net Framework 4.7.2

  • Java 1.8 (64 bit) or higher

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.

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

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

    • If Java is installed but a Java is not found message appear, restart your Windows machine.

    • If the following error appears, Java (32-bit) is listed in your PATH environment variable. You need to set Java (64-bit) as the last path in the PATH environment variable.

      com.izforge.izpack.util.library.LibraryLoadExeception: error loading library.......Can't load AMD 64-bit .dll on a IA32-bit platform

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.

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

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 11 installation directory>

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

    • If the following error appears, Java (32-bit) is listed in your PATH environment variable. You need to set Java (64-bit) as the first path in the PATH environment variable.

      com.izforge.izpack.util.library.LibraryLoadExeception: error loading library.......Can't load AMD 64-bit .dll on a IA32-bit platform

  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_files\components\clientem\setup.bat -silent <xml_path>\<filename.xml>

        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 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:

  4. 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:

        <installFolder>\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 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_InstallFolder>\BMCINSTALL\uninstall\DRNFT.9.0.21

  3. Type the following command:

    Uninstall.exe -silent

    Control-M is successfully removed from your computer.