Configuring adapters for the Continuous Compliance for Database Automation solution

Using Grid Manager, add the required adapters to the grid, and then update their configurations to match your environment.

To add an adapter to the grid

1. Log on to Grid Manager with administrative privileges.
2. Select Manage > Adapters.

3. From the Adapters in Repository section, select the adapters required for the run book. The following table lists the required adapters.
   
   Required adapters

   Adapter	Description
   ro-adapter-remedy-actor	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 the BMC Atrium Orchestrator Application Adapter for BMC Remedy AR System topic in the BMC Atrium Orchestrator online documentation.
   ro-adapter-remedy-monitor
   ro-adapter-bladeLogic-database-automation	This adapter provide an interface for BMC Database Automation. The adapter must be installed on the BMC Atrium Orchestrator Platform, imported into BMC Atrium Orchestrator Development Studio, and configured to integrate with your BMC Database Automation system. See the BMC Atrium Orchestrator Application Adapter for BMC Database Automation topic in the BMC Atrium Orchestrator online documentation.

4. Click Add to Grid.

To update the adapter configuration

1. From Grid Manager, select Manage > Adapters.
2. From the Adapters on Grid section, select the adapter that you want to configure, and then click Configure.
3. Enter the adapter name and description in the appropriate fields. The Propertiessection of the Adapter Configuration page varies depending on the adapter you are configuring. The Adapter Configuration page for some adapters contains:
   • one Properties field. In this case, you enter the adapter configuration properties in XML in the Properties field.
   • a form with text fields and other controls for you to enter the adapter configuration properties. Required fields are marked with an asterisk (*).

4. ( optional ) If the Adapter Configuration page for the adapter contains a form for the adapter configuration properties, and you want to enter the property values using XML, click Switch to XML view, and then click Switchviewin the confirmation window.

   Note

   If you switch from form view to the XML view of configuration information for any adapter and save the configuration information, you cannot switch back to form view for that adapter. To reconfigure that adapter, you must use the XML view.

5. Perform the appropriate action. If the Adapter Configuration page for the adapter contains:
   • the Properties field, enter the XML configuration document as required for the adapter. If the adapter does not require a specific configuration, enter the XML text <config/> in the Properties field. The following table displays the configuration properties for the associated adapter, and provides the name of each adapter guide for more information.
   • a form view with separate fields to enter the properties, provide the required information according to the instructions in the user guide specific to the adapter. The following table lists the name of each adapter guide for more information.
6. Click OK. If you switch the configuration from form view to XML view, you must also click Save in the confirmation window.

BMC Remedy AR System application adapter

Enter the following details and 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 elements are required:
  • Target-- AR System host name or IP address
  • Username-- BMC Atrium Orchestrator (orchestrationuser) user name
  • Password-- Password of the BMC Atrium Orchestrator user account on BMC Remedy ITSM <config> <target>nnn.nn.nn.nnn</target> <userName>orchestrationuser</userName> <password>password</password> </config>

For more information, see the BMC Atrium Orchestrator Application Adapter for BMC Remedy AR System topic in the BMC Atrium Orchestrator online documentation.

BMC Remedy Monitor adapter

Enter the following details and click OK.

• Name-- RemedyMonitorAdapter
• Description-- Type a description for the adapter
• Type-- ro-adapter-remedy-monitor
• Properties-- Enter the adapter Configuration properties in an XML format. The following elements are required:
  • Target-- AR System host name or IP address
  • Username-- BMC Atrium Orchestrator (orchestrationuser) user name
  • Password-- Password of the BMC Atrium Orchestrator user account on BMC Remedy ITSM
  • poll-interval-- defaults to a value of 300 <config> <target>172.23.23.225</target> <userName>orchestrationuser</userName> <password>password</password> <poll-interval>300</poll-interval> </config>

For more information, see the BMC Atrium Orchestrator Application Adapter for BMC Remedy AR System topic in the BMC Atrium Orchestrator online documentation.

BMC Atrium Orchestrator BladeLogic Database Automation adapter

Enter the following details and click OK.

• Name-- BDA
• Description-- Type a description for the adapter
• Type-- bmc-adapter-bmc-database-automation-actor
• Properties-- Enter the adapter Configuration properties in an XML format. The following elements are required:
  • Use Ssl certificate-- specifies whether to use an SSL certificate to establish a secure connection
  • Install-certificate-- specifies whether to install security certificates automatically
  • Allow-unsigned-certificate-- specifies whether to allow unsigned certificates from trusted zones
  • Passphrase-- specifies the password to the cacerts keystore file local to the BMC Atrium Orchestrator peer . Default value is changeit.
  • Signature-properties-- contains the elements that specify information about the public key (X.509 certificate) and the private key that are used for the digital signature.
    
    The following elements are required when signature-properties is set to keystore:
    • Keystore-file-- specifies the path to the JKS that contains the client certificate
    • Key-password-- specifies the password of the key contained in the JKS
    • Keystore-password-- specifies the password to the JKS
    • Alias-- specifies the name of the alias in the JKS that identifies the Public Key Certificate (PKC), which the web server uses to authenticate the client
      
      The following elements are required when signature-properties is set to key-files:
    • Private-key-file-- specifies the file containing the private key, which is used to sign the HTTP request
    • Certificate-file-- specifies the file containing the public key (X.509 Certificate)
      
      The following elements are required when signature-properties is set to key-data:
    • Private-key-data-- contains the XML data specifying the private key in a Base64-encoded PEM format
    • Certificate-data-- contains the XML data specifying the public key (X.509 Certificate) in a Base64-encoded PEM format

The following sample configuration shows an XML sample for configuring the actor adapter.

{{<config>
    <use-ssl-certificate>true</use-ssl-certificate>
    <install-certificate>true</install-certificate>
    <allow-unsigned-certificate>true</allow-unsigned-certificate>
    <signature-properties mode="key-files">
        <private-key-file>D:\User1\ssl\BBDA_client_certs\server.key</private-key-file>
        <certificate-file>D:\User1\ssl\BBDA_client_certs\server.pem</certificate-file>
    </signature-properties>
</config>}}