libEventIntroscopeprovider.so error in Unix with CA Wily and SiteMinder integration

Products

• CA Single Sign On Secure Proxy Server (SiteMinder)
• CA Single Sign On SOA Security Manager (SiteMinder)
• CA Single Sign-On

Issue/Introduction

When attempting to initialize XPSConfig, the following error is thrown:

(ERROR) : [sm-xpsxps-06810] Failed to initialize event handler library "<SiteMinder_Policy_Server_root>/lib/libEventIntroscopeprovider.so"

Environment

CA SiteMinder all supported environments with CA Wily installed for the specified releases on Unix or Linux

 

Cause

There are several potential causes for this error:

1. A Shared memory segment could have not been created
2. An incorrect library may be in use
3. For the Policy server, libEventIntroscopeprovider.so OR EventIntroscopeprovider.dll has not been added to the event handlers list defined in Policy Server console
4. Environment has not been sourced for Policy Server and/or WebAgent
5. The monitor has not been enabled
6. The shared memory segment could be corrupted

Resolution

Here are some resolution steps for the possible causes outlined before:

1.    Please verify that the shared memory segment has been created

1. 1. Run ./IntroscopeNativeDataReporter.sh –list
   2. If no data is being written into the shared memory segment the above command would show no metrics as well as Number of Connections as 0. In that case most likely the integration between SiteminderWebAgent\Policy Server and Wily Siteminder Manager is broken.

2.    Please check the byte size of libIntroscopeNativeDataAPI.so OR IntroscopeNativeDataAPI.dll file is present in the <Wily SMM install Root>/SiteminderManagerAgent is same as in the policy and webagent directories located in: <SiteMinder_Policy_Server_root>/lib and <Web_Agent_root>/bin

3.    Add either libEventIntroscopeprovider.so OR EventIntroscopeprovider.dll to the event handlers list defined in the policy server console

4.    Source the following environmental scripts:

• • For the webagent: ca_wa_env.sh (older versions use nete_wa_env.sh)
  • For the Policy Server: ca_ps_env.sh (older versions use nete_ps_env.sh)
  • For Wily: smm_env.sh

5.    Make sure the following information is contained in the WebAgent.conf file:

• • EnableMonitoring="YES"
  • EnableIntroscopeAgentSupport="YES"
  • LoadPlugin="/netegrity/webagent/bin/libIntroscopePlugin.so"

6.    Delete the Shared Segment:

1. 1. Shut down any process which is accessing the shared memory segment including WebAgents, Policy Server as well as Wily Siteminder Manager Agent
   2. Get the id of the shared memory segment created from IntroscopeAPI.log file present in <Wily SMM root>/SiteminderManagerAgent/data folder for e.g INFO - Shared memory segment ID: 25
   3. Delete segment using ipcrm -m <shared memory segment id>
   4. Clear contents of the <Wily SMM root>/SiteminderManagerAgent/data folder and restart the Webserver and Wily SMM agent.