Configuring adapters for the Continuous Compliance for Server Automation for ServiceNow 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
   bmc-adapter-service-now-actor	The ServiceNow actor adapter provides an interface for ServiceNow application. The actor adapter must be installed on the TrueSight Orchestration Platform, imported into TrueSight Orchestration Development Studio, and configured to integrate with your ServiceNow application.
   bmc-adapter-service-now-monitor	The ServiceNow monitor adapter is a mail-based monitor, which checks for messages on a specified account on the POP3 mail server. Ensure that the email notifications are configured for appropriate events on the ServiceNow application.
   ro-adapter-bladeLogic-server-automation	This adapter provide an interface for BMC Server Automation. The adapter must be installed on the TrueSight Orchestration Platform, imported into TrueSight Orchestration Development Studio, and configured to integrate with your BMC Server Automation system. For information about this adapter, see BMC Server 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-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.

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

ServiceNow actor adapter

Enter the following details and click OK.

• Name — ServiceNowActor 
• Description — Type a description for the adapter
• Type – bmc-adapter-service-now-actor_20.15.01.00
• Target – Enter the domain name of the ServiceNow application server
• User Name – Enter the user name required for remote host authentication
• Password – Enter the password that corresponds to the <user-name> 

For more information, see Configuring the ServiceNow actor adapter documentation. The topic contains sample configurations and detailed setup instructions required for configuring the ServiceNow actor adapter. 


ServiceNow monitor adapter

Enter the following details and click OK.

• Name – ServiceNowMonitor
• Description — Type a description for the adapter
• Type – bmc-adapter-service-now-monitor_20.15.01.00
• Target – Enter the domain name of the ServiceNow application server
• User Name – Enter the user name required for remote host authentication
• Password – Enter the password that corresponds to the <user-name> 
• Email Address – Enter the email address of the account to be monitored
• Protocol – Enter the email protocol to be used. Default value is POP3.

For more information, see ServiceNow monitor adapter documentation. The topic contains sample configurations and detailed setup instructions required for configuring the ServiceNow actor adapter. 

BMC BladeLogic Server Automation adapter

Enter the following details and click OK.

• Name — BladeLogic Adapter
• Description — Type a description for the adapter
• Type-- ro-adapter-bladelogic--operations-manager
• Properties — Enter the adapter Configuration properties in an XML format. The following elements are required:
  • Executable-directory — the directory containing the BMC 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 BMC Server Automation single sign-on (SSO), and the settings for the application adapter.

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 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 —  SOAPAdapter (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.