Technical Blog Post
Abstract
Predictive Insights - Install Application Performance Management (APM)
Body
If you are considering integrating APM with PI, this blog entry can provide you with some clues on how it can be done.
This entry will cover only the APM core and agent installation in a "Quick Start Guide" manner.
For details, you can refer to the IBM Knowledge Center =>
https://www.ibm.com/support/knowledgecenter/en/SSHLNR_8.1.4/com.ibm.pm.doc/welcome.htm
To download the packages, you can refer to the Part Number in the link below =>
Once you have downloaded the APM core and agent package:
(1) apm_base_8.1.4.0.tar
(2) base_agents_xlinux_8.1.4.0.5.tar
you can proceed to install the APM core first.
To do that, please follow the simple procedure below:
(1) Firstly, install some required packages.
(2) Then, set the following ulimit in the /etc/security/limits.conf file (you have to logout and login for it to take effect):
NOTE: You can change the value accordingly, but only to higher values.
(3) After that, you can start to install with command "install.sh".
NOTE: When asked "Enter the path to the directory where you downloaded the agent, Hybrid Gateway, and/or data collector installation images (e.g. /opt/agents)", enter the path where you saved the "base_agents_xlinux_8.1.4.0.5.tar" file.
| [root@test1 apm_base]# ls -l Do you want to upgrade from an existing installation of the IBM Cloud Application Performance Management server [ 1-yes or 2-no; "no" is default ]? This script will install IBM Cloud Application Performance Management, Base Private (8.1.4.0). Do you want to continue [ 1-yes or 2-no; "yes" is default ]? Do you want to change the default installation directory ( /opt/ibm ) [ 1-yes or 2-no; "no" is default ]? Do you accept the license agreement(s) found in the /home/danielyeap/Downloads/apm_base/licenses/ipm_monitoring directory [ 1-accept or 2-decline ]?1 License agreement was accepted, installation will proceed... Do you want to change the default password for the administrator account [ 1-yes or 2-no; "no" is default ]? Agent installation images must be configured to connect to this server. If you have downloaded the agent images to the same system as the server, you can configure the agent images now. Do you want to configure the compressed (*.zip or *.tar) agent installation files now [ 1-yes or 2-no; "yes" is default ]? Enter the path to the directory where you downloaded the agent, Hybrid Gateway, and/or data collector installation images (e.g. /opt/agents):/home/danielyeap/Downloads Enter the path to the directory where configured agent installation images can be stored or accept the default [/opt/ibm/ccm/depot]: Enter the IP address/hostname that will be used by agents to communicate with the server. Enter the hostname and IP address of the server that will be used in a web browser to log in to the IBM Cloud Application Performance Management console. Accept the default values or provide your own. Default values: Fully qualified domain name: test1.ibmtest.com Do you want to use these values [ 1-yes or 2-no; "yes" is default ]? Do you want to install the DB2 database or connect to an existing DB2? [ 1-install database or 2-connect to existing database; "1-install database" is default ]? Running Prerequisite Scanner. This may take a few minutes depending on the number of checked components and machine's performance.
IBM Prerequisite Scanner Scenario: Prerequisite Scan PRS execution is in progress, it may take some time ... IPDB2 - IBM Cloud Application Performance Management and IBM DB2 Server [version 08010300]:
Detailed results are also available in /opt/ibm/ccm/logs/apm-prs_20181123_111925/result.txt No further user input is required. The installation and configuration of components is now starting and may take up to one hour to complete. The installation log is available at "/opt/ibm/ccm/logs/apm-server-install_20181123_111925.log". Installing DB2. Please wait... Installing the IBM Cloud Application Performance Management server. Please wait... Starting components of the IBM Cloud Application Performance Management server... ............
Configuring components of the IBM Cloud Application Performance Management server...
|
(4) Once APM core is installed successfully, you can check its status with command "apm status".
| [root@test1 apm_base]# apm Usage: apm [-f|--force] command service_name -f or --force option only applies to the stop, stop_all, restart, and restart_all commands. The apm commands are: status | ss Show if service is running or stopped service_name is one of: db2 ksy kafka mongodb scr oidc server1 min apmui oslc uviews [root@test1 apm_base]# apm status |
(5) If everything is ok, you can now proceed to install the agent with command "./installAPMAgents.sh ".
In this case, I selected the "Monitoring Agent for Linux OS".
| [root@test1 APM_Agent_Install_8.1.4.0.5]# pwd Agent status: |
(6) Once the agent is installed, you can check its status with command "<agent-name>-agent.sh status".
In this case, the command is "os-agent.sh status".
| [root@test1 bin]# pwd /opt/ibm/apm/agent/bin [root@test1 bin]# ls -l os-agent.sh -rwxr-xr-x 1 root root 796 Nov 23 13:13 os-agent.sh [root@test1 bin]# ./os-agent.sh status Agent status: Agent is running. Process ID is 73423 Server connection status: Connected For more information, see the following file: /opt/ibm/apm/agent/logs/lz_ServerConnectionStatus.txt |
(7) Once started, the "Monitoring Agent for Linux OS" will start to collect data, you can check using the DB2 user "db2apm".
| [danielyeap@test1 ~]$ su - db2apm Database Connection Information Database server = DB2/LINUXX8664 10.5.6 [db2apm@test1 ~]$ db2 list tables for schema ITMUSER | grep -i klz
[db2apm@test1 ~]$ db2 "select * from ITMUSER.KLZ_CPU" TMZDIFF WRITETIME System_Name Timestamp CPU_ID User_CPU User_Nice_CPU System_CPU Idle_CPU Busy_CPU Wait_IO_CPU User_Sys_Pct Steal_CPU_Percent BUSYC_WHSC IDLEC_WHSC WAITC_WHSC STEAL_WHSC SYSCP_WHSC WHTENANTID |
(8) To stop the agent and APM, use the commands below:
| [root@test1 bin]# ./os-agent.sh stop
[root@test1 bin]# apm status
[root@test1 bin]# apm stop_all |
Now, you have a working APM environment that is ready to be integrated with PI.
UID
ibm11081719