Deploying custom third-party integrations by using the Custom Integration template

You can use the Custom Integration template to deploy a custom third-party integration that is developed by the integration developer of your organization or a third party. 

Before you begin

• Download and install the BMC Helix Developer Tools connector.
• Create a sandbox environment by using the Custom Integration template.
• Get the custom integration deployable package in tar.gz format from the integration developer of your organization or from a third-party vendor.

To deploy a custom third-party integration

1. On the Configured integrations tab, locate the integration that you configured by using the Custom Integration template; for example, Custom_Integration_Demo.
2. Click the action menu, and select Copy ID to copy the integration ID of the sandbox integration, and make a note of this integration ID, which will be used in the next section. 
   

3. Click the info icon on the integration tile, and note the connector name and host name on which the connector is running. 
   In the following example, the host name is Test-host and the connector name is Custom_integration_demo.

   
    

4. Get the deployable integration package in tar.gz format from your integration developer, and save it in the /opt/bmc/connectors/<connector-name>/custom/download directory on the host computer whose details you noted in the previous step.
5. Get a complete list of parameters that you want to customize from your integration developer.
6. Click the Configured Integrations tab.
7. Click the action menu of the sandbox integration that you created using the Custom Integration template, and select Edit.
   
8. Select an entity from the Entity Name list, and enter the pipeline configuration file name in the Pipeline File text box.
   For example, select the Events entity, and enter solarwinds_events_pipeline.conf in the Pipeline File text box. 
9. In the Custom Pipeline Parameters Section section, enter the parameter name, its value, and optionally, select the Encrypt option to encrypt a parameter value.
   
10. Enter the Deployable package file name (for example, enter solarwinds.tar.gz), and click Configure.
    
11. Confirm a successful deployment by checking for events from the URL that you specified in step 9:
    1. On the Configured Integrations tab, locate the configured integration tile that is created by using the Custom Integration template; for example, Custom_Integration_Demo. You should see the count of ingested events on the configured tile.
       
    2. Log on to the BMC Helix Operations Management console, and select Monitoring > Events to view the ingested events.