APM - 9.5 - APM For SiteMinder Application Server Agents Guide

for CA SiteMinder Application Server
Agents Guide
Release 9.5
CA Application Performance
Management

This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to
as the Documentation) is for your informational purposes only and is subject to change or withdrawal by CA at any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without
the prior written consent of CA. This Documentation is confidential and proprietary information of CA and may not be disclosed
by you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governing
your use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you and
CA.
Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you may
print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your
employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced
copy.
The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable
license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to
certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION AS IS WITHOUT WARRANTY OF ANY
KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE,
DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST
INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE
POSSIBILITY OF SUCH LOSS OR DAMAGE.
The use of any software product referenced in the Documentation is governed by the applicable license agreement and such
license agreement is not modified in any way by the terms of this notice.
The manufacturer of this Documentation is CA.
Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions
set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or
their successors.
Copyright 2013 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to
their respective companies.

CA Technologies Product References
This document references the following CA Technologies products and features:
CA Application Performance Management (CA APM)
CA Application Performance Management ChangeDetector (CA APM
ChangeDetector)
CA Application Performance Management ErrorDetector (CA APM ErrorDetector)
CA Application Performance Management for CA Database Performance (CA APM
for CA Database Performance)
CA Application Performance Management for CA SiteMinder (CA APM for CA
SiteMinder)
CA Application Performance Management for CA SiteMinder Application Server
Agents (CA APM for CA SiteMinder ASA)
CA Application Performance Management for IBM CICS Transaction Gateway (CA
APM for IBM CICS Transaction Gateway)
CA Application Performance Management for IBM WebSphere Application Server
(CA APM for IBM WebSphere Application Server)
CA Application Performance Management for IBM WebSphere Distributed
Environments (CA APM for IBM WebSphere Distributed Environments)
CA Application Performance Management for IBM WebSphere MQ (CA APM for
IBM WebSphere MQ)
CA Application Performance Management for IBM WebSphere Portal (CA APM for
IBM WebSphere Portal)
CA Application Performance Management for IBM WebSphere Process Server (CA
APM for IBM WebSphere Process Server)
CA Application Performance Management for IBM z/OS (CA APM for IBM z/OS)
CA Application Performance Management for Microsoft SharePoint (CA APM for
Microsoft SharePoint)
CA Application Performance Management for Oracle Databases (CA APM for Oracle
Databases)
CA Application Performance Management for Oracle Service Bus (CA APM for
Oracle Service Bus)
CA Application Performance Management for Oracle WebLogic Portal (CA APM for
Oracle WebLogic Portal)
CA Application Performance Management for Oracle WebLogic Server (CA APM for
Oracle WebLogic Server)
CA Application Performance Management for SOA (CA APM for SOA)

CA Application Performance Management for TIBCO BusinessWorks (CA APM for
TIBCO BusinessWorks)
CA Application Performance Management for TIBCO Enterprise Message Service
(CA APM for TIBCO Enterprise Message Service)
CA Application Performance Management for Web Servers (CA APM for Web
Servers)
CA Application Performance Management for webMethods Broker (CA APM for
webMethods Broker)
CA Application Performance Management for webMethods Integration Server (CA
APM for webMethods Integration Server)
CA Application Performance Management Integration for CA CMDB (CA APM
Integration for CA CMDB)
CA Application Performance Management Integration for CA NSM (CA APM
Integration for CA NSM)
CA Application Performance Management LeakHunter (CA APM LeakHunter)
CA Application Performance Management Transaction Generator (CA APM TG)
CA Cross-Enterprise Application Performance Management
CA Customer Experience Manager (CA CEM)
CA Embedded Entitlements Manager (CA EEM)
CA eHealth Performance Manager (CA eHealth)
CA Insight Database Performance Monitor for DB2 for z/OS
CA Introscope
CA SiteMinder
CA Spectrum Infrastructure Manager (CA Spectrum)
CA SYSVIEW Performance Management (CA SYSVIEW)

Contact CA Technologies
Contact CA Support
For your convenience, CA Technologies provides one site where you can access the
information that you need for your Home Office, Small Business, and Enterprise CA
Technologies products. At http://ca.com/support, you can access the following
resources:
Online and telephone contact information for technical assistance and customer
services
Information about user communities and forums
Product and documentation downloads
CA Support policies and guidelines
Other helpful resources appropriate for your product
Providing Feedback About Product Documentation
If you have comments or questions about CA Technologies product documentation, you
can send a message to techpubs@ca.com.
To provide feedback about CA Technologies product documentation, complete our
short customer survey which is available on the CA Support website at
http://ca.com/docs.

Contents 7

Contents

Chapter 1: Overview of CA APM for CA SiteMinder Application Server
Agents 9
Introduction ................................................................................................................................................................. 9
CA SiteMinder Web Access Manager ........................................................................................................................... 9
Service-Oriented Architecture (SOA) Security Manager ..................................................................................... 10
CA APM for CA SiteMinder Application Server Agents ............................................................................................ 10
Monitoring SiteMinder components .................................................................................................................. 10
How it all works .......................................................................................................................................................... 11
Architectural overview ............................................................................................................................................... 12
Integrating CA APM for SiteMinder in a CA SiteMinder environment ....................................................................... 13
Web server-based security ................................................................................................................................. 13
Application server-based security ....................................................................................................................... 14
Web server and application server-based security ............................................................................................. 15
Chapter 2: Installing and Configuring CA APM for CA SiteMinder
Application Server Agents 17
Installation requirements ........................................................................................................................................... 17
Before you begin ........................................................................................................................................................ 17
Installing and configuring CA APM for SiteMinder ..................................................................................................... 18
Step 1: Run the Enterprise Manager Installer ..................................................................................................... 19
Step 2: Running the CA Introscope Agent installer ........................................................................................... 20
Step 3: Configure the Extension to monitor CA SiteMinder ASA ........................................................................ 21
Step 4: Configure the Extension to Monitor CA SiteMinder Web Agent ............................................................ 21
Step 5: Configure the Extension to Monitor CA SOA Security Manager ............................................................. 22
Step 6: Enable Extension Components............................................................................................................... 23
Upgrading CA APM for CA SiteMinder Application Server Agents ........................................................................... 23
Chapter 3: Using CA APM for CA SiteMinder 25
Viewing metrics and dashboards in the Investigator ................................................................................................. 25
Viewing Metrics .......................................................................................................................................................... 26
Viewing SiteMinder Web Agent metrics ............................................................................................................. 26
Viewing Caching metrics ..................................................................................................................................... 27
Viewing Operations metrics ................................................................................................................................ 28
Viewing Application Server Agent metrics .......................................................................................................... 29
Viewing Policy Server Calls metrics ..................................................................................................................... 31
Viewing SSPI metrics ........................................................................................................................................... 31

8 for CA SiteMinder Application Server Agents Guide

Viewing TAI metrics ............................................................................................................................................. 33
Viewing SOA Agent metrics ................................................................................................................................. 34
Using Dashboards Included with CA APM for CA SiteMinder Application Server Agents ........................................ 34
SiteMinder PP Overview dashboard ................................................................................................................... 35
SiteMinder PP Web Agents Top and Bottom 5 Avg Response Times dashboard ............................................... 36
SiteMinder PP Web Agents Top and Bottom 5 Responses Per Interval dashboard ............................................ 36
SiteMinder PP WebAgents Load dashboard ....................................................................................................... 36
SiteMinder PP WebAgents Response Time dashboard ....................................................................................... 37
SiteMinder PP WebLogic ASA Load dashboard ................................................................................................... 37
SiteMinder PP WebLogic ASA Response Time dashboard .................................................................................. 38
SiteMinder PP WebSphere ASA Load dashboard ................................................................................................ 38
SiteMinder PP WebSphere ASA Response Time dashboard ............................................................................... 38
Viewing and Creating CA APM for SiteMinder Metric Groupings .............................................................................. 39
Viewing and Creating Alerts for SiteMinder Data ...................................................................................................... 40
Viewing and Creating Alerts ................................................................................................................................ 40
Viewing Cross-process Transaction Tracing ............................................................................................................... 41
Appendix A: Metrics 43
Metrics for Application Server Agent ......................................................................................................................... 43
Policy Server Calls ............................................................................................................................................... 43
SSPI ...................................................................................................................................................................... 44
Other Policy Server Calls ..................................................................................................................................... 46
TAI ....................................................................................................................................................................... 47
Metrics for SOA Security Manager ............................................................................................................................. 48
Metrics for SiteMinder Web Agent ............................................................................................................................ 49
Caching ................................................................................................................................................................ 50
Operations .......................................................................................................................................................... 50
Aggregated metrics for SiteMinder Web Agent ......................................................................................................... 51
Caching ................................................................................................................................................................ 52
Appendix B: IPv6 Support 53
Enabling display of the IPv6 address in the Investigator for CA SiteMinder Web Agent ........................................... 53
Enabling display of the IPv6 address in the Investigator for CA SOA Security Manager Application Server
Agent .......................................................................................................................................................................... 54
Enabling display of the IPv6 address in the Investigator for CA SOA Security Manager Web Server Agent .............. 54

Chapter 1: Overview of CA APM for CA SiteMinder Application Server Agents 9

Chapter 1: Overview of CA APM for CA
SiteMinder Application Server Agents

This chapter provides an architectural overview of CA APM for CA SiteMinder
Application Server Agents and an overview of how it reports key metrics to CA APM.
This section contains the following topics:
Introduction (see page 9)
CA SiteMinder Web Access Manager (see page 9)
CA APM for CA SiteMinder Application Server Agents (see page 10)
How it all works (see page 11)
Architectural overview (see page 12)
Integrating CA APM for SiteMinder in a CA SiteMinder environment (see page 13)
Introduction
CA APM for CA SiteMinder Application Server Agents is a CA APM extension that
provides advanced performance management tools for the production environment of
CA SiteMinder Web Access Manager. Together with CA APM, this extension monitors
critical CA SiteMinder components and helps to isolate application bottlenecks and
improve the availability of the product.
The following sections provide an overview of CA SiteMinder Web Access Manager and
CA APM for CA SiteMinder Application Server Agents, and how they work together.
CA SiteMinder Web Access Manager
CA SiteMinder Web Access Manager (CA SiteMinder) is a centrally managed access
control platform for web-accessed applications and web services. The platform
facilitates single sign-on and federated identities for enterprise employees, customers,
and partners across heterogeneous web servers, identity stores, and application servers.
CA SiteMinder protects critical IT systems and services with user authentication and
access control.
CA APM for CA SiteMinder Application Server Agents


Service-Oriented Architecture (SOA) Security Manager
SOA Security Manager is an identity-based security product that secures access to Web
services by inspecting the security XML document information that a Web services
consumer submits. SOA Security Manager uses the core set of Web services standards
and centralized security policies that are bound to user identities for authentication,
authorization, federation, session management, and audit.
CA APM for CA SiteMinder Application Server Agents
CA APM for CA SiteMinder Application Server Agents allows you to view metric data
from CA SiteMinder Web Access Manager. Along with CA APM, the extension monitors
the performance impact of CA SiteMinder and SOA Security Manager on distributed
web applications and distributed web services, respectively.
Key features include:
Out-of-the-box visibility into how CA SiteMinder and SOA Security Manager affect
the performance and availability of distributed web applications and Web services
Information for web application support and development teams that monitor CA
SiteMinder and SOA Security Manager performance and its effect on the end-user
experience
Complete transaction visibility into SiteMinder Agent operations affecting
application performance
Support for triaging performance problems, reducing the mean time to resolution
Aggregated views of metrics and a variety of out-of-box views and visualizations
Monitoring SiteMinder components
CA APM for CA SiteMinder Application Server Agents monitors the following
SiteMinder components:
SiteMinder Web Agents for Apache, IIS, and Sun ONEprovide visibility into
transaction execution time spent in the SiteMinder Web Agent, and enables
detailed diagnosis with cache, authorization, and validation information.
SiteMinder Application Server Agents (for IBM WebSphere and Oracle WebLogic
application servers)provide visibility into how the SiteMinder Application Server
Agent affects the performance of a J2EE transaction. Given a problematic
transaction, you can determine whether or not SiteMinder was responsible for any
delay. Aggregated performance statistics show authorization calls per period,
average response time, and related metrics.
SOA Security Manager Agentsprovide visibility into the response time and load
to authorize XML web services messages.
How it all works


How it all works
When a call is made to the web server integrated with the SiteMinder Web Agent, the
plug-in adds SiteMinder Web Agent performance information to the transaction. When
the transaction reaches the application server, CA APM for SiteMinder probes collect
this data and send it on to the Enterprise Manager.
When SiteMinder security uses the SiteMinder Application Server Agent, the extension
monitors calls from the SiteMinder Application Server Agents to the SiteMinder Policy
Server.
SOA Security Manager probes monitor calls from the SOA Security Manager Agents.
Because SiteMinder performance metrics are added to each transaction, the application
owner can, on a transaction-by-transaction basis, see how SiteMinder performs.
CA APM for CA SiteMinder Application Server Agents provides alerts and displays data
using the standard CA APM infrastructure. With the management module editor, users
can customize the CA APM for CA SiteMinder Application Server Agents outputs or
create their own to customize the transaction-by-transaction monitoring of SiteMinder
and its impact on application performance.
Architectural overview


Architectural overview
The following figure illustrates the core architecture of CA APM for CA SiteMinder
Application Server Agents.

CA APM for CA SiteMinder Application Server Agents components are:
SiteMinder WebAgent Extension:
SiteMinder WebAgent Extension provides instrumentation of SiteMinder Web
Agents. It uses data received from SiteMinder Introscope plug-in and processes it as
appropriate to display in the Investigator. It also provides integration with
Introscope Transaction Traces.
ProbeBuilderDirective (PBD) files for SiteMinder ASA:
Instrumentation of SiteMinder Application Server Agent is done using this PBD to
get per-transaction visibility. It also collects aggregated statistics on SiteMinder
Application Server Agent performance.
Integrating CA APM for SiteMinder in a CA SiteMinder environment


PBD files for CA SOA Security Manager:
Instrumentation of SOA Security Manager Agents (web servers and app servers) is
done using this PBD. It collects aggregated statistics on SOA SM Agent performance.
SiteMinder Remote Data Collector:
It reads the SiteMinder OneView Monitor data collected by the OneView Monitor
from the Policy Server and all the web agents, using SNMP4J API. This data is then
pushed to Introscope Enterprise Manager using CA APM EPAgent.
CA APM for Site Minder Enterprise Manager components:
These contain an Enterprise Manager Extension, typeviews, and management
modules to visualize the collected data.
Integrating CA APM for SiteMinder in a CA SiteMinder
environment
The way in which CA APM for CA SiteMinder Application Server Agents interfaces with
SiteMinder depends on how SiteMinder has been implemented on your network. Most
SiteMinder installations fall into one of three categories:
Web server-based security
Security features are enforced using a SiteMinder Web Agent on the Web server.
Application server-based security
Security features are enforced using a SiteMinder Application Agent on the
application server.
Web and application server-based security
Security features are enforced using a SiteMinder Web Agent on the Web server
and a SiteMinder Application Agent on the application server.
The following sections depict the way CA APM for CA SiteMinder Application Server
Agents integrates with CA SiteMinder based on the security method implemented. The
components installed by CA APM for CA SiteMinder Application Server Agents are
labeled in green text in the accompanying diagrams.
Web server-based security
When SiteMinder security is enforced using the SiteMinder Web Agent, the Web Agent
Extension configured on the application server machine can monitor the header data
passed by CA SiteMinder Web Agent to the application server and report corresponding
metrics to Enterprise Manager.


On the application server machine, the Web Agent Monitor enables CA APM to collect
data. The CA APM Agent installed on the Application Server machine then passes on
SiteMinder Web Agent metric data to the Enterprise Manager. CA APM for SiteMinder
Management Modules are installed on the Enterprise Manager, enabling pre-configured
Workstation views and dashboards.
Note: The Introscope Agent refers to the CA APM agent on any of the supported
application servers.

Application server-based security
When SiteMinder security is enforced using a SiteMinder Application Server Agent,
probe directives which are configured with the Application Server Monitor on the
application server collect SiteMinder application server agent metrics.
CA APM for CA SiteMinder Application Server Agents probe directives, integrated into
the CA APM agent, pass SiteMinder application server agent metric data to the
Enterprise Manager. CA APM for CA SiteMinder Application Server Agents installs
Management Modules on the Enterprise Manager, enabling pre-configured views and
dashboards to be displayed in the Workstation.


Note: The Introscope Agent refers to the CA APM WebSphere agent on WebSphere
application servers or the CA APM WebLogic agent on WebLogic application servers.

Web server and application server-based security
When SiteMinder Web Access Manager security is enforced using both the SiteMinder
Web Agent and a SiteMinder Application Server Agent, configure the Web Agent
Monitor and the Application Server Monitor on the application server. The probe
directives installed with the Application Server Monitor and Web Server monitor
integrate into the CA APM agent and pass ometric data for the SiteMinder Web Agent
and the SiteMinder Application Server Agent to the Enterprise Manager. CA APM for
SiteMinder installs Management Modules on the Enterprise Manager, enabling the
Workstation to display proconfigured views and dashboards.


Note: The Introscope Agent refers to the WebSphere agent on WebSphere application
servers or the WebLogic agent on WebLogic application servers.

Chapter 2: Installing and Configuring CA APM for CA SiteMinder Application Server Agents 17

Chapter 2: Installing and Configuring CA
APM for CA SiteMinder Application Server
Agents

This chapter describes how to install and configure CA APM for CA SiteMinder
Installation requirements (see page 17)
Before you begin (see page 17)
Installing and configuring CA APM for SiteMinder (see page 18)
Upgrading CA APM for CA SiteMinder Application Server Agents (see page 23)
Installation requirements
CA APM for CA SiteMinder Application Server Agents supports these systems and
components:
CA SiteMinder Web Agent
CA SiteMinder Policy Server
ASA
SOA Security Manager
See the CA APM Compatibility Guide for the supported versions of these systems and
components.
Before you begin
Perform the following steps before you install CA APM for CA SiteMinder Application
Server Agents:
1. Identify the following directory locations in your CA APM environment:
The application server home directorythe home directory of your
application server, referred to in this guide as <AppServer_Home>.
The Introscope directorythe installation directory for CA APM on your
Enterprise Manager machine, referred to in this guide as <EM_Home>.
The web agent home directorythe home directory of the CA APM agent,
referred to in this guide as <Agent_Home>.
Installing and configuring CA APM for SiteMinder


2. To enable the CA SiteMinder Web Agent to send data to Application Server, set the
EnableIntroscopeAgentSupport and EnableMonitoring parameters in the WebAgent
Config object or in the WebAgent.conf file:
If you set the properties in WebAgent Config object, set:
EnableIntroscopeAgentSupport=NO
Note: If you are using both Manager for SiteMinder and CA APM for SiteMinder to
monitor the WebAgent, then set the EnableIntroscopeAgentSupport parameter to
BOTH and EnableMonitoring=YES
If you set the properties in WebAgent.conf file, located in the web server's
config directory, set:
EnableIntroscopeAgentSupport="NO"
Note: If you are using both Manager for SiteMinder and CA APM for SiteMinder to
monitor the WebAgent, then set the EnableIntroscopeAgentSupport parameter to
"BOTH" and EnableMonitoring="YES".
If these properties are set appropriately, the application server agent extension can
monitor the header data passed by Web Agent to the application server agent and
report corresponding metrics to Enterprise Manager.
Note: The installation instructions that follow assume you use JVM AutoProbe to
instrument your applications. For information on using JVM AutoProbe, see the CA APM
Java Agent Guide or CA APM .NET Agent Guide, depending on your environment.
Installing and configuring CA APM for SiteMinder involves the following steps:
Step 1: Run the Enterprise Manager installer (see page 19)
Step 2: Run the standalone agent installer (see page 20)
Step 3: Configure the extension to monitor CA SiteMinder ASA (see page 21)
Step 4: Configure the extension to monitor CA SiteMinder Web Agent (see page 21)
Step 5: Configure the extension to monitor CA SOA Security Manager (see page 22)
Step 6: Enable Extension Components (see page 23)


Step 1: Run the Enterprise Manager Installer
Run the Enterprise Manager installer to install the extension's Enterprise Manager
component files along with Enterprise Manager.
Note: If you are using an Enterprise Manager that is already being used by a different
agent, then the Enterprise Manager components of all extensions are already installed
in the <EM_Home>/examples directory. You can skip this step and instead continue with
configuring the Enterprise Manager.
The installer places the files into the following directory:
<EM_Home>\examples\PowerPackForSiteMinder
You will later move the files to the correct location, based on how they are organized in
the \examples directory.
For details about running the Enterprise Manager installer, see the CA APM Installation
and Upgrade Guide.
The APM installer places the following files in the
<EM_Home>\examples\PowerPackForSiteMinder directory:
File:
.\ext\SMPPEmExt.jar
Description:
Enterprise Manager extensions for the extension.
File:
.\ext\ddtv\SiteMinder-PP.typeviewers.xml
Description:
Tabs and views for this extension.
File:
.\config\modules\SiteMinderPP_ManagementModule.jar
Description:
Management Modules for the extension.


Step 2: Running the CA Introscope Agent installer
Run the standalone agent installer to install and initially configure agent information.
For details, see the CA APM Java Agent Implementation Guide or the CA APM .NET
Agent Implementation Guide.
The Standalone agent installer places the following files onto the application server
machine in the <Agent_Home>/wily directory:
File:
examples\PowerPackForSiteMinder\ext\SMWebAgentExt.jar
Description:
SiteMinder WebAgent extension.
File:
smwebagentext.pbd
Description:
SiteMinder WebAgent's extension PBD.
File:
smwebsphereasa.pbd
Description:
PBD file for SiteMinder WebSphere ApplicationServer Agent (ASA). Single PBD for all
the WebSphere application srver versions supported by SiteMinder ASA 6.0.
File:
smweblogicasa.pbd
Description:
PBD file for SiteMinder WebLogic Server Agent. Single PBD for all the WebLogic
application server versions supported by SiteMinder ASA 6.0.
File:
soaagent.pbd
Description:
PBD file for SOA Security Manager Agent. This gets installed if you use a WebLogic,
WebSphere, or default application server.
File:
libaprW.dll
Description:
The dependency library is installed only for the Windows platform.


Step 3: Configure the Extension to monitor CA SiteMinder ASA
1. Open the IntroscopeAgent.profile file located in the wily/core/config directory.
2. Modify the introscope.autoprobe.directives file property to add new probe
directives files to the list. Separate the PBD files in the list with a comma. For
example:
introscope.autoprobe.directivesFile=smweblogicasa.pbd, smwebagentext.pbd,
soaagent.pbd
Note: The above example is for WebLogic Server. For WebSphere Server replace
smweblogicasa.pbd with smwebsphereasa.pbd.
3. Add the soaagent.pbd if you use a WebLogic, WebSphere, or default application
server.
4. Save the IntroscopeAgent.profile file.
5. Restart the agent.
Step 4: Configure the Extension to Monitor CA SiteMinder Web Agent
1. Configure the plug-in that is provided with the CA SiteMinder Web Agent on each
web server that you want to monitor.
a. Open the WebAgent.conf file located in the web server's configuration
directory.
b. For Windows, copy the dependency library for web servers, libaprW.dll, from
<AppServer_Home>/wily/common directory to the <Agent_Home>/bin
directory.
c. Add or uncomment the line for the plug-in in the WebAgent.conf file after the
line for HTTP plug-in as follows:
For Windows:
LoadPlugin="C:\Program Files\netegrity\webagent\bin\IntroscopePlugin.dll"
For UNIX:
LoadPlugin="/usr/netegrity/webagent/bin/libIntroscopePlugin.so"
Depending on your environment, the path to the plug-in may vary. Enter the
appropriate path.
2. Verify that the web agent is enabled. For instructions on how to do this, see Before
you begin (see page 17).
3. Copy SMWebAgentExt.jar to the <AppServer_Home>/wily/ext directory.
4. Follow the steps necessary to configure the extension to monitor CA SiteMinder
ASA. For more information, see Step 3: Configure CA APM for CA SiteMinder to
monitor CA SiteMinder ASA (see page 21).


5. Optionally, configure the Transaction Trace Threshold.
This configuration setting determines threshold value at which transactions are
traced. Transactions that take longer to execute than the threshold you specify are
traced. If you do not configure a value, Introscope traces transactions that take
longer than 5000 milliseconds (5 seconds) to execute:
a. Open the IntroscopeAgent.profile in the wily/core/config directory.
b. Add the introscope.agent.siteminderwebagent.tracethreshold property and
specify the required threshold value in milliseconds.
For example, to set the threshold to 6 seconds, add this property:
introscope.agent.siteminderwebagent.tracethreshold=6000
6. Restart the agent.
Step 5: Configure the Extension to Monitor CA SOA Security Manager
Add agent-related command line arguments for JVMoptions property for SOA Security
Manager.
1. Install the default Java Agent for Windows or UNIX.
2. Add the command line arguments:
Valid for Windows 1.5 JRE:
a. Modify the NETE_TXM_JRE_ROOT system variable to point to 1.5 JRE.
b. Open the XmlSdkConfig.properties file present in the <Agent_Home>/java
directory and locate Section 3: JVM Startup Options (Windows platforms only)
in the file.
c. Add the following lines to the section and remove the quotation marks (" ").
JVMoptions=-javaagent:\opt\wily\Agent.jar
-Dcom.wily.introscope.agentProfile=\wily\core\config
IntroscopeAgent.profile
-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.
xerces.jaxp.DocumentBuilderFactoryImpl -Xms64M
d. Save and close the file.
e. Restart the SOA Security Manager Agent.
Upgrading CA APM for CA SiteMinder Application Server Agents


Valid for UNIX 1.5 JRE:
a. Open the tmxmlsdkserver.sh file present in the <SOA_HOME>/webagent/bin
directory.
b. Add the following lines:
/<JAVA_HOME>/bin/java -javaagent:/opt/wily/Agent.jar
-Dcom.wily.introscope.agentProfile=/wily/core/config/Intros
copeAgent.profile
-Djavax.xml.parsers.DocumentBuilderFactory=org.apache.
xerces.jaxp.DocumentBuilderFactoryImpl
-Dtxm.ipc.tmxmlsdkserver=true -classpath
../java/smjavaagentapi.jar:../java/jsafeJCE.jar:../java/soa
smapi.jar:../java -Dtmxmlsdkserver=true -Xms64M
-DNETE_TXM_ROOT=./.. -Dnete.wa.root=./..
com.netegrity.tm.ipc.service.xmlsdkserver.XmlSdkServer
Note: <JAVA_HOME> must point to 1.5 JRE
c. Save and close the file.
d. Restart the SOA Security Manager Agent.
Step 6: Enable Extension Components
1. Copy SiteMinder-PP.typeviewers.xml to the <EM_Home>/ext/ddtv directory.
2. Copy SMPPEmExt.jar to the <EM_Home>/ext directory.
3. Copy the SiteMinderPP_ManagementModule.jar to the
<EM_Home>/config/modules/ directory.
4. Restart the Enterprise Manager.
Upgrading CA APM for CA SiteMinder Application Server
Agents
Valid for version 2.0 or 8.0: If you want to upgrade CA APM for CA SiteMinder
Application Server Agents from version 2.0 or 8.0, you must uninstall using its
uninstaller and install afresh. See Installing and Configuring CA APM for CA SiteMinder
Application Server Agents (see page 18).
For information on steps to perform before and after upgrading SiteMinder Manager for
Policy Server or Web Agent, see KB article TEC534108, Steps to Take Before and After
Upgrading SiteMinder Manager.


Chapter 3: Using CA APM for CA SiteMinder

This chapter describes how you can use CA APM for CA SiteMinder Application Server
Agents to view metrics and overall health of the application using tabs and dashboards.
Viewing metrics and dashboards in the Investigator (see page 25)
Viewing Metrics (see page 26)
Using Dashboards Included with CA APM for CA SiteMinder Application Server Agents
(see page 34)
Viewing and Creating CA APM for SiteMinder Metric Groupings (see page 39)
Viewing and Creating Alerts for SiteMinder Data (see page 40)
Viewing Cross-process Transaction Tracing (see page 41)
Viewing metrics and dashboards in the Investigator
You can view live data in the Workstation to monitor the performance of CA APM for CA
SiteMinder Application Server Agents.
To view data in the Workstation:
1. Ensure that your applications are instrumented and providing data.
2. Ensure that the Enterprise Manager is running.
3. Start the Workstation.
4. Log in to the Workstation.
5. Navigate to the Workstation Investigator window.
Metrics that are specific to CA SiteMinder, except SOA Security Manager metrics,
appear under the SiteMinder PowerPack node in the Metric Browser tree.
Metrics specific to CA SOA Security Manager appear under SOAAgent node in the
Metric Browser tree. For a detailed list of metrics, see Metrics (see page 43).
6. Navigate to the Workstation Console.
CA APM for CA SiteMinder Application Server Agents provides a number of
pre-configured dashboards for displaying CA SiteMinder performance metrics. See
Using Dashboards Included with CA APM for CA SiteMinder Application Server
Agents (see page 34).
Viewing Metrics


Viewing Metrics
CA APM for CA SiteMinder Application Server Agents collects metric data from CA
SiteMinder and reports these metrics to CA APM. This enables CA APM to monitor the
performance impact of CA SiteMinder on your application infrastructure.
Viewing SiteMinder Web Agent metrics
To view Web Agent metrics:
1. Click the SiteMinder PowerPack > Web Agents > <WebAgentName_Port> node.
In the Viewer pane, the SiteMinder tab is active by default and you can see metrics
associated with the web agent to assess its overall performance. Under the web
agent node, you can see two sub-nodes, namely, Caching and Operations.
2. Expand the sub-nodes to see the metrics listed under each.

Viewing Metrics


Viewing Caching metrics
To view Caching metrics:
Click the SiteMinder PowerPack > Web Agents > <WebAgentName_Port> > Caching
node to view all the associated metrics in a graphical format.
The associated metrics are displayed in the Viewer pane where the SiteMinder tab is
active by default.
1. Expand the Caching node.
You can see Resource and User Session listed under this node.
2. Expand the Resource and User Session nodes to see the metrics listed for each.

Viewing Metrics


Viewing Operations metrics
To view Operations metrics:
1. Click the SiteMinder PowerPack > Web Agents > <WebAgentName_Port> >
Operations node.
In the Viewer pane, the SiteMinder tab is active by default, and you can view all the
associated metrics in a graphical format. Also, metrics for the Authorize,
IsProtected, Login, and Validation operations are listed in a table.
2. Click an operation to view all the associated metrics in a graphical format.
3. Expand the Operations node to see the operations listed under it.
4. Expand the operations to see the metrics listed for each.

Viewing Metrics


Viewing Application Server Agent metrics
To view Application Server Agent (ASA) metrics:
1. Click the SiteMinder PowerPack > <Application Server Agent> node.
In the Viewer pane, the SiteMinder tab is active by default and you can see metrics
associated with the application server agent to assess its overall performance.
2. Expand the <Application Server Agent> node.
If you are using WebLogic, you can see two sub-nodes under the <Application
Server Agent> node, namely, Policy Server Calls and SSPI.
If you are using IBM WebSphere, you can see two sub-nodes under the <Application
Server Agent> node, namely, Policy Server Calls and TAI.
3. Expand the sub-nodes to see the metrics listed under each.
WebLogic supports Security Support Provider Interface (SSPI) that defines the
mechanics of authenticating a user and the password associated with a particular user
account. SSPI helps a client and server establish and maintain a secure channel,
providing confidentiality, integrity, and authentication. It abstracts most of the details of
performing an authentication handshake and provides methods for integrity-protecting
and encrypting data as well as for decrypting and validating data. CA APM for CA
SiteMinder monitors the interfaces for SSPI and displays metrics for these interfaces.
Viewing Metrics


WebSphere supports single sign-on through trust associations. When trust associations
are enabled in WebSphere, it is not required to authenticate a user if a request arrives
through a trusted source that has already performed authentication. Trust Association
Interceptor (TAI) handles the trust association in WebSphere Application Server. TAI is
implemented using Trust Association Interceptor interfaces.

Viewing Metrics


Viewing Policy Server Calls metrics
To view Policy Server Calls metrics:
1. Click the SiteMinder PowerPack > <Application Server Agent> > Policy Server Calls
node.
associated metrics in a graphical format.
2. Expand the Policy Server Calls node to see the operations listed under it.
3. Expand the operations to see the metrics listed for each.

Viewing SSPI metrics
To view SSPI metrics:
1. Click the SiteMinder PowerPack > <Application Server Agent> > SSPI node.
2. Expand the SSPI node to see the interfaces listed under it.
Viewing Metrics


Expand the interfaces to see the metrics listed for each.

Viewing Metrics


Viewing TAI metrics
To view TAI metrics:
1. Click the SiteMinder PowerPack > <Application Server Agent> > TAI node.
2. Expand the TAI node to see the interfaces listed under it.
3. Expand the interfaces to see the metrics listed for each.



Viewing SOA Agent metrics
To view SOA Agent metrics:
1. Click the <Server Agent> > SOA Agent node.
2. Under the SOA Agent node, you can see a sub-node called XMLContentHelper.
3. Expand the XMLContentHelper node to see the interfaces listed under it.
4. Expand the interfaces to see the metrics listed for each.
XMLContentHelper is a Java based API used by the SOA Agents for any XML specific
processing such as resource identification, credential gathering, modifying XML payload,
and so on.

Using Dashboards Included with CA APM for CA SiteMinder
Application Server Agents
Dashboards included with CA APM for CA SiteMinder Application Server Agents
combine and present application metrics in views that you can use to monitor your
application environment. Dashboards aggregate data across all the deployed agents and
deliver the in-depth performance information required for you to rapidly diagnose and
resolve problems.
The included dashboards provide:
High-level application health and status views of the application.
At-a-glance notification of problems in the production application environment.


Data that enables you to quickly identify the problems.
Pre-defined navigation between high-level and drill-down performance
information.
When installing CA APM for CA SiteMinder Application Server Agents, you copy
SiteMinderPP_ManagementModule.jar to the <EM_Home>/config/modules directory.
The Management Module contained in this .jar file provides nine pre-defined
dashboards.
Dashboards are associated with alerts that show the overall health of the application.
Each alert color has a value:
Gray indicates that no data is available
Green indicates nominal performance
Yellow indicates Caution
Red indicates Danger
To view dashboards:
1. Start the APM Workstation.
2. Open the Console.
3. Select one of the dashboards from the drop-down list.
Note: The dashboards for this extension start with the text SiteMinder PP.
SiteMinder PP Overview dashboard
When monitoring CA APM for CA SiteMinder Application Server Agents, first view the
SiteMinder PP Overview dashboard. The dashboard displays alerts to show overall
health.
To view more information:
Double-click an alert to open the associated dashboard. For example, click the Web
Agents Load alert to go to the Web Agents Load dashboard.
Right-click an alert, click Links, and navigate to corresponding alert in the
Management Module.


SiteMinder PP Web Agents Top and Bottom 5 Avg Response Times dashboard
The dashboard shows:
A graph for the top five average response times for Web Agents.
A graph for the bottom five average response times for Web Agents.
Right-click a graph, click Links, and navigate to the metric grouping in the
Management Module.
SiteMinder PP Web Agents Top and Bottom 5 Responses Per Interval dashboard
A graph for the top five responses per interval for Web Agents.
A graph for the bottom five responses per interval for Web Agents.
Right-click a graph, click Links, and navigate to the metric grouping in the
Management Module.
SiteMinder PP WebAgents Load dashboard
A graph for responses per interval for all Web agents
Graphs for responses per interval for Login, Validation, Authorization, and
IsProtected.
Right-click the graph for responses per interval for all Web Agents, click Links, and
navigate to the SiteMinder PP Overview dashboard or the corresponding alert in
the Management Module.
Right-click a graph for responses per interval for Login, Validation, Authorization, or
IsProtected, click Links, and navigate to the corresponding metric grouping in the
Management Module.


SiteMinder PP WebAgents Response Time dashboard
A graph for average response time for all Web agents
Graphs for average response time for Login, Validation, Authorization, and
IsProtected.
Right-click the graph for average response time for all Web Agents, click Links, and
navigate to the SiteMinder PP Overview dashboard or the corresponding alert in
Right-click a graph for average response time for Login, Validation, Authorization, or
IsProtected, click Links, and navigate to the corresponding metric grouping in the
Management Module.
SiteMinder PP WebLogic ASA Load dashboard
A graph for responses per interval for all WebLogic Application Server Agents.
Graphs for responses per interval for SSPI information for all WebLogic Application
Server Agents.
Security Service Provider Interface (SSPI) for WebLogic Server ensures that only
appropriate users and groups can access Oracle Access Manager-protected WebLogic
resources to perform specific operations. The Security Provider also enables you to
configure single sign-on between Oracle Access Manager and WebLogic resources.
Right-click the graph for responses per interval for all WebLogic Application Server
Agents, click Links, and navigate to the SiteMinder PP Overview dashboard or the
corresponding alert in the Management Module.
Under SSPI Information for all the WebLogic Application Server Agents, right-click
a graph for responses per interval for Authentication, Authorization, Adjudication,
or Access Decision, click Links, and navigate to the corresponding metric grouping in


SiteMinder PP WebLogic ASA Response Time dashboard
A graph for average response time for all WebLogic Application Server Agents.
Graphs for average response time of SSPI information for all WebLogic Application
Server Agents.
Right-click the graph for average response time for all WebLogic Application Server
Agents, click Links, and navigate to the SiteMinder PP Overview dashboard or the
corresponding alert in the Management Module.
Under SSPI Information for all the WebLogic Application Server Agents, right-click
a graph for average response time for Authentication, Authorization, Adjudication,
or Access Decision, click Links, and navigate to the corresponding metric grouping in
SiteMinder PP WebSphere ASA Load dashboard
A graph for responses per interval for all WebSphere Application Server Agents.
Graphs for responses per interval for TAI information for all WebSphere Application
Server Agents.
Right-click the graph for responses per interval for all WebSphere Application
Server Agents, click Links, and navigate to the SiteMinder PP Overview dashboard
or the corresponding alert in the Management Module.
Under TAI Information for all the WebSphere Application Server Agents, right-click
a graph for responses per interval for Initialization, ValidateandEstablishTrust, or
IsTargetInterceptor, click Links, and navigate to the corresponding metric grouping
in the Management Module.
SiteMinder PP WebSphere ASA Response Time dashboard
A graph for average response time for all WebSphere Application Server Agents.
Graphs for average response time of TAI information for all WebSphere Application
Server Agents.
Viewing and Creating CA APM for SiteMinder Metric Groupings


Right-click the graph for average response time for all WebSphere Application
Server Agents, click Links, and navigate to the SiteMinder PP Overview dashboard
or the corresponding alert in the Management Module.
Under TAI Information for all the WebSphere Application Server Agents, right-click
a graph for average response time for Initialization, ValidateandEstablishTrust, or
IsTargetInterceptor, click Links, and navigate to the corresponding metric grouping
in the Management Module.
Viewing and Creating CA APM for SiteMinder Metric Groupings
You can view and create the metric groupings for CA APM for CA SiteMinder
Application Server Agents using Management Module Editor.
To view CA APM for CA SiteMinder Application Server Agents metrics groupings
across all agents:
1. In the Investigator, click Workstation > New Management Module Editor.
The Management Module Editor opens.
2. Expand the following nodes:
a. Super Domain.
b. Management Modules.
c. SiteMinder PP (*Super Domain*).
3. Expand the Metric Groupings node to view all metric groupings for CA APM for
SiteMinder.
4. Click a metric grouping to view it in the Viewer pane.
5. Click Elements > New Metric Grouping to create a new metric grouping.
For information about creating and defining metric groupings, see the CA APM
Workstation User Guide.
Viewing and Creating Alerts for SiteMinder Data


Viewing and Creating Alerts for SiteMinder Data
You can view and create the alerts for CA APM for CA SiteMinder Application Server
Agents using the Management Module Editor and the Investigator.
To view CA APM for CA SiteMinder Application Server Agents alerts using
Management Module Editor:
1. In the Investigator, click Workstation > New Management Module Editor.
The Management Module Editor opens.
2. Expand the following nodes:
a. Super Domain.
b. Management Modules.
c. SiteMinder PP (*Super Domain*).
3. Expand the Alerts node to view all alerts for PowerPack for SiteMinder.
4. Click an alert to view it in the Viewer pane.
5. Click Elements > New Alert to create a new alert.
For information about creating and defining alerts, see the CA APM Configuration and
Administration Guide.
Viewing and Creating Alerts
To view alerts using Investigator:
1. In the Investigator, expand the following nodes:
a. Super Domain.
b. Custom Metric Host.
c. Custom Metric Process.
d. Custom Metric Agent.
e. Alerts.
2. Expand the SiteMinder PP node to view all alerts for CA APM for CA SiteMinder
3. Click an alert to view its current status in the Viewer pane.
Each alert color has a metric value:
0 indicates No Data
1 indicates Normal
Viewing Cross-process Transaction Tracing


2 indicates Caution
3 indicates Danger
Viewing Cross-process Transaction Tracing
By using the Transaction Trace feature of CA Introscope, you can trace synchronous
transactions in CA SiteMinder. During a typical transaction, a client sends an HTTP
request to the web server. The web server processes a part of the request and routes
the request to the Application Server. The application server then sends a response to
the client.
You can specify a threshold limit for each transaction on the web server and the
application server on which CA APM for SiteMinder is installed.
You set the threshold limit of a transaction for web server in the
IntroscopeAgent.profile file.
You set the threshold limit for a transaction for application server in the
Workstation.
This threshold limit is propagated to the web server and Application server, respectively.
If any of the transactions exceed this value, CA SiteMinder prepares a Transaction Trace
message and sends it back to the Investigator. With the help of Transaction Trace, you
will not only be able to drill down into the details of a transaction but also find time
spent by the web server and Application Server on various transactions for a particular
request.


Appendix A: Metrics

This appendix defines the metrics provided by CA APM for CA SiteMinder Application
Server Agents.
Metrics for Application Server Agent (see page 43)
Metrics for SOA Security Manager (see page 48)
Metrics for SiteMinder Web Agent (see page 49)
Aggregated metrics for SiteMinder Web Agent (see page 51)
Metrics for Application Server Agent
All metrics appear in the Investigator under the SiteMinder PowerPack node in the
format:
SiteMinder
PowerPack|<instrumentedelementname>|<modulename>|<sub-modulename>:<metricname>
Policy Server Calls
These metrics are reported for each of the resources listed in the tables in this section:
Average Response Time (ms)
Concurrent Invocations
Responses Per Interval
Stall count
Errors Per Interval


The metrics contain these sub-nodes and metrics:
Metric sub-node:
SiteMinder PowerPack|<server type> Application Server Agent|Policy Server
Calls|login
Definition:
Metrics for the login connection to the Policy Servernumber of logins, time taken
for login, and others.
Metric sub-node:
Calls|authorize
Definition:
Determines if a defined user is authorized by SiteMinder to perform a defined
action on a defined resource.
Metric sub-node:
Calls|isProtected
Definition:
Checks whether a defined resource is protected by SiteMinder, and returns the
relevant realm.
SSPI
Metrics for all interfaces for SSPI for WebLogic Application Server Agent is displayed
under the SSPI node:
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI:Average Response Time (ms)
Definition:
Average of the average response times for all SSPI interfaces.
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI:Responses Per Interval
Definition:
Sum of the responses per interval for all SSPI interfaces.


These metrics are provided for each resource listed in the tables in this section:
Stall count
Errors Per Interval
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI|Identity
Asserter|assertIdentity
Definition:
Asserts an identity based on token identity information.
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI|Adjudicator|adjudicate
Definition:
Determines the final adjudication from a set of decisions rendered by Access
Decisions, provided they are acting as policy decision points (PDPs).
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI|Authentication
Provider|getPrincipalValidator
Definition:
Gets this authentication provider's associated principal validation provider.
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI|Principal Validator|sign
Definition:
Signs the principal to assure trust.


Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI| Principal
Validator|validate
Definition:
Verifies that the principal has not been altered since it was signed.
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI|Authorization
Provider|getAccessDecision
Definition:
Gets the implementation of the AccessDecision security service provider interface
(SSPI).
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|SSPI|Access
Decision|isAccessAllowed
Definition:
Indicates whether the authorization policies defined for the resource allow the
requested method to be performed, by utilizing the information contained in the
subject.
Other Policy Server Calls
Stall count
Errors Per Interval


Metric sub-node:
SiteMinder PowerPack|Websphere Application Server Agent|Policy Server
Calls|login
Definition:
Metrics for the login connection to the Policy Servernumber of logins, time taken
for login, and others.
Metric sub-node:
SiteMinder PowerPack|Websphere Application Server Agent|Policy Server
Calls|isProtected
Definition:
relevant realm.
TAI
Metrics for all interfaces for TAI for WebSphere Application Server Agent is displayed
under the TAI node:
Metric:
SiteMinder PowerPack|Application Server Agent|TAI:Average Response Time (ms)
Definition:
Average of the average response times for all TAI interfaces.
Metric:
SiteMinder PowerPack|Application Server Agent|TAI:Responses Per Interval
Definition:
Sum of the responses per interval for all TAI interfaces.
Stall count
Errors Per Interval
Metrics for SOA Security Manager


Metric sub-node:
SiteMinder PowerPack|Application Server Agent|TAI|isTargetInterceptor
Definition:
Determines whether or not this interceptor is designed to process an HTTP request,
in behalf of the trusted server it is designed to interoperate with.
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|TAI|
negotiateValidateandEstablishTrust
Definition:
Determines whether trust association can be established between WebSphere
Application Server and the third party security service (WebSphere 6.0 specific).
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|TAI|initialize
Definition:
Initializes the trust association interceptor. (WebSphere 6.0 specific)
Metric sub-node:
SiteMinder PowerPack|Application Server Agent|TAI|cleanup
Definition:
Called during stopping the WebSphere Application Server process; this provides an
opportunity for trust association interceptor to perform any necessary clean up.
Metrics for SOA Security Manager
Metrics appear in the Investigator under the SOA Agent node in the format:
SOA Agent
|<instrumentedelementname>|<modulename>|<sub-modulename>:<metricna
me>.
Errors Per Interval
Stall Count
Metrics for SiteMinder Web Agent


Metric sub-node:
SOA Agent| XMLContentHelper| identifyResource
Definition:
Identifies the URL of the requested resource and the rule action of the requesting
client.
Metric sub-node:
SOA Agent| XMLContentHelper| gatherCredentials
Definition:
Obtains the required user credentials of the entity to be authenticated for the
current request from the posted XML message.
Metric sub-node:
SOA Agent| XMLContentHelper| applyResponses
Definition:
Applies any XML message content-based responses returned by the SiteMinder
Agent API Sm_AgentApi_authorizeEx() method to the XML message before passing
that message on to the web service.
Metric sub-node:
SOA Agent| XMLContentHelper| resolveVariables
Definition:
Resolves XML content-based variables required to satisfy associated policy
expressions.
Metric sub-node:
SOA Agent| XMLContentHelper| setMessageBuffers
Definition:
Initializes the agent for the current message by setting the headers and body.
Metrics appear in the Investigator under the SiteMinder node in the format:
SiteMinder PowerPack|Web
Agents|<instrumentedelementname>|<modulename>|<sub-modulename>:<me
tricname>


Caching
Average Cache Size (records)
Hits Per Interval
Max Cache Size (records)
Misses Per Interval
Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Caching|Resource
Definition:
Metrics about how often resources are found in the resource cache
Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Caching|User Session
Definition:
Metrics about how often sessions are found in the user session cache
Operations
Metrics for all operations for Web Agent is displayed under the Operations node:
Metric:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Operations:Average Response
Time (ms)
Definition:
Average of the average response times for all operations performed by the Web
Agent.
Metric:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Operations:Responses Per
Interval
Definition:
Sum of the responses per interval for all operations performed by the Web Agent.
Aggregated metrics for SiteMinder Web Agent


Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Operations|Login
Definition:
Establishes a connection to the Policy Server.
Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Operations|Authorize
Definition:
Authorize a user after the user's logon credentials are validated.
Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Operations|IsProtected
Definition:
relevant realm.
Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Operations|Validation
Definition:
Determines if a defined user is authorized by SiteMinder to perform a defined
action on a defined resource.
Aggregated metrics appear in the Investigator under the SiteMinder node in the format:
SiteMinder PowerPack|Web Agents| <instrumentedelementname>|
<modulename>|<sub-modulename>:<metricname>


Caching
These aggregated metrics are provided for each resource listed in the tables in this
section:
Accesses Per IntervalThis aggregate metric is calculated by adding hits and misses
per interval received for a particular cache.
Cache Hit PercentageThis aggregate metric is calculated by multiplying hits per
interval 100 and dividing the result by accesses per interval for a particular cache,
that is,
Cache Hit Percentage = (Hits Per Interval * 100) / Accesses Per Interval.
Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Caching|Resource
Definition:
Metrics about how often resources are found in the resource cache
Metric sub-node:
SiteMinder PowerPack|Web Agents|<Server Host Name>|Caching|User Session
Definition:
Metrics about how often sessions are found in the user session cache


Appendix B: IPv6 Support

IPv6 support for CA APM for CA SiteMinder Application Server Agents is dependent
upon IPv6 support in the environment (JVM, operating system, hardware stack) in which
CA APM is running.
See the CA APM Compatibility Guide for IPv6 compliance information.
Enabling display of the IPv6 address in the Investigator for CA SiteMinder Web Agent
(see page 53)
Enabling display of the IPv6 address in the Investigator for CA SOA Security Manager
Application Server Agent (see page 54)
Enabling display of the IPv6 address in the Investigator for CA SOA Security Manager
Web Server Agent (see page 54)
Enabling display of the IPv6 address in the Investigator for CA
SiteMinder Web Agent
On Windows:
1. Open the Application Server startup script.
2. Add the following property to the JavaOptions section in the script:
-Djava.net.preferIPv6Addresses=true
On UNIX:
Enabling display of the IPv6 address in the Investigator for CA SOA Security Manager Application Server Agent


SOA Security Manager Application Server Agent
On Windows:
On UNIX:
SOA Security Manager Web Server Agent
On Windows:
1. Open the XmlSdkConfig.properties file present in the <WebAgentHome>\java
directory.
2. Locate Section 3: JVM Startup Options (Windows platforms only) in the file and
add the following property to the JVMOptions as a Java argument:
On UNIX:
1. Open the tmxmlsdkserver.sh file present in the <SOA_HOME>/webagent/bin
directory.
2. Add the following property as a Java argument:
Note: When you set -Djava.net.preferIPv6Addresses=true, the Investigator displays
the full IPv6 address under *SuperDomain* | <agentname> | <hostname> | Host :
IP Address. However, if the IPv6 address is not mentioned in the hosts file of the
machine on which the agent is running, the Investigator displays 0:0:0:0:0:0:0:1.

APM - 9.5 - APM For SiteMinder Application Server Agents Guide

Загружено:

Сведения о документе

Исходное описание:

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

APM - 9.5 - APM For SiteMinder Application Server Agents Guide

Загружено:

Авторское право:

Доступные форматы

for CA SiteMinder Application Server

Вам также может понравиться