Skip to Content

Configuring adapters for the Continuous Compliance for Server 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.

    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 TrueSight Orchestration online documentation.

    bmc-adapter-bmc-server-automation

    This adapter provides an interface for TrueSight Server Automation. The adapter must be installed on the TrueSight Orchestration Platform, imported into TrueSight Orchestration Development Studio, and configured to integrate with your TrueSight Server Automation system. For information about this adapter, see TrueSight Server Automation adapter in the TrueSight Orchestration online documentation.

    ro-adapter-bmc-atrium-cmdb-actor

    BMC Atrium CMDB adapter is an application adapter that interacts with the BMC Atrium CMDB. The BMC Atrium CMDB adapter consists of an actor adapter, as well as the workflow processes to perform the standard applications actions available through the BMC Atrium CMDB API. See BMC-Atrium-CMDB-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-file

    The File adapter is an actor adapter that performs read, write, append, and delete functions on a file. Using a file name and action (read, write, append, or delete) arguments, the File adapter performs the specified action on the specified file, and in the case of write and append, using the lines provided. The File adapter does not require a configuration node but, you must configure the adapter in Grid Manager. See File-adapter in the TrueSight Orchestration Base Adapters online documentation.

    ro-adapter-ws

    The 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.

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 Properties section 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 Switchview in the confirmation window.

    Warning

    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 — The user name created for TrueSight Orchestration (for example, orchestrationuser)
    • Password — Password of the TrueSight Orchestration user account on BMC Remedy ITSM <config> <target>nnn.nn.nn.nnn</target> <userName>orchestrationuser</userName> <password>password</password> </config>

For more information, see BMC-Remedy-AR-System-adapter in the TrueSight Orchestration 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 — TrueSight Orchestration (orchestrationuser) user name
    • Password — Password of the TrueSight Orchestration 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 BMC-Remedy-AR-System-monitor-adapter in the TrueSight Orchestration online documentation.

BMC BladeLogic Server Automation adapter

Enter the following details and click OK.

  • Name — BladeLogic Adapter
  • Description — Type a description for the adapter
  • Type-- bmc-adapter-bmc-server-automation
  • Properties — Enter the adapter Configuration properties in an XML format. The following elements are required:
    • Executable-directory — the directory containing the TrueSight Server Automation executables for nsh, blcli, and bljython
    • Script-directory — the directory containing the blcli wrapper scripts and other scripts that are called by the adapter
    • Script-executable — executable to run blcli or nsh based scripts. Default value is nsh.exe.
    • Jython-executable — executable to run jython based scripts. Default value is bljython.bat.
    • User-credential-file — user information certificate or data file. Default value for Windows environment is %USERPROFILE%\Application Data\BladeLogic\user\user_info.dat. The default value for Red Hat Enterprise Linux or Sun Solaris environment is ${HOME}/.bladelogic/user/user_info.dat.

    • Default-user-role — role of the user executing the request.
       The following sample configuration illustrates SRP-based authentication using the user credentials in the user_info.dat file.

      <config> <initial-command> <command prompt="%">nsh</command> </initial-command>
      <prompt>%</prompt>
      <authentication-mechanism>SRP</authentication-mechanism>
      <executable-directory>C:\Program Files\BMC Software\BladeLogic\NSH\bin</executable-directory> 
      <script-directory>C:\scripts\BLOM\jy_Scripts</script-directory>
      <script-executable>nsh.exe</script-executable> 
      <jython-executable>bljython.bat</jython-executable> 
      <default-user-role>Admins</default-user-role>
      <profile-name>defaultProfile</profile-name>
      <blsso-cache-refresh-interval>1.5</blsso-cache-refresh-interval>
      <blsso-cache-recovery-interval-in-minutes>10</blsso-cache-recovery-interval-in-minutes>
      <install-certificate>yes</install-certificate> 
      <install-certificate-prompt>?[yes|no]:</install-certificate-prompt>
      <blcli-jvm-options>-Xmx512M \-XX:-HeapDumpOnOutOfMemoryError \-Xms512m</blcli-jvm-options>
      <user-credential-file>C:\Documents and Settings\kinituser\Application 
      Data\BladeLogic\user\user_info.dat</user-credential-file>
      <connection-ttl>30</connection-ttl> <timeout-secs>120</timeout-secs> </config>

For more information, see BMC-Server-Automation-adapter in the TrueSight Orchestration online documentation. The topic contains sample configurations for different authentication types, detailed setup instructions required for TrueSight Server Automation single sign-on (SSO), and the settings for the application adapter.

BMC Atrium CMDB adapter

Enter the following details and click OK.

  • Name — BMCAtriumCMDBActorAdapter
  • Description — Type a description for the adapter
  • Type — ro-adapter-bmc-atrium-cmdb-actor
  • Properties — Enter the adapter Configuration properties in an XML format. The following element is required:
    • Soap Url – URL for the remote SOAP service

For more information, see the BMC-Atrium-CMDB-adapter in the TrueSight Orchestration online documentation.

SNMP Monitor adapter

Enter the following details and 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 following elements are required:
    • Version — SNMP Trap version. Defaults to 2c.
    • Port — Port on which SNMP Manager runs. Defaults to 162.
      <config> <version>2c</version> <port>162</port> </config>

For more information, see SNMP-monitor-adapter in the TrueSight Orchestration online documentation.

File adapter

Enter the following details and click OK.

  • Name — FileAdapter
  • Description — Type a description for the adapter
  • Type — ro-adapter-file
  • Properties — File adapter uses no XML elements

For more information, see File-adapter in the TrueSight Orchestration online documentation.

Web Services adapter

Enter the following details and click OK.

  • Name — ITSM WSAdapter (insert a space following the word ITSM in the adapter name)
  • Description — Type a description for the adapter
  • Type — ro-adapter-ws
  • Properties — ITSM web services adapter uses no XML elements

For more information, see Web-Services-adapter in the TrueSight Orchestration online documentation.

To enable adapters

After adding and configuring the adapters on the Grid Manager, you must now enable them so that the workflows and processes can use the adapters.

  1. In the Grid Manager application, click Manage > Peers tab.
  2. Select the peer where you want to enable the adapter; then click the Edit selected Peer icon.
  3. In the New Adapters section, click Enable and select the available adapters and click OK.
  4. Click OK to save changes. 
    You can see the status of the enabled adapters on the Status tab of the Grid Manager. 

For more information about working with adapters, see Enabling-and-disabling-adapters in the TrueSight Orchestration online documentation.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Automation Suite 23.4