IBM Tivoli Monitoring Agent Builder Language Package 6.3.5-TIV-ITM_ABLDR-LP0001

Download Description

Copyright International Business Machines Corporation 2018.
All rights reserved.

Component: IBM® Tivoli® Monitoring Agent Builder, Version 6.3.5

Component ID: 5724C04BR

Language Pack Fix: 0001, 6.3.5-TIV-ITM_ABLDR-LP0001

Date: May 30, 2018

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 Copyright and trademark information
10.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: IJ05369
Abstract: JAPANESE APPLICATION SUPPORT FILE IS INCORRECT AND FAILS TO
INSTALL
Additional information:
Generating an agent with the Agent Builder Japanese Language
Pack installed, results in a k<pc>_resources.jar, where <pc> is
the product code of the agent, with no class files.

Application support installation may complete without a visible
error. However, after installing the TEMS and TEPS support for
the agent results in one of the following symptoms:

1. The Tivoli Enterprise Portal displays the internal keys of
the attribute group names.
2. The Java Web Start portal fails to start up.
3. Attribute Group and Attribute items of the agent do not
match in Situation Editor.

Reviewing the TraceKQZ.log in the Agent Builder workspace
.metadata\tivoli\KQZ\logs directory, you can see that an error
occurred when compiling the application support because a
unicode character is split/truncated, when the line is continued
to the next line.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
...

2018-03-22T16:19:26.968-04:00] - MID - 9 - ModalContext -
com.ibm.tivoli.monitoring.util.ProcUtil.runProcess - Entry,
parm 1 = C:\Program Files
(x86)\IBM\AgentBuilder_635\jre\bin\javac
[2018-03-22T16:19:27.665-04:00] - MIN - 9 - Thread-17 -
com.ibm.tivoli.monitoring.util.ProcUtil$StreamHandler.logLines
- C:\Program Files (x86)\IBM\AgentBuilder_635\jre\bin\javac
stderr

??: [options] ???????????????? -source 1.4 ?????????????
??: [options] ???? 1.4 ????????????????????
??: [options] ?????? 1.4 ????????????????????
??: [options] ?????????????????????????-Xlint:-options ???????

C:\PMRS\k19\ira\agent\common\odi2rb\package\candle\k19\resources
\K19Bundle.java:53: ???: Unicode ???????????????
{ K191008,
"\u300c\u30d1\u30d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u3
0d6\u30b8\u30a7\u30af\u30c8\u72b6\u6cc1\u300d\u5c5e\u6027\u30b0\
u30eb\u30fc\u30d7\u306b\u306f\u4ed6\u306e\u5c5e\u6027\u30b0\u30e
b\u30fc\u30d7\u306e\u72b6\u6cc1\u3092\u53cd\u6620\u3059\u308b\u6
0c5\u5831\u304c\u542b\u307e\u308c\u3066\u3044\u308b\u305f\u3081\
u3001\u3053\u306e\u30a2\u30d7\u30ea\u30b1\u30fc\u30b7\u30e7\u30f
3\u3092\u69cb\u6210\u3059\u308b\u3059\u3079\u3066\u306e\u30d1\u3
0d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u30d6\u30b8\u30a7\
u30af\u30c8\u306e\u72b6\u6cc1\u3092\u307e\u3068\u3081\u3066\u4e0
0\u62ec\u8868\u793a\u3059\u308b\u3053\u3068\u304c\u3067\u304d\u3
07e\u3059\u3002\u3053\u308c\u3089\u306e\u4ed6\u306e\u30d1\u30d5\
u30a9\u30fc\u3" +
^^ (Half a unicode character preceding quote)
C:\PMRS\k19\ira\agent\common\odi2rb\package\candle\k19\resources\
K19Bundle.java:55: ???: Unicode ???????????????
"\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306e\u72b6\u6cc1\u306b\u3
06f\u3001\u305d\u306e\u5c5e\u6027\u30b0\u30eb\u30fc\u30d7\u306b\
u3064\u3044\u3066\u306e\u6700\u5f8c\u306e\u30c7\u30fc\u30bf\u53c
e\u96c6\u306e\u8a66\u884c\u7d50\u679c\u304c\u53cd\u6620\u3055\u3
08c\u308b\u305f\u3081\u3001\u30a8\u30fc\u30b8\u30a7\u30f3\u30c8\
u304c\u30c7\u30fc\u30bf\u53ce\u96c6\u3092\u6b63\u3057\u304f\u5b9
f\u884c\u3057\u3066\u3044\u308b\u304b\u3069\u3046\u304b\u3092\u7
8ba\u8a8d\u3067\u304d\u307e\u3059\u3002\u4ed6\u306e\u5c5e\u6027\
u30b0\u30eb\u30fc\u30d7\u3068\u306f\u7570\u306a\u308a\u3001\u300
c\u30d1\u30d5\u30a9\u30fc\u30de\u30f3\u30b9\u30fb\u30aa\u30d6\u3
0b8\u30a7\u30af\u30c8\u72b6\u6cc1\u300d\u5c5e\u6027\u30b0\u30eb\
u30fc\u30d7\u3"
^^
[2018-03-22T16:17:23.556-04:00] - MIN - 9 - Thread-11 -
com.ibm.tivoli.monitoring.util.ProcUtil$StreamHandler.logLines -
C:\Program Files (x86)\IBM\AgentBuilder_635\jre\bin\javac
stderr
??? 2 ?
?? 4 ?

[2018-03-22T16:17:23.559-04:00] - MID - 9 - ModalContext -
com.ibm.tivoli.monitoring.util.ProcUtil.runProcess - Exit,
return value = 1
....

[2018-03-22T16:19:33.737-04:00] - MIN - 9 - Thread-18 -
com.ibm.tivoli.monitoring.util.ProcUtil$StreamHandler.logLines
- C:\Program Files
(x86)\IBM\AgentBuilder_635\jre\bin\jarsigner.exe stdout
jarsigner: jar????????: java.io.IOException: DER input not a
UTF8 string
...
- - - - - - - - - - - - - - - - - - - - - - - - - - - -- - -
In the K<pc>Bundle.java generated by the builder, which is
located in the agent package in
...\ira\agent\common\odi2rb\package\candle\k<pc>\resources,
you can see where the "Performance Object Status" strings are
broken into pieces and split in the middle of a UNICODE
character (see above ^^)

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

None.

2.3 Superseded fixes
-------------------------
None.

2.4 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 Agent Builder User's Guide, version 6.3.5.

3.1 Prerequisites for this fix
--------------------------------
The prerequisite level for this fix is as follows:

IBM Tivoli Monitoring V6.3.5 Agent builder, which is available
from PassPort Advantage under the following eAssembly:

* IBM Tivoli Monitoring V6.3.5 Agent Builder, English,
Multiplatform (CNL8RML)
* IBM Tivoli Monitoring V6.3.5 Agent Multiplatform Multilingual
eAssembly (CNL8QML).


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

- 6.3.5-TIV-ITM_ABLDR-LP0001.README - This README file
- 6.3.5-TIV-ITM_ABLDR-LP0001.tar - Fix archive .tar format

Note: Use the .tar file if you are working in a Windows or UNIX
environment.

The fix archive file contains the following files:
- ablpinstaller.bin
- ablpinstaller.exe
- agentbuilder_lp_201804240154.jar


5.0 Installation instructions
==================
This fix applies to an Agent Builder, version 6.3.5 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.

- Stop the builder, if it is currently running.

5.2 Language pack update
--------------------------
1. Transfer the archive file 6.3.5-TIV-ITM_ABLDR-LP0001.tar
to a temporary directory on the system where Agent Builder
is installed. Then expand the archive file.

2. Run "ablpinstaller.exe" on Windows environment or "ablpinstaller.bin"
on Linux environment.

2.1 Select "Remove" if the language package is already installed with
Agent Builder in the environment.
2.2 Select "Add/Update" to install the language package.

The default Agent Builder installation location on Windows
systems is "C:\Program Files\IBM\ITM\AgentBuilder"
and on UNIX systems, it is "/opt/IBM/ITM/AgentBuilder".

3. If the builder was running when the update was installed, you may
restart the builder.

4. Use the Generate Agent Wizard to regenerate your agents and then
re-install the agent.

6.0 Additional installation information
========================

6.1 Verifying the update
----------------------------
1. In the builder, select Help->About IBM Tivoli Monitoring Agent
Builder and select the "Installation Details" button. Select the
"Feature Id" tab. Select "com.ibm.agentbuilder.langpack.ja" Feature Id
and Click "Plug-in Details" button.

1. Plug-in Name: Agent Generator Runtime
Version: 6.3.5.v201804240154
2. Plug-in Name: IBM Agent Builder Native Code
Version: 6.3.5.v201804240154
3. Plug-in Name: Fragment.Name and Plug-in Id starts with "com.ibm.tivoli"
Version: 6.3.5.v201804240154

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


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

9.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.


10.0 Notices
=======

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.

Microsoft, Windows, and Windows Server are trademarks of Microsoft
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.

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

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.