This documentation supports the releases of BMC Helix Service Monitoring till September 2021 (21.3.03). Documentation for later versions is available in the BMC Helix AIOps documentation space. To view the documentation, select a version from the Product version menu.

Rolling back a third-party integration to the previous version

After you upgrade a third-party integration, if you see any errors while monitoring the third-party data, you can roll back to the previous integration version.

Important

To avoid interfering with supporting services at later versions, rolling back integrations is recommended only if you see errors while monitoring third-party data.

Related topic

Upgrading-third-party-integrationsDownloading and installing the Connector

  1. Run the following command to verify the BMC Helix Intelligent Integrations Connector status: 

    docker ps | grep <connector-name>

    #Output
    CONTAINER ID    IMAGE           COMMAND      CREATED        STATUS       PORTS                NAMES
    deed817ccb72    57e8da5cb8ac    "/run.sh"    5 hours ago    Up 2 hours   5140/tcp,24224/tcp   tsom_test_connector

  2. (Optional) If the Connector is up and running, run the following command to stop the Connector: 

    #Syntax
    docker stop <Container ID>

    #Example
    docker stop deed817ccb72

  3. Take a backup of the /opt/bmc/connectors/<connector-name>/data directory.

    Best practice
    Name the backup directory with the integration build details. For example, if you are taking a backup of the integration build 80, name the backup directory as Integration_backup_build80.

  4. Extract and copy the backup data directory of the previous integration version and paste it in the /opt/bmc/connectors/<connector-name>/data directory. 
  5. Confirm the file replace operation.

  6. Restart the container by running the following command: 

    #Syntax
    docker exec -it <container ID> bash


    #Example
    docker exec -it deed817ccb72 bash

To verify the rollback operation

Go to Integrations > Configured Integrations, check the build number on the third-party integration tile, and ensure that the integration version is rolled back to its previous version. For example, before the rollback, if the build number is 108, after the rollback, the build number displayed on the tile would be 107 as shown in the following example:

tsom_connector_rollback.png

 

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