Connect
DX APM
to Application Delivery Analysis

dxapm111
Connecting
DX APM
to ADA allows you to view infrastructure data on APM WebView. Enterprise Manager periodically calls web services on the ADA Manager for these metrics and renders them on APM WebView. Enterprise Manager also stores these metrics in the SmartStor for historical reporting.
As an administrator, perform the following steps:
Prerequisites
Before you begin, verify that you have installed and configured:
  • CA Application Delivery Analysis 9.1 or newer
  • NPC 6.1/CAPC 2.0
  • APM database 9.1 or newer
  • Enterprise Manager 9.1 or newer
  • DX APM
    Workstation 9.1 or newer
  • DX APM
    WebView (optional)
  • One
    of the following:
    • DX APM
      .NET agent 9.0 or newer
    • DX APM
      Java agent 9.0 or newer
Run the Installer Program
The
DX APM
Integration for ADA installer program contains two installable components, CAPC Integration Pack and ADA Extension for APM. Instructions in this section show you how to install the ADA Extension for APM. This installable component enables communication between ADA and
DX APM
.
Install the installable component on the Enterprise Manager or MOM (if you have a clustered
DX APM
environment).
You need the following information to complete the installation:
  • Enterprise Manager host name
  • Enterprise Manager port number
  • Host name or IP address of the servers to which the ADA Extension for APM installable component connects
Follow these steps:
  1. Download the
    DX APM
    Integration for ADA installer program from the
    DX APM
    software download area on support.
  2. Navigate to your local version of the Integration Pack installer program and double-click it.
    The installer opens.
  3. Click Next on the Welcome screen.
  4. Read and accept the End User License Agreement.
    Accept the agreement to continue.
  5. Specify where you want the integration pack files installed and click Next.
  6. Select the ADA Extension for APM installable component.
  7. Click Next.
  8. Specify the Enterprise Manager hostname and port to which this installable component will connect and click Next.
  9. Specify the hostname or IP address of all the ADA consoles to which this installable component will connect and click Next.
  10. Specify whether to configure the ADA Extension for APM as a Windows service and click Next.
    In a Windows OS environment, the ADA Extension for APM installable component installs the ADA-APM service.
  11. Review your settings and click Install.
CA Application Delivery Analysis Property Files
After you install the CA Application Delivery Analysis Extension for APM, the ADAExtensionForAPM folder contains the ADAConnector files. These files let you verify configuration settings and update default settings if necessary.
The following configuration settings are part of the CA Application Delivery Analysis Extension for APM installable component, but you can verify and update them using these properties:
  • Enterprise Manager host name
    com.wily.apm.adaconnector.em.host=<EM host name>
  • Enterprise Manager port number
    com.wily.apm.adaconnector.em.port=<EM port>
  • Host names or IP addresses
    This information reflects the values of all the ADA Manager to which the CA Application Delivery Analysis Extension for APM installable component is connected
    com.wily.apm.adaconnector.adawssoap_address_source1=<addr> com.wily.apm.adaconnector.ada_hostName1=<host name>
  • Name of the installer program
    com.wily.apm.adaconnector.ada_processName1=<ADAExtensionforAPM>
    The ADAExtensionforAPM value represents the process name as seen on the Workstation.
The ADAConnector files make the following configuration settings available:
  • Enhanced metrics
    The queries for these infrastructure metrics are disabled by default. Enable the query if you want to make the following infrastructure metrics available on the Workstation:
    • Data Transfer Time
    • Network Round Trip Time
    • Retransmission Delay
    • Server Response Time
    Sample property:
    com.wily.apm.adaconnector.ada_enhancedmetrics_enabled2=<true|false>
    <enabled2>
    is an index of your ADA Manager. The first ADA Manager corresponds to
    <enabled1>
    , second Management console corresponds to
    <enabled2>
    , and so on.
  • CA Application Delivery Analysis web service query
    The wait period between the ADA data time bin and web service query. The default wait time is 5 minutes. The ADA Manager can connect to several collectors, such as Multi-Port Monitors and single port ADA collectors. To allow for aggregation of the collected data, ADA time bins are 5-minutes wide and end at 5-minutes boundaries, for example, 7:00, 7:05, and so on. ADA Manager updates its database every 5-minutes. The wait period value in this property shifts the query from exact 5-minutes boundaries by the specified time frame. For example, defining the wait period as 2-minutes shifts the ADA time bins to 7:02, 7:07, and so on.
    CA Technologies recommends that you do
    not
    change the default value unless instructed by
    CA Support
    .
    Updating this property does not change the web service call frequency. This frequency is fixed at 5-minutes intervals.
    Sample property (units are in milliseconds):
    com.wily.apm.adaconnector.adawebservice.wait=120000
  • SmartStor data feed interval
    Data feed interval from ADA to Enterprise Manager.
    The default interval is 15 seconds. CA Technologies recommends that you do
    not
    change the default value unless instructed by
    CA Support
    .
    Sample property (units are in milliseconds):
    com.wily.apm.adaconnector.smartstorfeed.interval=15000
  • SmartStor data feed wait time
    The wait period between the CA Application Delivery Analysis web service query and Enterprise Manager starting its data feed.
    The default wait time is 10 seconds. CA Technologies recommends that you do
    not
    change the default value unless instructed by
    CA Support
    .
    Sample property (units are in milliseconds):
    com.wily.apm.adaconnector.smartstorfeed.wait=10000
Start the ADA-APM Service
After you install the ADA Extension for APM installable component, start the ADA-APM service.
Windows OS
Start the ADA-APM service in Windows Services.
This service does not start automatically. You start it manually after the installation.
Linux/UNIX OS
Start the ADA Extension for APM using the following command:
<INSTALL_HOME>\ADAExtensionForAPM$./ADAConnector
Synchronize Time
Synchronize the clocks between the following machines to a common time source:
  • CA Application Delivery Analysis
  • Enterprise Manager or MOM
Synchronizing the clocks helps to ensure the integrity of
DX APM
application data on the CA NetQoS Performance Center/CA Performance Center and infrastructure data on the APM WebView. If this task is not performed, time between the components can drift, leading to data inaccuracies or loss.
CA Technologies recommends synchronizing your entire network to a Network Time Protocol time source or a time server. If this is not possible, then at a minimum, you must synchronize the machines discussed.
Verify the Connection
Look for the out-of-the-box dashboard and certain network metrics to confirm the
DX APM
to ADA connection.
Follow these steps:
  1. Log on to either the APM WebView or Introscope Workstation.
  2. Look for the Network Status Information dashboard on the Console.
  3. Look for the following information for each client subnet and server on the Investigator, Metric Browser tab:
    • Network health status
    • Server health status
    • Data Transfer Time
    • Network Round Trip Time
    • Retransmission Delay
    • Server Response Time
    By default, the following metrics are disabled:
    • Data Transfer Time
    • Network Round Trip Time
    • Retransmission Delay
    • Server Response Time
    To enable these metrics, use the
    com.wily.apm.adaconnector.ada_enhancedmetrics_enabled1=<true|false>
    property in the ADA property file. See the How to Connect
    DX APM
    to Application Delivery Analysis
    scenario for information on this property file.
From the Network Status Information dashboard, you can navigate directly to NPC/CA Performance Center. In addition to this out-of-the-box dashboard, the infrastructure metrics are also available for you to create custom dashboards.
Note:
For more information about creating dashboards, see the
DX APM
Workstation User Guide
.