This documentation supports the 9.1 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

Troubleshooting AREA LDAP plug-in issues

The AR System External Authentication (AREA) LDAP plug-in enables you to authenticate BMC Remedy AR System users against external LDAP directory services. The AREA LDAP plug-in implements the AREA LDAP Configuration form.

Plug-in type

AREA LDAP is a Java-based plug-in.

AR System server connectivity

The AR System server interacts with the AREA LDAP plug-in when an event occurs on the AREA LDAP Configuration form. This plug-in (arealdappluginVerNum.jar) is installed in the <ARInstallationFolder>\pluginsvr directory. ( — VerNum represents the release version number).

Configuration information

The configuration information of the AREA LDAP plug-in is available in the AR System Administration: Plugin Server Configuration form.

The AR System Administration: AR System Configuration Generic UI form includes the Server-Plugin-Alias setting that points to the correct plug-in server alias as follows:
Server-Plugin-Alias: AREA AREA myServer:9999

See Updating configuration settings by using the AR System Configuration Generic UI form, Configuring java plug-in servers and Setting plugin server configuration options.

There is no separate Server-Plugin-Alias for each AREA type of plug-in.

If you have a custom AREA LDAP plug-in that is developed in C, you need to use the native plug-in server instead of the Java plug-in server. This fallback can be configured in the pluginsvr_config.xml file and is controlled by a property called enableNativeBridge. This property routes the AREA login verification calls to the native plug-in server.

By default, the value of enableNativeBridge property is false, meaning the native plug-in server is not available. To enable this property, edit the pluginsvr_config.xml file and add the following code under the pluginsvr_config tag:

<pluginsvr_config>
<enableNativeBridge>true</enableNativeBridge>

If the enableNativeBridge property is enabled, during AREA login verification, the Java plug-in server chains through all the Java AREA plug-ins in the order in which they appear in the pluginsvr_config.xml file. If no match is found, the call is propagated to the native plug-in server to check the AREA plug-ins hosted by the native plug-in server.

To avoid infinite looping between the Java plug-in server and the native server, ensure that you have disabled the AREA Proxy plug-in (areaatriumsso.dll) after enabling the enableNativeBridge property.

To troubleshoot AREA LDAP plug-in issues

  1. Verify the AREA LDAP plug-in configuration.
  2. Troubleshoot common plug-in related issues.
    For more information, see General approach for troubleshooting plug-in issues.
  3. If you need to investigate the issue further, enable the following logs:

To enable logs for the AREA LDAP plug-in

  1. In a browser, open the BMC Remedy AR System Administration Console, and click System > General > Plugin Server Configuration.

  2. On the Plugin Server Configuration form, from the 
  3. Select the Plugin Server Configuration tab.
  4. In the Logging Configurations area, from the Log Level listselect DEBUG.
  5. Click Apply
    The arjavaplugin.log file now generates the debug logs for the AREA LDAP plug-in.

Related topics

Using the AREA LDAP plug-in
Configuring the AREA LDAP plug-in
Enabling plug-ins

Was this page helpful? Yes No Submitting... Thank you

Comments