Creating IBM Infrastructure Management integrations

Before you begin

Before you configure an Infrastructure Management integration, ensure that the following prerequisites are met:

• You have a working Infrastructure Management cluster. Infrastructure Management must be installed on an Red Hat OpenShift Container Platform cluster. The integration cannot be created for an Infrastructure Management appliance that is running on a virtual machine (VM).

• Event syndication, inventory syndication, and metrics syndication must be enabled within Infrastructure Management as required.

  For information on how to enable event, inventory, and metrics syndication, see Enabling events, inventory and metrics syndication within the topic General Configuration.

Note: Infrastructure Management and Cloud Pak for AIOps can be located in the same cluster or in different clusters.

Creating Infrastructure Management integrations

To create an Infrastructure Management integration, complete the following steps:

1. Log in to the IBM Cloud Pak for AIOps console.

2. Expand the navigation menu (four horizontal bars), then click Define > Integrations.

3. On the Integrations page, click Add integration.

4. From the list of available integrations, find and click the Infrastructure Management tile.

   Note: If you do not immediately see the integration that you want to create, you can filter the tiles by type of integration. Select the Events, Topology, and Metrics from the Category list.

5. On the side panel, review the information and when ready to continue, click Get started.

   

6. On the Add integration page, define the general integration details:

   Name: The display name for the integration.

   Description (optional): An optional description for the integration.

   

7. Click Done.

   Important: After creating the integration, you are prompted to copy or download a boostrap command for running a remote deployment script. The script is generated when you create the integration in IBM Cloud Pak for AIOps. This script is required for establish the integration from Infrastructure Management to IBM Cloud Pak for AIOps.

   

8. Copy or download the bootstrap command for the deployment script.

   You can click the Copy to clipboard button to copy the command, or click Download as shell script to download the command as a bootstrap.sh file.

   Note: If you do not obtain the command now, you can copy or download the command later by completing the following steps:

   1. Log in to IBM Cloud Pak for AIOps console.

   2. Expand the navigation menu (four horizontal bars), then click Define > Integrations.

   3. Click the IBM Infrastructure Management integration type on the Manage integrations tab of the Integrations page.

   4. On the IBM Infrastructure Management page, click the Download link in the Remote deployment script column for the integration.

   5. Either copy or download the bootstrap command for the deployment script.

9. Run the remote deployment script on your Infrastructure Management cluster.

   1. Get the OpenShift CLI oc login command from the cluster where Infrastructure Management is installed.

   2. From a command line, log in to the Infrastructure Management cluster with the oc login command.

   3. Switch to the project (namespace) where Infrastructure Management is installed.

   4. Run the deployment script as a sh (script file), such as the downloadable bootstap.sh file.

Editing Infrastructure Management integrations

After you create a integration, you can edit the integration to update the name or description. Complete the following steps to edit the integration:

1. Log in to IBM Cloud Pak for AIOps console.

2. Expand the navigation menu (four horizontal bars), then click Define > Integrations.

3. Click the IBM Infrastructure Management integration type on the Manage integrations tab of the Integrations page.

4. On the IBM Infrastructure Management page, click the name of the integration that you want to edit. Alternatively, you can click the options menu (three vertical dots) for the integration and click Edit. The integration configuration opens.

5. Edit your integration as required.

6. Click Save when you are done editing.

Deleting Infrastructure Management integrations

If you no longer need your IBM Infrastructure Management integration and want to not only disable it, but delete it entirely, you can delete the integration from the console.

To delete a integration, you need to complete the following steps for IBM Cloud Pak for AIOps. Then, you need to complete steps on your Infrastructure Management to remove the integration deployment. The deployment on the cluster is not removed when you delete the integration in the IBM Cloud Pak for AIOps console for IBM Cloud Pak for AIOps.

1. Log in to IBM Cloud Pak for AIOps console.

2. Expand the navigation menu (four horizontal bars), then click Define > Integrations.

3. Click the IBM Infrastructure Management integration type on the Manage integrations tab of the Integrations page.

4. On the IBM Infrastructure Management integrations page, click the options menu (three vertical dots) for the integration that you want to delete and click Delete.

5. Enter the name of the integration to confirm that you want to delete your integration. Then, click Delete. Your integration is deleted.

6. Delete the integration deployment on your Infrastructure Management cluster. To delete the deployment, you must manually run OpenShift CLI (oc) commands against the cluster.

   1. From a command line, use the oc login command to log in to your Infrastructure Management cluster.

   2. Switch to the project (namespace) where Infrastructure Management is installed.

      oc project <project>
      

      Where <project> is the project (namespace) where Infrastructure Management is installed.

   3. Delete the grpc-bridge-secret secret.

      oc delete secret grpc-bridge-secret
      

   4. Delete the integration deployment

      oc delete deploy aiops-connector
      

      The deployment is now deleted from your Infrastructure Management cluster.

   5. Delete the aiops-connector-allow-kafka network policy:

      oc delete networkpolicy aiops-connector-allow-kafka