Skip to Content

Configuring adapters for the Service Desk Automation Run Book

This topic describes the adapters required for the Service Desk Automation Run Book and their configurations. 

Warning

Note

Based on the use case that you want to automate, you may require to configure one or more adapters apart from the BMC Remedy AR System actor and monitor adapter. For example, if you want to use the JMS alert mechanism to invoke the service request fulfillment use case, you would require the JMS actor and monitor adapters. 

The following adapters are required for the Unlock Account use case, which is available out-of-the-box with the run book.

Adding adapters to the Grid Manager

  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 for the unlock account use case.

    Adapter

    Required for

    BMC Remedy AR System actor and monitor adapter

    The actor and monitor 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.

    Windows Command

    The Windows Command adapter is used to execute commands on a remote host running the Windows operating system. This adapter must be enabled on a Windows-based system.

  4. Click Add to Grid.
    You can use the following sections to configure the adapters. 

Configuring the BMC Remedy AR System actor adapter

You configure an adapter in Grid Manager. The configuration provides information about how the adapter interacts with the BMC Remedy Action Request System application (BMC Remedy AR System). 

Warning

Note

The default name for the BMC Remedy AR System actor adapter is ARSAdapter. You can change the name of the adapter as per your own requirement, however, ensure that you use the name in all configurations later.

While configuring the BMC Remedy AR system actor adapter, specify the following required fields. 

Element

Description

Target

Specifies the host name or IP address of the BMC Remedy AR System server

Username

Specifies the user name to be used to connect to the BMC Remedy AR System server

Password

Specifies the password that corresponds to the specified username 

The following figure shows a sample XML for the BMC Remedy AR system actor adapter configuration.

<config>
 <target>xyz-pun-123456.bmc.com</target>
 <port>0</port>
 <user-name>Allen</user-name>
 <password>password</password>
</config>

For more detailed information about how to configure the BMC Remedy AR System adapter in the Grid Manager, see Configuring the BMC Remedy AR System actor adapter. 

Configuring the BMC Remedy AR System monitor adapter

The configuration provides information about how the adapter interacts with the BMC Remedy AR System.

Warning

Note

The default name for the BMC Remedy AR System monitor adapter is RemedyMonitorAdapter.

While configuring the BMC Remedy AR system monitor adapter, specify the following required fields. 

Element

Description

Target

Specifies the host name or IP address of the BMC Remedy AR System server

Username

Specifies the user name to be used to connect to the BMC Remedy AR System server

For example, Orchestration.

Information
Important

Ensure that you specify the username used for installing the BMC Service Desk Automation run book. If you specify any other user, the use case may fail. 

Password

Specifies the password that corresponds to the specified username 

The following figure shows an XML template for the BMC Remedy AR system monitor adapter configuration.

<config>
 <target>xyz-pun-123456.bmc.com</target>
 <port>0</port>
 <schemas>
   <schema>Alert Events</schema>
 </schemas>
 <user-name>Allen</user-name>
 <password>password</password>
</config>

For more information, see Configuring-the-BMC-Remedy-AR-System-monitor-adapter.

Video

The following BMC Communities video (3:46) shows how to configure BMC Remedy AR System actor and monitor adapter.

YouTube icon-play.png https://www.youtube.com/watch?v=YhF4TMc0vtg&feature=youtu.be

Configuring the Windows Command adapter

The Windows Command adapter is used to execute commands on a remote host running the Microsoft Windows operating system.

This adapter must be enabled on a Windows-based system.

Warning

Note

The default name for the adapter is WindowsCommandAdapter. The Windows Command adapter works only on peers that are running on a Windows-based computer. To use the Windows Command adapter, the remote host must also be a Windows-based computer.

The following figure shows an XML template for the Windows Command adapter configuration.

<config>
  <target></target>
  <user-name></user-name>
  <password encryption-type=""></password>
  <logon-with-user-credentials></logon-with-user-credentials>
  <protocol></protocol>
  <executable-directory></executable-directory>
  <executable></executable>
  <escape-double-quotes></escape-double-quotes>
  <protocol></protocol>
  <script-file-path></script-file-path>
  <character-set></character-set>
  <max-request-queue-size></max-request-queue-size>
  <debug-utility></debug-utility>
</config> 

For more information, see Configuring-the-Windows-Command-adapter.

 

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

BMC Atrium Orchestrator Content 20.16.01