Control-M Client Distribution

Control-M Client Distribution is a tool that enables you to deploy a single instance of Control-M/EM client to every supported Windows computer in your organization. You can install or upgrade to Control-M 9.0.18 or higher on Control-M client 9.0.00.500 or higher.

Control-M client updates are automatically distributed to end users, who receive a message when they log in that a new update is available.

You can require users to install updates by a specific date. If they have not installed the update by the defined deadline, users cannot log in until they complete the installation.

Distributing Control-M Clients

This procedure describes hows to distribute Control-M clients to multiple users.

  • If Control-M client is installed via Client Distribution by a non-Admin user, then updates can only be installed by the same user.

  • Client Distribution is not supported on a Control-M/EM Distributed host.

Before You Begin

  • Verify that all the target computers meet the system requirements, as described in Control-M Client System Requirements.

    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

  • If the Control-M/EM Web Server is installed on a computer that can only be accessed via a fully qualified domain name (FQDN), configure Control-M/EM Web Server access, as described in Configuring Control-M/EM Web Server Access via FQDN.

Begin

  1. From the Manage tab in the CCM, select Client Distribution.

    The Control-M Client Distribution window appears.

  2. Select the Enable Distribution Mode checkbox.

  3. Do one of the following:

    • Distribute Control-M Client Installation: Send users the following URL:

      http://<Control-M/EM_Server_Hostname>:18080/Welcome

    • Distribute Control-M Client Update: From the Distribute Version drop-down list, select the Control-M version to distribute to users.

      The list of available versions reflects the installations on the Control-M/EM Server.

  4. (Optional) To ensure that users upgrade their Control-M client by a certain date, do the following:

    1. Select the Prevent Login if User Has Not Upgraded By checkbox.

    2. Click the drop-down calendar and select a date.

  5. Click OK.

    If you distributed a Control-M client update, the installation automatically downloads to target user computers, and users receive a notification that an installation update is ready to be installed.

    Control-M/EM Server connection parameters are automatically populated in the appropriate installation wizard fields. When the installation completes, Control-M client is available to users.

Configuring Control-M/EM Web Server Access via FQDN

This procedure describes how to configure Control-M/EM Web Server access with a fully qualified domain name (FQDN). You must perform this procedure when the host computer where Control-M/EM Web Server is installed is only accessible via FQDN. This enables you to view the Control-M Online Help, and use Application Integrator and Client Distribution.

Begin

  1. Run the following command:

    em restore_host_config -interface_name -name <FQDN>

    If you are working in a High Availability or Distributed environment, run this command on both the Primary and Secondary hosts. For Distributed environments, this utility must be executed on the current active host with the FQDN value.

  2. Navigate to the following directory:

    <Control-M/EM_Home_Directory>/Client_Updates/conf/

  3. Open the web_server_params.xml file and do the following:

    1. Replace <ALLOW_MODIFICATION>true</ALLOW_MODIFICATION> with the following text:

      <ALLOW_MODIFICATION>false</ALLOW_MODIFICATION>

    2. Replace <WEB_SRV_HOST><value></WEB_SRV_HOST> with the following text:

      <WEB_SRV_HOST><FQDN></WEB_SRV_HOST>

    3. Save the file.

    4. Restart the Control-M client and Control-M/EM Web Server.

      Access to the Control-M/EM Web Server is configured via FQDN.