Control-M Workflow Insights System Requirements

Before you install Control-M Workflow Insights, verify that your machines meet the following requirements for your operating system:

  • You must run all of your Workflow Insights machines on either Windows or Linux—mixed operating systems might cause the service to fail or corrupt data.

  • Control-M Full Installation in a High Availability environment does not support Workflow Insights.

  • Workflow Insights does not support AIX hosts.

Control-M Workflow Insights System Requirements on Windows

The following table lists the prerequisites for Control-M Workflow Insights on Windows.

Resource

Amount

Notes

Control-M/EM Distributed Servers

2 servers

Recommended number of servers.

The Control-M/EM Distributed Servers must be dedicated.

Memory

16 GB

(Control-M/EM Distributed only) 6–8 GB dedicated to OpenSearch.

CPU

4 cores

(Control-M/EM Distributed only)

Disk Space

1 TB

(Control-M/EM Distributed only) Dedicated to OpenSearch data retention.

Workflow Insights Ports

 

If your network cannot open these ports, set alternative ports during the activation of Control-M Workflow Insights.

Control-M Self Service Installation

 

Relevant for Control-M/EM Primary only.

Paging Parameters

 

 

Enable the following parameters:

  • Automatically manage paging files size for all drives.

  • No paging file.

Control-M Workflow Insights System Requirements on Linux

The following table lists the prerequisites for Control-M Workflow Insights on Linux.

Resource

Amount

Notes

Control-M/EM Distributed Servers

2 servers

Recommended number of servers.

The Control-M/EM Distributed Servers must be dedicated.

Memory

16 GB

(Control-M/EM Distributed only) 6–8 dedicated to OpenSearch.

CPU

4 cores

(Control-M/EM Distributed only)

Diskspace

1 TB

(Control-M/EM Distributed only) Dedicated to OpenSearch data retention.

Operating System

 

If your network cannot open these ports, set alternative ports during the activation of Control-M Workflow Insights.

Control-M Self Service Installation

Product Availability and Compatibility

BMC recommends that you use the same Linux OS for both the primary Control-M/EM and the Control-M/EM Distributed instances.

Linux Kernel Parameters

 

 

 

Workflow Insights Ports

 

If your network cannot open these ports, set alternative ports during the activation of Control-M Workflow Insights.

Control-M Self Service Installation

 

Relevant for Control-M/EM Primary only.

Linux Kernel Parameters

The following table describes the Linux kernel parameter values that you must define on Linux-based hosts where Workflow Insights is installed.

The kernel parameters must be defined on all hosts in the Workflow Insights environment, including the Control-M/EM Primary and Control-M/EM Distributed computers.

Parameter

Description

Relevant Instance

Minimum Value

vm.max_map_count

Determines the maximum number of memory map areas that a process can contain.

Control-M/EM Primary and Distributed.

262,144

soft nofile

Determines the number of files that a process can simultaneously open. This soft limit cannot exceed the hard limit.

Control-M/EM Distributed only.

65,535

hard nofile

Determines the number of files that a process can simultaneously open. This hard limit cannot be exceeded.

Control-M/EM Distributed only.

65,535

memlock

Determines the maximum locked-in-memory address space (KB). This is memory that is not paged out.

Control-M/EM Distributed only.

Unlimited

soft nproc

Determines the maximum number of threads permitted to the user. This soft limit cannot exceed the hard limit.

Control-M/EM Primary and Distributed.

4,096

hard nproc

Determines the maximum number of threads permitted to the user. This hard limit cannot be exceeded.

Control-M/EM Primary and Distributed.

4,096

Verify Linux Kernel Parameter Settings

This procedure describes how to verify Linux Kernel parameter settings before installing Control-M Workflow Insights.

Begin

  1. Do the following to verify the value of the vm.max_map_count parameter:

    1. Run the following command:

      sysctl -q vm.max_map_count

      The following return value appears: 262144.

    2. Do the following to increase the value of vm.max_map_count:

      1. Log in as root.

      2. In the /etc/sysctl.conf file, set vm.max_map_count to 262144.

      3. Run the following command to update the new value:

        sysctl -p

        The following vm.max_map_count return value appears: 262144.

  2. Do one of the following from one of these command shells to verify the value of the soft nofile, hard nofile, memlock, soft nproc, and hard nproc parameters:

    • tcsh:

      1. Run the following command:

        limit | grep descriptors

        The following return value appears: 65536.

      2. Run the following command:

        sh -c ulimit -|

        The following return value appears: unlimited.

      3. Run the following command:

        ulimit -u

        The return value appears and exceeds the following number: 4096.

    • bash:

      1. Run ulimit - a |grep files

        The following return value appears: 65536.

      2. Run ulimit -|

        The following return value appears: unlimited.

      3. Run the following command:

        ulimit -u

        The return value appears and must exceed the following number: 4096.

  3. Do the following to increase the value of the soft nofile, hard nofile, and memlock, soft nproc, and hard nproc parameters:

    1. Log in as root.

    2. Open the /etc/security/limits.conf file.

    3. Add or edit or add the following lines:

      • Soft nofile 65536

      • Hard nofile 65536

      • Soft memlock unlimited

      • hard memlock unlimited

  4. Restart the host.

  5. Do the following to verify that the configuration is updated:

    1. Run the following command:

      sysctl -q vm.max_map_count

      The following return value appears: 262144.

    2. Do one of the following from one of these command shells

      • tcsh: Run the following command:

        limit | grep descriptors

        The following return value appears: 65536.

      • bash: Run the following command:

        ulimit -a | grep files

        The following return value appears: 65536.

    3. Do one of the following from one of these command shells

      • tcsh: Run the following command:

        sh -c ulimit -|

        The following return value appears: unlimited.

      • bash: Run the following command:

        ulimit -|

        The following return value appears: unlimited.

Workflow Insights Ports

The following table describes the default Workflow Insights ports on Windows and Linux.

The ports must be open for all hosts in the Workflow Insights environment, including Control-M/EM Primary and Control-M/EM Distributed Servers.

If you cannot open any of these ports, you must define custom ports in the designated screen of the Workflow Insights installation. The Workflow Insights installation is described in Installing Control-M Workflow Insights on Windows or Installing Control-M Workflow Insights on Linux.

Port Name

Port Value

Component Installation

Description

Control-M/EM Web Server

8443

Control-M/EM Primary

Defines the Control-M/EM Web Server port, which grants access to a number of applications, as described in Control-M/EM Servers.

KAFKA_PORT

19092

Control-M/EM Primary

Defines the Kafka server port, which enables micro-service communications.

ZOOKEEPER_LE_PORT

3888

Control-M/EM Primary

Defines the Kafka cluster port, via which the primary host is chosen.

ZOOKEEPER_FOLLOWERS_PORT

2888

Control-M/EM Primary

Defines the Kafka cluster port via which the Kafka Follower hosts communicate with the Leader host.

ZOOKEEPER_CLIENT_PORT

12181

Control-M/EM Primary

Defines the Kafka port, which enables Zookeeper communication.

OpenSearch_HTTP_Port

19200

Control-M/EM Distributed First Workflow Insights Activation

Defines the OpenSearch HTTP port, which enables communication between the OpenSearch client and server, based on the http and https protocol.

OpenSearch_Transport_Port

19300

Control-M/EM Distributed First Workflow Insights Activation

Defines the OpenSearch Transport port, which enables communication between the OpenSearch hosts.

OpenSearch_Dashboards_Port

15061

Control-M/EM Distributed First Workflow Insights Activation

Defines the OpenSearch Dashboards port, which enables communication between Control-M Web and OpenSearch Dashboards, based on the http and https protocol.

WORKFLOW INSIGHT Service API PORT

DYNAMIC

Post-installation Step

Defines the Control-M Web API port that enables API requests.

Checking Workflow Insights Ports

This procedure describes how to check which ports are assigned to the Workflow Insights ports.

Begin

Execute one of the following commands:

  • Kafka and Zookeeper:

    • Windows: emcha -get_kafka_info -json

    • Linux: em -no_wrap cha -get_kafka_info -json

  • OpenSearch and OpenSearch Dashboards:

    • Windows: emcha -get_elastic_info

    • Linux: em -no_wrap cha -get_elastic_info

  • WORKFLOW INSIGHT Service API PORT: Do the following:

    1. Open the following file:
      <EM_HOME>/services/config/workflow-insights-service-application.yml

    2. Check the value of the Port property.

Changing Kafka/Zookeeper Ports

This procedure describes how to change the Kafka/Zookeeper Ports after you install Workflow Insights. You must perform this procedure on every Control-M/EM primary and Control-M/EM distributed host where Workflow Insights is installed.

Begin

  1. From any Control-M/EM host where Workflow Insights is installed, run the following script to see the usage:

    em bmcpython ~/ctm_em/services/bin/apache_kafka_config.py change_ports -h

    The usage shows you the exact names that the script uses for each service: Kafka, OpenSearch, and OpenSearch Dashboards.

  2. Run the following commands:

    em bmcpython ~/ctm_em/services/bin/apache_kafka_config.py install --<Port_Name> <Port_Value>

    em emsca set-desired-state down -s <Service>

    em emsca set-desired-state up -s <Service>

    Set <Service> to apache-zookeeper or apache-kafka.

Changing OpenSearch and OpenSearch Dashboards Ports

This procedure describes how to change the OpenSearch and OpenSearch Dashboards ports after you install Workflow Insights. You must perform this procedure on every Control-M/EM primary and Control-M/EM distributed host where Workflow Insights is installed.

Begin

  1. From a command line, run one of the following commands:

    • OpenSearch_HTTP_Port: em bmcpython ~/ctm_em/services/bin/workflow_insights_config.py change_ports --OpenSearch_HTTP_Port <Port_Number>

    • OpenSearch_Transport_Port: em bmcpython ~/ctm_em/services/bin/workflow_insights_config.py change_ports --OpenSearch_Transport_Port <Port_Number>

    • OpenSearch_Dashboards_Port: em bmcpython ~/ctm_em/services/bin/workflow_insights_config.py change_ports --OpenSearch_Dashboards_Port <Port_Number>

    where the <Port_Number> parameter defines the new port number.

  2. Run the following commands to restart OpenSearch:

    em emsca set-desired-state down -s opensearch

    em emsca set-desired-state up -s opensearch

  3. Run the following commands to restart OpenSearch Dashboards:

    em emsca set-desired-state down -s opensearch-dashboards

    em emsca set-desired-state up -s opensearch-dashboards

Changing the Service API Port

This procedure describes how to change the Workflow Insights Service API Port after you install Workflow Insights. You must perform this procedure on every Control-M/EM primary and Control-M/EM distributed host where Workflow Insights is installed.

Begin

  1. Open the following file:

    $EM_HOME/services/config/workflow-insights-service-application.yml

  2. In the file, change the port property to the required port number.

  3. Restart the Workflow Insights service.