IBM Support

IBM Tivoli Composite Application Manager for Transactions Internet Service Monitoring 7.4 Interim Fix 13 README Tivoli Composite Application Manager for Transactions 7.4.0.0 7.4.0.0-TIV-CAMIS-IF0013 Readme

Fix Readme


Abstract

xxx

Content

Readme file for: 7.4.0.0-TIV-CAMIS-IF0013
Product/Component Release: 7.4.0.0
Update Name: 7.4.0.0-TIV-CAMIS-IF0013
Fix ID: 7.4.0.0-TIV-CAMIS-AIX-IF0013, 7.4.0.0-TIV-CAMIS-LINUX-IF0013, 7.4.0.0-TIV-CAMIS-SOLARIS-IF0013, 7.4.0.0-TIV-CAMIS-WINDOWS-IF0013
Publication Date: 3 Jul 2014
Last modified date: 3 Jul 2014

Download location

To download this update, you must first login to IBM Fix Central. Once logged in, you may select from the individual download packages.
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:
Tivoli Composite Application Manager for Transactions AIX
7.4.0.0-TIV-CAMIS-AIX-IF0013

Fix Download for Linux

Product/Component Name: Platform: Fix:
Tivoli Composite Application Manager for Transactions Linux
7.4.0.0-TIV-CAMIS-LINUX-IF0013

Fix Download for Solaris

Product/Component Name: Platform: Fix:
Tivoli Composite Application Manager for Transactions Solaris
7.4.0.0-TIV-CAMIS-SOLARIS-IF0013

Fix Download for Windows

Product/Component Name: Platform: Fix:
Tivoli Composite Application Manager for Transactions Windows
7.4.0.0-TIV-CAMIS-WINDOWS-IF0013

Prerequisites and co-requisites

This upgrade for ITCAM for Transactions Internet Service Monitoring supersedes 7.4.0.0 IF 3 and 7.4.0.0 IF 11 and may be applied to the following base versions.

  • 7.4.0.0
  • 7.4.0.0-IF03
  • 7.4.0.0-IF11
Note: Supported base versions include interim fixes applied to any of the above release levels.

For Windows 2008 SP2 you must first install the following Microsoft Patch:
You cannot run an application that is signed with a SHA-256 certificate on a computer that is running Windows Vista SP2 or Windows Server 2008 SP2

For up-to-date ITCAM for Transactions v7.4 software prerequisites, please visit:
Prerequisites for ITCAM for Transactions V7.4

For additional download packages or ITM support information, visit the ITM support portal at:
http://www.ibm.com/support/entry/portal/Overview/Software/Tivoli/Tivoli_Monitoring_V6

Known issues

Non APAR Defect 13042 - ISM agent doesn't start after upgrading Windows Box

Problem Description
The Windows ISM agent is stopped after an upgrade.
Root cause
The installer does not support changes to define old and new agent registry keys.
Workaround
Reconfigure the ISM agent after the upgrade to resolve the problem.

Non APAR Defect 10767 - ISM support file upgrades overwrites ismconfig.props

Problem Description
ISM support files upgrades overwrite ismconfig.props. Note: ISM monitor props files are NOT overwritten.
Root cause
The installer does not support not overwriting ismconfig.props.
Workaround
Backup the ismconfig.props file before performing an upgrade of ISM support.

Known limitations

Change of Summarized Data

Problem Description
After upgrading earlier versions of the ISM application, summarized data may not be visible, since the summarization behaviour has changed. This issue can be resolved by re-summarizing your existing detailed data. Please refer to this technote for more information.

Remote Deployment to Windows Running MTEMS

Problem Description
Attempting to remotely deploy the ISM agent to a Windows machine actively running the Manage Tivoli Enterprise Monitoring Services (MTEMS) program fails. Before remote deploying, please close the MTEMS program on the target machine.

SOAP Monitor Does Not Support Nested Arrays or multiRef Values

Problem Description
The SOAP monitor is unable to handle parameters containing nested (two or more dimension) arrays or those that are referenced externally in the 'multiRef' style.

Installation information

For AIX, if upgrading from an ISM 6.0.1 release, you must uninstall the product and perform a new install. This does not apply for other ISM 6 releases. For more information, refer to the following support document:
http://www-01.ibm.com/support/docview.wss?uid=swg21321186

For Linux 64-bit, if upgrading from the original ISM 7.1.0.0 release with no fix packs applied, you must uninstall the 7.1.0.0 ISM component and perform a new install. This does not apply to other releases. For more detailed information, refer to the following support document:
http://www-01.ibm.com/support/docview.wss?uid=swg21330976

For Windows installation, if you encounter the message "Another version of this product is already installed" follow the instructions in the following support document to diagnose and resolve the problem. Note that although this technote refers to ITM, the diagnosing and resolving steps are applicable to ITCAM for Transactions Internet Service Monitoring.
http://www-01.ibm.com/support/docview.wss?uid=swg21587068

Prior to installation

The update installer should perform the following steps for you automatically. You can, if necessary, perform them manually.

  1. Stop ITM agents and infrastructure (including TEMS and TEPS).
  2. Ensure the Databridge and Monitors have stopped.

1. Stop ITM agents and infrastructure (including TEMS and TEPS):
The ITM agents and infrastructure only need to be stopped when either the application support packages are being installed or ISM is being installed on the ITM machine. If ISM is being installed on a machine that does not contain any ITM infrastructure, the ITM infrastructure does not need to be stopped.

Use the Manage Tivoli Enterprise Monitoring Services (MTEMS) dialog or the command line tools (`ITM\bin\tacmd` or `ITM/bin/itmcmd`) to stop any running ITM agents or infrastructure (including TEMS and TEPS).

On Windows systems, you can start the MTEMS application from your Start menu or by running `ITM\InstallITM\kinconfg.exe`. Alternatively, if you have installed ITM, use the command `ITM\bin\tacmd stopAgent <type>`.

On UNIX systems, you can run MTEMS using the `ITM/bin/itmcmd manage` command. Alternatively, use the commands `ITM/bin/itmcmd agent stop <type>` and `ITM/bin/itmcmd server stop <TEMS name>`.

2. Ensure the Databridge and Monitors have stopped:
When the KISAgent is stopped, it automatically signals for the monitors and databridge to be shutdown. If this does not occur or has been disabled by configuration changes, you may need to perform this step manually.

On Windows systems use the Windows Services dialog to look for any 'NCO * Internet Service Monitor' services. To stop the databrige and monitors ensure that each of these 'NCO *' services are stopped.

On UNIX systems run `ps -ef |grep nco_m_` and issue a `kill <pid>` command for each entry shown. If the databridge or monitors were heavily loaded, they may take some time to shutdown. You may also use `kill -9 <pid>` to immediately stop the databridge or monitors, but this may result in loss or corruption of data being processed.

Installing

This maintenance package is applied directly to the Tivoli Enterprise Management Agent (TEMA). In addition, apply application support from this interim fix to the following ITM components:

  • - Tivoli Enterprise Management Servers (TEMS), including any remote or failover TEMS configurations
  • - Tivoli Enterprise Portal Server (TEPS)
  • - Tivoli Enterprise Portal (TEP), including any locally installed desktop TEP clients

On Windows systems, extract the files from the archive and double-click WINDOWS\setup.exe. Follow the prompts to install the update.

On UNIX systems, extract the installer from the archive using the tar -xvf <filename.tar> command. Then, execute the installer using the ./install.sh command. Follow the prompts to install the update.

It is also possible to deploy this interim fix remotely using ITM TEMS depot and tacmd AddBundles command. For more information, please refer to the ITCAM for Transactions v7.4.0.0 Installation and Configuration Guide, available here:
http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamt.doc_7.4.0.0/rt/Install_Guide/remotedeploy.html

Installing application support for TEPS/TEMS
For each monitoring agent installed, you must install agent-specific application support on IBM Tivoli Monitoring components. You can choose to install application support on all components at one time, or you can install the application support on components separately. If installing components separately, the following order is recommended:

  1. Tivoli Enterprise Monitoring Server
  2. Tivoli Enterprise Portal Server
  3. Tivoli Enterprise Portal Desktop Client
  4. Tivoli Enterprise Portal Server Browser client (for Linux and UNIX Only)
The procedure for installing agent-specific application support on the components is similar to installing the monitoring agent. The main difference is to select the application support components required.

Note: When installing application support any ITM components on the current machine is automatically stopped, including any TEMS or TEPS. Follow the Starting and stopping servers and agents guide to manually stop ITM agents and infrastructure. You should warn other users before beginning the installation.

For step by step application support installation information refer to the documentation:
Installing Internet Service Monitoring on Windows systems
Installing on Linux or UNIX systems

Performing the necessary tasks after installation

A successful installation modifies the ISM version to 7.4.0.0. Ensure that the Version of Internet Service Monitoring in the MTEMS is '07.40.00.13'.

On Windows the installation logs are written to the following directory:
ITM\InstallITM\

On Unix the installation logs are written to the following directory:
ITM/logs/

Troubleshooting installation problems from the Support site

For more detailed information, refer to the Installation and Configuration Guide:
http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamt.doc_7.4.0.0/ism/dita/ag/topic/ISM_install_chapter.html

Uninstalling if necessary

This maintenance package cannot be rolled back.

On Windows, you must run the following command prior to uninstalling the product to remove the Windows Services created during the install:
ITM\TMAITM6\ism\platform\win32\bin\preuninstall.cmd
The product may then be removed using the Control Panel's Add/Remove Programs.

On UNIX,the product may be removed using the script:
ITM/bin/uninstall.sh

For detailed instructions, please refer to the ITCAM for Transactions v7.4.0.0 Installation and Configuration Guide, available here:
http://publib.boulder.ibm.com/infocenter/tivihelp/v24r1/topic/com.ibm.itcamt.doc_7.4.0.0/ism/dita/ag/topic/ISM_uninstall_chapter.html

Additional information

The Secure Hash Algorithm 1 (SHA1) checksum of the images are as follows:
SHA1(7.4.0.0-TIV-CAMIS-AIX-IF0013.tar)= 85d340e942c823bb9df12ad89c63a08676085713
SHA1(7.4.0.0-TIV-CAMIS-Linux-IF0013.tar)= 89285bbb928ef9a381e4bc5c1c7764cf6d28ac9c
SHA1(7.4.0.0-TIV-CAMIS-Solaris-IF0013.tar)= a50810bce507abc78a4885671d53820930bb0eb4
SHA1(7.4.0.0-TIV-CAMIS-Windows-IF0013.zip)= f1a111dca8fb657e00dd164f26097b7d24b5b130

The ITM kisagent logs show that the Release ID of this interim fix is: ITCAM_ISM_7.4_Integration,ITCAM_ISM_7.4.0.0_0129

New Features

The following new features are included in ITCAM for Transactions Internet Service Monitoring 7.4 Interim Fix 13:

The following new features are included in ITCAM for Transactions Internet Service Monitoring 7.4 Interim Fix 11 (Included in Interim Fix 13):

The following new features are included in ITCAM for Transactions Internet Service Monitoring 7.4 Interim Fix 3 (Included in Interim Fix 13):

  • Multi user ISM configuration - RFE 13434 - Multi user ISM configuration.

List of fixes

A) APAR Content:
IV55317 Parenthesis ( and ) are not supported in ISM 7.4 for OID group names.
IV57413 ISM OBJECT SERVER MODULE ON WINDOWS DOES NOT CONNECT TO SECURE OBJECT SERVER MODULE.
IV59957 MULTIPLE CONTENT TYPE HEADERS IN A HTTP RESPONSE CAN CAUSE THE ISM HTTP(S) MONITOR TO CRASH.
IV60157 UNDER TRANSX HTTP(S) COOKIES CAN'T BE TRANSFERRED BETWEEN STEPS.
IV60769 IF0011 KIS_RESOURCES.JAR HAS INCORRECT VERSION INFO RESULTING IN APPLICATION SUPPORT MISMATCH ERROR.

From superseded fixes:

IV44842 ISM monitors such as HTTPS and SOAP may crash on AIX
IV46127 HTTP and HTTPS Core dumps.
IV46773 Invalid data passed into the KISAgent can cause a core dump
IV46786 SOAP monitor can create duplicate namespaces in SOAP messages
IV47366 ismconfig is unable to connect to ITM using secure ports
IV49848 NTP monitor returns incorrect offset values
IV49869 Large cookies can cause TRANSX ISM monitor to crash with core
IV50219 ISM NCO__M_<monitor> may produce core file when ISM agent is stopped, if monitor is too slow to stop
IV52160 Failure retests do not get executed on the SIP monitor
IV52162 ISM SIP monitor can crash at the end of a test
IV53691 NTLM doesn't work with Long DomainName host combos
IV54496 KIS SDA FAILING ON ZOS RETURN_CODE 129 REASON=62 QUALIFIER=562
IV54952 AN ISM ELEMENT WITH NO SLC GROUP WILL CAUSE THE MONITOR TO REFUSE TO LOAD THE CONFIGURATION
IV55578 ISM Config CLI does not create OIDs in oidgroup correctly when making a SNMP profile via CLI.
IV55810 ISM Config GUI is very slow when there are MANY Profiles
IV56117 ISM MONITORS NEED TO BE ABLE TO DISABLE TLS 1.2 AND TLS 1.1 FOR COMPATIBILITY WITH OLDER CRYPTOGRAPHY IMPLEMENTATIONS
IV56387 ICMP Monitor Monitoring periods do not work.
IV56684 ISM DNS MONITOR TRANSACTION ID IS ALWAYS SET TO ZERO.
IV57345 WHEN HTTP/S MONITOR HAS THE OUTPUTRESULT PROPERTY ENABLED LONG URLS CAN CAUSE THE MONTOR TO CRASH

B) Additional Non APAR Defects:

N/A

From superseded fixes:

19176 improper message for Resync Agent - Resyncing an this agent will cause locally stored profiles to be removed
18874 ismconfig cli failed to copy profile
19744 the later ismconfig gui overwrites the previous gui's the same named profile under specific steps
19745 the later ismconfig gui can not display the previous gui created element for the same profile under specific steps
19769 The profile still exist after cancelling copy profile.
19771 The profile still exist after cancelling creating profile
19901 Failure to delete and copy ISM profiles on ISM Configuration GUI
20061 The parameters and Regexp data lost in the transx http step after reopen the ISM GUI.

C) Enhancements

N/A
From superseded fixes:

19790 Add new CLIConfig command to bulk unlock profiles

Document change history


Version Date Description of change
1.0 19 June 2014 Initial Version
1.1 23 June 2014 Added Build Number
1.2 3 July 2014 Update APAR Info


















[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS5MD2","label":"Tivoli Composite Application Manager for Transactions"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
03 July 2014

UID

isg400001841