IBM Support

IBM APM 8.1 : WINDOWS OS AGENT INSTALL AND UPGRADE - WINDOWS 2019

How To


Summary

How to install or upgrade a Windows OS agent on Windows 2019 operating system.

Objective

Steps showing the installation, and upgrade, of the Windows OS agent running on Windows 2019.

Environment

APM server version 8.1.4 FP9
Operating system where to install/upgrade the Agent:  Windows 2019
Packages from IBM Passport Advantage for Cloud APM, Advanced Private
Packages number CC2K0ML  advanced_agents_win_8.1.4.0.8.zip
https://www.ibm.com/support/knowledgecenter/en/SSHLNR_8.1.4/com.ibm.pm.doc/install/install_download_pm_part_no.html
Packages number CC10MML advanced_agents_win_8.1.4.0.7.zip
Create Packages with command configure_agent_images.sh:
advanced_agents_win_8.1.4.0.7.zip
advanced_agents_win_8.1.4.0.8.zip
Directories created while extracting the files above.
APMADV_Agent_Install_8.1.4.0.7
APMADV_Agent_Install_8.1.4.0.8

Steps

1) Considering that packages were made with these steps:

make_configuration_packages

configure_agent_images.sh

Link to create

Configuring the installation images

OR see this Technote:

APM V8: Upgrade Agents to latest V8.1.4 level

2) BUT both packages failed during the installation because the Operating System is "not known" (Windows 2019).

So we are going to use this parameter:

set SKIP_PRECHECK=1

With a user Administrator, I am starting a CMD windows session:
From this path where I have extracted the file advanced_agents_win_8.1.4.0.7.zip and where I am starting the install:

c:\tmp\advanced_agents_win_8.1.4.0.7>cd APMADV_Agent_Install_8.1.4.0.7

c:\tmp\advanced_agents_win_8.1.4.0.7\APMADV_Agent_Install_8.1.4.0.7>dir

 Volume in drive C has no label.

 Volume Serial Number is 0E92-2926

 Directory of c:\tmp\advanced_agents_win_8.1.4.0.7\APMADV_Agent_Install_8.1.4.0.7

24/03/2019  21:31    <DIR>          .

24/03/2019  21:31    <DIR>          ..

25/04/2019  15:08    <DIR>          apm

24/03/2019  21:32             4,506 APMADV_silent_install.txt

25/04/2019  15:08    <DIR>          apm_config

25/04/2019  15:08            25,414 installAPMAgents.bat

24/03/2019  21:32    <DIR>          licenses

24/03/2019  21:32            19,685 README.txt

                              3 File(s)         49,605 bytes

                              5 Dir(s)  60,806,991,872 bytes free

c:\tmp\advanced_agents_win_8.1.4.0.7\APMADV_Agent_Install_8.1.4.0.7>set SKIP_PRECHECK=1

c:\tmp\advanced_agents_win_8.1.4.0.7\APMADV_Agent_Install_8.1.4.0.7>installAPMAgents.bat

The following products are available for installation:

    1) Monitoring Agent for Cisco UCS

    2) Monitoring Agent for DB2

    3) Monitoring Agent for Microsoft .NET

    4) Monitoring Agent for HTTP Server

    5) Monitoring Agent for MQ Appliance

    6) Monitoring Agent for IBM Integration Bus

    7) Monitoring Agent for JBoss

    8) Monitoring Agent for Microsoft Hyper-V Server

    9) Monitoring Agent for Microsoft IIS

    10) Monitoring Agent for Microsoft Cluster Server

    11) Monitoring Agent for WebSphere MQ

    12) Monitoring Agent for Active Directory

    13) Monitoring Agent for Microsoft Exchange Server

    14) Monitoring Agent for Microsoft SQL Server

    15) Monitoring Agent for MS SharePoint Server

    16) Monitoring Agent for MySQL

    17) Monitoring Agent for NetApp Storage

    18) Monitoring Agent for Oracle Database

    19) Monitoring Agent for Windows OS

    20) Monitoring Agent for PostgreSQL

    21) Response Time Monitoring Agent

    22) Monitoring Agent for SAP Applications

    23) Monitoring Agent for Skype for Business Server

    24) Monitoring Agent for Siebel

    25) Monitoring Agent for Sybase server

    26) Monitoring Agent for Tomcat

    27) Monitoring Agent for VMware VI

    28) Monitoring Agent for WebSphere Applications

    29) Monitoring Agent for WebLogic

    30) all of the above

Type the numbers that correspond to the products that you want to install. Type "q" to quit selection.

If you enter more than one number, separate the numbers by a space or comma.

Type your selections here (For example: 1,2): 19

The following agents will be installed:

    Monitoring Agent for Windows OS

Are your selections correct [ 1-Yes, 2-No; default is "1" ]? 1

Specify the installation directory. [Default is C:\IBM\APM] :

The agents will be in installed in C:\IBM\APM.

Do you accept the license agreement(s) found in the directory c:\tmp\advanced_agents_win_8.1.4.0.7\APMADV_Agent_Install_8.1.4.0.7\licenses?

Please enter [ 1-to accept the agreement, 2-to decline the agreement ] : 1

User has accepted the license agreement(s).

    Monitoring Agent for Windows OS will be installed.

Installing Monitoring Agent for Windows OS...

The Prerequisite Scanner is skipped.

Installation destination path: C:\IBM\APM

Installing core framework...

Installing Monitoring Agent for Windows OS...

Agent installation completed. The agent was configured and started with default configuration settings.

End running cmd /c c:\tmp\ADVANC~1.7\APMADV~1.7\apm\os-agent.bat install > "C:\IBM\APM\logs\install_agent_NT.log"

##################################################################################

The following agents were installed successfully into the C:\IBM\APM directory:

Monitoring Agent for Windows OS

    Agent status:

    Agent is running. Process ID is 0003924

    Server connection status: Connected

    For more information, see the following file: C:\IBM\APM\TMAITM6_x64\logs\nt_ServerConnectionStatus.txt

The installation log file is C:\IBM\APM\logs\APMADV_Agents_install.log.

To configure your agents, use the following detailed instructions:

For IBM Cloud Application Performance Management SaaS:

http://ibm.biz/kc-ipmcloud-configagent

For IBM Cloud Application Performance Management On Premises:

http://ibm.biz/kc-ipm-configagent

As part of the configuration instructions, you will use the following commands to configure and manage each installed agent:

  Monitoring Agent for Windows OS  C:\IBM\APM\bin\os-agent.bat start or stop or status or uninstall

#####################################################################################################################
 

The Agent is now at version 06.35.14.06 after this above installation after using APMADV_Agent_Install_8.1.4.0.7 package.

3) Now we are starting to upgrade such OS agent version 06.35.14.06.
From this path I am starting the installation:

C:\tmp\advanced_agents_win_8.1.4.0.8>cd APMADV_Agent_Install_8.1.4.0.8

C:\tmp\advanced_agents_win_8.1.4.0.8\APMADV_Agent_Install_8.1.4.0.8>DIR

 Volume in drive C has no label.

 Volume Serial Number is 0E92-2926

 Directory of C:\tmp\advanced_agents_win_8.1.4.0.8\APMADV_Agent_Install_8.1.4.0.8

21/06/2019  09:06    <DIR>          .

21/06/2019  09:06    <DIR>          ..

11/09/2019  16:04    <DIR>          apm

21/06/2019  09:06             4,498 APMADV_silent_install.txt

11/09/2019  16:04    <DIR>          apm_config

11/09/2019  16:04            25,414 installAPMAgents.bat

21/06/2019  09:06    <DIR>          licenses

21/06/2019  09:06            19,889 README.txt

               3 File(s)         49,801 bytes

               5 Dir(s)  60,615,081,984 bytes free

Again we will use 

set SKIP_PRECHECK=1

command to skip the prerequisite checking, and allow the installation to proceed...

C:\tmp\advanced_agents_win_8.1.4.0.8\APMADV_Agent_Install_8.1.4.0.8>set SKIP_PRECHECK=1

C:\tmp\advanced_agents_win_8.1.4.0.8\APMADV_Agent_Install_8.1.4.0.8>installAPMAgents.bat

The following products are available for installation:

    1) Monitoring Agent for Cisco UCS

    2) Monitoring Agent for DB2

    3) Monitoring Agent for Microsoft .NET

    4) Monitoring Agent for HTTP Server

    5) Monitoring Agent for MQ Appliance

    6) Monitoring Agent for IBM Integration Bus

    7) Monitoring Agent for JBoss

    8) Monitoring Agent for Microsoft Hyper-V Server

    9) Monitoring Agent for Microsoft IIS

    10) Monitoring Agent for Microsoft Cluster Server

    11) Monitoring Agent for WebSphere MQ

    12) Monitoring Agent for Active Directory

    13) Monitoring Agent for Microsoft Exchange Server

    14) Monitoring Agent for MSSQL server

    15) Monitoring Agent for MS SharePoint Server

    16) Monitoring Agent for MySQL

    17) Monitoring Agent for NetApp Storage

    18) Monitoring Agent for Oracle Database

    19) Monitoring Agent for Windows OS

    20) Monitoring Agent for PostgreSQL

    21) Response Time Monitoring Agent

    22) Monitoring Agent for SAP Applications

    23) Monitoring Agent for Skype for Business Server

    24) Monitoring Agent for Siebel

    25) Monitoring Agent for Sybase server

    26) Monitoring Agent for Tomcat

    27) Monitoring Agent for VMware VI

    28) Monitoring Agent for WebSphere Applications

    29) Monitoring Agent for WebLogic

    30) all of the above

Type the numbers that correspond to the products that you want to install. Type "q" to quit selection.

If you enter more than one number, separate the numbers by a space or comma.

Type your selections here (For example: 1,2): 19

The following agents will be installed:

    Monitoring Agent for Windows OS

Are your selections correct [ 1-Yes, 2-No; default is "1" ]? 1

Specify the installation directory. [Default is C:\IBM\APM] : 1

Installation directory must be absolute and not relative.

Specify the installation directory. [Default is C:\IBM\APM] :

The agents will be in installed in C:\IBM\APM.

Do you accept the license agreement(s) found in the directory C:\tmp\advanced_agents_win_8.1.4.0.8\APMADV_Agent_Install_8.1.4.0.8\licenses?

Please enter [ 1-to accept the agreement, 2-to decline the agreement ] : 1

User has accepted the license agreement(s).

!!!    Monitoring Agent for Windows OS will be upgraded from version 06351406 to 06351408. !!!

Do you want to continue? [ 1-Yes, 2-No; default is "1" ]? 1

Installing Monitoring Agent for Windows OS...

Monitoring Agent for Windows OS is already installed and will be upgraded to a newer version.

Installed version: 06.03.05.14.06

Version after upgrade: 06.03.05.14.08

The Prerequisite Scanner is skipped.

IBM Monitoring agents installation found in C:\IBM\APM.

Installation destination path: C:\IBM\APM

Installing Monitoring Agent for Windows OS...

Agent installation completed. The agent was configured and started with default configuration settings.

End running cmd /c C:\tmp\ADVANC~1.8\APMADV~1.8\apm\os-agent.bat install > "C:\IBM\APM\logs\install_agent_NT.log"

#####################################################################################################################

The following agents were installed successfully into the C:\IBM\APM directory:

Monitoring Agent for Windows OS

    Agent status:

    Agent is not running

The installation log file is C:\IBM\APM\logs\APMADV_Agents_install.log.

To configure your agents, use the following detailed instructions:

For IBM Cloud Application Performance Management SaaS:

http://ibm.biz/kc-ipmcloud-configagent

For IBM Cloud Application Performance Management On Premises:

http://ibm.biz/kc-ipm-configagent

As part of the configuration instructions, you will use the following commands to configure and manage each installed agent:

  Monitoring Agent for Windows OS  C:\IBM\APM\bin\os-agent.bat start or stop or status or uninstall

##################################################################################

C:\tmp\advanced_agents_win_8.1.4.0.8\APMADV_Agent_Install_8.1.4.0.8>

The Agent is in version 06.35.14.08 after this installation.

4) Here is the result with the agent running with the 'IBM Performance Management' GUI tool:

image-20190913095411-1

Document Location

Worldwide

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"Windows OS agent","Platform":[{"code":"PF033","label":"Windows"}],"Version":"APM 8.14 \nWindows 2019","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

IBM Application Performance Management;APM;moneu19

Document Information

Modified date:
27 January 2020

UID

ibm11073692