Install and Configure DX APM Infrastructure Agent and vCenter Extension

Products

• CA Application Performance Management SaaS

Issue/Introduction

 

What is the procedure of installing/configuring the DX APM Infrastructure Agent and vCenter Extension? 

Environment

Release : SAAS

Component : APM SAAS ENTERPRISE

Cause

Not clear documented on the Guide 

Resolution

Answer:

Prerequisites

Before you install the vCenter Monitoring Extension, ensure that you have access to the vCenter environment that you want to monitor.

Install the DX APM Infrastructure Agent and vCenter Monitoring Extension

The DX APM Infrastructure Agent is a master package containing DX APM extensions and a JRE.

Download the Infrastructure Agent

After you log in to DX APM, download and extract the Infrastructure Agent containing vCenter Monitor.

Follow these steps:

-Login to DX SaaS.
-Click Open on the Application Performance Management box.The Application Performance Management home page appears.Then, download the Infrastructure Agent package containing vCenter monitoring.
-At the top center of the Application Performance Management page, click the Download Agent button.
-On the Select Agent to Download page, select the tab corresponding to your operating system.
-Click vCenter Monitor under the Infrastructure category.
- DX APM downloads the package to your computer.

Extract the contents of the package file to the desired installation location. Use your operating system command to extract the file.

UNIX:
tar xf VCenter_Monitor_v.tar

For Example
tar xf VCenter_Monitor_v1.tar

Windows:

Unzip the zip file.

Install the Infrastructure Agent and vCenter Monitoring Extension

Extract the contents of the Infrastructure_Agent package file to the desired installation location. Use your operating system command to extract the file.

UNIX:

tar xf Infrastructure-Agent--unix.tar.gz

Windows:

Unzip Infrastructure-Agent--windows.zip

Deploy the vCenter Monitoring Extension.

Navigate to the APMIA/Extensions directory
Open the Extensions.profile file using a text editor.

Examine the introscope.agent.extensions.bundles.load property. If the vCenter Monitoring name is not listed in the Extensions.profile, add it as shown:
introscope.agent.extensions.bundles.load=VCenterExtension

Use commas to separate multiple entries.
Save the file.

Start the Infrastructure Agent.

UNIX:

./apmia-ca-installer.sh install

Windows:

apmia-ca-installer.bat install

(Optional) Use more Infrastructure Agent-related commands. For more information, see Install the Infrastructure Agent.

Configure the default settings in the bundle.properties file. For more information, see Configure the bundle.properties File.

Configure the bundle.properties File
You can configure vCenter Monitoring to fine-tune your data collection. Define the vCenter host name, user and password credentials, and other properties.

Follow these steps:

Navigate to the apmia/extensions directory.
Go to the /extensions/VCenterExtension directory.
Open the bundle.properties file in a text editor.After you change the properties in the bundle.properties file, restart the Infrastructure Agent to reflect the changes.
Set the vCenter Name using the following property:

introscope.agent.vcenter.collector.hostName
The vCenter host name that is used to connect with vCenter environment. No Default
introscope.agent.vcenter.collector.user
The user name to log in the vCenter environment. No Default
introscope.agent.vcenter.collector.password
The password to log in the vCenter environment.No Default
introscope.agent.vcenter.collector.pollInterval
The polling time in seconds.  Default 300 secs
introscope.agent.vcenter.collector.esxHosts
The details of the ESX Hosts (comma separated value) that you want the vCenter monitoring extension to monitor. Defualt:All
introscope.agent.vcenter.collector.clusters
The comma-separated value of the clusters, the details of which you want to view in the Metric View and Map View. By Default, the vCenter monitoring extension monitors all clusters. Default: All
introscope.agent.vcenter.collector.datacenters
The comma-separated value of the datacenters, the details of which you want to view in the Metric View and Map View. By Default, the vCenter monitoring extension monitors all datacenters. Default :All
introscope.agent.vcenter.monitored.groups
The valid metric groups are : esxphysicalnics,esxvirtualnics,esxportgroups,esxvirtualswitches,esxsensors,esxdisks,vmvirtualdevices,vmguestdisks,vmsnapshots,perfmetrics
To disable all monitoring groups, leave the value of this property as blank. Default :All
introscope.agent.vcenter.collector.perfTime
The performance metrics total wait time for processing. Default :180 secs
#introscope.agent.vcenter.collector.atcReportTime=
The ATC vertex and the edge Time To Live in milliseconds.
Note: By default, this property is commented in the bundle.properties file. Default: 1800000 (30 mins)

Save and close the file.

Restart the Infrastructure Agent.

UNIX:

./apmia-ca-installer.sh restart

Windows:

apmia-ca-installer.bat restart

(Optional) Review the installation log.

Navigate to apmia/APMIA_install.log directory.
Review the log for error messages or troubleshooting help.