Installing BMC Helix Smart Reporting 21.3.04

zzz

You can install Smart Reporting only if you have chosen to opt for Smart Reporting extended support. The Smart Reporting installation option is not available with the BMC Helix Service Management installation. To install Smart Reporting, use the Smart Reporting repositories and the HELIX_SMARTREPORTING pipeline.

The HELIX_SMARTREPORTING pipeline deploys the following component and pod:

Component	Pod
BMC Helix ITSM: Smart Reportingconsole	smartreporting

Before you begin

Make sure that you perform the following preinstallation tasks before you start the installation:

Download the Smart Reporting installation files.
See Downloading the installation files.
Access the Smart Reporting container images.
See Accessing container images and Setting up a Harbor repository to synchronize container images.
Set up BMC Helix Deployment Engine.
While setting up BMC Helix Deployment Engine, make sure that you set the SMART_REPORTING value to true in the deployment-engine-config.env file.
Install BMC Helix Service Management.
See Performing the BMC Helix Service Management installation.

To install BMC Helix Smart Reporting

Run the HELIX_SMARTREPORTING pipeline by performing the following steps:

Important

Do not use spaces in the pipeline parameter values.

Log in to your Jenkins server by using the following URL:
http://<Jenkins server host name>:8080
Select the HELIX_SMARTREPORTING pipeline, and click Build with Parameters.

In the INFRASTRUCTURE section, specify the following parameters:

Parameter	Description
CONTAINERIZED_DE	Select this check box.
AGENT	Jenkins agent to run the pipeline. Specify the value as jenkins-agent.
CHECKOUT_USING_USER	Jenkins credential ID that contains the Git credentials. Specify the value as github.
KUBECONFIG_CREDENTIAL	Jenkins credential ID that contains the kubeconfig file for the target Kubernetes cluster.
GIT_USER_HOME_DIR	Git user home directory. Specify the value as /home/jenkins.
GIT_REPO_DIR	Directory that contains all the Git repositories for the deployment pipelines. Specify the value as http://gitea:3000/ciadmin.
HELM_NODE	Specify the host name of the Jenkins server where you have installed HELM. Specify the value as jenkins-agent.

In the ENVIRONMENT DETAILS section, specify the following parameters:

Parameter	Description
CLUSTER_CONTEXT	Specify the value of the Kubernetes cluster context. Find the cluster from the kubeconfig file. The current-context value in the kubeconfig file is the cluster name. Example: dev-k8s-cluster apiVersion: v1 clusters: - cluster: server: https://<local host>/k8s/clusters/c-rxcc6 current-context:dev-k8s-cluster
CUSTOMER_NAME	Specify the customer's full name. Example: ABC Jenkins Limited.
IS_NAMESPACE	Specify the namespace where you want to install BMC Helix Innovation Suite. Important: The maximum namespace name limit is 33 characters.
CUSTOMER_SERVICE and ENVIRONMENT	Specify values of your service and environment. The pipeline generates URL in a specific format based on the inputs provided in the CUSTOMER_SERVICE, ENVIRONMENT, and CLUSTER_DOMAIN parameters. Example: If CUSTOMER_SERVICE=itsm, ENVIRONMENT=poc, and CLUSTER_DOMAIN=aus-ranch.bmc.com, the following URL is generated for Smart Reporting: itsm-poc-sr.aus-ranch.bmc.com The platform and application URLs support only the HTTPS protocol. Important: When the ENVIRONMENT value is prod for production environments, the URLs are generated by excluding -<ENVIRONMENT> value. The URL format for Smart Reporting production environment is itsm-sr.aus-ranch.bmc.com Make sure that you specify the correct values. You cannot change the application domain and URLs after installing BMC Helix Service Management. If you need to make changes, you will have to reinstall BMC Helix Service Management.
CUSTOMER_SIZE	Specify the deployment size such as, compact, small, medium, large, or extra large. Enter the value as C, S, M, L, or XL.
SMARTREPORTING_SOURCE_VERSION	For fresh installation, specify NA for the Smart Reporting application version of the Helm repositories. For the upgrade, specify the SMARTREPORTING_SOURCE_VERSION value based on your current Smart Reporting version. The acceptable values are 2021303.1.03.00, 2021303.1.06.00, 210503.1.05.00, 210503.1.09.00, 210503.1.11.00, or 210503.1.12.00.

In the PRODUCTS section, in the DEPLOYMENT_MODE parameter, specify the value as FRESH to perform a fresh installation or UPGRADE to upgrade Smart Reporting.

In the OTHER_INPUT_PARAMS section, specify the following parameters:

Parameter	Description
INGRESS_CLASS	Specify the Ingress class name of the NGINX Ingress Controller that you used while installing BMC Helix Platform. The default value is nginx.
ROUTE_ENABLED	Do not select this check box.
OS_RESTRICTED_SCC	Select this check box if you are using an OpenShift cluster and have restricted security context constraints enabled.
CLUSTER_DOMAIN	Specify the Ingress controller domain name that is used for application URLs.
HARBOR_REGISTRY_HOST	Specify the host name of BMC Docker Trusted Registry (DTR) docker.io If you use a local Harbor registry to synchronize with BMC DTR, specify the host name of your local registry. Important: Do not specify the host path; specify only the host name.
IMAGE_REGISTRY_USERNAME	Specify your EPD user name to log in to BMC DTR. If you use a local Harbor registry to synchronize with BMC DTR, specify the user name to log in to your local registry.
IMAGE_REGISTRY_PASSWORD	Specify the BMC DTR (docker.io) token that you download from EPD. If you use a local Harbor registry to synchronize with BMC DTR, specify the password to log in to your local registry. To update the password, click Change Password.
REGISTRY_TYPE	Select the DTR option.
DB_TYPE	Select the database type that you want to use: mssql postgres oracle
DB_PORT	Specify the database port value.
ORACLE_SERVICE_NAME	Specify the Oracle service name to use an Oracle database.
DATABASE_HOST_NAME	Specify the host name of the database server.
(Only for PostgreSQL database) DATABASE_ADMIN_USER	If you select the DB_TYPE value as mssql or oracle, you can leave this field blank. For a PostgreSQL database, specify the administrator user name that is used to create and restore database dumps. Important: For a PostgreSQL database, if you use a user other than the postgres user, make sure that you create a database with the same name as that of the user.
(Only for PostgreSQL database) DATABASE_ADMIN_PASSWORD	If you select the DB_TYPE value as mssql or oracle, leave this field blank. For a PostgreSQL database, specify the administrator user password. To update the password, click Change Password.
(Only for PostgreSQL database) DATABASE_RESTORE	By default, this check box is selected to restore PostgreSQL database dumps automatically. If you have restored the database dumps manually, clear this check box.
IS_DATABASE_ALWAYS_ON	Select this check box if your Microsoft SQL database is in a high availability cluster.
HELM_NODE	Specify the host name of the Jenkins server where you have installed HELM.
SMARTREPORTING_ADMIN_PWD	Specify the Smart Reporting administrator user password.
IMAGESECRET_NAME	Specify the name used to create Kubernetes image registry secret. Important: Use lower case, alphanumeric characters, and a hyphen (-) in the secret. The secret must start and end with an alphanumeric character. Example: image-1.
SMARTREPORTING_DB_NAME	Specify the name of the BMC Helix ITSM: Smart Reporting database. Important: Make sure that you the database name starts with a character. You can specify numbers and only the following special characters in the name: Dollar $ Hash # Underscore _
SMARTREPORTING_DB_USER	Specify the BMC Helix ITSM: Smart Reporting database user. Important: Make sure that you the database user name starts with a character. You can specify numbers and only the following special characters in the name: Dollar $ Hash # Underscore _
SMARTREPORTING_DB_PASSWORD	Specify the password for the BMC Helix ITSM: Smart Reporting user. Important: The maximum password character limit is 28 characters.

Click Build.
The HELIX_SMARTREPORTING pipeline installs the Smart Reporting application.

To perform post-installation checks

Verify that the Smart Reporting pod is running by using the following command:
kubectl get pod -n <BMC Helix Innovation Suite namespace>
Verify that the you can access Smart Reporting by using the following URL:
https://<smartreporting ingress name>
Use the siadmin user credentials to log in.

Where to go from here

Obtaining-license-keys