Originally published here by Fran Martinez, May 18, 2015.

This document covers the installation of the new IBM monitoring 8.1 version on Linux RedHat 6.3 following the below points. It also describes some problems and their solutions in case we face them.

A. Pre-requisites.

B. Requirement

C. Installation

A. Pre-requisites:

Certain ports must be available before you begin installing the Performance Management server. The prerequisite scanner checks if they are available and

returns fail for each port that is not available:

table of port numbers and descriptions

Note: Based on how the installer classifies the system, the JVM heap size is set for the Performance Management services to the following values:

table of JVM heap sizes

B. Requirement :

table of system requirements

Note: the available disk space is the space free needed for opt/ibm it is expected to have a SWAP between 2-4GB (recommended 4GB)

The following packages and libraries are required:

list of packages and libraries

Note: If you get error about regex libraries you will need to install that package

regex{libstdc++.so.6} —> yum install libstdc++.i686 (GNU standard C++Library 32bit)

regex{libpam.so.*} ——-> yum install pam-devel.i686

Note: In case you don’t have so many requirement in your system and it is going to be a little test environment to check the installation and play

a while you can skip this requirement running the command export SKIP_PRECHECK=1 before running the installation. It is true the that

variable also skip the libraries pre-req. (point A) but I can not sure that it starts/works correctly after installation.

Note: The installion is placed in /opt/ibm and it can not be changed.

Note: The installation must be performed by root user.

C. Installation:

They are the internal steps during the installation:

1. Running Prerequisite Scanner

2. Collecting user input

3. Installing DB2 (if your system has another DB2 instance already installed , it must be uninstalled previously)

4. Installing Summarization and Pruning agent

5. Installing Server components

6. Installing Supports

7. Creating the Metric Cache database (Prefetch database) (the database for historical)

8. Creating the Topology database (SCR database)

9. Finalazig database creation

10.Configuring Summarization and Pruning agent

11. Configuring Messaging Broker (configuring Kafka)

12. Starting server components of IBM Monitoring: min, server1, asfrest and apmui

13. Configuring server components of IBM Monitoring

14 Configuring agent installation images if you want.

C1. Download and untar the “ibm-monitoring.tar” file and download the agents media that we want pre-configure.

C2. Run the install.sh script with root user

install script

C3. Accept the agreement

C4. Accept or change the password for “apmadmin” user (pwd default apmpass)

change password prompt

C5. Pre-configure the agents image (this part is optional). In our case, we are going to configure the image “ibm-monitoring-agents-xlinux-64bit.tar” (the

agents for linux 64bit) and “ibm- monitoring-hybrid-gateway.tar” the agent to integrate ITM 6.3 and IM8.1 which are located in /repositorio .

preconfigure agent images prompt

C6. Provide the IP address/hostname that will be used by agent to communicate with server and the path where image agents are located and the

installation starts

installing message

Note: The errors during the installation are located in /opt/ibm/ccm/logs/apm-server-install_xxx.log

Important: To check that the hostname is defined in the DNS or etc/hosts and it is pingable , otherwise we are going to get the error

during installing DB2:

“Error: the host name “xxx” is invalid. Specify a valid host name”

extracting message

Important: If the installation fails with this error:

error message

and we can find in /opt/ibm/ccm/logs/smai-fabric-install_xxxxx.log, these errors:

Tue Apr 7 10:50:28 CEST 2015: smai-apd-apmui-dashboard-resource-
Tue Apr 7 10:50:28 CEST 2015
Tue Apr 7 10:50:28 CEST 2015 : Installing Self Monitoring components…
Tue Apr 7 10:50:28 CEST 2015 : Specified server address is not reachable.
Tue Apr 7 10:50:28 CEST 2015 : Failed to configure Self Monitoring components installation image.

We must apply this solution:

-uninstall server (/uninstall.sh)

-turn off installation of self-monitoring (export SKIP_SELFMON=YES)

-start server installation again (/install.sh)

-after installation completes, install self-monitoring agents manually by launching:

/opt/ibm/ccm/install_self_mon_agents.sh -a install -s -d db2apm -i

Perhaps there is a problem because the host is not dns registered or the dns server is not reachable.

Eventually the installation follow and finish:

configuration complete message

C7. Running “apm status” command we can check if the services are started or not:

apm status command

C8. Log in to the console using https://:9443 with user = apmadmin and password=apmpass (default) .

getting started page

all my applications page

Note: if we want to change the apmadmin or db2 users password we can use the script:

opt/ibm/ccm/apmpasswd.sh and db2_users_password.sh

Thanks for reading , Fran.

Join The Discussion

Your email address will not be published. Required fields are marked *