Configuring and enabling adapters for Continuous Compliance for Network Automation

The BMC Continuous Compliance for Network Automation solution requires the following BMC Atrium Orchestrator 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

1. Log into the BMC Atrium Orchestrator 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 BMC Atrium Orchestrator 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 BMC Atrium Orchestrator Development Studio. See BMC Remedy AR System adapter in the BMC Atrium Orchestrator online documentation.
   bmc-adapter-bmc-network-automation-actor	This adapter provides an interface for BMC Network Automation. See BMC Network Automation adapter in the BMC Atrium Orchestrator 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 BMC Atrium Orchestrator 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 BMC Atrium Orchestrator 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 BMC Atrium Orchestrator)

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

   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: BMC Atrium Orchestrator (the default is orchestrationuser) user name.
  • password: Password of the BMC Atrium Orchestrator user account on BMC Remedy ITSM

See BMC Remedy AR System adapter in the BMC Atrium Orchestrator online documentation.

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

<config>
  <target>hostname</target>
  <userName>orchestrationuser</userName>
  <password>password</password>
</config>

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 BMC Network Automation application server
  • user-name: A BMC 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: BMC Network Automation server certificate pass phrase. Default is changeit.

See BMC Network Automation adapter in the BMC Atrium Orchestrator online documentation.

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

<config>
    <soap-url>https://hostname:443</soap-url>
    <user-name>ao_adapter</user-name>
    <password>!26$2327837!</password>
    <soap-version>1.1</soap-version>
    <use-ssl-certificate>true</use-ssl-certificate>
    <install-certificate>true</install-certificate>
    <allow-unsigned-certificate>true</allow-unsigned-certificate>
    <passphrase>changeit</passphrase>
</config>

To configure the BMC ITSM Web Services adapter

Enter the following details and then click OK.

• Name: ITSM WSAdapter

  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 BMC Atrium Orchestrator 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: BMC Atrium Orchestrator (the default is orchestrationuser) user name.
  • password: Password of the BMC Atrium Orchestrator user account on BMC Remedy ITSM
  • poll-interval: Defaults to a value of 300.

See BMC Remedy AR System monitor adapter in the BMC Atrium Orchestrator online documentation.

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

<config>
    <target>hostname</target>
    <user-name>orchestrationuser</user-name>
    <password>password</password>
    <poll-interval>300</poll-interval>
</config>

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.

  Note

  The SNMP Trap properties set here must match the values set for the BMC Network Automation SNMP Manager. See Configuring BMC 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.

      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 BMC Atrium Orchestrator Base Adapters online documentation.

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

<config>
    <mibs-directory />
    <version>2c</version>
    <port>162</port>
      <character-set>ISO-8859-1</character-set>
</config>

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

<config>
    <version>3</version>
    <port>162</port>
      <character-set>ISO-8859-1</character-set>
    <engines>
      <engine>
         <user-name>USM</user-name>
         <authentication-password>password123</authentication-password>
         <authentication-protocol>md5</authentication-protocol>
           <privacy-password>password123</privacy-password>
         <engine-id>0x1234567890ab</engine-id>
      </engine>
    </engines>
</config>

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.