IBM Support

IBM Application Performance Management 8.1.4.0 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-IF0003 Readme

Fix Readme


Abstract

xxx

Content

Readme file for: Monitoring Agent for HTTP SERVER for IBM Application Performance Management 8.1.4.0 Interim Fix 3
Product/Component Release: 8.1.4.0
Update Name: 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-IF0003
Fix ID: 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-AIX-IF0003, 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN64-IF0003, 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN32-IF0003, 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-XLINUX-IF0003, 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-ZLINUX-IF0003
Publication Date: 13 September 2018
Last modified date: 13 September 2018

Download location

IMPORTANT NOTE: To download this update, you must first login to IBM Fix Central. Once logged in, you may select from the individual download packages. When selecting fixes, ensure your download options are set to "Include requisites: Yes".
http://www.ibm.com/support/fixcentral/

Below is a list of components, platforms, and file names that apply to this Readme file.

Fix Download for AIX

Product/Component Name: Platform: Fix:
IBM Application Performance Management AIX
8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-AIX-IF0003

Fix Download for Windows

Product/Component Name: Platform: Fix:
IBM Application Performance Management Windows
8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN64-IF0003
IBM Application Performance Management Windows
8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN32-IF0003

Fix Download for Linux

Product/Component Name: Platform: Fix:
IBM Application Performance Management Linux
8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-XLINUX-IF0003
IBM Application Performance Management Linux
8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-ZLINUX-IF0003

Prerequisites and co-requisites

General description
This is an interim fix for the Monitoring agent for HTTP Server provided with IBM Application Performance Management family of products, Version 8.1.4.0.
It includes fixes for the HTTP Server Agent and upgrades the agent to 01.00.10.03.

Platforms and prerequisites
The Monitoring Agent for HTTP Server is supported on the platforms documented here.

The interim fix for the HTTP Server Agent is intended to be applied to the Monitoring Agent for HTTP Server version 01.00.07.00, 01.00.08.00, 01.00.08.01, 01.00.09.00, 01.00.10.00 which is provided with:

IBM Cloud Application Performance Monitoring Base Private, Version 8.1.4.0
IBM Cloud Application Performance Monitoring Advanced Private, Version 8.1.4.0.

IBM Cloud Application Performance Monitoring Base, Version 8.1.4.0
IBM Cloud Application Performance Monitoring Advanced, Version 8.1.4.0.

Note: For Windows platform, the upgrade needs to be applied to the Monitoring Agent for HTTP Server with version 01.00.08.00, 01.00.08.01, 01.00.09.00, 01.00.10.00.

Known issues

None

Known limitations

None

Installation information

Prior to installation

The HTTP Server Agent with one of the following versions must be installed and running before applying the agent interim fix.
01.00.07.00
01.00.08.00
01.00.08.01
01.00.09.00
01.00.10.00

Note: For Windows platform, the HTTP Server Agent with version 01.00.08.00 or 01.00.08.01 or 01.00.09.00 or 01.00.10.00 must be installed before apply the interim fix.

Installing

Installing the Performance Management Agent interim fix
Installing the Monitoring Agent for HTTP Server update

  • Change to the following directory:
    • <HTTP_server_installation_directory>/bin
  • Stop the HTTP server.
    • Linux/AIX: ./apachectl -k stop
    • Windows: httpd.exe -k stop

  • Download the patch bundle from Fix Central for each OS type where your agent is installed :
    • 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-AIX-IF0003.tar
    • 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN32-IF0003.zip
    • 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN64-IF0003.zip
    • 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-XLINUX-IF0003.tar
    • 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-ZLINUX-IF0003.tar

  • Unpack the patch bundle (untar on Linux/AIX or unzip on Windows)
  • Enter the created directory.
  • (For AIX platform only) Run slibclean command as root user.
  • Run the apmpatch.sh/bat tool:
    • Linux/AIX:
      ./apmpatch.sh [ <APM agent install directory> ]

    • Windows: apmpatch.bat <APM agent install directory>

    • Notes: the <APM agent install directory> parameter only needs to be provided if the agent is installed in a non-default directory on Linux and AIX.
  • Start the HTTP server.
      cd <HTTP_server_installation_directory>/bin
    • Linux/AIX: ./apachectl -k start
    • Windows: httpd.exe -k start
  • Performing the necessary tasks after installation of the interim fix

    A successful installation modifies the HTTP Server Agent version to 01.00.10.03.

    On Linux or AIX:
    - Ensure that the <APM-AGENT-HOME>/bin/cinfo -t output for the Monitoring Agent for HTTP Server is '01.00.10.03'.
    - The agent interim fix installation logs are written to the <APM-AGENT-HOME>/logs/ directory.

    On Windows:
    - Ensure that version number 01.00.10.03 is displayed for the Monitoring Agent for HTTP Server on the Performance Management window.
    - The agent interim fix installation logs are written to the <APM-AGENT-HOME>\INSTALLITM\ directory.

    Troubleshooting installation problems from the Support site

    For more detailed information, refer to the Troubleshooting and support Guide:
    http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/trouble_intro.htm

    Uninstalling if necessary

    This maintenance package cannot be rolled back. If necessary you can uninstall and reinstall the monitoring agent and patches.

    For detailed instructions to uninstall monitoring agents, please refer to the IBM Application Performance Management guide, here:
    http://www.ibm.com/support/knowledgecenter/SSHLNR_8.1.4/com.ibm.pm.doc/install/uninstall_agents.htm

    Additional information

    The Secure Hash Algorithm 256 (SHA256) checksum of the image is as follows:
    SHA256(8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-AIX-IF0003.tar) = 2f825f1da5a0fa1c2f15b3346c94ff00cc7b900775e6fdb6958469903b1cf6c8
    SHA256(8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN64-IF0003.zip) = 6ab3104f42eb162c756434f6e82c3ec4390433fecc81db0f092fa4f120d1565d
    SHA256(8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN32-IF0003.zip)= 9d560787a35ecdea865ba6b248d74113c32d9f5067e209a16bb452ae33372335
    SHA256(8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-XLINUX-IF0003.tar)= 0abcd48f3a5ca3c097a35738d8c6b748a77f2a6fd074aceb5cae18ffda211719
    SHA256(8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-ZLINUX-IF0003.tar)= 5c38f01d1dece6244cacb7d2cfc411cc0f36386952983b63c4a63d4a0f43435c

    Image Contents
    The following files implement this fix.
    - 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-README-IF0003.readme.html - This README file

    - 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN32-IF0003.zip - For extracting patch files use the WinZip or similar zip utility.

    Extracting the above bundle (.zip) creates the following directory and patch files:

    8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN32-IF0003/
    |-- apmpatch.bat
    |-- patches
    |-- patch.properties

    - 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-XLINUX-IF0003.tar - For extracting patch files use the tar utility.

    Extracting the above bundle (.tar) creates the following directory and patch files:

    8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-XLINUX-IF0003/
    |-- apmpatch.sh
    |-- patches
    |-- patch.properties

    - 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-ZLINUX-IF0003.tar - For extracting patch files use the tar utility.

    Extracting the above bundle (.tar) creates the following directory and patch files:

    8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-ZLINUX-IF0003/
    |-- apmpatch.sh
    |-- patches
    |-- patch.properties

    - 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-AIX-IF0003.tar - For extracting patch files use the tar utility.

    Extracting the above bundle (.tar) creates the following directory and patch files:

    8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-AIX-IF0003/
    |-- apmpatch.sh
    |-- patches
    |-- patch.properties

    - 8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN64-IF0003.zip - For extracting patch files use the WinZip or similar zip utility.

    Extracting the above bundle (.zip) creates the following directory and patch files:

    8.1.4.0-IBM-APM-HTTP-SERVER-AGENT-WIN64-IF0003/
    |-- apmpatch.bat
    |-- patches
    |-- patch.properties

    New Features

    The following changes are included in HTTP Server Agent interim fix:

    • Defect fixes


    List of fixes

    The following problems are addressed by this interim fix.

    APARs

    • None
    Agent defects:
    • 134592: T-WRT: APM814 t5 agent stops after 20mins of run - "Failed to parse JSON" error in T5 log
    • 134155: T-WRT: Add one customized parameter to control cookie settings from server side


    Enhancements:
    • None

    APARS and defects from superseded agent interim fixes:
    • 133271: T-WRT: Fix logging issue of IHS wrt module
    • 132867: T-WRT: uncertain requests cause HTTP Server crash
    • 126567: D - PSIRT ALERT: 9519 Multiple Cross-Site Scripting Vulnerabilities- 8.1.4


    Document change history


    Version Date Description of change
    1.0 11 Sept 2018 Initial Version

    [{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSVJUL","label":"IBM Application Performance Management"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

    Document Information

    Modified date:
    13 September 2018

    UID

    isg400004093