OPC Servers Agent 6.3.2.1-TIV-ITM_EM-OPC-IF0001

Downloadable files


Abstract

This fix resolves the APARs and defects listed in the "Problems Fixed" section below in the Description.

Download Description

Copyright International Business Machines Corporation 2012.

All rights reserved.

Component: IBM(R) Tivoli(R) Monitoring for Energy Management Agent
for OPC Servers, version 6.3.2 Interim Feature 01

Component ID: 5725C20OP

Interim Fix: 0001, 6.3.2.1-TIV-ITM_EM-OPC-IF0001

Date: September 26, 2012

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.


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


2.1 APARS
---------
APAR: IV23870
Abstract: OPC Agent is not connecting when OPC Server is on
local machine.
Additional Information: The agent for OPC Server is not connecting
when the OPC Server is running on the same local machine.
In the Tivoli Enterprise Portal, the "Agent Status"
workspace for that agent instance, shows the
"Object Status" as INACTIVE.


2.2 Defects
-----------
Defect: 190674
Abstract: The agent for OPC Server is not reconnecting to the
OPC server.
Additional information: If the OPC server is recycled, the agent
for OPC Server is unable to reconnect to the OPC Server.
In the Tivoli Enterprise Portal, the "Agent Status"
workspace for that agent instance, shows the
"Object Status" as INACTIVE.


2.3 Enhancements
----------------
None.

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

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


3.0 Architecture and prerequisites
----------------------------------
This fix is supported on all operating systems listed in the IBM
Tivoli Monitoring for Energy Management Offering Guide, version
6.3.2.1.

Please refer to the IBM Software Product Compatability Reports (SPCR)
for the latest operating system certification information:
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 Monitoring for Energy Management:
OPC Server Agent Version 6.3.2 Interim Feature 01.


4.0 Image directory content
---------------------------
This fix image contains the following files:

File Description

6.3.2.1-TIV-ITM_EM-OPC-IF0001.README This README file
6.3.2.1-TIV-ITM_EM-OPC-IF0001.zip Fix archive .zip format
6.3.2.1-TIV-ITM_EM-OPC-IF0001.tar Fix archive .tar 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:
6.3.2.1-TIV-ITM_EM-OPC-IF0001/ke1_winnt_tema_if0001.cab
6.3.2.1-TIV-ITM_EM-OPC-IF0001/e1_dd.properties
6.3.2.1-TIV-ITM_EM-OPC-IF0001/e1_dd_063201001.xml
6.3.2.1-TIV-ITM_EM-OPC-IF0001/KE1WINNT.dsc

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 symbol <CANDLEHOME> 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 environment
variable CANDLEHOME to the IBM Tivoli Monitoring installation
directory.

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

- Because there is no uninstall utility for this fix, make sure to
perform a backup of your environment before installing this fix.

5.2 Local agent update
----------------------
1. Transfer the appropriate archive file
(6.3.2.1-TIV-ITM_EM-OPC-IF0001.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 symbol <TEMP>
represents the fully qualified path to this directory.
Note: On a Windows system, this includes the drive letter.

2. Expand the archive file 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. Use the "itmpatch" command to install the fix for that agent
platform. For more information on the "itmpatch" command, see
section 6.2.

On a Windows system, if the fix was expanded to
<TEMP>\6.3.2.1-TIV-ITM_EM-OPC-IF0001, the install command would
be:

> itmpatch -h <CANDLEHOME>
-i <TEMP>\6.3.2.1-TIV-ITM_EM-OPC-IF0001
\ke1_winnt_tema_IF0001.cab

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

2. Expand the archive file 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. To add the agent fix bundles into the remote deploy depot, use
the "tacmd addBundles" command found in $CANDLEHOME/bin on UNIX
systems or in %CANDLEHOME%\bin on Windows systems. For more
information on the "tacmd addBundles" command, see the IBM Tivoli
Monitoring Administrator's Guide.

On UNIX systems,
if the fix was expanded to <TEMP>/6.3.2.1-TIV-ITM_EM-OPC-IF0001:
> $CANDLEHOME/bin/tacmd addBundles
-n -i <TEMP>/6.3.2.1-TIV-ITM_EM-OPC-IF0001

On Windows systems,
if the fix was expanded to <TEMP>\6.3.2.1-TIV-ITM_EM-OPC-IF0001:
> %CANDLEHOME%\bin\tacmd addBundles
-n -i <TEMP>\6.3.2.1-TIV-ITM_EM-OPC-IF0001

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
might require. Please 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 on the
"tacmd login" and "tacmd updateAgent" commands, see the IBM Tivoli
Monitoring Administrator's Guide.

On UNIX systems:
> $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 e1
-n <Managed system name>
-v 063201001

On Windows systems:
> %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 e1
-n <Managed system name>
-v 063201001

Note:
- The component (-t) for the "tacmd updateAgent" command is
specified as two characters (e1), not three characters (ke1).
- The node (-n) for the "tacmd 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
------------------------
There are no agent support updates for the Tivoli Enterprise
Monitoring Server, Tivoli Enterprise Portal Server or Tivoli
Enterprise Portal Desktop included in this fix or any of the
superceded fixes. No additional installation steps are required.


6.0 Additional installation information
---------------------------------------

6.1 Installation instructions for agent baroc files
---------------------------------------------------

There are no updates to the baroc files in this fix. 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 system, this must include
the drive letter.
<TEMP> represents the fully qualified directory specification,
where the fix is located.
Note: On a Windows system, this includes the drive letter.

6.3 Verifying the update
------------------------
1. To verify the agent was updated correctly, use the "tacmd" command
to view the agent's current version after the agent is restarted.
You are required to log in to a Tivoli Enterprise Monitoring
Server prior to 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 e1

On a Windows system, where %CANDLEHOME% is the IBM Tivoli Monitoring
installation directory. The default location is 'C:\IBM\ITM'.

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

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

When the agent update is successful, the agent version is
06.32.01.01.


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 and Windows are trademarks of Microsoft Corporation in the
United States, other countries, or both.

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

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

Download package

Fix Central

Fix Central is a new way to acquire fixes and, for this fix, it is the only option for downloading. The two main differences are that the FTP option will be replaced by HTTP and you will need to use an IBM registered ID to acquire the files, which allows us to notify you if there is a problem with the fix. Privacy is maintained.


Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central (FC)?
6.3.2.1-TIV-ITM_EM-OPC-IF0001 27 Sep 2012 English 999999999 FC

Product Alias/Synonym

ITMfEM

Problems (APARS) fixed
IV23870

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Monitoring for Energy Management
OPC Servers Agent

Software version:

6.3.2.1

Operating system(s):

Windows

Reference #:

4033557

Modified date:

2012-09-28

Translate my page

Machine Translation

Content navigation