Cannot initialize libEventIntroscopeprovider.so with Policy Server
Article ID: 243151
Updated On: 01-28-2025
Products
Issue/Introduction
Upon startup, the Policy Server reports this error:
[2894550/140420368136000][Thu May 19 2022 12:06:52.921][SmEventWedge.cpp:289][LateInit][ERROR][sm-xpsxps-06810] Failed to initialize event handler library "<SiteMinder_home>/lib/libEventIntroscopeprovider.so"
Environment
Policy Server is 12.8.X running on RHEL 8.5;
CA APM SSO version is 13.2.0 or later.
Cause
SiteMinder Policy Server lib folder (<SiteMinder_home>/lib) was missing some .so files.
In some installations, running the ldd command against the libEventIntroscopeprovider.so file may indicate that 2 specific files, libIntroscopeNativeDataAPI.so and libxerces-c-3.1.so, which are required to be in the /siteminder/lib folder as per the APM Documentation are missing (1).
However, it may happen that both libraries (or equivalently libxerces-c-3.2.so in the latest versions) are already present and the issue is still happening.
If this is the case, check as well the ldd command line output for library libIntroscopeNativeDataAPI.so and make sure all dependencies are satisfied.
Resolution
Ensure supported version of "APM for SSO" is installed (2).
Follow the Upgrade Guide (1) and also the Installation guide (3).
The error
"Failed to initialize event handler library "<SiteMinder_home>/lib/libEventIntroscopeprovider.so"
was due to the two files(libIntroscopeNativeDataAPI.so and libxerces-c-3.1.so) mentioned in the "Upgrade Guide" was not found in the SiteMinder Policy Server's lib folder (<SiteMinder_home>/lib).
Original issue was discovered with SiteMinder Policy server 12.8SP06a and APM 13.2.0.
In that case, the quick solution was to copy the two missing shared object files existed in the APM installation folder to the Policy Server lib folder and restart the Policy Server.
Note:
In case if the files exist in the Policy Server lib folder, but with different size/hash, then backup the files, so, the procedure can be reverted.
In version 12.8SP8 of Policy Server working with the APM agent 13.4.3.2, an issue has been found whereby even having both libraries present (actually with the newer libxerces-c-3.2.so) the error is still present and ldd does not seem to show any missing dependency for libEventIntroscopeprovider.so.
In this case, check the ldd command output for libIntroscopeNativeDataAPI.so as this one may as well have been missing dependencies.
This was the case for one of the issues and the problem was cured like in the original problem, by copying the missing libraries on which libIntroscopeNativeDataAPI.so was dependant.
Additional Information
Feedback
