Configuring and enabling adapters for Continuous Compliance for Network Automation

The BMC Continuous Compliance for Network Automation solution requires the following TrueSight Orchestration adapters to be configured and enabling:

• BMC Remedy Actor
• BMC Network Automation
• BMC ITSM Web Services
• BMC Remedy Monitor
• SNMP Monitor

This topic contains information on configuring and enabling these adapters:

• To add required adapter configurations
• To configure the BMC Remedy Actor adapter
• To configure the BMC Network Automation adapter
• To configure the BMC ITSM Web Services adapter
• To configure the BMC Remedy Monitor adapter
• To configure the SNMP Monitor adapter
• To enable the adapter configurations

To add required adapter configurations

1. Log into the TrueSight Orchestration Grid Manager. You must have a Grid role of Manager.
2. Click the Manage tab, then the Adapters tab to access the adapters page.

3. On the left side of the Adapters page, select all of the following required adapters:

   Adapter	Details
   ro-adapter-remedy-actor and ro-adapter-remedy-monitor	These adapters provide an interface for TrueSight Orchestration to monitor and act upon change and task tickets. These adapters must be installed and configured on the Grid Manager, and the adapter utilities imported into TrueSight Orchestration Development Studio. See BMC-Remedy-AR-System-adapter in the TrueSight Orchestration online documentation.
   bmc-adapter-bmc-network-automation-actor	This adapter provides an interface for TrueSight Network Automation. See BMC-Network-Automation-adapter in the TrueSight Orchestration online documentation.
   ro-adapter-snmp-monitor	The SNMP monitor adapter receives traps from external systems, (for example, a source server), and forwards these traps to the foundation system, (for example, a target server) in a known XML format. See SNMP-adapter in the TrueSight Orchestration Base Adapters online documentation.
   ro-adapter-ws	The BMC ITSM Web Services adapter is used to make Remote Procedure Call (RPC) requests using Simple Object Access Protocol (SOAP). This adapter does not require a configuration node. However, you must configure the adapter in Grid Manager. See Web-Services-adapter in the TrueSight Orchestration Base Adapters online documentation.

4. Click Add to Grid or Update Adapters on Grid, as follows:
   
   • Click Add to Grid if the adapters are not already added to the grid on the right side.
   • Click Update Adapters on Grid if adapters are already added to the grid (for example, when upgrading TrueSight Orchestration)

5. Click each adapter to enter adapter configurations as described in the following sections.

   Warning

   Note

   During upgrade, existing adapter configuration is overwritten. BMC recommends to back up the settings before upgrade.

To configure the BMC Remedy Actor adapter

Enter the following details and then click OK.

• Name: ARSAdapter
• Description: Type a description for the adapter
• Type: ro-adapter-remedy-actor
• Properties: Enter the adapter configuration properties in XML format. The following required elements must be added:
  • target: BMC Remedy Action Request System host name or IP address
  • username: TrueSight Orchestration (the default is orchestrationuser) user name.
  • password: Password of the TrueSight Orchestration user account on BMC Remedy ITSM

See BMC-Remedy-AR-System-adapter in the TrueSight Orchestration online documentation.

The following is an example of the configuration properties in XML format:

To configure the BMC Network Automation adapter

Enter the following details and then click OK.

• Name: BCANAdapter
• Description: Type a description for the adapter
• Type: bmc-adapter-bmc-network-automation-actor
• Properties: Enter the adapter configuration properties in XML format. The following required elements must be added:
  • soap-url: URL to the Network Automation application server
  • user-name: A Network Automation user name
  • password: The password for the specified user name
  • soap-version: 1.1
  • use-ssl-certificate: Set to true if the soap-url points to a secure connection
  • install-certificate: Set to true if SSL certificate is being used
  • allow-unsigned-certificate: Set to true if unsigned certificates are allowed
  • passphrase: Network Automation server certificate pass phrase. Default is changeit.

See BMC-Network-Automation-adapter in the TrueSight Orchestration online documentation.

The following is an example of the configuration properties in XML format:

To configure the BMC ITSM Web Services adapter

Enter the following details and then click OK.

• Name: ITSM WSAdapter

  Warning

  Note

  There is a space following the word ITSM in the adapter name.

• Description: Type a description for the adapter
• Type: ro-adapter-ws
• Properties: Enter <config /> to successfully create the adapter

See Web-Services-adapter in the TrueSight Orchestration Base Adapters online documentation.

To configure the BMC Remedy Monitor adapter

Enter the following details and then click OK.

• Name: RemedyMonitorAdapter
• Description: Type a description for the adapter
• Type: ro-adapter-remedy-monitor
• Properties: Enter the adapter configuration properties in XML format. The following required elements must be added:
  • target: BMC Remedy Action Request System host name or IP address
  • username: TrueSight Orchestration (the default is orchestrationuser) user name.
  • password: Password of the TrueSight Orchestration user account on BMC Remedy ITSM
  • poll-interval: Defaults to a value of 300.

See BMC Remedy AR System monitor adapter in the TrueSight Orchestration online documentation.

The following is an example of the configuration properties in XML format:

To configure the SNMP Monitor adapter

Enter the following details and then click OK.

• Name: SNMPMonitorAdapter
• Description: Type a description for the adapter
• Type: ro-adapter-snmp-monitor

• Properties: Enter the adapter configuration properties in XML format. The properties differ based on the SNMP version selected. The valid versions are 2c and 3.

  Warning

  Note

  The SNMP Trap properties set here must match the values set for the Network Automation SNMP Manager. See Configuring TrueSight Network Automation for Continuous Compliance for Network Automation for more information.

  • The following elements are required for SNMP version 2c:
    • mibs-directory: leave this element empty
    • version: SNMP Trap version. Default value is 2c.
    • port: Port on which SNMP Manager runs. Defaults to 162.
  • The following elements are required for SNMP version 3:
    • version: SNMP Trap version. Set to 3. Default value is 2c.
    • port: Port on which SNMP Manager runs. Defaults to 162.
    • user-name: User name required to connect to the SNMP Manager Station.
    • authentication-password: Authentication password required to connect to the SNMP Manager Station.

    • privacy-password: Privileged password required to connect to the SNMP Manager Station.

      Warning

      Note

      The SNMP Manager Privileged Algorithm should be DES and the password should be the same as the privacy password configured for the SNMP Monitor Adapter.

    • engine-id: The SNMP engine ID of the SNMP Manager Station in hexidecimal format.

See SNMP-adapter in the TrueSight Orchestration online documentation.

The following is an example of the configuration properties in XML format for SNMP version 2c:

The following is an example of the configuration properties in XML format for SNMP version 3:

To enable the adapter configurations

1. Navigate to Manage > Peers on the Grid Manager.
2. Select the Peer, and click Edit selected Peer.
3. Click Enable in the New Adapters section.
4. Highlight the adapter to be enabled, and click OK on the Add Adapters to Peer CDP page.
5. Repeat these steps to enable each adapter.