Configuring adapters

You configure an adapter in Grid Manager. The configuration provides information about how the adapter interacts with the BMC or third-party application. While each adapter must have a unique name, you can create multiple adapters with the same adapter type to allow for different configuration properties.

The form view provides an easy-to-use interface for configuring adapters. The form view prevents human errors that might occur as a result of copying the configuration XML from the adapter user documentation into the UI when configuring an adapter. You can switch to the XML view to configure those elements and attributes that are not available as fields or to configure all the elements and attributes using XML only. When you save an adapter configuration for the first time, the editor choice that you made to enter the property values becomes a permanent setting for subsequent modifications to the current adapter configuration.

To configure an adapter

1. In the Grid Manager application, select the Manage tab, and then select the Adapters tab.
2. In the Adapters on Grid table perform the appropriate action:
   • If you want to configure the adapter for the first time, click Configure for that adapter.
   • If you want to change the configuration of an adapter that has already been configured, click the name of the adapter.
     
     The Adapter Configuration page is displayed.
3. Enter the adapter name and description in the appropriate fields.
4. Complete the Properties section of the Adapter Configuration page, according to the adapter that you are configuring:
   • If the Adapter Configuration page contains one Properties field, enter the adapter configuration properties in XML in that field.
   • If the Adapter Configuration page contains a form with text fields, where required fields are marked with an asterisk (*), and other controls, perform the appropriate action:
     • If you want to use the form, enter the adapter configuration properties in the form, and then click OK.
       
       On the Warning dialog box, clicking Save saves the configuration. In future, when you edit the adapter configuration, you do not see the Switch to XML View hyperlink for that configured adapter instance. Clicking Cancel closes the dialog box and takes no other action.
     • If you want to enter the property values using XML, click Switch to XML view.
       
       On the Warning dialog box, clicking Switch View implies that this adapter can be configured using only XML view in the future. Clicking Cancel implies that the form view is available for this adapter in the future.
       
       The Adapter Configuration page is redisplayed with one Properties field. If any of the form fields contained configuration values, those values are included in the XML code in the Properties field.
       
       Enter the adapter configuration properties in XML in the Properties field, and then click OK. On the Warning dialog box, clicking Save saves the configuration in XML view permanently. You cannot revert to the standard form view. In the future, when you edit the adapter configuration, you can only use the XML view.
       
       For specific configuration requirements, see BMC Atrium Orchestrator Base Adapters or BMC Atrium Orchestrator Application Adapters . If the adapter does not require a specific configuration, enter the following XML text in the Properties field: <config/>.

Related topics

Adding-adapters-to-a-grid
Enabling-and-disabling-adapters