Configuring the Web Services Registry integration

To activate the connection to the BMC Atrium Web Services Registry, use the WS Registry Integration tab of the AR System Administration: Server Information form. 

To install and configure the BMC Atrium Core components described in this section, see Installing  in the BMC Helix Innovation Suite Deployment documentation.


Best practice
We recommend that you use the AR System Management Console to configure the Web Services Registry integration. For more information, see  Setting-global-level-and-local-level-configurations-for-a-server-group .

The AR System server provides the following forms that support the BMC Atrium Web Services Registry integration:

  • AR System Web Services Registry—The AR System interface to the BMC Atrium Web Services Registry. Creating a request in this form and marking it for publication registers a web service.
  • AR System Web Services Category—A supporting form that stores web service categories to help identify the web service. Each entry in the Category form is associated with one entry in the Registry form. An entry in the Registry form can be associated with one or more entries in the Category form.
  • AR System Web Services Registry Pending Delete—A supporting form that temporarily stores entries marked for de-registration.
  • AR System Web Services Registry Query—A vendor form that works with the ARDBC registry plug-in to query the registry at design time.

Before you begin

To use the BMC Atrium Web Services Registry, the following BMC Atrium Core and AR System components must be installed and running:

  • AR System server and Java plug-in server
  • Mid Tier
  • BMC Atrium Web Services Infrastructure (installed with BMC Atrium Core)
  • BMC Atrium Web Services Registry (installed with BMC Atrium Core)

To configure the connection to the BMC Atrium Web Services Registry

Important

This form shows the local level value of the configuration. If a local value does not exist, the form displays the global level configuration. If you modify the value on this form, the local level configuration value is modified. For example, if a configuration shows global level value and you modify the value by using this form, the local level value gets created for the configuration.

  1. From a browser, open the AR System Administration Console, and select System > General > Server Information.
  2. In the AR System Administration: Server Information form, click the WS Registry Integration tab.

    serverInfoWSRegistry.gif
  3. In the BMC Atrium Web Services Registry Settings area, enter the options:
    • Registry Location—The URL of the BMC Atrium Web Services Registry.
    • Registry Admin User—The user name of the administrator for the web services registry.
    • Registry Admin Password—The password of the web services registry administrator.

  4. Click Apply.

    If the Registry Location is changed after the AR System server has registered web services and categories in the registry, the AR System server updates the new registry location with the existing web services and categories, but does not delete the web services and categories from the old location.

Plug-in server configuration file entries

Two registry plug-ins communicate with the BMC Atrium Web Services Registry API. A filter API plug-in (ARSYS.ARF.REGISTRY) handles all updates to the registry as a result of workflow on the AR System Web Services Registry, Category, and Registry Pending Delete forms. An ARDBC plug-in (ARSYS.ARDBC.REGISTRY) handles queries from the AR System Web Services Registry Query form.

The AR System server installation program installs these plug-ins and creates the following entries in the AR System configuration file (ar.conf or ar.cfg):

  • Server-Plugin-Alias: ARSYS.ARF.REGISTRY ARSYS.ARF.REGISTRY plugInServerHostName:plugInServerPort
  • Server-Plugin-Alias: ARSYS.ARDBC.REGISTRY ARSYS.ARDBC.REGISTRY

In the Java plug-in server configuration file (pluginsvr_config.xml), the installation program creates XML <plugin> definitions for ARSYS.ARF.REGISTRY and ARSYS.ARDBC.REGISTRY. See the pluginsvr_config.xml file for the complete XML definitions.

For information about the BMC Atrium Web Services Registry API, see Publishing, unpublishing, and finding custom web services.