IBM Support

INTEGRATE ITM 6.3 AND APM 8.1.4 USING HYBRID GATEWAY

How To


Summary

HOW TO INTEGRATE ITM 6.30 AND APM 8.1.4 - QUICK STEPS

Objective

Show how to do the integration between APM 8.1.4 and IBM Tivoli Monitoring V6.3

Environment

APM server 8.1.4 ; patchVersion=8.1.4.0.3
ITM TEPS 630 FP7
Hybrid GateWay 8.1.4

 

Steps

First Download the file :  apm_hybrid_gateway_8.1.4.0.tar  from PassPort Advantage on APM Server.
The aim  is to create a package to do the install on the  ITM TEPS system.

Example of paths used :

/opt/ibm/ccm/depot

/root/Downloads/HYBRIDGATEWAY/PackagesAPM/images contains  apm_hybrid_gateway_8.1.4.0.tar file downloaded from Passport Advantage

/opt/ibm/ccm

On APM Server system, I used the path /opt/ibm/ccm and <APM Server IP ADDRESS> which is the IP address of the APM Server in the following step.

================

On APM Server system:

================

1)  Make_configuration_packages.sh

[root@apmserver ccm]# cd /opt/ibm/ccm

[root@apmserver ccm]# ./make_configuration_packages.sh

Enter the IP address/hostname that should be used by agents to communicate with the server.

Enter the IP address/hostname or accept the default [APM server IP ADDRESS]:

Configuration packages which contain the parameters for connecting to the server will be created and stored in a directory that you specify.

Enter the path to the directory where you want to store the configuration packages or accept the default value [/opt/ibm/ccm/mkcustpkg_workdir.1474]:

Agents can connect to the server using secure https or unsecure http protocol.

Enter your choice [ 1-http, 2-https; "http" is default ]?

Configuration packages are stored in the following directory: /opt/ibm/ccm/mkcustpkg_workdir.1474

[root@apmserver ccm]#

Go to  path /opt/ibm/ccm/mkcustpkg_workdir.1474

[root@apmserver mkcustpkg_workdir.1474]#ls -sali

total 1188

169883043   0 drwxr-xr-x  2 root root     56 Feb  5 14:45 .

102955712   8 drwxr-xr-x 35 root root   4096 Feb  5 14:45 ..

102752180 960 -rw-r--r--  1 root root 983040 Feb  5 14:45 onprem_config.tar

102752160 220 -rw-r--r--  1 root root 221331 Feb  5 14:45 onprem_config.zip

2 ) Configure_agent_images.sh 

[root@apmserver ccm]# ./configure_agent_images.sh

To pre-configure agent images, the Hybrid Gateway image or the data collector images, you must have created configuration packages with the parameters for connecting to the server. You either created the configuration packages as part of the installation of the infrastructure node or by using the make_configuration_packages.sh script on the system where the infrastructure node is installed.

Enter the path to the directory containing the configuration packages:/opt/ibm/ccm/mkcustpkg_workdir.1474

Agent installation images, the Hybrid Gateway image and the data collector images are pre-configured using this script.

Enter the path to directory where the images (compressed or uncompressed) are located:/root/Downloads/HYBRIDGATEWAY/PackagesAPM/images

The configuration script copies the pre-configured images to another directory.

Enter the path to the directory where you want to store the pre-configured images or accept the default value /opt/ibm/ccm/depot:

Configuring apm_hybrid_gateway_8.1.4.0.tar.

Successfully configured apm_hybrid_gateway_8.1.4.0.tar.

1 Agent image total.

1 Agent image added to /opt/ibm/ccm/depot.

[root@apmserver ccm]#

==================

ON TEPS ITM 6.30 system :

======================

3) On my Linux System "FVHGATE"  is  installed a TEPS ITM v630 FP7,  where we will install the Hybrid Gate Way (see Prereq part below) :

On my system   FVHGATE, the directory /ITMP/HGATEWAY/APM_Hybrid_Gateway_Install_8.1.4.0 is used to download the package

from the APM Server, using FTP for example.

Package name from APM Server on /opt/ibm/ccm/depot :  apm_hybrid_gateway_8.1.4.0.tar.

root@fvhgate tmp]# cd ITMP

[root@fvhgate ITMP]# ls

HGATEWAY 

[root@fvhgate ITMP]# cd HGATEWAY

[root@fvhgate HGATEWAY]# ls

APM_Hybrid_Gateway_Install_8.1.4.0

[root@fvhgate HGATEWAY]# cd APM_Hybrid_Gateway_Install_8.1.4.0

Untar the file  apm_hybrid_gateway_8.1.4.0.tar with command like

tar xvf apm_hybrid_gateway_8.1.4.0.tar

and go to the new directory created,  which is APM_Hybrid_Gateway_Install_8.1.4.0.

[root@fvhgate APM_Hybrid_Gateway_Install_8.1.4.0]# ls

config  files  install.sh  licenses  version_product.properties

[root@fvhgate APM_Hybrid_Gateway_Install_8.1.4.0]# ./install.sh

Checking product prerequisites before installation. You can disable this check by setting environment variable SKIP_PRECHECK.

Setting Prerequisite Scanner output directory to user defined directory: /opt/ibm/hybridgateway/logs/prereqchecker/20190207_152730

IBM Prerequisite Scanner

     Version: 1.2.0.18

     Build  : 20160602

     OS name: Linux

   User name: root

  Machine Information

 Machine name: fvhgate

 Serial number:  VMware-42 14 c2 fe b2 7c aa 1b-0f 84 ce 6e 96 62 ca 21

Scenario: Prerequisite Scan

PRS execution is in progress, it may take some time ...

KHG - IBM Cloud Application Performance Management Hybrid Gateway [version 01020600]:

Overall result:   PASS 

Detailed results are also available in /opt/ibm/hybridgateway/logs/prereqchecker/20190207_152730/result.txt

Do you accept the license agreement(s) found in the "/tmp/ITMP/HGATEWAY/APM_Hybrid_Gateway_Install_8.1.4.0/licenses" directory? [ 1-yes or 2-no; "no" is default ]?1

User has accepted the license agreement(s).

Before continuing, log in to the Cloud APM console and select System Configuration > Hybrid Gateway Manager to configure the Hybrid Gateway.

Enter the profile name that was defined for this Hybrid Gateway to connect to the Tivoli Enterprise Portal Server.

Each profile should be used by only one Hybrid Gateway. The default profile name is [fvhgate]:

Preparing...                                                ########################################

Updating / installing...

ibm-java-x86_64-jre-8.0-4.5                   ########################################

Preparing...                                                ########################################

Updating / installing...

smai-liberty-8.1.4.0-1.el6                         ########################################

smai-itmcdp-itmclient-08.14.00.00-1.el########################################

Server hybridgateway created.

Preparing...                                                 ########################################

Updating / installing...

smai-agentproxy-8.1.4.0-1.el6                ########################################

Starting server hybridgateway.

Server hybridgateway started with process ID 3734.

Hybrid Gateway installation completed. The installation log file is located at "/opt/ibm/hybridgateway/logs/install-hybridgateway-20190207152729.log".

Use the following command to manage Hybrid Gateway:

    /opt/ibm/hybridgateway/bin/hybridgateway.sh start|stop|status|uninstall

The Hybrid Gateway log files are located in the "/opt/ibm/wlp/usr/servers/hybridgateway/logs" directory.

[root@fvhgate APM_Hybrid_Gateway_Install_8.1.4.0]#

[root@fvhgate ~]# cd /opt/ibm/hybridgateway/logs/

[root@fvhgate logs]# ls

hybridgateway.log  install-hybridgateway-20190207152729.log  prereqchecker

4 ) Configuration and Checking on ITM TEPS if the Dashboard data provider  is enabled :

a) When you configure the TEPS, go to the tab "Dashboard data Provider" and select the option :  Enable the dashboard data provider.

image-20190225100549-2

b) Check that the Dash board data provider is enabled by editing the file fvhgate_cq_KfwServices.inv  which show all the KfwServices logs available and by editing the last log available :

From path /opt/IBM/ITM/logs 

[root@fvhgate logs]# pwd
/opt/IBM/ITM/logs
[root@fvhgate logs]# cat fvhgate_cq_KfwServices.inv
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c73b231-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c73b1d5-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c657154-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c5dba2f-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c5db649-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c5db5d0-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c5da076-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c5d9ff9-01.log
/opt/IBM/ITM/logs/fvhgate_cq_KfwServices_5c5d8ecb-01.log

In my case the last log  is fvhgate_cq_KfwServices_5c73b231-01.log.

[root@fvhgate logs]# grep KD8 fvhgate_cq_KfwServices_5c73b231-01.log
(5C73B242.0000-E:kbbssge.c,72,"BSS1_GetEnv") KD8_ITM_REST_SERVICE_ENABLE="Y"
(5C73B24B.0000-19:kbbssge.c,72,"BSS1_GetEnv") KD8_VIEWMODEL_THREAD_POOL_SIZE="5"
(5C73B24B.0001-19:kbbssge.c,72,"BSS1_GetEnv") KD8FETCHLIMIT="10000"
(5C73B256.0000-D:kbbssge.c,72,"BSS1_GetEnv") KD8_HUBNAME_OVERRIDE=""

If you find the parameter KD8_ITM_REST_SERVICE_ENABLE set at yes, this means  that the dashboard data provider service is enable.
 

Then start the TIVOLI Entreprise Monitoring Services with the below command :

[root@fvhgate bin]# ./itmcmd manage

5) Create a Group for example : 'HGLinuxOS' in Managed system , from the ITM console :

image-20190225140706-1

image-20190225140851-2

Here above is the HGLinuxOS group created.

6) On APM 8.1.0.4 GUI console, under "Advanced configuration" => Select "Hybrid Gateway Manager"

image-20190225093852-1

image-20190225135557-3

Then add and create a configuration profile.

image-20190225135305-1

Confirm pressing OK.

image-20190225135557-3

And normally you should see now all the ITM Agents selected by the ITM Group Name in the APM UI console.

image-20190222170709-4


Additional Information

Links and Commands:

PATH command to start, stop and check the status of the Hybrid Gateway:

/opt/ibm/hybridgateway/bin

Command on this path :

./hybridgateway.sh status

./hybridgateway.sh start

./hybridgateway.sh stop

PATH install log :

/opt/ibm/hybridgateway/logs

And found a file like the below :

install-hybridgateway-20190207152729.log

PATH Hybrid GateWay log :

/opt/ibm/wlp/usr/servers/hybridgateway/logs

Syntax to search Fix for Hybrid GATEWAY : 

8.1.4.0-IBM-APM-GATEWAY-IF0005


Related information

Preparing to install the Hybrid Gateway

Product Alias/Synonym

APM
Hybrib Gateway
Application Performance Management
IBM Cloud Performance Management

Document information

More support for: IBM Application Performance Management

Component: APM 8.1.4 - ITM 6 - Hybrid Gateway - Integration

Software version: ITM 6.30 FP7 APM 8.1.4 LINUX 7

Operating system(s): Linux

Reference #: 0872882

Modified date: 05 April 2019