IBM Support

Making your life easier: Installing IBM Monitoring v8.1 On-Premise

Technical Blog Post


Abstract

Making your life easier: Installing IBM Monitoring v8.1 On-Premise

Body

 

 

This document covers the installation of the new Ibm monitoring 8.1 version on Linux RedHad 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:

 

 

image

 

 

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

 

image

 

 

 

B. Requirement :


image

 

 

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:

image

 

 

 

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 scrip with root user

image

 

 

C3. Accept the agreement

 

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

 

image

 

 

  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 .

 

image

 

 

 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

 

image

 

 

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”

image

 

 

Important: If the installation fails with this error:

 

image

 

 

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-07.30.08.00-1.el6
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 (<image_path>/uninstall.sh)

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

-start server installation again (<image_path>/install.sh)

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

/opt/ibm/ccm/install_self_mon_agents.sh -a install -s <path_to_image> -d db2apm -i <hostname_or_ip>

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:

 

image

 

 

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

image

 

 

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

 

image

 

 

image

 

 

 

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.

 

image

 

Check out all our other posts and updates:

Academy Blogs:                   http://ibm.co/1sPj9E8
Academy Videos:                 http://bit.ly/1wFKveY
Academy Google+:             http://bit.ly/1sR5QTV
Academy Twitter Handle:  http://bit.ly/1CknfoF

 

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"","label":""},"Component":"","Platform":[{"code":"","label":""}],"Version":"","Edition":"","Line of Business":{"code":"","label":""}}]

UID

ibm11083717