IBM Tivoli Netcool OMNIbus 7.2.0 Interim Fix 2 Readme

Name: 7.2.0.2-TIV-NCOMNIbus-IF0002

Installation

UNIX

Enter the following command to install this fix interactively, replacing the arch placeholder with the string identifying your platform:

$NCHOME/install/ncisetup -install 7.2.0.2-TIV-NCOMNIbus-arch-IF0002.jar

Enter the following command to install this fix non-interactively, replacing the arch placeholder with the string identifying your platform:

$NCHOME/install/ncisetup -install 7.2.0.2-TIV-NCOMNIbus-arch-IF0002.jar -silent

Windows

Extract the contents of 7.2.0.2-TIV-NCOMNIbus-win32-IF0002.zip into a temporary location, and double-click setup.exe to install this fix.

Defect solutions

The following defect solutions are included in this release:

7.2.0.2-TIV-NCOMNIbus-IF0002

54373

Previously, the AppDescription field value for an event list was recorded incorrectly in the catalog.connections table when the event list was displayed on a system that had an IPv6 interface. This has been fixed.

56238

Escaped newline characters (\n) used within single quotation marks in rules files resulted in a warning, and the line number was incremented erroneously, leading to incorrect line number references for subsequent errors. Warnings are now only reported for literal newline characters, and the line count remains accurate.

56249

When running tools from the event list, the SQL syntax for the tool can now contain fields that are enclosed in single qutation marks; for example, '@Summary' .

57678

If a pre-update trigger invoked a procedure, and passed a new field value as the parameter to the procedure, the value received by the procedure was the old value. This is now fixed.

57753

Internal code changes have been made to support the gateways that use the libnipc library.

57935

On UNIX, if the local host name and IP address of the local machine were missing from the /etc/hosts file, which was configured to resolve host names, gateways would fail to start. This has been fixed.

7.2.0.2-TIV-NCOMNIbus-FP0002

34618

The File Details window in Netcool/OMNIbus Administrator now includes a check box for writing information to a single file with an unlimited size. If the file size is set to unlimited, the fields for setting the maximum ObjectServer file size and the maximum number of files to create become unavailable.

50163

Users can elect to change the default alignment settings of data displayed in tables within Netcool/OMNIbus Administrator (nco_config). Changing the alignment resulted in an overpaint issue with the text. This issue has been resolved and columns are refreshed as soon as the alignment change is made.

53925

Previously, running probes with a large network timeout value resulted in segmentation faults. This issue has been fixed by restricting the maximum network timeout value to 2147483.

54322

The send message function in Netcool/OMNIbus Administrator can now be used to send a message to multiple AEN clients using multiple channels.

54951

If an event with a severity that had no corresponding color definition was sent to the Accelerated Event Notification (AEN) client, and an attempt was made to view historical information about this event, the Historical Data Viewer window would stop responding. This issue has been resolved, and the AEN client now displays a white color for events with no corresponding severity color.

55259 IZ13939

The Open URL tools for both Windows and UNIX have been updated to handle URLs containing ampersand (&) symbols. Existing ObjectServers must be updated manually because the new versions of the tools will only be included in new ObjectServers that are created using nco_dbinit.



If not already updated, the Open URL tools should be updated as follows. (All quotation marks are double quotation marks.)



UNIX:

$OMNIBROWSER "@URL"



Windows:

start "" "@URL"

55344 IZ14560

During recovery, the ObjectServer no longer generates an error if the ALTER TRIGGER SET GROUP SQL command assigns a trigger to a group that the trigger already belongs to.

55681

In the Properties window of the Accelerated Event Notification client, the Netcool/Webtop server version can now be selected from a drop-down list.

55772 IZ16524

During UNIX authenticaton, the process agent truncated the encrypted password string that was retrieved from the shadow password file. This could lead to core dumps, or failure to authenticate users by using non-default encryption schemes (where the encrypted password entry began with a $). This has now been fixed.

55776

There is no longer a memory leak in nco_pad when an external action is called.

55782

Previously, the failure of a solitary process under process agent control could go unnoticed if the process failed immediately after starting. This has been resolved.

55811 IZ16650

PAM authentication attempts with a blank username now result in a failure rather than causing Process Agent (nco_pad) to hang.

55830

The UNIX Server Editor, nco_xigen, used to fail when the 'Close' button was pressed if all entries had been deleted, and a new entry had been edited, but not saved. This has been fixed.

56259 IZ19171

Previously, the process agent failed to collect host name alias information if no IPv6 interface was defined. The process agent now defaults back to an IPv4 socket to gather this information if an IPv6 socket cannot be opened.

56262

A core dump could occur if an ObjectServer was shut down when external automations were pending. This has been fixed.

56371

The ALTER SYSTEM BACKUP command no longer fails on Windows when a backup file already exists. Previously, the backup command would fail with a "File exists" error occurring in the ObjectServer log file. This error also affected the automatic_backup trigger, preventing it from creating backups on Windows when backup files existed.

56850

Probes previously reported errors when opening include files or lookup tables if multiple HUP signals were sent. This has been resolved.

57216

The ObjectServer now maintains a persistent connection to nco_pad for running external actions. Previously, the connection was created, a single external action's details were passed to nco_pad, and then the connection was closed.



A new command-line argument has been added to nco_pad to control the maximum number of connections:

        -connections  <value>    : Maximum number of connections permitted. (Default:30)
        

57322

The ObjectServer gateways had string handling issues in some locales due to the underlying operating system call not being thread safe. This resulted in errors when handling strings containing characters that needed to be escaped. This has now been fixed.

57526

On Solaris, the open source LDAP/PAM module does not operate correctly when many connections or files are open. The number of connections that the ObjectServer can accept will now increase as required, to prevent this issue.

57690 IZ23329

The ObjectServer failed to replicate a table across a gateway, and an "already registered" ( E-IDU-102-048 ) error message was incorrectly recorded in the ObjectServer log file. This error has been fixed.

7.2.0.1-TIV-NCOMNIbus-FP0001

55108

The ObjectServer's memory usage previously increased when processing commands containing a WHERE condition that compared the string returned by a SQL function with a list comparison operator. The following command is an example of the type of SQL that caused the problem:

SELECT Identifier FROM alerts.status WHERE substr( Node, 1, 2 ) IN ( 'aaaa', 'bbbb');

55112

When using the nco_confpack -import command to import classes, if there are classes with identical class IDs but different class names on the source and target ObjectServer, an ID mismatch error will be raised. To overwrite the class name on the target ObjectServer, use the -force command-line option to suppress the error message.

55248

The ObjectServer no longer core dumps when combining the results of a string function with the NOT LIKE comparison operator.

55285

It is now possible to define a cache filter condition that should be used by an ObjectServer writer when it attempts to refresh its destination table cache at the start of processing a batch of IDUC updates. This filtering is useful in silo-oriented deployemnts where the uni-directional ObjectServer gateway runs locally to the source server. The destination server is a consolidation of events from multiple locations and pulling the cache details for all rows is not really necessary.



The cache filter is set for an ObjectServer gateway by using the table replication definition file, as shown in the following example:



REPLICATE ALL FROM TABLE 'alerts.status'

USING MAP 'StatusMap'

CACHE FILTER 'ServerName IN (\'NCOMS_P\',\'NCOMS_B\')' ;

55287

Both the uni-directional and bi-directional ObjectServer gateways will raise two new signals within the connected ObjectServers to indicate the start and finish of a resynchronisation operation. The two new ObjectServer signals are "gw_resync_start" and "gw_resync_stop", and they provide additional information to an automation about the nature of the ObjectServer's role in the resynchronisation, such as whether it is the master or slave of the operation. Both of the signals have the following signal arguments available within an attached automation:



gateway_name: The name of the gateway that is starting or finishing the resynchronisation; for example, NCO_GATE.



node: The host name of the machine that the gateway is running on.



at: The time at which the resynchronisation was started and finished.



is_master: A boolean that indicates whether the local ObjectServer is the master or slave of the resynchronisation.

55308

The "install-patch-1", "install-patch-2" and "install-patch-3" patches are obsolete and can no longer be installed. This prevents potential issues when installing other patches.

55494 IZ15348

Previously, the use of the following statement in a deduplication trigger caused the internal value of the Serial to be corrupted:



set row old = new;



This has been fixed.

55709

Previously, if a realtime client could not read the IDUC messages sent by the ObjectServer in a timely manner, the send buffer on the ObjectServer would fill up and the send operation would block until the client either resumed reading or was disconnected from the ObjectServer. This has been resolved.

7.2.0.0-TIV-NCOMNIbus-IF0001

53725

Previously, during an nco_confpack export on Windows, a case sensitive match was performed on the file and directory names specified in exclusions.xml file. However, file and directory names on Windows are not case sensitive.



This has been fixed. The match performed for exclusions.xml on Windows platforms is no longer case sensitive.

53752

The ObjectServer migration from 3.6 to 7.2 using UPGRADE.sh was not migrating the Tools database properly. This is now fixed

.

Now the migration of the Tools database is done as follows

:
   -All 7.2 Tools.* tables entries are copied to the migrated ObjectServer
           -Only those Tools.* tables entries from 3.6 will be copied to the migrated objectserver
           which are not present in 7.2 Tools.* tables.
           -If any Tool entry has exactly the same entry in 3.6 and 7.2, only one entry is retained
            from 7.2.
           -If any Tools.* tables entry in 3.6 has the same primary key as the 7.2 entry, but has a
           different actual entry, then that value will be copied into migrated ObjectServer by
           changing primary key value. Changes to the primary key will be logged in the
           nco_os_migrate.log file and related Tools tables will be changed accordingly during
           migration.
        

54382

Before this fix, for some classes with duplicated class names, nco_confpack could only list, export and import one class entry for them. Now all classes on the source ObjectServer can be exported and then imported to the target ObjectServer, regardless of whether their names are duplicated. The list file generated by nco_confpack using the -list option has both Class Id and Class Name for Classes to identify individual classes.

54408 IY88360

The "When" condition clause of a temporal trigger was being stripped out when importing this trigger to a target ObjectServer. This problem has now been fixed. The condition clause is now imported properly.

54432 IZ04401

Probes were logging their encrypted properties in plain text when debug logging was switched on and the log file rolled over. They now log their encrypted properties as "*********".

54435

Encrypted properties and the keyfile property entry could not contain any envronment variables (for example, OMNIHOME) as part of their path. They are now expanded correctly.

54721

Previously, the linux2x86install script would not install the startup service in the correct format for SuSE Linux. This was partly due to specific Red Hat functions being used in the "nco" service script

.

The service script has now been modified to use SuSE specific functions as well as Red Hat ones. The install script now distinguishes between different types of Linux and either includes or discards sections of the "nco" service script based on the type of Linux being used

.

Any lines that are specific to either Red Hat or to SuSE Linux are now enclosed in comment lines as follows

:
   ### REDHAT ONLY
                   <Red Hat specific lines>
                   ...
           ### END REDHAT ONLY
           ### SUSE ONLY
                   <SuSE specific lines>
                   ...
           ### END SUSE ONLY
           Do not nest the "REDHAT ONLY" and "SUSE ONLY" lines.
        

54724

Transient views and filters (created with NCOELCT.EXE) are no longer added to view/filter drop down boxes unless "Keep Window" menu option selected.

54732

The transient event list (nco_elct) now runs on a slow network without issues when other event lists (nco_event) are running.

54740

If a probe connected to an ObjectServer just as the server was starting up or shutting down, the probe could enter SAF mode and not leave it. This has been fixed.

54748

Previously there was a problem with menu options selected from a transient view window that had been launched by NCOElct on Windows. If, for example, the freeze option was selected from the pull down menu, the Event List would crash and need restarting. All pull down menu options now work correctly from the transient view.

54785

The nco_g_tivoli_eif gateway was failing to start due to a race condition. This has been fixed. Also fixed was an issue whereby gateway watch messages occasionally caused the gateway to fail.

54825 IY88442

The UNIX Filter Builder has been extended to allow more advanced conditions to be created. The Filter Builder allows the construction of predicates of different levels of complexity. The existing 'Simple' and 'Complex' types are restricted to predicates of the form 'ColumnName operator expression'. The new 'Freeform' type permits you to enter an arbitary predicate. This allows the advanced features of the v7 ObjectServer SQL to be used. As each predicate is edited, it is validated by the ObjectServer. Individual predicates are built into a complete condition as before.

54829

When running most components on AIX 6.1, the following error was generated

.

"Error: Unknown target platform : AIX

Using the default program setting."



This has now been fixed.

54881 IY88367

In the Unix Event List, when the user attempted to perform a significantly large command, such as deleting 30,000 events, the Event List would disconnect and the tool would not run

.

This was due to the use of a fixed-size memory pool for Sybase connections in the Event List. When a tool is used that is too large to fit into the memory pool, a memory error occurs

.

The use of a memory pool has been disabled by default. The system now supplies the Event List's memory requirements. If necessary, the memory pool can be reactivated by setting the NCO_MEM_POOL_SIZE environment variable to a minimum of 1048576 (1 megabyte).

54892 IY88442

The UNIX Filter Builder has been extended to allow more advanced conditions to be created. The Filter Builder allows the construction of predicates of different levels of complexity. The existing 'Simple' and 'Complex' types are restricted to predicates of the form 'ColumnName operator expression'. The new 'Freeform' type permits you to enter an arbitary predicate. This allows the advanced features of the v7 ObjectServer SQL to be used. As each predicate is edited, it is validated by the ObjectServer. Individual predicates are built into a complete condition as before.

54900

nco_igen did not run on AIX 6 unless the '-arch' option was specified. nco_igen will now run without this option, and will create $NCHOME/etc/interface.aix5 which is still used by other programs.

55038

The filter builder no longer drops the last item from the IN list within SQL statements.

55074

This bug occurred when a probe was connected to a failover ObjectServer pair and was configured such that SAF and polling were enabled. If the primary ObjectServer went down then the probe would crash when receiving a HUP signal. In the fixed version, it now correctly reloads its rules files when connected to the backup server as well as the primary server.

55084

This fixes a rare condition in the process agent (PA) logging system. If an external process of the PA logged a message to the PA's log file at the exact point that it rolls over, the PA would continue to write to the "_old" log file instead of the new log file. This would continue to happen until the system's maximum file size was reached, at which point the PA would crash. This no longer happens.

Package versions

nco_libOpl5.10.37
nco_libnobjserv5.10.29
nco_libniduc_client5.10.27
nco_libnauto5.10.33
nco_libnetcool5.10.36
nco_os_migrate5.10.27
nco_objserv5.10.33
nco_administrator5.10.34
nco_proxyserv5.10.27
nco_libDaemon5.10.27
nco_desktop_dll5.10.27
nco_libngtk5.10.37
nco_g_crypt5.10.33
nco_omnibus_scripts5.10.29
nco_libnstore5.10.33
nco_libniduc_server5.10.36
nco_store_resize5.10.33
nco_dbinit5.10.36
nco_elct5.10.37
nco_libnproc5.10.37
nco_libnmemstore5.10.31
nco_libngobjserv5.10.36
nco_libnipc5.10.37
nco_eventlist5.10.27
nco_conductor5.10.27
nco_check_store5.10.33
nco_patching5.10.29
nco_crypt5.10.33
nco_g_objserv_uni5.10.37
nco_libnregion5.10.34
nco_g_objserv_bi5.10.37
nco_confpack5.10.29
nco_get_login_token5.10.33
nco_libnsecurity5.10.36
nco_libncmd5.10.37