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

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

Installing

BMC provides Jenkins pipelines to install BMC Helix Service Management on your on-premises systems. To get started with the installation, you must understand the end-to-end process for implementing BMC Helix Service Management on your system. To set up your system, you must meet the system requirements, download the installation files, perform the installation, complete the system configurations, and then make the system available to the users.

BMC Helix Service Management installation process

A typical installation of BMC Helix Service Management requires two namespaces as shown in the following image:

Important

bmc-helix-platform and bmc-helix-innovation-suite-poc are example namespace names. The actual namespace names are specific to your environment.

For more information about the namespaces, see System requirements.

The following image provides an overview of BMC Helix Service Management installation process for the on-premises system:

The following table provides the steps to install BMC Helix Service Management and set up your on-premises system:

TaskActionReference
1
Plan the installation
a

Review the deployment architecture.

Get familiarized with the BMC Helix Service Management deployment architecture.
See BMC Helix Service Management deployment architecture.

b

Plan the sizing of the container environment.

Plan your environment and check the license requirements based on the products you want to install.

Review the sizing guidelines for BMC Helix Service Management container environment. The sizing guidelines include the sizing requirements for the following products:

  • BMC Helix ITSM
  • BMC Helix ITSM: Smart IT
  • BMC Helix Dashboards
  • BMC Digital Workplace
  • BMC Digital Workplace Catalog
  • BMC Live Chat

Important:

  • The Kubernetes cluster and worker node sizing guidelines in the Sizing and scalability considerations topic do not include BMC Helix Business Workflows and BMC Helix Multi-Cloud Broker requirements.
  • If you plan to install BMC Helix ITSM Insights, see BMC Helix ITSM Insights resource requirements.
cPlan and set up your Kubernetes cluster

Review the supported orchestration platforms and set up the cluster where you want to install BMC Helix Innovation Suite.

Create the namespaces to install BMC Helix Platform and BMC Helix Innovation Suite, and configure the master and worker nodes in the cluster.

For information about the orchestration platforms and namespaces requirements, see Orchestration platforms.
For information about the nodes, see Sizing and scalability considerations.

dSet up load balancer and Ingress controller

Review the supported load balancer, load balancer SSL methods, and headers for SSL configurations

Review the Ingress controller and parameter value requirements.

Set up the load balancer and Ingress controller for your cluster.

eSet up hardware requirements for BMC Deployment Engine

Review the Jenkins server requirements to set up the BMC Deployment Engine.

2

Prepare for installation 

aDownload the installation files and container images access key from Electronic Product Download (EPD).Downloading the installation files
b

Create your Harbor repository and synchronize the repository with BMC Docker Trusted Registry (DTR).

Setting up a Harbor repository to synchronize container images

cPrepare the database that you want to use.

Setting up a Microsoft SQL Server database

Setting up an Oracle database

Setting up a PostgreSQL database

dSet up the BMC Deployment Engine to call the relevant pipelines that deploy the platform and applications.Setting up BMC Deployment Engine
e

Deploy BMC Helix Platform services and set up the installation environment to make it installation ready. 

Important: Deploy BMC Helix Platform services in the BMC Helix Platform namespace.

Installing BMC Helix Platform Common services 24.1.00

Installing BMC Helix Platform Common Services 23.4.00

Installing BMC Helix Platform Common Services 23.2.02

Setting up the installation environment

3

Perform BMC Helix Service Management installation


In the BMC Helix Innovation Suite namespace, install the platform and applications.

4

Perform BMC Helix Service Management post-installation tasks

aObtain license keys for the platform and applications that you want to use.Obtaining license keys
bApply license keys for the platform and applications that you want to use.Activating application licenses
cPerform the post-installation configurations.Performing the postinstallation configurations
5Perform basic configurations

Perform basic configurations such as configure set up users, and provide user permissions.

Onboarding and implementing Open link

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

Comments

  1. henrique m ferreira

    In this doc, it says "A typical installation of BMC Helix IT Service Management requires three namespaces as shown in the following image:", but in the picture only shows two. What would be the 3rd namespace, just as example?

    Sep 22, 2023 03:44
    1. Poonam Morti

      Hello,

      BMC Helix IT Service Service Management 22.1.06 installation requires two namespaces. We have updated the content.

      Thanks,

      Poonam

      Sep 24, 2023 11:33
  2. Ravi Sharma

    Under section 2 (e), steps are not provided to Installing BMC Helix Platform Common Services 24.1.00. Is this not supported?

    Mar 07, 2024 06:38
    1. Poonam Morti

      Hi Ravi,

      Thanks for bringing this to our notice. We have added the link for Installing BMC Helix Platform Common Services 24.1.00.

      Thanks,

      Poonam

      Mar 07, 2024 10:55