ITCAM Agent for WebSphere DataPower Applications: 7.1.0.1-TIV-ITM_WDP-IF0002

Downloadable files


Abstract

This fix resolves the enhancements listed in the "Problems Fixed"
section below.

Download Description

Copyright International Business Machines Corporation 2014.

All rights reserved.

Component: IBM(R) Tivoli(R) Composite Application Manager Agent for WebSphere DataPower Appliance
Version 7.1 Fix Pack 1 Interim Fix 0002

Component ID: 5724SOADP

Interim Fix: 0002, 7.1.0.1-TIV-ITM_WDP-IF0002

Date: Revised June 15, 2014

Contents:

1.0 General description
2.0 Problems fixed
3.0 Architecture and prerequisites
4.0 Image directory contents
5.0 Installation instructions
6.0 Additional installation information
7.0 Known problems and workarounds
8.0 Additional product information
9.0 Notices

1.0 General description
=======================
This fix resolves the APARs and defects listed in the "Problems Fixed"
section below. This fix also includes the superseded fixes listed in
section 2.4.

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

2.1 APARS:
----------

N/A

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

Defect: 47513
Abstract: Support DataPower Appliance FW7.0.
Additional Information: Some SOMA interfaces were changed in DataPower Appliance FW7.0. This change is used to support DataPower Appliance FW7.0.

2.3 Enhancements:
-----------------



2.4 Superseded fixes
-------------------------
None.


2.5 APARs and defects included from superseded fixes
----------------------------------------------------
None.


3.0 Architecture and prerequisites
=================================
Supported operating systems are listed in the system requirements reports
for the Sybase agent. You can access these reports at one of these locations:

- Prerequisites topic in Knowledge Center:
http://www-01.ibm.com/support/knowledgecenter/SS3JRN_7.2.1/com.ibm.itcama.doc_7.2.1/prerequisites/apps721_systemreqs.html

- Software Product Compatibility Reports (SPCR)
http://publib.boulder.ibm.com/infocenter/prodguid/v1r0/clarity/index.html

3.1 Prerequisites for this fix
--------------------------------
The prerequisite level for this fix is as follows:
- IBM Tivoli Composite Application Manager Agent for WebSphere DataPower Appliance version 7.1 Fix Pack 1


4.0 Image directory contents
============================
This fix image contains the following files:
- 7.1.0.1-TIV-ITM_WDP-IF0002.README - This README file
- 7.1.0.1-TIV-ITM_WDP-IF0002.tar - Fix archive .tar format
- 7.1.0.1-TIV-ITM_WDP-IF0002.zip - Fix archive .zip format

Note: The .tar and .zip files are identical in content. Use the .tar
file if you are working in a UNIX(R) environment; use the .zip file if
you are working in a Windows(R) environment.

The fix archive file contains the following files:
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnaix523.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnaix526.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnli6263.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnlpp266.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnls3246.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnls3263.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnls3266.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbnlx8266.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/KBNWINNT.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/KBNWIX64.dsc
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_aix523_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_aix526_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_li6263_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_lpp266_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_ls3246_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_ls3263_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_ls3266_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_lx8266_tema_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_tems_teps_tepd_if0002.tar
- 7.1.0.1-TIV-ITM_WDP-IF0002/kbn_tems_teps_tepd_if0002.zip
- 7.1.0.1-TIV-ITM_WDP-IF0002/BN_winnt_tema_if0002.cab
- 7.1.0.1-TIV-ITM_WDP-IF0002/bn_dd.properties
- 7.1.0.1-TIV-ITM_WDP-IF0002/bn_dd_071001002.xml

5.0 Installation instructions
=============================
This fix can only be installed over an existing installation. Use
the following steps to install this fix.

5.1 Before installing the fix
-------------------------------
- The prerequisites listed under section 3.1 entitled 'Prerequisites
for this fix' must be installed before this fix can be installed.

- For the purpose of this README, the <CANDLEHOME> symbol is the
IBM Tivoli Monitoring installation directory. The default value
for CANDLEHOME is '/opt/IBM/ITM' on UNIX systems and 'C:\IBM\ITM'
on Windows systems.

Before installing this fix on UNIX systems, set the CANDLEHOME environment
variable to the IBM Tivoli Monitoring installation directory.

For example:
> CANDLEHOME=/opt/IBM/ITM
> export CANDLEHOME

- <OPTIONAL: See section 7.0 entitled "Known problems and workarounds" before
installation.>

- Because there is no uninstall utility for this fix, back up
your environment before installing this fix.


5.2 Local agent update
----------------------
1. Transfer the appropriate archive file (7.1.0.1-TIV-ITM_WDP-IF0002.tar
or .zip) to a temporary directory on the system that contains the
agent code to be updated. For the purpose of this README, the
<TEMP> symbol represents the fully qualified path to this
directory. Note: On a Windows system, this path includes the
drive letter.

2. Expand the archive file by using the tar command on UNIX systems
or an extract utility on Windows systems. This step creates a
directory structure that contains fixes for all supported
platforms.

3. Use the itmpatch command to install the fix for the operating
system of that agent. For more information about the itmpatch
command, see section [6.2].

On UNIX systems, if the fix was expanded to <TEMP>/7.1.0.1-TIV-ITM_WDP-IF0002,
<TEMP>/7.1.0.1-TIV-ITM_WDP-IF0002, the installation command is:

> itmpatch -h <CANDLEHOME>
-i <TEMP>/7.1.0.1-TIV-ITM_WDP-IF0002/kbn_xxxxxx_tema_if0002.tar

where:
- xxxxxx corresponds to the value in the first column returned
by the ./cinfo -i command.

In the following example, the file is
kbn_lx8266_tema_if0002.tar
> ./cinfo -i
ITCAM Agent for WebSphere DataPower Appliance
lx8266 Version: 07.10.01.02

Note:
For AIX 7.1, manually restart the bn agent to enable the ifix.

On a Windows system, if the fix was expanded to
<TEMP>\7.1.0.1-TIV-ITM_WDP-IF0002, the install command is:

> itmpatch -h <CANDLEHOME>
-i <TEMP>\7.1.0.1-TIV-ITM_WDP-IF0002\kbn_winnt_tema_if0002.cab

5.3 Remote agent update
-----------------------
1. Transfer the appropriate archive file (7.1.0.1-TIV-ITM_WDP-IF0002.tar
or .zip) to a temporary directory on the Tivoli Enterprise
Monitoring Server system. For the purpose of this README, the
<TEMP> symbol represents the fully qualified path to this
directory. Note: On Windows systems, this path includes the drive letter.

2. Expand the archive file by using the tar command on UNIX systems or
an extract utility on Windows systems. This step creates a
directory structure that contains fixes for all supported
operating systems.

3. To add the agent fix bundles into the remote deploy depot, use
the tacmd addBundles command that is found in $CANDLEHOME/bin on UNIX
systems or in %CANDLE_HOME%\bin on Windows systems. For more
information about the tacmd addBundles command, see the IBM Tivoli
Monitoring Command Reference.

On UNIX systems,
if the fix was expanded to <TEMP>/7.1.0.1-TIV-ITM_WDP-IF0002:
> $CANDLEHOME/bin/tacmd addBundles -n -i <TEMP>/7.1.0.1-TIV-ITM_WDP-IF0002

On Windows systems,
if the fix was expanded to <TEMP>\7.1.0.1-TIV-ITM_WDP-IF0002:
> %CANDLE_HOME%\bin\tacmd addBundles -n -i <TEMP>\7.1.0.1-TIV-ITM_WDP-IF0002

where:
-n indicates that prerequisite bundles are not automatically
added. The -n parameter must be used because the fix
directory does not contain any prerequisites that the fix
requires. See Section 3.1 for the prerequisites
for this fix.
-i is the directory that contains the deployment bundles to be
added to the depot.

4. To log in to the Tivoli Enterprise Monitoring Server and deploy
the fix to the appropriate nodes where the agent is running, use
the following tacmd commands. For more information about the
tacmd login and updateAgent commands, see the IBM Tivoli Monitoring
Command Reference.

On a UNIX system:
> $CANDLEHOME/bin/tacmd login -s <server>
-u <itmuser>
-p <password>

> $CANDLEHOME/bin/tacmd listSystems

The output shows the Managed System Name for the OS agent on the
remote system to be updated. Use this value as the target of the
tacmd updateAgent command.

> $CANDLEHOME/bin/tacmd updateAgent -t bn
-n <Managed system name>
-v 071001002

On Windows systems:
> %CANDLE_HOME%\bin\tacmd login -s <server>
-u <itmuser>
-p <password>

> %CANDLE_HOME%\bin\tacmd listSystems

The output shows the Managed System Name for the OS agent on the
remote system to be updated. Use this value as the target of the
tacmd updateAgent command.

> %CANDLE_HOME%\bin\tacmd updateAgent -t BN
-n <Managed system name>
-v 071001002
Note:
- The component (-t) for the updateAgent command is specified as
two characters (bn), not three characters (kbn).
- The node (-n) for the updateAgent command is the managed system
name of the operating system (OS) agent to be updated. The
target node for an updateAgent command is always an OS agent.

5.4 Agent support update
------------------------
Fix 7.1.0.1-TIV-ITM_WDP-IF0002 included changes to the agent
support files that must be installed. If you have
installed these updates, there are no additional installation
steps. Otherwise, use the following steps to update the Tivoli
Enterprise Monitoring Server, Tivoli Enterprise Portal Server, or
Tivoli Enterprise Portal Desktop.

1. Transfer the appropriate archive file (7.1.0.1-TIV-ITM_WDP-IF0002.tar
or .zip) to the Tivoli Enterprise Monitoring Servers,
Tivoli Enterprise Portal Servers, or Tivoli Enterprise Portal
Desktops.

2. Expand the archive file by using the tar command on UNIX systems
or an extract utility on Windows systems. This step creates a
directory structure that contains fixes for all of the supported
platforms.

3. Expand the archive file (kbn_tems_teps_tepd_if0002.tar or .zip)
that contains the updates for the Tivoli Enterprise Monitoring Server,
Tivoli Enterprise Portal Server, and Tivoli Enterprise Portal
Desktop by using the tar command on UNIX systems or an extract
utility on Windows systems. This step creates a directory
structure that includes a subdirectory called CD-ROM, with the
necessary updates.

4. Use the Application Support Installer(ASI) GUI or the silent
installation method to install the application support files.

GUI installation option
------------------------
The GUI can be started by using one of the following commands
from within the CD-ROM directory where the setup.jar file is located.

On UNIX systems:
> ./itmasi.sh [-h <CANDLEHOME>] [-j <JAVAHOME>]

On Windows systems:
> itmasi [-h <CANDLEHOME>] [-j <JAVAHOME>]

When prompted by the Application Support Installer for the
installable media directory, select the CD-ROM directory, not the
component directory. The installer can install updates for
multiple components at the same time.

Silent installation option
--------------------------
To use the silent installation option, use one of the following
commands from within the CD-ROM directory where the setup.jar file is
located.

Note: Using the silent installation option for Linux and zLinux
operating systems requires the following files that are contained in
interim fix 6.2-TIV-ITM_ASI-IF0001:
- Linux: setupLinux.bin
- zLinux: setupLinux390.bin
Follow the installation instructions contained in the
"6.2-TIV-ITM_ASI-IF0001.README".

On UNIX systems:
> ./itmasi.sh -h <CANDLEHOME>[-silent]
[-r <response file>]
[-j <JAVAHOME>]

On Windows systems:
> itmasi -h <CANDLEHOME> [-silent]
[-r <response file>]
[-j <JAVAHOME>]

where:
-h <CANDLEHOME> - Required. The path to the IBM Tivoli
Monitoring installation directory.

-r <response file> - Optional. Customized response file name.
The response.txt default response file that is in
the CD-ROM directory can be copied and modified
for your environment. Do not update the response.txt file.

-j <JAVAHOME> - Optional. The fully qualified path to the bin
directory where Java(R) is installed. The
location of Java on your system might vary.

5. The next panel presented by the Application Support Installer asks
for the selection of which Tivoli Monitoring components you want
to add application support to. For this fix, check or clear the
check boxes as follows:

[checked | unchecked] - Tivoli Enterprise Monitoring Server (TEMS)
[checked | unchecked] - Tivoli Enterprise Portal Server (TEPS)
[checked | unchecked] - Tivoli Enterprise Desktop Client (TEPD)

Continue through the remaining GUI panels selecting the DataPower agent
07.10.01.02 support to complete the installation.

6. If the Tivoli Enterprise Portal Desktop or Tivoli Enterprise Portal
Browser was running when the update was installed, it must be
restarted.



6.0 Additional installation information
========================
6.1 Installation instructions for agent baroc file
-----------------------------------------------------
There are no updates to the baroc files included in this fix or
any of the superseded fixes. No additional installation steps are
required.

6.2 Additional information on using "itmpatch" command
--------------------------------------------------------------
The itmpatch command has the following syntax:

Usage: itmpatch -h <installation home> [OPTIONS]

itmpatch -h <installation home>
-t { <patch_file_directory> | <patch_file> }

itmpatch -h <installation home>
-i { <patch_file_directory> | <patch_file> }

where:
-h Specifies the IBM Tivoli Monitoring installation directory.
-i Specifies the path to the directory or patch file to be installed.
-t Generates a report of the actions to be taken by the patch.


For example, on UNIX systems:
- To preview the fix installation, use the "-t" option:
> <CANDLEHOME>/bin/itmpatch -h <CANDLEHOME> -t <TEMP>

- To install the fix, use the "-i" option:
> <CANDLEHOME>/bin/itmpatch -h <CANDLEHOME> -i <TEMP>

where:
<CANDLEHOME> is the fully qualified IBM Tivoli Monitoring
installation directory. On a Windows systems, this path must include
the drive letter.
<TEMP> represents the fully qualified directory specification where
the fix is located. On a Windows systems, this value must include the drive
letter.

6.3 Verifying the update
----------------------------
1. To verify that the agent was updated correctly, use the tacmd command
to view the current version of the agent after the agent is restarted.
You are required to log in to a Tivoli Enterprise Monitoring
Server before viewing the agent version.

For example:
On UNIX systems, where $CANDLEHOME is the IBM Tivoli Monitoring
installation directory, the default location is '/opt/IBM/ITM'.

> $CANDLEHOME/bin/tacmd login -s <server>
-u <itmuser>
-p <password>
> $CANDLEHOME/bin/tacmd listSystems -t or

On Windows systems, where %CANDLE_HOME% is the IBM Tivoli
Monitoring installation directory, the default location
is 'C:\IBM\ITM'.

> %CANDLE_HOME%\bin\tacmd login -s <server>
-u <itmuser>
-p <password>
> %CANDLE_HOME%\bin\tacmd listSystems -t bn

Note: The component (-t) for the tacmd listSystems command is
specified as two characters (bn), not three characters (kbn).

When the agent update is successful, the agent version is:
07.10.01.02

After the agent is restarted, you can also use the GUI to verify
that the agent was successfully updated.

For the agent on Windows systems, the version number is
07.10.0102.
For the agent on UNIX systems, the version number is
07.10.0102.

2. To verify that the agent support files were updated correctly, use the
kincinfo command on Windows systems or the cinfo command on
Linux or UNIX systems. The sample output below shows the versions
of the Tivoli Enterprise Portal Server, Tivoli Enterprise
Monitoring Server, or Tivoli Enterprise Portal Desktop systems
after this fix has been successfully applied.

Note: The displayed date of the build might not be accurate. This
is a known problem.

On UNIX or Linux systems:
-------------------------
To validate that all components have been installed, run the
following command:

./cinfo -i

*********** Fri Mar 18 13:23:02 CST 2011 ******************
User: root Groups: root bin daemon sys adm disk wheel
Host name : myaixsys Installer Lvl:06.22.02.00
CandleHome: /opt/IBM/ITM
***********************************************************
...Product inventory
.
.
.
Monitoring Agent for WebSphere DataPower Appliance update:

bn ITCAM Agent for WebSphere DataPower Appliance
lx8266 Version: 07.10.01.02


.
.
.
Tivoli Enterprise Monitoring Server update:

bn ITCAM Agent for WebSphere DataPower Appliance
tms Version: 07.10.01.02

.
.
.

On Windows systems:
---------------------
To validate that all components have been installed, run the
following command:

For example:
> %CANDLE_HOME%\InstallITM\kincinfo -i


kincinfo output:

*********** Wednesday, January 8, 2014 3:46:34 PM ***********
User : Administrator Group : NA
Host Name : IBM-8B96EE78239 Installer : Ver: 062302000
CandleHome : C:\IBM\ITM
Installitm : C:\IBM\ITM\InstallITM
*************************************************************
...Product Inventory

.
.
.
[ Tivoli Enterprise Monitoring Server |
Tivoli Enterprise Portal Server and Tivoli Enterprise Portal Desktop] update:
BN DataPower Agent Support
WINNT Version: 07.10.01.02 Build:

Tivoli Enterprise Portal Server and Tivoli Enterprise Portal
Desktop update:


BN DataPower Agent Support
WINNT Version: 07.10.01.02 Build:


ITCAM Agent for WebSphere DataPower Appliance update:
BN ITCAM Agent for WebSphere DataPower Appliance
WINNT Version: 07.10.01.02 Build:

Note:

- The date of the build that is displayed might not be accurate. This
problem is known and is being addressed.
- The kincinfo and cinfo command output examples in the sections
that follow show all components that can be updated. If you do
not have all of these components installed, then components not
installed are not displayed in the output of these commands.


7.0 Known problems and workarounds
==================================
None.

8.0 Additional product information
=================================
None.

9.0 Notices
===========
This information was developed for products and services offered in the United
States. IBM may not offer the products, services, or features discussed in this
document in other countries. Consult your local IBM representative for information
on the products and services currently available in your area. Any reference to an
IBM product, program, or service is not intended to state or imply that only that
IBM product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user's responsibility to evaluate and verify
the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.

The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:

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 states do not allow disclaimer of express or implied warranties in
certain transactions, therefore, this statement may not apply to you.

Trademarks and service marks
------------------------------------
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks
of International Business Machines Corp., registered in many
jurisdictions worldwide. Other product and service names might be
trademarks of IBM or other companies. A current list of IBM trademarks
is available on the Web at "Copyright and trademark information" at
www.ibm.com/legal/copytrade.shtml.

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

Java and all Java-based trademarks are trademarks of Sun Microsystems,
Inc. in the United States, other countries, or both.

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.

Download package


Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
7.1.0.1-TIV-ITM_WDP-IF0002.README 15 Jun 2014 English 22904 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.de.README 15 Jun 2014 German 27612 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.es.README 15 Jun 2014 Spanish 25910 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.fr.README 15 Jun 2014 French 26366 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.ja.README 15 Jun 2014 Japanese 29345 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.pt_BR.README 15 Jun 2014 Brazilian Portuguese 25070 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.zh_CN.README 15 Jun 2014 Simplified Chinese 21647 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.zh_TW.README 15 Jun 2014 Traditional Chinese 22137 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.tar 15 Jun 2014 English 298680320 HTTP
7.1.0.1-TIV-ITM_WDP-IF0002.zip 15 Jun 2014 English 222778334 HTTP

Product Alias/Synonym

DataPower Agent Version 7.1 Fix Pack 1 Interim Fix 0002

Rate this page:

(0 users)Average rating

Document information


More support for:

Tivoli Composite Application Manager for Applications
ITCAM Agent for WebSphere DataPower Appliance v710

Software version:

7.1.0

Operating system(s):

AIX, AIX 64bit, Linux, Linux Red Hat - xSeries, Linux SUSE - xSeries, Windows

Software edition:

All Editions

Reference #:

4037904

Modified date:

2014-07-01

Translate my page

Machine Translation

Content navigation