Tivoli Log File Agent, Version 6.2.2.4 Interim Fix 07 6.2.2.4-TIV-ITM_LFA-IF0007

Downloadable files


Abstract

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.3. Updated 2013/07/01.

Download Description

*******************************************************************
* A change introduced by this interim fix might negatively
* affect existing product function.
*
* Please refer to APAR IV25184 for a description of the
* problem(s) and corrective action(s).
*
* Evaluate these APARs for the potential impact in your environment.
*******************************************************************

(C) Copyright International Business Machines Corporation 2012.
All rights reserved.

Component: Tivoli(R) Log File Agent,
Version 6.2.2 Fix Pack 4

Component ID: 5724C04LF

Interim Fix: 0007, (6.2.2.4-TIV-ITM_LFA-IF0007)

Date: July 12, 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. This fix also includes the superseded fixes listed in
section 2.3.


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

2.1 APARs
-------------

APAR: IV24412
Abstract: ONE OR MORE SPACES ARE REMOVED FROM LOG RECORD
Additional information: When blank characters (space character x20)
fall, such that they are the only data read into an internal
buffer, the blanks or spaces are removed.

APAR: IV22257
Abstract: "LABEL" KEYWORD DOES NOT GENERATE HOSTNAME IN MSG SLOT
Additional information: The LABEL keyword used in the format file
does not contain the host name of the system where the agent
is currently running. Instead, the actual LABEL variable is
contained in the slot.

For example, the format file contains
FORMAT Class_IV22257
%s* popenFAILED%s*
hostname Claude_momet
-tmp1 LABEL
origin PRINTF("%s", tmp1)
sub_origin PRINTF("%s", tmp1)
msg PRINTF("POPENFAILED at %s", tmp1)
END

The msg slot contains: "POPENFAILED at -tmp1"
where -tmp1 should contain the host name of the system.

APAR: IV20604
Abstract: MULTI-BYTE CHARACTERS IN AN EVENT MIGHT BE CORRUPTED
Additional information: When reading a log file in multi-byte
character encoding, the Log File agent may occasionally
generate event messages that contain incorrect or corrupted
characters.

This might happen when the agent is reading data at the same
time as it is being written to the log. This problem tends to
be rare and is difficult to reproduce. It has only been seen
on UNIX platforms.

APAR: IV19470
Abstract: MEMORY LEAK WITH USE OF *DISCARD*
Additional information: Use of the special predefined event class
*DISCARD* with either REGEX or FORMAT statement causes a
memory leak because storage for part of the event is not
freed when the event is discarded. As a result, the size of
the agent process increased.


APAR: IV17283
Abstract: DOUBLE SINGLE QUOTES ARE SEEN IN EVENTS WHEN SENT TO ITM
Additional information: Escaped single quote characters ('') appear
in events when sent to IBM Tivoli Monitoring. This behavior
results from compatibility with the Tivoli Enterprise Console
Log File Adapter when sending events to the Tivoli Enterprise
Console.

For example:
-------------- Monitored file -----------------------
Feb 7 09:18:08 <hostname> root: abcd'TEST'abcd
-----------------------------------------------------

--------------As seen in the portal------------------
Feb 7 09:18:08 <hostname> root: abcd''TEST''abcd
-----------------------------------------------------

2.2 Defects
--------------
None.

2.3 Superseded fixes
-------------------------
6.2.2.4-TIV-ITM_LFA-IF0006
6.2.2.4-TIV-ITM_LFA-IF0005
6.2.2.4-TIV-ITM_LFA-IF0004
6.2.2.4-TIV-ITM_LFA-IF0003
6.2.2.4-TIV-ITM_LFA-IF0002
6.2.2.4-TIV-ITM_LFA-IF0001

2.4 APARs and defects included from superseded fixes
---------------------------------------------------------------

6.2.2.4-TIV-ITM_LFA-IF0006
-------------------------------
APAR: IV15874
Abstract: U_INVALID_CHAR_FOUND ERROR WHEN CONVERTING UTF8 STRINGS
Additional information: When translating UTF-8 characters to UTF-16
for ICU regular expression processing, the translation fails
with an U_INVALID_CHAR_FOUND error. This is because only a
partial multi-byte UTF-8 character is read into the buffer,
which causes the encoding conversion to fail. This might occur
when the agent is operating in multi-line mode, for example
when monitoring a syslog pipe or using a multi-line pattern in
the .fmt file.

The following error is seen in the agent log
<hostname>_lo_<instance>_kloagent_<timestamp>.log:
(4F1FFCD1.0006-1E:kum0regx.c,206,"KUM0_IsRegExPatternMatch")
*****Error: u_strFromUTF8 failed for string <log record>
...
+4F1FFCD1.0006 <log record> pRegEx @1BCA8D90
status 10 <U_INVALID_CHAR_FOUND>
(4F1FFCD1.0007-1E:kum0regx.c,267,"KUM0_IsRegExPatternMatch")
*****Error: uregex_setText failed for string <log record>:@A6087

APAR: IV15682
Abstract: PORT IY99731 FIX INTO ITM EIF COMPONENT KEF
Additional information: Under heavy load, if the Event Integration
Facility event cache file wraps, its event header may be
included in the event string, corrupting the event being sent
to the event receiver.

This APAR is included in this fix for the Log File Agent on
Windows(R) systems only. For UNIX(R)/Linux(R) systems, a
provisional fix must be requested to obtain this fix.

APAR: IV09148
Abstract: EIF-REMOVE LIMITATION ON USING FIXED LOG NAMES PER IZ08862
Additional information: The PreFilter statements in the .conf
file do not allow custom Windows Event log names. This
limitation was present in the EIFEvent library base code.

This APAR is included in this fix for the Log File Agent on
Windows systems only. For UNIX/Linux systems, these fixes are
included in IBM Tivoli Monitoring Shared Libraries (TEMA)
component of IBM Tivoli Monitoring 6.2.2 Fix Pack 8
(6.2.2-TIV-ITM-FP0008). You must install the Shared Libraries
(ax) component separately.

6.2.2.4-TIV-ITM_LFA-IF0005
-------------------------------
APAR: IV12835
Abstract: LOG File AGENT CRASH IN V6.2.2.4
Additional information: The Log File Agent crashes occasionally or
only on some machines, due to a null record pointer.

The end of the agent log <hostname>_lo_kloagent_<timestamp>.log
with tracing set to KBB_RAS1: ERROR (UNIT:kum ALL)
shows the following:
. . .
(4F41F02F.2A21-1D:kumprmfr.c,325,"KUMP_ReadMonitorFileUnicodeRecord")
File EOF switch set

6.2.2.4-TIV-ITM_LFA-IF0004
-------------------------------
APAR: IV07245
Abstract: SEMI-COLONS IN WINDOWS EVENT LOG MESSAGES ARE CONVERTED TO
SPACES
Additional information: Using the Tivoli Log File Agent v6.2.2.4
to monitor the Windows Event Log, the agent replaces a
semi-colon(;) in the message with a space.

If using the semi-colon to match in the regular expression,
the resulting event message appears in the UnmatchLog.

APAR: IV07885
Abstract: LFA SHUTDOWN CAUSES A CORE DUMP OF LFA ON AIX
Additional information: The agent might core on shutdown in an AIX(R)
environment, because the agent is re-signaling itself.

With KBB_RAS1: ERROR (UNIT:ct_main ALL), the
<hostname>_lo_<instance>_kloagent_<timestamp>.log might contain
two occurrences of:
(4E725950.0002-18:ct_main.cpp,255,"CleanUp") Signal 15 captured

This might occur on all agent versions prior to this fix.

APAR: IV08075
Abstract: LFA DOES NOT START WHEN LOG FILE PATH DOES NOT EXIST ON
WINDOWS
Additional information: On Windows(R) systems, the agent does not
start when the path of the log file to be monitored does not
exist or is not accessible to the agent. If the path is
created before the agent starts, the problem does not occur.

A problem might also occur if the path to the log file contains
a wildcard.

APAR: IV08727
Abstract: LOG FILE AGENT INCORRECTLY MATCHES ADDITIONAL FILES WHEN
LOGSOURCES FILE NAMES CONTAIN WILDCARDS
Additional information: Incorrect file names are matched when a
wildcard character is used in a file name of the LogSources
setting in the conf file. The presence of a wildcard
character (?, *) in the LogSources setting causes the agent
to match a subset or substring of the file name, thus resulting
in more files being monitored than expected. This could result
in CPU performance issues.

APAR: IV08975
Abstract: TACMD ADDSYSTEM FAILS WITH 6224 AND 6224 IF0002 IN DEPOT
Additional information: "tacmd addSystem" fails to install the Tivoli
Log File Agent (klo) version 6.2.2.4, when both v6.2.2.4
(062204000) and Interim Fix 0002, 6.2.2.4-TIV-ITM_LFA-IF0002
(v062204020) are in the depot. Interim Fix 0002 is deployed
and fails with error KDY1008E, because it is not a full install
image and does not pre-req the lo agent.

This also occurs when both version 062204001 and
6.2.2.4-TIV-ITM_LFA-IF0002 or 6.2.2.4-TIV-ITM_LFA-IF0003 are
in the depot.

6.2.2.4-TIV-ITM_LFA-IF0003
-------------------------------
The following APARs are included in this fix for the Log File
Agent on Windows(R) systems only. For UNIX(R)/Linux(R) systems,
these fixes are included in IBM Tivoli Monitoring Shared Libraries
(TEMA) component of IBM Tivoli Monitoring 6.2.2 Fix Pack 6
(6.2.2-TIV-ITM-FP0006). You must install the Shared Libraries (ax)
component separately.

APAR: IZ97359
Abstract: LFA TAKES 75 SECONDS BETWEEN EACH EVENT AFTER FAILOVER IS
COMPLETE
Additional information: The Log File Agent takes 75 seconds between
each event after the failover is completed from primary server
to the backup server.

APAR: IZ99777
Abstract: SET CODEPAGE 943 TO 932 EIF LIBRARY TO HANDLE "¥"
Additional information: On a Japanese AIX OMNIbus system, the
back slash character gets displayed as a question mark. The
back slash character comes from the Log File Agent where it
is converted to UTF-8.

APAR: IV00828
Abstract: LFA SEND EVENTS WITH DELAY WHEN FIREWALL IS PRESENT
Additional information: Events sent by the Log File Agent are delayed
when a firewall is present in the environment.

6.2.2.4-TIV-ITM_LFA-IF0002
-------------------------------
APAR: IV02628
Abstract: MEMORY LEAK WHEN NOT SENDING EVENT TO IBM TIVOLI
MONITORING
Additional information: If the Log File Agent is not configured
to send events to IBM Tivoli Monitoring, an object for use
by ITM is created anyway for each log event, but not freed,
resulting in a memory leak.

APAR: IV02796
Abstract: MEMORY LEAK WHEN MONITORING WINDOWS EVENT LOG
Additional information: When using the Tivoli Log File Agent to
monitor a Windows Event Log source via the WINEVENTLOGS conf
file setting, certain fields of each event are not freed,
leading to a memory leak over time.

APAR: IV02798
Abstract: 6.2.2.4-TIV-ITM_LFA-IF0001 FAILS TO INSTALL ON WIX64
Additional information: When attempting to install interim fix
6.2.2.4-TIV-ITM_LFA-IF0001 on a 64-bit Windows system, the
installer fails, saying it is not a supported platform.
The following error is seen in the itmpatch.log in
%CANDLEHOME%\patchlogs\:
TRACE 03:22:57 (dcfpackageprocessor.cpp,624): Platform
specified in patch filename: winnt, does not match current
platform: wix64. Patch is not applicable.

APAR: IV03361
Abstract: TOTAL ATTRIBUTE LENGTH EXCEEDING 3600 BYTES CAUSES
SITUATIONS TO FAIL
Additional information: The situation stops or goes into a
'Problem' state when the total size of the space used by
string attributes exceeds 3600 bytes, including column
headers.

The situation will remain in a stopped or failed state,
until the situation or the agent is restarted.

If the total size of the string attribute data does not
exceed 3600 bytes, the situation evaluates correctly.

APAR: IV03898
Abstract: REM DEPLOY OF 6.2.2.4-TIV-ITM_LFA-IF0001 FAILS WITH
KDY0005E,DUE TO MISS PREREQ LO
Additional information: On UNIX, the remote deploy of
6.2.2.4-TIV-ITM_LFA-IF0001 fails with the error KDY0005E
"The agent bundle LO is missing the prerequisite LO which
was not be installed on <host name>. An error occurred
during an attempt to install the specified prerequisite."

6.2.2.4-TIV-ITM_LFA-IF0001
-------------------------------
APAR: IV01784
Abstract: AGENT MEMORY LEAK OF VALUES MAPPED FROM SLOTS TO IBM
TIVOLI MONITORING CUSTOMSLOT ATTRIBUTES
Additional information: When using the 'CustomSlot' mapping feature
that allows event slots to be mapped into IBM Tivoli
Monitoring attributes, the memory used to hold the attribute
values is leaked.

3.0 Architecture and prerequisites
======================
This fix is supported on all operating systems listed in the Tivoli
Log File Agent User's Guide, version 6.2.2.4.

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, Version 6.2.2: Fix Pack 02 or higher
(6.2.2-TIV-ITM-FP0002)
- Tivoli Log File Agent Version 6.2.2 Fix Pack 4 (CI1JSML)
Interim Fix 01 available from PassPort Advantage,
or
Tivoli Log File Agent Version 6.2.2 Fix Pack 4.

As this fix is cumulative, it can be installed on any fix level for
this version, release, and mod level above the prerequisite.

4.0 Image directory contents
===================
This fix image contains the following files:

- 6.2.2.4-TIV-ITM_LFA-IF0007.README
- 6.2.2.4-TIV-ITM_LFA-IF0007.tar
- 6.2.2.4-TIV-ITM_LFA-IF0007.zip.

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

The fix archive file contains the following files:
6.2.2.4-TIV-ITM_LFA-IF0007/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/itmpatch.exe
6.2.2.4-TIV-ITM_LFA-IF0007/kloaix523.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_aix523_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/kloaix526.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_aix526_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klohp11.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_hp11_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klohp116.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_hp116_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klohpi116.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_hpi116_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/kloli6263.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_li6263_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klols3263.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_ls3263_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klols3266.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_ls3266_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klolx8266.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_lx8266_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klosol283.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_sol283_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klosol286.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_sol286_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/klosol606.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_sol606_tema_if0007.tar
6.2.2.4-TIV-ITM_LFA-IF0007/KLOWINNT.dsc
6.2.2.4-TIV-ITM_LFA-IF0007/klo_winnt_tema_if0007.cab
6.2.2.4-TIV-ITM_LFA-IF0007/lo_dd_062204007.xml
6.2.2.4-TIV-ITM_LFA-IF0007/lo_dd.properties
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/aix523/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/aix526/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/hp11/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/hp116/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/hpi116/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/li6263/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/ls3263/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/ls3266/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/lx8266/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/sol283/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/sol286/itmpatch
6.2.2.4-TIV-ITM_LFA-IF0007/patchtool/sol606/itmpatch

Each tar or cab file has updates to the IBM Tivoli Enterprise
Monitoring Server component for a specific platform. The platform that
each file applies to is included in its name.

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.2.2.4-TIV-ITM_LFA-IF0007.tar or .zip) to a temporary directory
on the system that contains the agent to be updated. For the
purpose of this README, the symbol <TEMP> represents the fully
qualified path to this directory. Note: On Windows systems, this
path 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 the operating
system of that agent. For more information on the "itmpatch"
command, see section 6.2.

On UNIX systems, if the fix was expanded to <TEMP>/6.2.2.4-TIV-ITM_LFA-IF0007,
the install command is:

> <TEMP>/6.2.2.4-TIV-ITM_LFA-IF0007/itmpatch -h <CANDLEHOME>
-i <TEMP>/6.2.2.4-TIV-ITM_LFA-IF0007/klo_xxxxxx_tema_if0007.tar

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

In the following example, the file is "klo_li6243_tema_if0007.tar".
> ./cinfo -i
lo Tivoli Log File Agent
li6263 Version: 06.22.04.00

On Windows systems, if the fix was expanded to
<TEMP>\6.2.2.4-TIV-ITM_LFA-IF0007, the install command is:

> <TEMP>\6.2.2.4-TIV-ITM_LFA-IF0007\itmpatch -h <CANDLEHOME>
-i <TEMP>\6.2.2.4-TIV-ITM_LFA-IF0007\klo_winnt_tema_if0007.cab

Note: The itmpatch.exe provided with older releases of IBM Tivoli
Monitoring did not support updating 64-bit Windows systems with
32-bit binaries. For 64-bit Windows systems, you must use the
itmpatch.exe provided with this interim fix.

5.3 Remote agent update
----------------------------
1. Transfer the appropriate archive file
(6.2.2.4-TIV-ITM_LFA-IF0007.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 Windows systems, this
path 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 %CANDLE_HOME%\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.2.2.4-TIV-ITM_LFA-IF0007:
> $CANDLEHOME/bin/tacmd addBundles -n
-i <TEMP>/6.2.2.4-TIV-ITM_LFA-IF0007

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

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 lo
-n <Managed system name>
-v 062204070

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 LO
-n <Managed system name>
-v 062204070

Note:
- The component (-t) for the "tacmd updateAgent" command is
specified as two characters (LO), not three characters (KLO).
- 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 the "tacmd 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
superseded fixes. No additional installation steps are required.

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 Windows systems, this path must include
the drive letter.
<TEMP> represents the fully qualified directory specification, where
the fix is located. On Windows systems, this must include 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 LO

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 LO

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

When the agent update is successful, the agent version is:
06.22.04.07.

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

For the agent on Windows systems, the version number is
06.22.04.07.

2. To verify the agent you are running contains the updates from the
fix, see the following lines in the agent log
<hostname>_<productCode>_<instance>_k<productCode>agent_<timestamp>.log:
located in $CANDLEHOME/logs on UNIX systems and
%CANDLE_HOME%\tmaitm6[_x64]\logs on Windows systems.

+4FFB4077.0001 Component: ira
+4FFB4077.0001 Driver: agent_fac_6227:201207030901/4250308.3
+4FFB4077.0001 Timestamp: Jul 3 2012 10:05:06


7.0 Known problems and workarounds
=========================
The following environment variable IncludeEIFEventAttr can be set in
the configuration (.conf) file to re-enable the EIFEvent attribute.

IncludeEIFEventAttr
The agent includes a large attribute called EIFEvent, which is a
representation of the event that would be sent through the Event
Integration Facility if that feature is enabled. This attribute is not
very useful, and its large size has made it problematic, thus it has
been disabled and no value is displayed if viewed on the Tivoli
Enterprise Portal. Setting this value to y, re-enables the EIFEvent
attribute in Tivoli Monitoring.


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.

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

Microsoft, Windows, Windows NT, and the Windows logo 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, or service names may be trademarks or service
marks of others.

Created/Revised by Date of Creation/Update Summary of Changes
LMD June 14, 2011 Created
LMD July 1, 2013 Withdrawn due to APAR IV25184; superseded by current maintenance 6.2.2.4-TIV-ITM_LFA-IF0008

Prerequisites

The prerequisite level for this fix is as follows:

- IBM Tivoli Monitoring, Version 6.2.2: Fix Pack 02 or higher
(6.2.2-TIV-ITM-FP0002)
- Tivoli Log File Agent Version 6.2.2 Fix Pack 4 (CI1JSML)
Interim Fix 01 available from PassPort Advantage,
or
Tivoli Log File Agent Version 6.2.2 Fix Pack 4.

As this fix is cumulative, it can be installed on any fix level for
this version, release, and mod level above the prerequisite.

URL LANGUAGE SIZE(Bytes)
6.2.2-TIV-ITM-FP0002 English 999999

Installation Instructions

Please refer to the full README contained in the Download Description section above for general installation instructions.

Download package


Download RELEASE DATE LANGUAGE SIZE(Bytes) Download Options
What is Fix Central (FC)?
6.2.2.4-TIV-ITM_LFA-IF0008 13 Jul 2012 English 98611200 FC

Product Alias/Synonym

LFA
klo

Problems (APARS) fixed
IV24412, IV22257, IV20604, IV19470, IV17283, IV15874, IV15682, IV12835, IV09148, IV08975, IV08727, IV08075, IV07885, IV07245, IV03898, IV03361, IV02798, IV02796, IV02628, IV01784, IV00828, IZ99777, IZ97359

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Tivoli Monitoring Version 6
Tivoli Log File Agent

Software version:

6.2.2.4

Operating system(s):

AIX, HP-UX, Linux, Linux zSeries, Solaris, Windows

Reference #:

4033027

Modified date:

2013-07-01

Translate my page

Machine Translation

Content navigation