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.
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).
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
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:
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
- Verify the AREA LDAP plug-in configuration.
- Troubleshoot common plug-in related issues.
For more information, see General approach for troubleshooting plug-in issues.
- If you need to investigate the issue further, enable the following logs:
To enable logging for the AREA LDAP plug-in
Modify the following lines in the <ARInstallationFolder>/pluginsvr/log4j_pluginsvr.xml file:
<logger additivity="true" name="com.bmc.arsys.pluginsvr.plugins"> <level value="warn"/> </logger>
<logger additivity="true" name="com.bmc.arsys.pluginsvr.plugins"> <level value="debug"/> </logger>
- Restart the AR System server.
The arjavaplugin.log file now generates the debug logging for the AREA LDAP plug-in.