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.04 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.

Related topics

BMC-Helix-Service-Management-deployment-architecture

Sizing-and-scalability-considerations

BMC Helix Service Management installation process

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

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:

Installation process overview.png

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

Task

Action

Reference

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.

c

Plan 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.

d

Set 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.

e

Set up hardware requirements for BMC Deployment Engine

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

2

Prepare for installation 

a

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

b

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

c

Prepare the database that you want to use.

d

Set up the BMC Deployment Engine to call the relevant pipelines that deploy the platform and applications.

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.

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

a

Obtain license keys for the platform and applications that you want to use.

b

Apply license keys for the platform and applications that you want to use.

c

Perform the post-installation configurations.

5

Perform basic configurations


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

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*