IBM SmartCloud Application Performance Management UI V7.7 Interim Fix 3

Download Description

Copyright International Business Machines Corporation 2016.
All rights reserved.

IBM SmartCloud Application Performance Management UI V7.7
Interim Fix 3

Contents:
1.0 General description
2.0 Problems fixed
3.0 Image directory contents
4.0 Installation instructions
5.0 Copyright and trademark information
6.0 Notices



1.0 General description
===============
This fix contains the new features that are described in the
"New features" section below.


2.0 Problems fixed
==================
The following problems are addressed in this fix.

2.1 APARs:
----------

APAR: IV75699
Abstract: T6 TX/AGENTS LIST INCOMPLETE IN APMUI WIDGET
Additional Information: To proceed transaction request (for T5/T6
agents), APMUI has special logic to handle transaction
groupwidget, and convert them to CURI request to ITM data provider;
If there is "SCOPE" defined with "count" or "sort" filters, it
converts "SCOPE" as parameter in CURI request, and proceed
"count"/"sort" filters in APMUI server side; But in Itm 630, "SCOPE"
parameter usage is removed, and instead there must be a condition
clause to process this agent filter. APMUI server must adjust the
logic to pick up this change for ITM 630.

APAR: IV76635
Abstract: MS CLUSTER SERVER AGENT APMUI DASHBOARD IS MISSING DATA
Additional Information: APMUI is missing data in the following
group widgets of Microsoft Cluster Server Agent: Resource Groups,
Available Memory (last 2 hours), Processor Time.

APAR: IV77350
Abstract: INCORRECT PERCENT USAGE VALUES SHOWN IN PAGING MEMORY
USAGE WIDGET OF THE WINDOWS OS COMPONENT
Additional Information: Values displayed for the "Percent Usage"
metric in the "Paging Memory Usage" widget of the Memory Status
Overview page, in the APM UI for the Windows OS component, are
not correctly scaled by a factor 100.
Affected Platforms / Versions:
This issue affects APMUI 7.7 IF1 and IF2, Windows OS component
only.

APAR: IV78320
Abstract: APMUI - CPU DETAIL WIDGETS MISSING DATA
Additional Information: APMUI Overview -> CPU Overview ->
CPU Detail -> Processor widget shows "Dataprovider error".

APAR: IV80810
Abstract: SUMMARY STATUS INCONSISTENT TO INSTANCE STATUS
Additional Information: In WAS cluster summary group widget, JVM
CPU status is often shown with critical status (red), although
the cpu percentage is less than 4% in the instance list group
widget.

APAR: IV85017
Abstract: DATABASE COPY STATUS GROUP WIDGET, FOLLOWING ERROR
OCCURRED: FAILED TO LOAD GROUP WIDGET
IBM_MSEXCH_DATABASE_AVAILABILITY.
Additional Information: Failed to load group widget
ibm_msexch_database_availability" error occurs when user clicks
on mailbox name of Database Copy Status group widget. As per
Exchange Agent Dashboard functionality, Database Copy Status
group widget does not provide any pop up on click of mailbox
name of Database Copy Status group widget.


2.2 Defects
--------------

N/A

2.3 Enhancements:
-----------------
Enhancement: RFE: 69777
Abstract: Ability to set autocomplete="off" for login form
Additional Information: Pick up Blaze 2.3.0.3.
https://www.ibm.com/developerworks/rfe/execute?
use_case=viewRfe&CR_ID=69777


2.4 Superseded fixes
-------------------------
IBM SmartCloud Application Performance Management UI V7.7 Interim
Fix 2


2.5 New Feature, APARs and defects included from superseded fixes
------------------------------------------------------------------
New Feature:

Abstract: Updated All Applications page and Application Overview Status page

Additional Information:
New Dashboards introduced for the following ITM based agents:
- IBM Integration Bus agent (formerly known as WebSphere Message Broker agent)
- VMWare agent

Updated dashboards for the following ITM based agents:
- Microsoft Exchange Agent
- Microsoft IIS agent
- Microsoft Active Directory agent
- WebSphere MQ agent
- Windows OS agent
- Linux OS agent
- DataPower agent

APARs:

N/A

Defects:

N/A

2.6 Limitations:
----------------
- After upgrading, the customization settings (such as thresholds,
layout, etc.) of the old dashboards that are updated with new
dashboards might be lost. In this case, you need to manually set
them again after upgrading. It has been idenfied that the
dashboard customization settings of the DataPower agent, Linux OS
agent and Windows OS agent will be lost.

- For WebSphere MQ agent, the existing dashboard will not be updated
completely and the summary group widget on the summary page will
remain unchanged; In this case, you need to manually edit the
dashboard to remove MQ components and add them back again; Then,
you need to manually do customization setting again, such as,
thresholds, layout, etc.

- If this is a fresh installation and you never perform the first login
for IF01 or IF02, you might have the login issue (cannot login with SSL
error). To solve the problem, you need to manually update the server.xml
file to add the following SSL definition after the keyStore tag and then
restart APMUI. The server.xml file is in the <APMUI_HOME>/usr/servers/apmui
directory.
<ssl id="defaultSSLConfig" sslProtocol="TLSv1.2"
keyStoreRef="defaultKeyStore"/>

Here is an example of what it looks like after your modification:
<keyStore id="defaultKeyStore"
password="{aes}ANr1/7kJYAbKR+5yf1rbXvpGQIwU/AppIkuKdaChGCOW"/>
<ssl id="defaultSSLConfig" sslProtocol="TLSv1.2"
keyStoreRef="defaultKeyStore"/>

3.0 Image directory contents
===============
This fix image contains the following files:
- 7.7-TIV-APM_UI-IF0003.README (the README file)
- 7.7-TIV-APM_UI-IF0003.tar (the fix archive in .tar format)
- 7.7-TIV-APM_UI-IF0003.zip (the fix archive in .zip format)

Note: The contents of the .tar and .zip files are identical.
Use the .tar file for Linux or AIX systems and use the .zip
file for Windows systems.

The fix archive file contains the following files.

7.7-TIV-APM_UI-IF0003.zip for Windows systems:

- upgrade.bat
- Version.properties
- remove.sql
- eba\com.ibm.apm.ui.eba
- eba\com.ibm.apm.ui.dashboard.eba
- eba\com.ibm.apm.ui.k3z.dashboard.eba
- eba\com.ibm.apm.ui.kbn.dashboard.eba
- eba\com.ibm.apm.ui.kex.dashboard.eba
- eba\com.ibm.apm.ui.klz.dashboard.eba
- eba\com.ibm.apm.ui.kmq.dashboard.eba
- eba\com.ibm.apm.ui.knt.dashboard.eba
- eba\com.ibm.apm.ui.kq5.dashboard.eba
- eba\com.ibm.apm.ui.kq7.dashboard.eba
- eba\com.ibm.apm.ui.kqi.dashboard.eba
- eba\com.ibm.apm.ui.kvm.dashboard.eba
- eba\com.ibm.itm.itportal.app-1.0.0.eba
- eba\itportal.properties
- blaze\Blaze.war
- blaze\cli\cli.jar
- blaze\cli\JSON4J.jar

7.7-TIV-APM_UI-IF0003.tar for Linux or AIX systems:

- upgrade.bat
- Version.properties
- remove.sql
- eba\com.ibm.apm.ui.eba
- eba\com.ibm.apm.ui.dashboard.eba
- eba\com.ibm.apm.ui.k3z.dashboard.eba
- eba\com.ibm.apm.ui.kbn.dashboard.eba
- eba\com.ibm.apm.ui.kex.dashboard.eba
- eba\com.ibm.apm.ui.klz.dashboard.eba
- eba\com.ibm.apm.ui.kmq.dashboard.eba
- eba\com.ibm.apm.ui.knt.dashboard.eba
- eba\com.ibm.apm.ui.kq5.dashboard.eba
- eba\com.ibm.apm.ui.kq7.dashboard.eba
- eba\com.ibm.apm.ui.kqi.dashboard.eba
- eba\com.ibm.apm.ui.kvm.dashboard.eba
- eba\com.ibm.itm.itportal.app-1.0.0.eba
- eba\itportal.properties
- blaze\Blaze.war
- blaze\cli\cli.jar
- blaze\cli\JSON4J.jar


4.0 Installation instructions
===============
4.1 Prerequisites
Before you install IBM SmartCloud Application Performance Management
UI V7.7 Interim Fix 3, you must first install IBM SmartCloud
Application Performance Management UI V7.7 GA, and then apply for
IBM SmartCloud Application Performance Management UI V7.7 Interim Fix
1.

It is also supported to upgrade APMUI from V7.7 Interim Fix 2 to
V7.7 Interim Fix 3.

For more information on installing IBM SmartCloud Application
Performance Management UI V7.7 GA, see IBM SmartCloud Application
Performance Management Knowledge Center, "Installing SmartCloud
Application Performance Management UI" section at
(http://www.ibm.com/support/knowledgecenter/SSATHD_7.7.0/com.ibm.apm.doc_77/apm_ui_docs/apmui_77fp1/installation.html)


To download IBM SmartCloud Application performance management UI V7.7
Interm Fix 1, go to the fix central site using the following url:
https://www-945.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm~Tivoli&product=ibm/Tivoli/SmartCloud+Application+Performance+Management&release=7.7&platform=All&function=all

4.2 Installation on Windows systems
1. Download the 7.7-TIV-APM_UI-IF0003.zip file.

2. Extract the file to a temporary directory.

3. Open the Windows command console.

Note: For non-administrative users, run cmd.exe with "run as
administrator" option, otherwise some services cannot be started.

4. Change the working directory to the temporary directory that contains
the extracted files and run the following command:

upgrade.bat <APMUI_HOME> <APMUI username> <APMUI password>

Where:
- <APMUI_HOME> is the installation path of Application
Performance Management UI 7.7 Interm Fix 1 or Interim Fix 2.
- <APMUI username> is the Application Performance Management UI user name
in the administrator role (such as apmadmin).
- <APMUI password> is the password of <APMUI username>.

Note: If there is any space in the installation path, you must add
double quotation marks before and after the path.

Example:
upgrade.bat "C:\Program Files\IBM\APMUI" apmadmin apmpass

5. IF0003 adopts Blaze 2.3.0.3 which provides fixes of SSL vulnerabilities
and enables TLS V1.2.
You must enable TLS v1.2 by adding the below line after the keyStore tag
in <APMUI_HOME>\usr\servers\apmui\server.xml.

<ssl id="defaultSSLConfig" sslProtocol="TLSv1.2"
keyStoreRef="defaultKeyStore"/>

Here is an example of what it looks like after your modification:
<keyStore id="defaultKeyStore"
password="{aes}ANr1/7kJYAbKR+5yf1rbXvpGQIwU/AppIkuKdaChGCOW"/>
<ssl id="defaultSSLConfig" sslProtocol="TLSv1.2"
keyStoreRef="defaultKeyStore"/>

Restart APMUI server after changing server.xml.

4.3 Installation on Linux or AIX systems:
1. Download the 7.7-TIV-APM_UI-IF0003.tar file.

2. Extract the file to a temporary directory.

3. Change the working directory to the temporary directory that contains the
extracted files and run the following command:

./upgrade.sh <APMUI_HOME> <APMUI username> <APMUI password>

Where:
- <APMUI_HOME> is the installation path of Application Performance Management
UI 7.7 Interm Fix 1 or Interim Fix 2.
- <APMUI username> is the Application Performance Management UI user name in
the administraor role (such as apmadmin).
- <APMUI password> is the password of <APMUI username>

Example:
./upgrade.sh /opt/IBM/APMUI apmadmin apmpass


After the installation completes, you can find the upgrade log in the
<APMUI_HOME>/usr/servers/apmui/logs directory, where <APMUI_HOME> is
the installation path of Application Performance Management UI 7.7
Interm Fix 1 or Interim Fix 2.

4. IF0003 adopts Blaze 2.3.0.3 which provides fixes of SSL vulnerabilities
and enables TLS V1.2.
You must enable TLS v1.2 by adding the below line after the keyStore tag
in <APMUI_HOME>/usr/servers/apmui/server.xml.

<ssl id="defaultSSLConfig" sslProtocol="TLSv1.2"
keyStoreRef="defaultKeyStore"/>

Here is an example of what it looks like after your modification:
<keyStore id="defaultKeyStore"
password="{aes}ANr1/7kJYAbKR+5yf1rbXvpGQIwU/AppIkuKdaChGCOW"/>
<ssl id="defaultSSLConfig" sslProtocol="TLSv1.2"
keyStoreRef="defaultKeyStore"/>

Restart APMUI server after changing server.xml.

5.0 Copyright and trademark information
==================================
A current list of IBM trademarks is available on the Web at "Copyright
and trademark information" at www.ibm.com/legal/copytrade.shtml.



6.0 Notices
=======
{Add or remove non-IBM trademark names as appropriate. Mark the first
occurrence of IBM and special non-IBM trademark names with a '?.
See http://www.ibm.com/legal/copytrade.shtml for a complete list of
non-IBM trademark names.}

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Some jurisdictions do not allow disclaimer of express or implied
warranties in certain transactions, therefore, this statement may not
apply to you.

This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM
may make improvements and/or changes in the product(s) and/or the
program(s) described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft
Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Oracle and/or its affiliates.

UNIX is a registered trademark of The Open Group in the United States
and other countries.

Linux is a registered trademark of Linus Torvalds in the United States,
other countries, or both.

Other company, product, or service names may be trademarks or service
marks of others.

Third-Party License Terms and Conditions, Notices and Information
-----------------------------------------------------------------
The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices and
other information IBM must provide to you under its license to
certain software code. The relevant terms and conditions, notices and
other information are provided or referenced below. Please note that
any non-English version of the licenses below is unofficial and is
provided to you for your convenience only. The English version of the
licenses below, provided as part of the English version of this file,
is the official version.

Notwithstanding the terms and conditions of any other agreement you
may have with IBM or any of its related or affiliated entities
(collectively "IBM"), the third party software code identified below
are "Excluded Components" and are subject to the following terms and
conditions:

- the Excluded Components are provided on an "AS IS" basis
- IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT
NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE
AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE
- IBM will not be liable to you or indemnify you for any claims
related to the Excluded Components
- IBM will not be liable for any direct, indirect, incidental,
special, exemplary, punitive or consequential damages with respect
to the Excluded Components.

Changes Summary: