Space banner


This documentation supports an earlier version of BMC Helix IT Operations Management on-premises deployment.

To view the documentation for the latest version, select 22.4 from the Product version picker.

Preparing for deployment

Perform the following tasks before deploying BMC Helix IT Operations Management. When you perform the installation or upgrade, individual components might require additional pre-installation or pre-upgrade steps. 


Install a BMC Discovery appliance version 21.3 or later.

Important: The BMC Discovery appliance is optional for BMC Helix Continuous Optimization and is not required if you are deploying only the BMC Helix Platform common services.

Setting up a BMC Discovery appliance

Make sure that all the ports that are related to Kubernetes are open on the worker and master nodes. Use the following command for each port:

firewall-cmd --permanent --add-port portNumber/tcp

Kubernetes documentation Open link  and the Kubernetes cluster management documentation for the application that you are using. For example, see  BMC Discovery documentation Open link .


Install the time synchronization protocol to synchronize the date and time on all nodes. For example, for the Network Time Protocol (NTP), use the following command on each node:

yum -y install ntp ntpdate ntp-doc; chkconfig ntpd on; ntpdate ; systemctl start ntpd

If you are using BMC Helix Operations Management and the BMC Discovery appliance, ensure that you use the same NTP server for both applications.

  • CentCentOS, RHEL, CoreOS, Fedora:

    ~]# yum install ntp

    See  the Red Hat documentation Open link  for the post-installation steps.

  • Ubuntu:

    apt-get install ntp

    See  the Ubuntu documentation Open link  for the post-installation steps.

  • Photon OS (VMWare)

    tdnf install ntp

    See  the VMWare documentation Open link  for the post-installation steps.

Rancher documentation Open link


Set up a private Docker registry if your Kubernetes cluster does not have internet access. We recommend Harbor.

Setting up a Harbor repository

Accessing container images from an air-gapped environment


For all worker nodes, set the sysctl -w vm.max_map_count parameter to 262144 before deployment. Run the following commands on the worker node:

sysctl -w vm.max_map_count=262144

echo vm.max_map_count=262144 > /etc/sysctl.d/es-custom.conf

Elasticsearch documentation Open link

6Create the NFS StorageClass and Block StorageClass in the cluster.
  • For an example NFS StorageClass provider, see  the Kubernetes documentation here Open link .

  • For an example Block StorageClass provider, see  the Ceph CSI documentation here Open link .

7Download the deployment manager and container images required to perform the deployment.Downloading the deployment manager and container images
8Configure the deployment files.

Configuration file settings

9If you are using Openshift, deploy the K8 ingress controller.Deploying the ingress controller for OpenShift or Kubernetes
10If you are using Elasticsearch, Fluentd, and Kibana for logging, review the logging requirements.Preparing for BMC Helix logging

Keep the following URLs handy. Ensure that these are unique URLs:

Property in the infra.config fileExpected formatTo be configured in the load balancerTo have a DNS entry

<a unique string>.$DOMAIN

Validate the URL on any internet browser. The following message should appear:

Default backend - 404

TMS_LB_HOST<a unique string>.$DOMAINYESYES
(BMC Helix Operations Management only) Appliance URL



Was this page helpful? Yes No Submitting... Thank you


  1. Jã¼rgen Dannerbauer

    Regarding the vm.max_map_count parameter in step 5. Is this really an equals setting or are we good enough if we have at least this value set?

    Dec 18, 2022 11:11
    1. Ashwini Sawanth


      We are checking for the details and will get back to you soon.


      Ashwini Sawanth

      Apr 15, 2023 12:31
      1. Ashwini Sawanth

        Hi Dannerbauer, 

        It is good enough if you set the value to 262144.

        Thanks and regards, 


        Apr 27, 2023 06:43