MICRO FOCUS DIAGNOSTIC

AGENT INSTALLATION
GUIDE

ONGC
20 MAY 2023

1
2

TABLE OF CONTENTS
Version Control................................................................................................................ 2
Author......................................................................................................................... 2
Reviewer..................................................................................................................... 2
1 Java Agent installation for Websphere installation on UNIX........................................3
2 Diagnostics Collector installation............................................................................... 10
Document Reference.................................................................................................... 17

VERSION CONTROL

AUTHOR

VERSION AUTHOR DATE

Vishal Yadav, Jatin Mehra,

1.0 20-May-2023
Yash Gupta, Ravinder

REVIEWER

VERSION AUTHOR DATE

Nitesh Saxena
1.0 20-May-2023
Manager
3

1 Java Agent installation for Websphere installation on UNIX

$ cd /var/HP_JAVA_Agent
[$ tar -xvf HPDiagTVJavaAgt_9.26.7.1719.tgz (LINUX)]
$ /usr/contrib/bin/gzip -d HPDiagTVJavaAgt_9.26.7.1719.tgz (HP UX)
$ tar -xvf HPDiagTVJavaAgt_9.26.7.1719.tar
$ cd /var/HP_JAVA_Agent
$ chmod -R 777 *
$ cd JavaAgent/DiagnosticsAgent
[$ export JAVA_HOME=/usr/java/jdk1.7.0_80/ (If required source in bash_profile)]
$ export JAVA_HOME=/opt/java7

GUI Install:
$ ./setup.sh
4
5
6
7

Click Ok and Done.

Console Install:
$ ./setup.sh -console
*************************************************************************
*************************************************************************
INFORMATION-> [Welcome]: Welcome to the HP Diagnostics Setup Module
INFORMATION-> [Init]: Initializing...
INFORMATION-> [Init]: Initializing... complete
INFORMATION-> [Options]:
At any input prompt you may enter:
'Enter' for default value,
'-' for Prev Step,
'+' for Next Step,
'c' to Cancel, or
'f' to Finish
*************************************************************************
8

HP Diagnostics/TransactionVision Agent
Focus: Select the Agent Configuration Options
Progress: 1 of 11
*************************************************************************
PLEASE INPUT (Y:Yes, N:No)-> Diagnostics Profiler Mode [N]:N
PLEASE INPUT (Y:Yes, N:No)-> Diagnostics Mode for Load Runner/Performance Center
(AD License) [N]:N
PLEASE INPUT (Y:Yes, N:No)-> Enterprise Mode (AM License) for Diagnostics [Y]:Y
PLEASE INPUT (Y:Yes, N:No)-> Enterprise Mode (AM License) for Diagnostics with Server
on SaaS Premise [N]:N
PLEASE INPUT (Y:Yes, N:No)-> Enterprise Mode (AM License) for TransactionVision [N]:N
PLEASE INPUT (Y:Yes, N:No)-> Enterprise Mode (AM License) for RUM Client Monitor [N]:N
*************************************************************************
HP Diagnostics/TransactionVision Agent
Focus: Identify the Agent
Progress: 2 of 3
*************************************************************************
PLEASE INPUT-> Agent Name [SOA_APP]:
PLEASE INPUT-> Agent Group [SOA_Application]:PORTAL_Application
PLEASE INPUT-> Application Server Home Directory (Tomcat, JBoss and WebSphere only)
[]:
*************************************************************************
HP Diagnostics/TransactionVision Agent
Focus: Configure the Diagnostics Agent
Progress: 3 of 3
*************************************************************************
PLEASE INPUT-> Diagnostics Server []:
PLEASE INPUT-> Diagnostics Server Port [2006]:
PLEASE INPUT (Y:Yes, N:No)-> Tune Diagnostics Java Agent for use in an SAP NetWeaver
Application Server [N]:N
PLEASE INPUT (Y:Yes, N:No)-> Enable gzip compression (Recommended for HP SaaS
deployments) [N]:N
PLEASE INPUT (Y:Yes, N:No)-> Enable SSL [N]:N
9

PLEASE INPUT (Y:Yes, N:No)-> Use Proxy Server to connect to Diagnostics Server [N]:N
PLEASE INPUT-> Local Profiler Password [**********]:
PLEASE INPUT->
CONFIRM-> Would you like to save your changes now? Enter Y or N: [Y]:Y
INFORMATION-> [Save]: Saving Dialog Select the Agent Configuration Options
INFORMATION-> [Save]: Saving Dialog Identify the Agent
INFORMATION-> [Save]: Saving Dialog Configure the Diagnostics Agent
INFORMATION-> [Save]: Saving Dialog null
INFORMATION-> [Save]: Saving Dialog Configure the TransactionVision Java Agent (page
1 of 2)
INFORMATION-> [Save]: Saving Dialog Configure the TransactionVision Java Agent (page
2 of 2)
INFORMATION-> [Save]: Saving Dialog default
INFORMATION-> [Save]: Saving Dialog Configure the TransactionVision Java Agent Event
Transport Options for WebSphere MQ
INFORMATION-> [Save]: Saving Dialog Configure the TransactionVision Java Agent Event
Transport Options for HornetQ
INFORMATION-> [Save]: Saving Dialog Configure the TransactionVision Java Agent Event
Transport Options for Tibco EMS
INFORMATION-> [Save]: Saving Dialog Configure the TransactionVision Java Agent Event
Transport Options for Generic JMS
INFORMATION-> [Save]: Saving Diagnostics Agent property files
INFORMATION-> [HP Diagnostics Post Setup Summary]:
Enterprise Mode (AM License) selected...
Success (******)Diagnostics Server connectivity validation
The Java Agent configuration passed consistency validation test.
INFORMATION-> [What to Do Next?]: The application server startup script must be
modified to run the JRE instrumenter and invoke the agent.
INFORMATION-> [What to Do Next?]: These steps are application-server dependent. See
the Diagnostics Java Agent Guide for guidelines and examples for your application server.

need to instrument below java snip in Java Virtual machine and reboot the services.
10

-Xbootclasspath/p:/tmp/Java_Agent/DiagnosticsJavaAgent/classes/qapsdb/instr.jre

-javaagent:/tmp/Java_Agent/DiagnosticsJavaAgent/lib/probeagent.jar

-Xshareclasses:none

-Dprobe.id=qapsdb

Configure Java Agent on WebLogic start Scripts:

2 Diagnostics Collector installation

Download the Diagnostics collector and copy to servers. In GSI environment we have
installed a single collector and integrated with Oracle and MSSQL. Only need to change
the <collector_install_dir>\etc\sqlserver-config.xml file.
Right click on installer and run as administrator
. Assign a unique name to the Collector.
11

Slect the environment to be monitor

12

To collect data in an SAP NetWeaver–ABAP environment, select SAP NetWeaver–ABAP.

To collect data from an Oracle 10g database server, select Oracle.
To collect data in an MQ series environment, select MQ.
To collect data from an SQL Server database, select SQL Server.
To collect data from either a VMware vCenter or a VMware ESX server, select VMware.
To collect data from a TIBCO EMS environment, select TIBCO EMS.
To collect data from a webMethods Broker system, select WebMethods Broker.

Provide information about the Diagnostics Commander server.

13

Click on next, collector will be installed.

Configuration for SQL Server

Open <collector_install_dir>\etc\sqlserver-config.xml.
Alter the value of each property as described in the following table and save the file
14
15
16
17

DOCUMENT REFERENCE

https://docs.microfocus.com/doc/SMAX/2022.05/Install