Restoring a Workflow Insights Backup

This procedure describes how to restore a Workflow Insights backup, which enables you to revert the service to a previous state.

Before You Begin

Configure the Cluster Backup Location Workflow Insights setting, as described in Configuring Workflow Insights.

Begin

  1. Copy the existing backups to a temporary location in case the original backups become damaged during the procedure.

  2. Activate the restore mode as described in Setting the Workflow Insights Restore Mode.

  3. Install the same number of Control-M/EM distributed hosts that you had before the failure. Prepare and install them fully as you installed the original Control-M/EM distributed hosts with required system requirements, system settings, required open ports, and software such as Workflow insights.

  4. Verify the original Backup Location configuration setting is still set, as described in Configuring Workflow Insights. If no path or the wrong path to the backup location appears in the Workflow Insights configuration, insert the original backup path and verify that all new Control-M/EM hosts have write access.

  5. Restart all OpenSearch nodes and restart at least one Workflow Insights service in one of the Control-M/EM distributed hosts.

  6. Log in to one of the Control-M/EM distributed hosts where Workflow Insights is installed.

  7. From a Control-M/EM distributed machine, in the Workflow Insights environment, do one of the following:

    • To view the backups that can be restored, run the following script:

      • UNIX: em bmcpython ~/ctm_em/services/bin/elasticsearch_restore.py snapshots -eh <Machine_Name or Local_Host_Name> -ep <HTTP_Port_Number>

      • Windows: bmcpython "%EM_HOME%\services\bin\elasticsearch_restore.py" snapshots -eh <Machine_Name or Local_Host_Name> -ep <HTTP_Port_Number>

    • To restore the most recent backup, run the following script:

      • UNIX: em bmcpython ~/ctm_em/services/bin/elasticsearch_restore.py restore -eh <Machine Name or Local Host Name> -ep <HTTP_Port_Number>

      • Windows: bmcpython "%EM_HOME%\services\bin\elasticsearch_restore.py" restore -eh <Machine Name or Local Host Name> -ep <HTTP_Port_Number>

    • If you want to restore an earlier backup, run the following script:

      • UNIX: em bmcpython ctm_em/services/bin/elasticsearch_restore.py restore -eh localhost -ep 19200 -es <Backup_Name>

      • Windows: bmcpython "%EM_HOME%\services\bin\elasticsearch_restore.py" restore -eh localhost -ep 19200 -es <Backup_Name>

    • View Available Backups

      • UNIX: em bmcpython ~/ctm_em/services/bin/elasticsearch_restore.py snapshots -eh localhost -ep 19200
      • Windows: bmcpython "%EM_HOME%\services\bin\elasticsearch_restore.py" snapshots -eh localhost -ep 19200

    • Restore Most Recent Backup

      • UNIX: em bmcpython ~/ctm_em/services/bin/elasticsearch_restore.py restore -eh localhost -ep 19200

      • Windows: bmcpython "%EM_HOME%\services\bin\elasticsearch_restore.py" restore -eh localhost -ep 19200

    • Restore an Earlier Backup

      • UNIX: em bmcpython ctm_em/services/bin/elasticsearch_restore.py restore -eh localhost -ep 19200 -es 23-11-08-11-38

      • Windows: bmcpython "%EM_HOME%\services\bin\elasticsearch_restore.py" restore -eh localhost -ep 19200 -es 23-11-08-11-38

  8. After restore finishes, deactivate the restore mode as described in Setting the Workflow Insights Restore Mode.

    The Workflow Insights backup is restored.