Managing adapters on the grid

Adapters provide the interface between workflow processes and external systems and applications.

BMC Atrium Orchestrator workflows use the following categories of adapters to communicate with external applications and systems:

• Base adapters interface to systems by using standard protocols, such as JDBC, Telnet, SSH, JMS, and so on.
• Application adapters interface to a specific product.
  
  Within the base and application adapter categories:
• Actor adapters interact with external systems, sending commands or requests and, in some cases, receiving responses to the requests. For example, an email actor adapter can be used to send an email message.
• Monitor adapters listen on external systems and, based on their configuration, generate event messages. An email monitor adapter would monitor an email account on a specified server and generate an event when a specific message is received. This event could be used to trigger a process in a workflow.
  
  Some application adapters require additional Java archive (JAR) files. The required JAR files are identified in the user guide for the adapter. If additional or alternate JAR files are required for proper adapter function, copy the files into the AO_HOME/lib/add-ons directory of each CDP server and any peer where this adapter will be enabled. Then restart the CDP and peer servers that contain the new JAR file.

  Recommendation

  Put the JAR file in the AO_HOME/lib/add-ons directory of each peer on the grid. If you enable the adapter on additional peers in the grid, the required files are already there.

  Use BMC Atrium Orchestrator Grid Manager to configure adapters to establish connections and facilitate communications. Adapters are also available in BMC Atrium Orchestrator Development Studio so that you can use them when you are creating and testing processes.
  
  To work with an adapter, you must perform the following tasks:

1. Install the adapter into the repository. (For more information, see Installing BMC Atrium Orchestrator content.)
2. Add the adapter to the grid. (For more information, see To add adapters to a grid.)
3. Configure the adapter on the grid. (For more information, see To configure an adapter.)
4. Enable the configured adapter on one or more peers in the grid. (For more information, see Adding peers.)

• Adapter configuration and enablement overview
• Adding adapters to a grid
• Enabling adapters
• Adapter status
• Configuring adapters
• Upgrading adapters
• Removing adapters from a grid