OpenSearch and OpenSearch Dashboards Management

The following procedures enable you to manage OpenSearch An AWS search engine, based on Elasticsearch, that Workflow Insights uses to gather information and perform queries. and OpenSearch Dashboards An AWS data visualization dashboard software, based on Kibana, that Workflow Insights uses to show OpenSearch query data in the dashboards. in Workflow Insights:

• Upgrading from Elasticsearch to OpenSearch

• Uninstalling OpenSearch

Upgrading from Elasticsearch to OpenSearch

This procedure describes how to upgrade from Elasticsearch and Kibana (deprecated in Control-M) to OpenSearch and OpenSearch Dashboards in Control-M Workflow Insights.

Before You Begin

• Define a Workflow Insights backup, as described in Defining Workflow Insights Backups.

• Copy the Workflow Insights cluster backup location that you defined in Configuring Workflow Insights, and paste it to the following location:

  • UNIX: ~/BMCINSTALL/uninstall/DRNFT.<Current_Version>/Backup_Elasticsearch_Snapshots

  • Windows: "%EM_HOME%\BMCINSTALL\uninstall\DRNFT.<Current_Version>\Backup_Elasticsearch_Snapshots"

• Install Control-M/EM 9.0.21.300, as described in Control-M Upgrade.

• Verify that the Control-M/EM Configuration Agent is Up.

• (Control-M Full Install only) Verify that the Control-M/Server is Down.

Begin

1. Log in as a Control-M/EM user.

2. Run the following command to stop Elasticsearch and Kibana:

   In a Control-M/EM Cluster or High Availability Configuration, you must consecutively run this command on every host before you move to the next step.

   • UNIX:

     em bmcpython ~/ctm_em/services/bin/opensearch_update/opensearch_manager.py stop

   • Windows:

     bmcpython "%EM_HOME%\services\bin\opensearch_update\opensearch_manager.py" stop

3. Run the following command to install OpenSearch and OpenSearch Dashboards:

   In a Control-M/EM Cluster or High Availability Configuration, you must consecutively run this command on every host.

   • UNIX:

     em bmcpython ~/ctm_em/services/bin/opensearch_update/opensearch_manager.py install

   • Windows:

     bmcpython "%EM_HOME%\services\bin\opensearch_update\opensearch_manager.py" install

4. Run the following command to verify that OpenSearch service is running:

   em services-cli -st

Uninstalling OpenSearch

This procedure describes how to uninstall OpenSearch and OpenSearch Dashboards and restore Elasticsearch and Kibana in Control-M Workflow Insights. You must uninstall OpenSearch when you downgrade from 9.0.21.300 to Control-M/EM 9.0.21.100 and lower.

Begin

1. Log in as a Control-M/EM user.

2. Do the following:

   1. Run the following command to view the backups that can be restored:

      UNIX: em bmcpython $HOME/ctm_em/services/bin/elasticsearch_restore.py snapshots

      Windows: bmcpython "%EM_HOME%\services\bin\elasticsearch_restore.py" snapshots

      A list of backups appears.

   2. From the list of backups, find and record the backup Name that you want to restore.

3. Uninstall Control-M Workflow Insights, as described below:

   • UNIX: Uninstalling Control-M Workflow Insights from Linux

   • Windows: Uninstalling Control-M Workflow Insights from Windows

4. Run the following command to downgrade Control-M/EM:

   • UNIX: $HOME/ctm_em/BMCINSTALL/uninstall/DRNFT.9.0.21.200/uninstall.sh

   • Windows: "%EM_HOME%\BMCINSTALL\uninstall\DRNFT.9.0.21.200\uninstall.exe"

5. Reinstall Control-M Workflow Insights, as described below:

   • UNIX: Installing Control-M Workflow Insights on Linux

   • Windows: Installing Control-M Workflow Insights on Windows

6. Restore Elasticsearch with the backup Name that you recorded, as described in Restoring a Workflow Insights Backup.