Download
Abstract
This fix pack is a cumulative fix release and addresses APARs and internally found issues since the GA release of OMNIbus 8.1.
Download Description
Known problems and restrictions
===============================
MIB Manager
-----------
After fix pack 1 is installed on AIX operating systems, the MIB Manager
component fails and produces a core dump. To work around this problem:
* Use an existing IBM 32-bit JRE Version 6, or download the latest IBM
32-bit JRE Version 6 from IBM DeveloperWorks. Then, export the NCO_JRE
environment variable to point to that JRE, so that the path is
$NCO_JRE/bin/java. After the environment variable is set, you can run
the ./nco_mibmanager command to start the MIB Manager component.
* Install the Netcool MIB Manager feature on a separate host, that runs an
operating system other than AIX. Then, copy the rules files that are
output by the MIB Manager component from that host to the Tivoli
Netcool/OMNIbus installation.
Process Agent
-------------
In fix pack 1 support for properties files is added to the process agent.
Equivalent properties are provided for all command-line options. A default
properties file is in $OMNIHOME/etc/nco_pa.props.
Restriction: The following properties do not support environment variables
in paths: ConfigFile, PropsFile, RedirectFile, and TicketDir. If you define
a path for these properties that contains an environment variable, the
property does not work as expected. The following example does not work:
ConfigFile: '$OMNIHOME/etc/nco_pa.conf'
Instead, use a path like the following example:
ConfigFile: '/opt/IBM/tivoli/netcool/omnibus/etc/nco_pa.conf'
===============================================================
The following defect solutions are included in this fix pack:
IV55784
If a pre-insert trigger also does an insert into the same table,
the two events can end up with the same Serial value if the
Serial number wraps during the insert. This problem is resolved.
IV56455
The failover thread of a probe running in slave mode in a
peer-to-peer failover setup might hang. This could result in the
probe failing to send events on if it loses contact with the
primary probe of the peer-to-peer pair. It could also result in
unbounded memory growth of the slave probe as it buffers all
events without flushing the buffers. This issue has been fixed.
IV56609
The primary and backup ObjectServers might not resynchronize
properly if the primary ObjectServer fails again before a
resynchronization is complete. This problem has been resolved.
IV59634
A timeout can occur between AEN clients and the ObjectServer when
using a firewall bridge. A new trigger, aen_heartbeat, is added
to automation.sql. To resolve the problem, enable this trigger.
IV59959
The GSKit component used by Tivoli Netcool/OMNIbus is upgraded to
version 8.0.50.20. This is done to address a potential security
problem that is fixed in this version of GSKit.
IV60193
The ObjectServer HTTP/OSLC Interface now uses chunked transfer
encoding to stream large result payloads to HTTP/1.1 clients.
This reduces the amount of memory consumed for these large
responses and improves overall interface performance. Certain
chunking-related features, such as the optimal chunk size, can be
changed if required in the "chunking" section of the server
interface configuration file,
$OMNIHOME/etc/restos/servercfg.json.
IV61491
MIB Manager might fail to import an MIB if the MIB contains
non-ASCII characters and MIB Manager is not running in a UTF-8
locale. The import completes without errors or warnings but the
MIB is not displayed in the 'MIB Modules' tab on MIB Manager.
This problem has been resolved.
IV61642
On shutdown, there was a small chance that the ObjectServer would
dump core. The dump happened after the database files were
written, so there was no risk to data. This problem is fixed.
IV62192
MIBs containing extra spaces failed to import properly resulting
in orphans. This problem has been resolved.
IV62891
The nco_config updates a Boolean column when selected. This
problem has been resolved.
IV63168
Assigning an integer value to a string column in a JSON row set
payload for an ObjectServer table that was sent as part of an
HTTP POST to the servers HTTP interface, caused the server to
crash. This issue is now fixed. The type mismatch is now
correctly handled and a HTTP 400 (Bad Request) is returned with a
JSON error payload to indicate a type mismatch.
IV63169
The JRE installed for use by Netcool/OMNIbus has been upgraded to
7.0 SR7 FP1 (7.0 SR6 FP1 on HP-UX). The security related files
java.security, US_export_policy.jar, and local_policy.jar have
been marked as configuration files so that future updates to the
JRE will retain any changes made to these files. When upgrading
from 8.1.0.0 any changes made to java.security,
US_export_policy.jar, and local_policy.jar will be overwritten.
These changes will need to be reapplied after the installation of
8.1.0.1. If you are upgrading from 8.1.0.0 and have made changes
to java.security, note that the new JRE contains some extra
values for the package.access and package.definition properties.
Take care when reapplying changes to this file. If you need to
roll back to 8.1.0.0 and have made changes to java.security,
US_export_policy.jar, or local_policy.jar you must delete or
rename these files before attempting to roll back.
IV63203
In order to improve consistency between Netcool applications, the
Process Agent (nco_pad) now supports -messagelog, -messagelevel,
and -maxlogfilesize arguments. The additional arguments replace
-logfile, -debug and -logsize arguments which have been
deprecated and will no longer show in the default help text.
Furthermore, support for a properties file has also been added to
nco_pad and a default properties file is supplied
($OMNIHOME/etc/nco_pa.props). All properties in the file are
disabled by default. A -propsfile argument has been added to
nco_pad to enable a properties file path to be specified via the
command line. During startup nco_pad will output server settings
to the message log at information message level.
More details on the new nco_pad properties and arguments can be
found in the IBM Knowledge Centre at:
http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/omnibus/wip/admin/reference/omn_adm_pa_pacmdlineoptions.html
IV63212
RFE 4780: The default Resync.LockType property of Uni-Directional
and Bi-Directional ObjectServer Gateways (nco_g_objserv_uni,
nco_g_objserv_bi) has changed from 'FULL' to 'PARTIAL'.
IV63220
The use of HTTPS communication between the ObjectServer and a
JazzSM registry no longer experiences failures when chunked
encoding is in use. The problem was caused by short reads of data
from the underlying SSL library that was not correctly identified
in the HTTP library. These short reads are now identified and
processed correctly.
IV63222
RFE 19562: Property to disable probe details. A new common
property called DisableDetails and command-line options called
-disabledetails and -enabledetails have been added to
Netcool/OMNIbus probes. You can use these to disable the
generation of alerts details instead of editing rules files
manually.
IV63225
The nco command fails to start on some operating systems. This
problem has been resolved.
IV63228
nco_pad currently uses an older ctime() based timestamp for
messagelog entries and this is inconsistent with the timestamps
generated by applications that use NLog() which have an ISO8601
format. This enhancement updates nco_pad message log to use
ISO8601 and provides an OldTimeStamp property and -oldtimestamp
argument to enable legacy timestamp should they be required.
IV63229
Administrator did not show options for manipulating indexes when
connecting to a V8.1 ObjectServer. This issue has been fixed.
IV63230
During migrations from previous versions to Netcool/OMNIbus V8.1
on UNIX and Linux operating systems, the desktop configuration
files were incorrectly copied to $NCHOME/omnibus/etc instead of
$NCHOME/omnibus/desktop. This issue has been fixed. The desktop
files are now copied to the correct directory.
IV63230
UPGRADE.SH did not migrate over configuration files in
$OMNIHOME/etc/restos or migrate the docroot and uipreview
subdirectories in $OMNIHOME/etc/restos. This is resolved.
IV63234
If a iduc evft command was issued from a temporal trigger, there
was a small chance that a core dump might occur. This issue has
been fixed.
IV63236
If a value outside the range 0 to 65535 is entered in to a port
field in the Initial Configuration Wizard the value is silently
altered to be within the range. The user is now shown an error
message.
If a long installation path is entered into the Initial
Configuration Wizard, the ObjectServer pages might not display
correctly. This issue has been fixed.
When run in text mode the Initial Configuration Wizard did not
limit the length of server names. This has been fixed.
The Initial Configuration Wizard's list of configuration actions
has been reformatted to increase the separation between the
component name and the action.
The Initial Configuration Wizard error messages for 'port in use'
and 'zero port not allowed for the PA' were not displayed
correctly. This has been fixed.
When run in GUI mode the Initial Configuration Wizard would error
when the contents of a required integer port field were deleted.
This has been fixed.
Fixed a minor typo "Netcoo" -> "Netcool" in the Process Agent
edit page.
IV63237
Within MIB Manager, if help content is selected from the menu
items, the expected help files are not displayed. Instead, a
"Topic not found" message is displayed. This issue has been
fixed.
IV63248
If a non-zero IDUC port was specified for an ObjectServer, it was
not set as a command-line argument in the Process Agent
configuration file (nco_pa.conf). This issue has been fixed.
IV63249
The properties dialogue Web GUI Version selection control of the
AEN client, nco_aen, contained only out of support versions of
the Web GUI. This has been updated to contain currently supported
versions.
IV63757
The following Log File Pool properties were added to the default
NCOMS.props file: LogFileUsePool, LogFilePoolSize,
LogFileUseStdErr.
IV63758
Some fields of the Restrict Rows section of the desktop View
Builder did not work correctly. These fields restrict the number
of rows on display in the event list.
Minimum
Maximum
Default
After you entered values in these fields, they defaulted back to
1. The same occurred after you used the arrows to change the
values. This problem has been fixed.
IV63759
After you changed the value of the event_flash_time property in
the ~/.omnibus/prefs file, then event list freezes. This problem
has been fixed.
===============================
MIB Manager
-----------
After fix pack 1 is installed on AIX operating systems, the MIB Manager
component fails and produces a core dump. To work around this problem:
* Use an existing IBM 32-bit JRE Version 6, or download the latest IBM
32-bit JRE Version 6 from IBM DeveloperWorks. Then, export the NCO_JRE
environment variable to point to that JRE, so that the path is
$NCO_JRE/bin/java. After the environment variable is set, you can run
the ./nco_mibmanager command to start the MIB Manager component.
* Install the Netcool MIB Manager feature on a separate host, that runs an
operating system other than AIX. Then, copy the rules files that are
output by the MIB Manager component from that host to the Tivoli
Netcool/OMNIbus installation.
Process Agent
-------------
In fix pack 1 support for properties files is added to the process agent.
Equivalent properties are provided for all command-line options. A default
properties file is in $OMNIHOME/etc/nco_pa.props.
Restriction: The following properties do not support environment variables
in paths: ConfigFile, PropsFile, RedirectFile, and TicketDir. If you define
a path for these properties that contains an environment variable, the
property does not work as expected. The following example does not work:
ConfigFile: '$OMNIHOME/etc/nco_pa.conf'
Instead, use a path like the following example:
ConfigFile: '/opt/IBM/tivoli/netcool/omnibus/etc/nco_pa.conf'
===============================================================
The following defect solutions are included in this fix pack:
IV55784
If a pre-insert trigger also does an insert into the same table,
the two events can end up with the same Serial value if the
Serial number wraps during the insert. This problem is resolved.
IV56455
The failover thread of a probe running in slave mode in a
peer-to-peer failover setup might hang. This could result in the
probe failing to send events on if it loses contact with the
primary probe of the peer-to-peer pair. It could also result in
unbounded memory growth of the slave probe as it buffers all
events without flushing the buffers. This issue has been fixed.
IV56609
The primary and backup ObjectServers might not resynchronize
properly if the primary ObjectServer fails again before a
resynchronization is complete. This problem has been resolved.
IV59634
A timeout can occur between AEN clients and the ObjectServer when
using a firewall bridge. A new trigger, aen_heartbeat, is added
to automation.sql. To resolve the problem, enable this trigger.
IV59959
The GSKit component used by Tivoli Netcool/OMNIbus is upgraded to
version 8.0.50.20. This is done to address a potential security
problem that is fixed in this version of GSKit.
IV60193
The ObjectServer HTTP/OSLC Interface now uses chunked transfer
encoding to stream large result payloads to HTTP/1.1 clients.
This reduces the amount of memory consumed for these large
responses and improves overall interface performance. Certain
chunking-related features, such as the optimal chunk size, can be
changed if required in the "chunking" section of the server
interface configuration file,
$OMNIHOME/etc/restos/servercfg.json.
IV61491
MIB Manager might fail to import an MIB if the MIB contains
non-ASCII characters and MIB Manager is not running in a UTF-8
locale. The import completes without errors or warnings but the
MIB is not displayed in the 'MIB Modules' tab on MIB Manager.
This problem has been resolved.
IV61642
On shutdown, there was a small chance that the ObjectServer would
dump core. The dump happened after the database files were
written, so there was no risk to data. This problem is fixed.
IV62192
MIBs containing extra spaces failed to import properly resulting
in orphans. This problem has been resolved.
IV62891
The nco_config updates a Boolean column when selected. This
problem has been resolved.
IV63168
Assigning an integer value to a string column in a JSON row set
payload for an ObjectServer table that was sent as part of an
HTTP POST to the servers HTTP interface, caused the server to
crash. This issue is now fixed. The type mismatch is now
correctly handled and a HTTP 400 (Bad Request) is returned with a
JSON error payload to indicate a type mismatch.
IV63169
The JRE installed for use by Netcool/OMNIbus has been upgraded to
7.0 SR7 FP1 (7.0 SR6 FP1 on HP-UX). The security related files
java.security, US_export_policy.jar, and local_policy.jar have
been marked as configuration files so that future updates to the
JRE will retain any changes made to these files. When upgrading
from 8.1.0.0 any changes made to java.security,
US_export_policy.jar, and local_policy.jar will be overwritten.
These changes will need to be reapplied after the installation of
8.1.0.1. If you are upgrading from 8.1.0.0 and have made changes
to java.security, note that the new JRE contains some extra
values for the package.access and package.definition properties.
Take care when reapplying changes to this file. If you need to
roll back to 8.1.0.0 and have made changes to java.security,
US_export_policy.jar, or local_policy.jar you must delete or
rename these files before attempting to roll back.
IV63203
In order to improve consistency between Netcool applications, the
Process Agent (nco_pad) now supports -messagelog, -messagelevel,
and -maxlogfilesize arguments. The additional arguments replace
-logfile, -debug and -logsize arguments which have been
deprecated and will no longer show in the default help text.
Furthermore, support for a properties file has also been added to
nco_pad and a default properties file is supplied
($OMNIHOME/etc/nco_pa.props). All properties in the file are
disabled by default. A -propsfile argument has been added to
nco_pad to enable a properties file path to be specified via the
command line. During startup nco_pad will output server settings
to the message log at information message level.
More details on the new nco_pad properties and arguments can be
found in the IBM Knowledge Centre at:
http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/omnibus/wip/admin/reference/omn_adm_pa_pacmdlineoptions.html
IV63212
RFE 4780: The default Resync.LockType property of Uni-Directional
and Bi-Directional ObjectServer Gateways (nco_g_objserv_uni,
nco_g_objserv_bi) has changed from 'FULL' to 'PARTIAL'.
IV63220
The use of HTTPS communication between the ObjectServer and a
JazzSM registry no longer experiences failures when chunked
encoding is in use. The problem was caused by short reads of data
from the underlying SSL library that was not correctly identified
in the HTTP library. These short reads are now identified and
processed correctly.
IV63222
RFE 19562: Property to disable probe details. A new common
property called DisableDetails and command-line options called
-disabledetails and -enabledetails have been added to
Netcool/OMNIbus probes. You can use these to disable the
generation of alerts details instead of editing rules files
manually.
IV63225
The nco command fails to start on some operating systems. This
problem has been resolved.
IV63228
nco_pad currently uses an older ctime() based timestamp for
messagelog entries and this is inconsistent with the timestamps
generated by applications that use NLog() which have an ISO8601
format. This enhancement updates nco_pad message log to use
ISO8601 and provides an OldTimeStamp property and -oldtimestamp
argument to enable legacy timestamp should they be required.
IV63229
Administrator did not show options for manipulating indexes when
connecting to a V8.1 ObjectServer. This issue has been fixed.
IV63230
During migrations from previous versions to Netcool/OMNIbus V8.1
on UNIX and Linux operating systems, the desktop configuration
files were incorrectly copied to $NCHOME/omnibus/etc instead of
$NCHOME/omnibus/desktop. This issue has been fixed. The desktop
files are now copied to the correct directory.
IV63230
UPGRADE.SH did not migrate over configuration files in
$OMNIHOME/etc/restos or migrate the docroot and uipreview
subdirectories in $OMNIHOME/etc/restos. This is resolved.
IV63234
If a iduc evft command was issued from a temporal trigger, there
was a small chance that a core dump might occur. This issue has
been fixed.
IV63236
If a value outside the range 0 to 65535 is entered in to a port
field in the Initial Configuration Wizard the value is silently
altered to be within the range. The user is now shown an error
message.
If a long installation path is entered into the Initial
Configuration Wizard, the ObjectServer pages might not display
correctly. This issue has been fixed.
When run in text mode the Initial Configuration Wizard did not
limit the length of server names. This has been fixed.
The Initial Configuration Wizard's list of configuration actions
has been reformatted to increase the separation between the
component name and the action.
The Initial Configuration Wizard error messages for 'port in use'
and 'zero port not allowed for the PA' were not displayed
correctly. This has been fixed.
When run in GUI mode the Initial Configuration Wizard would error
when the contents of a required integer port field were deleted.
This has been fixed.
Fixed a minor typo "Netcoo" -> "Netcool" in the Process Agent
edit page.
IV63237
Within MIB Manager, if help content is selected from the menu
items, the expected help files are not displayed. Instead, a
"Topic not found" message is displayed. This issue has been
fixed.
IV63248
If a non-zero IDUC port was specified for an ObjectServer, it was
not set as a command-line argument in the Process Agent
configuration file (nco_pa.conf). This issue has been fixed.
IV63249
The properties dialogue Web GUI Version selection control of the
AEN client, nco_aen, contained only out of support versions of
the Web GUI. This has been updated to contain currently supported
versions.
IV63757
The following Log File Pool properties were added to the default
NCOMS.props file: LogFileUsePool, LogFilePoolSize,
LogFileUseStdErr.
IV63758
Some fields of the Restrict Rows section of the desktop View
Builder did not work correctly. These fields restrict the number
of rows on display in the event list.
Minimum
Maximum
Default
After you entered values in these fields, they defaulted back to
1. The same occurred after you used the arrows to change the
values. This problem has been fixed.
IV63759
After you changed the value of the event_flash_time property in
the ~/.omnibus/prefs file, then event list freezes. This problem
has been fixed.
Prerequisites
This fix pack installs on the GA Release of Tivoli Netcool/OMNIbus 8.1.0.
Installation Instructions
Installation
============
IMPORTANT: Before installing this fix, ensure that all Tivoli Network
Management applications on your computer are shut down.
NOTE: Fix Pack FP0001 is not available for Windows, Solaris or Linux s390.
A fresh install of Netcool/OMNIbus on these platforms installs at the 8.1.0 FP0001 level.
Installation Manager
--------------------
Installation manager can be started in GUI mode by running the application:
IBMIM, which can be found in the following locations:
Windows: install_dir\IBM\Installation Manager\eclipse
Linux and UNIX: install_dir/IBM/InstallationManager/eclipse
At any stage if you encounter difficulties using Installation Manager you can consult the built-in help or the latest Installation Manager documentation by searching IBM Knowledge Center at https://www.ibm.com/support/knowledgecenter/SSDV2W/im_family_welcome.html.
Using IBM Passport Advantage(r)
-------------------------------
If your computer has internet access and you have an IBM Passport Advantage account, you can update packages directly from Passport Advantage.
1. Start Installation Manager.
2. Under the Preferences option, select Repositories and make sure the "Search service repositories during installation and updates" is checked.
3. Start the update and select the "IBM Tivoli Netcool OMNIbus" entry from the list of packages to find updates for.
Local Repository
----------------
If you are using a repository which is not on the Passport Advantage site, you must specify the repository in the preferences before you update.
1. Start Installation Manager.
2. Under the Preferences option, select Repositories and add a new repository. Giving the location of your repository.
3. Start the update and select the "IBM Tivoli Netcool OMNIbus" entry from the list of packages to find updates for.
Electronic Software Delivery(ESD) ZIP file
----------------------------------------------
If you have downloaded the ESD for Fix Pack 1 then:
1. Create a directory to store the files and extract the contents on the ZIP file into this.
2. If you have installed Installation Manager using either Administrator or Nonadministrator mode, run the update_console or update_gui script to launch Installation Manager into the update panel without the requirement of configuring the update repository.
3. If the script fails or Installation Manager is installed in Group mode, then you must configure the update repository as in the Local Repository above, with the new repository being the extracted OMNIbusRepository/composite directory.
4. Select the "IBM Tivoli Netcool OMNIbus" entry from the list of packages to find updates for.
============
IMPORTANT: Before installing this fix, ensure that all Tivoli Network
Management applications on your computer are shut down.
NOTE: Fix Pack FP0001 is not available for Windows, Solaris or Linux s390.
A fresh install of Netcool/OMNIbus on these platforms installs at the 8.1.0 FP0001 level.
Installation Manager
--------------------
Installation manager can be started in GUI mode by running the application:
IBMIM, which can be found in the following locations:
Windows: install_dir\IBM\Installation Manager\eclipse
Linux and UNIX: install_dir/IBM/InstallationManager/eclipse
At any stage if you encounter difficulties using Installation Manager you can consult the built-in help or the latest Installation Manager documentation by searching IBM Knowledge Center at https://www.ibm.com/support/knowledgecenter/SSDV2W/im_family_welcome.html.
Using IBM Passport Advantage(r)
-------------------------------
If your computer has internet access and you have an IBM Passport Advantage account, you can update packages directly from Passport Advantage.
1. Start Installation Manager.
2. Under the Preferences option, select Repositories and make sure the "Search service repositories during installation and updates" is checked.
3. Start the update and select the "IBM Tivoli Netcool OMNIbus" entry from the list of packages to find updates for.
Local Repository
----------------
If you are using a repository which is not on the Passport Advantage site, you must specify the repository in the preferences before you update.
1. Start Installation Manager.
2. Under the Preferences option, select Repositories and add a new repository. Giving the location of your repository.
3. Start the update and select the "IBM Tivoli Netcool OMNIbus" entry from the list of packages to find updates for.
Electronic Software Delivery(ESD) ZIP file
----------------------------------------------
If you have downloaded the ESD for Fix Pack 1 then:
1. Create a directory to store the files and extract the contents on the ZIP file into this.
2. If you have installed Installation Manager using either Administrator or Nonadministrator mode, run the update_console or update_gui script to launch Installation Manager into the update panel without the requirement of configuring the update repository.
3. If the script fails or Installation Manager is installed in Group mode, then you must configure the update repository as in the Local Repository above, with the new repository being the extracted OMNIbusRepository/composite directory.
4. Select the "IBM Tivoli Netcool OMNIbus" entry from the list of packages to find updates for.
On
[{"DNLabel":"8.1.0-TIV-NCOMNIbus-AIX-FP0001","DNDate":"22 Sep 2014","DNLang":"English","DNSize":"275142582","DNPlat":{"label":"AIX","code":"PF002"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=8.1.0-TIV-NCOMNIbus-AIX-FP0001&product=ibm%2FTivoli%2FTivoli%20Netcool%20OMNIbus&source=dbluesearch","DNURL_FTP":" ","DDURL":null},{"DNLabel":"8.1.0-TIV-NCOMNIbus-Linux-FP0001","DNDate":"22 Sep 2014","DNLang":"English","DNSize":"269547209","DNPlat":{"label":"Linux","code":"PF016"},"DNURL":"http://www.ibm.com/support/fixcentral/quickorder?fixids=8.1.0-TIV-NCOMNIbus-Linux-FP0001&product=ibm%2FTivoli%2FTivoli%20Netcool%20OMNIbus&source=dbluesearch","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SSSHTQ","label":"Tivoli Netcool\/OMNIbus"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"--","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Problems (APARS) fixed
Problems (APARS) fixed
Was this topic helpful?
Document Information
Modified date:
03 January 2023
UID
swg24037996