Introscope Error on Unix

Products

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

Issue/Introduction

Problem:

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

(ERROR) : [sm-xpsxps-06810] Failed to initialize event handler library "/opt/CA/siteminder/lib/libEventIntroscopeprovider.so"

Environment:

Applies to all supported environments with CA Wiley installed for the specified releases on Unix.

Cause:

There are several potential causes for this error:

1. Shared segment could have not been created
2. Incorrect library 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:

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

a.    Run ./IntroscopeNativeDataReporter.sh –list

b.    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: <Policy Server Home>/lib and <Web Agent Home>/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 Wiley: 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:

a.    Shut down any process which is accessing the shared memory segment including WebAgents, Policy Server as well as Wily Siteminder Manager Agent

b.    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

c.    Delete segment using ipcrm -m <shared memory segment id>

d.    Clear contents of the <Wily SMM root>/SiteminderManagerAgent/data folder and restart the Webserver and Wily SMM agent.

Environment

Release: ESPSTM99000-12.51-Single Sign On-Extended Support Plus
Component: