Cannot initialize libEventIntroscopeprovider.so with Policy Server

Products

• SITEMINDER
• CA Application Performance Management (APM / Wily / Introscope)
• APM
• CA Application Performance Management Agent (APM / Wily / Introscope)
• Cross Enterprise Application Performance Management (APM)
• CA Single Sign-On

Issue/Introduction

Upon startup, the SiteMinder Policy Server fails to initialize the CA APM (Wily) Event Handler, logging the following error in the smps.log:

[sm-xpsxps-06810] Failed to initialize event handler library "<SiteMinder_home>/lib/libEventIntroscopeprovider.so"

Environment

Policy Server: 12.8.x (specifically observed on RHEL 8.x)
Integration: APM for SSO (formerly Wily Introscope)
APM SSO Version: 13.2 or later

Cause

The SiteMinder Policy Server library folder (<SiteMinder_home>/lib) is missing critical shared object (.so) dependencies required by the Introscope provider (1).

In many instances, running the ldd command against libEventIntroscopeprovider.so reveals that the following files are missing or cannot be linked:

1. libIntroscopeNativeDataAPI.so
2. libxerces-c-3.1.so (or libxerces-c-3.2.so in newer versions)

Even if these files are present, the error may persist if libIntroscopeNativeDataAPI.so itself has unsatisfied dependencies (such as an incorrect libapr version) (2).

Resolution

Ensure supported version of "APM for SSO" is installed (3).

Follow the Upgrade Guide (1) and also the Installation guide (4).

1. Verify Shared Library Dependencies

   
   Log in to the Policy Server via SSH and navigate to the SiteMinder library directory:
   

   # cd <SiteMinder_home>/lib
# ldd libEventIntroscopeprovider.so

   
   If any files are listed as "not found," proceed to step 2. If all files are present, check the dependencies of the data API specifically:
   
   # ldd libIntroscopeNativeDataAPI.so
   
   

2. Manual File Restoration

   
   If libIntroscopeNativeDataAPI.so or libxerces-c are missing from the <SiteMinder_home>/lib directory:
   
   1. Locate these files within your APM for SSO installation media or the folder where the APM agent was extracted.
   2. Copy the missing .so files into the <SiteMinder_home>/lib folder.
   3. Ensure the permissions and ownership match the other libraries in that directory (typically chmod 755).
   4. Restart the Policy Server.
   
   

3. Address Architecture Mismatches (RHEL 8/APM 13.4+)

   
   If you encounter a libapr-1.so.0 => not found error, verify that the file provided by the integration is for the correct architecture (x86_64).
   
   In some 13.4 distributions, an ARM-based libapr was mistakenly included.
   
   In this case, install the native Linux package:
   
   # yum install apr
   
   

Note: Always perform a backup of the <SiteMinder_home>/lib directory before manually copying or replacing system files.

Additional Information

1. Upgrading DX APM for Symantec SiteMinder
   
   
2. "(ERROR) : [sm-xpsxps-06810] Failed to initialize event handler library "libEventIntroscopeprovider.so" with SiteMinder Wily integration
   
   
3. Installation and Configuration
   
   
4. Installation and Configuration on Policy Server (Linux)