Download
Abstract
This fix pack is a cumulative fix release and addresses some new APARs and internally found issues since the release of Tivoli Netcool/OMNIbus Web GUI 8.1.0
Download Description
Issues and Enhancements addressed in 8.1.0.1 FP1
===================================================
This fix pack supports Safari 6.1 and Internet Explorer 11.
Enhancements
----------------
alm00310801 / IV63108
.....................
Short Description: ADDITION OF A NEW DYNAMIC WATCH LISTS ENHANCEMENT
Summary:
There should be a way to easily move alerts into a temporary filter directly from the event viewer. This should support the following features:
1. Creating watch list filters based on existing alerts (i.e. based on node, alert group, summary) which include all future alerts of a similar form.
2. Display of all accessible watch list filters on a dynamically generated map.
3. Ability to delete watch lists from the event viewer.
4. Ability to create watch lists on a user or group level.
5. Ability to set an expire time for watch list filters.
This enhancement request originates from an RFE submitted to
http://www.ibm.com/developerworks/rfe/execute?use_case=viewRfe&CR_ID=25368
alm00310799 / IV63104
.....................
Short Description: ADDITION OF AN ALERT QUICK FILTERING ENHANCEMENT TO THE EVENT VIEWER
Summary:
There is currently no way to quickly filter or search the currently displayed event list based on a custom search string. A feature should be implemented which allows the operator to instantly filter the event list based on an entered string of text.
Defects
-----------
alm00308847 / IV61062
.....................
Short Description: WEBGUI TABLEVIEW SMARTPAGE COMMAND DOES NOT USE THE DATASOURCE PARAMETER
Summary:
When a smartpage is created using the TABLEVIEW command the parameter to specify the datasource is ignored.
If there are multiple datasources the default datasource is used and changing this setting does not change the used datasource.
If the default datasource is NCOMS and there is a datasource called RSCOMS the following will not use this datasource, while this is what should happen and is desired.
<!--
insert:TABLEVIEW[filtername="AllEvents",filtertype="global",data
source="RSCOMS",maxrows="2"] -->
alm00311747/ IV64569
.....................
Short Description: EVENT DASHBOARD ERROR WHEN TRY TO DISPLAY FILTER FROM GROUP NAME WITH SPACE
Summary:
Event Dashboard error when try to display filter from group name which space
alm00312192 / IV65075
.....................
Short Description: FILTER BUILDER BUTTONS MISSING IF USING IE11
Summary:
Filter Builder buttons ("Save and Exit", "Save", "Cancel") are missing when browser IE11 is used.
alm00295723 / IV43485
.....................
Short Description: SQL PARSER IN WEBGUI ISSUE
Summary:
There is an issue with the SQL parser in Web GUI which is easily reproducible by executing the following GET requests:
1) Register the filter https://localhost:16411/ibm/console/webtop/TransientFilterRegisterServi… IN(123,345))&forceoverwrite=true&type=filter&format=xml
2) Get the filter status https://localhost:16411/ibm/console/webtop/EventDataService?filtername=…
alm00301979 / IV52572
.....................
Short Description: NEWLY CREATED USER CAN'T EXECUTE SQL TOOLS IN AEL UNTIL OS RESYNC HAPPEN.
Summary:
Newly created Web GUI User (with all role) unable to Acknowledge or any other SQL tools on events in AEL although Web GUI is using Object Server as users repository. Unless OS-resync happen via waapi or auto re-sync happen.
alm00305114 / IV56253
.....................
Short Description: UNABLE TO HANDLE FIELD="" FOR RIGHT-CLICK TOOL
Summary:
When AlertGroup="" and try to launch keyword count tool, an error will occur: An error occurred during parameter conversion. The same error happens if we customise the tool with additional field where the field is also empty. The above issue affected 2 tools (Keywords with search filter, Search for similar events).
alm00307650 / IV59986
.....................
Short Description: TRANSIENT FILTERS NOT HANDLING INTERNATIONAL CHARACTERS WHEN USING INTERNET EXPLORER
Summary:
When an AEL is launched with a transient filter (not pre-defined in the Filter Builder) using the IE browser, any international characters in the string will not be handled/matched. This could be seen, for example, by creating a Javascript tool that launches a new TIP page containing an AEL and specifies a filter that the AEL should load.
alm00308904 / IV61098
.....................
Short Description: FIRST AND LAST NAMES ARE NOT DISPLAYED CORRECTLY IN USER LIST WHEN COMMA IS PRESENT
Summary:
When customer creates a new user on TIP GUI and includes comma character in the first or last names, the names are not displayed correctly in TIP user list. The user repository used is ObjectServer.
alm00309393 / IV61617
.....................
Short Description: WEB GUI DATA PROVIDER SHOULD HIDE UNSUPPORTED TOOL TYPES
Summary:
In the Web GUI (CURI) data provider, all "events" datasets contains task definitions, which results in a right-click menu appearing when the dataset is populating a TWL widget in DASH, such as a table widget. The right-click menu represents the Web GUI "alerts" menu.
However, TWL table widgets do not support all the different tool types which Web GUI Event Viewer supports. Examples of tools which will not work in a TWL widget are command tools, and prompted tools. Such tasks should be removed from the menu so that they are not available, unless using Event Viewer.
alm00309395 / IV61622
.....................
Short Description: UNABLE TO DISPLAY GAUGE WITH WEIGHTED AVERAGE METRICS
Summary:
Guage page displays an error message: An error occurred during processing of Metric Data Service Request: null.
When one of the Metrics defined was using "Weighted Average" function and the Gauge portlet is configured with Multiple Data Source Function.
alm00309397 / IV61623
.....................
Short Description: FIXED CHOICE PROMPT WITH NON-UNIQUE LABEL/VALUE CHOICES RESULTS IN UNEXPECTED OUTPUT
Summary:
When configuring Fixed Choice prompt with non-unique values provided for either the label or the value choices, the resulting output in the Event Viewer shows a single menu item for the non-unique label at the bottom of the choices list.
alm00309552 / IV61742
.....................
Short Description: THREAD COUNT KEPT INCREASING WHEN WEBGUI FAILS TO CONNECT TO FAILOVER OBJECTSERVER PAIR
Summary:
Web GUI thread count kept increasing when Primary and Backup ObjectServer pair are both unreachable. netstat output does not show any connection in TIME_WAIT state.
The issue does not occur if either ObjectServer is up or in a stand-alone ObjectServer configuration.
alm00309813 / IV61999
.....................
Short Description: EVENTVIEWER.JSP URL DECODING OF QUERY PARAMETERS DOES NOT CORRECTLY DECODE '+' CHARACTERS TO SPACES.
Summary:
In order to close a JavaScript injection issue with the eventViewer.jsp page (and other JSP pages for the AEL, etc) a change has been made in the extraction and decoding of query parameters.
alm00246976 / IV04057
.....................
Short Description: AEL SIZING AND COLUMS RESET BACK TO DEFAULT
Summary:
When changing the column size or relocating a column/s to a new location within the AEL, it resets the sizing and column arrangement back to the default after a while. This happens when configuration changes occur at Web GUI triggers AEL config resync with the server. AEL refreshes the view even when there are no changes made to the view associated with the AEL.
Prerequisites
This Fix Pack requires 8.1.0.0 GA release
Installation Instructions
1. IBM Tivoli Netcool/OMNIbus Web GUI 8.1 Fix Pack Installation Instructions
============================================================================
This fix pack supports Safari 6.1 and Internet Explorer 11.
This section shows how to install the Fix Pack for IBM Tivoli Netcool/OMNIbus Web GUI 8.1. It is strongly recommended to perform a manual backup of the current JazzSM and Web GUI before the installation of this fix pack. The steps for doing this manual backup are provided in section (4). So that, a restore can be performed, in case an issue occurred during applying this fix pack. The steps for doing this manual restore are provided in section (5).
Note: See the section (3) for special instructions about how to apply fix packs in a load balancing environment.
1.1 Terminology:
----------------
These instructions use the following terms to refer to directories used during
installation:
<JazzSM_HOME> Refers to the directory where Jazz for Service Management is installed.
Examples:
/opt/IBM/JazzSM on UNIX systems.
C:\Program Files\IBM\JazzSM on Windows systems.
<DASH_HOME> Refers to the directory where the user interface of Jazz for Service Management is installed.
Examples (on UNIX systems):
<JazzSM_HOME>/ui on UNIX systems.
<OMNIBUS_WEBGUI> Refers to the directory where Netcool/OMNIbus Web GUI 8.1 is installed.
Examples:
/opt/IBM/netcool/omnibus_webgui on UNIX systems.
C:\IBM\netcool/omnibus_webgui on Windows systems.
<FP_dir> Refers to the temporary directory where you extract the contents of the fix pack's archive.
<REPOSITORY_GA> Refers to the repository of Web GUI 8.1.
<REPOSITORY_FP> Refers to the delta and serviceDelta repositories of this fix pack.
Examples (on UNIX systems):
<FP_dir>/OMNIbusWebGUIRepository/delta/repository.config
<FP_dir>/OMNIbusWebGUIRepository/serviceDelta/repository.config
1.2 The way to install this fix pack:
-------------------------------------
The media (zip) file of this fix pack includes the update pack and the tools for Linux & AIX only. These medias can be downloaded and extract to <FP_dir>.
a. Install Web GUI 8.1 (not GA in June 2014 version) together with this fix pack
The update pack can be used with the 8.1 installation media to create a new installation. For instance, use Installation Manager to configure the "Preference", to add and select both <REPOSITORY_GA> and <REPOSITORY_FP> repositories, and then click "Install".
b. Update an existing Web GUI 8.1 (not GA in June 2014 version) installation to 8.1 Fix Pack
The update pack can be used to update an existing installation, but not for customers with the installed Web GUI 8.1 that was GA in June 2014 on Linux/AIX platforms.
For instance, use Installation Manager to configure the "Preference" to add and select only <REPOSITORY_FP> repositories, and then click "Update".
c. Update an existing Web GUI 8.1 (GA in June 2014 version) installation to 8.1 Fix Pack.
Note: Do not remove/uninstall JazzSM during this process.
1. Use the provided tools to create preservation zip files on Linux/AIX.
The tool (e.g. <FP_dir>/tools/backupGA.sh) provided in Linux and AIX fix packs can be used to create the temporary files (e.g. <JazzSM>/ui/temp/*.zip), before an immediate reinstall of Netcool/OMNIbus Web GUI. These configuration and data will be preserved when uninstall the (current version) Netcool/OMNIbus Web GUI, and automatically restored after the next installation of Netcool/OMNIbus Web GUI.
This tool must be executed by the same user, who installed Web GUI 8.1. it is specifically designed and supported for customers with the installed Web GUI 8.1 that was GA in June 2014 on Linux/AIX platforms only, in order to update to a new Web GUI 8.1 (not GA in June 2014 version) or Web GUI 8.1.0.1 FP1.
The usage of this tool:
<FP_dir>/tools/backupGA.sh -dash <DASH_HOME> -webgui <OMNIBUS_WEBGUI>
For examples, with the default install directories on a Linux/AIX system
<FP_dir>/tools/backupGA.sh -dash /opt/IBM/JazzSM/ui -webgui /opt/IBM/netcool/omnibus_webgui
2. Manual backup of Web GUI 8.1 (GA in June 2014 version), see section (4)
3. Uninstall Web GUI 8.1 (GA in June 2014 version), see section (7)
4a. Install Web GUI 8.1 (not GA in June 2014 version), and follow section (2)
or
4b. Install Web GUI 8.1 (not GA in June 2014 version) together with this fix pack, as mentioned in section 1.2 (a)
Addition notes:
---------------
- A roll back to previous versions, will be available if "update" facility was used, rather than "install" from the Installation Manager.
- In GUI mode, the launch page to Post-installation configuration tool will not be available for an update, and will be available for a new install.
- If the steps in section 1.2 (c) were not followed, when update an existing Web GUI 8.1 (GA in June 2014 version) installation to 8.1 Fix Pack. A recovery from the outcome would be perform one of the followings:
(a) manual restore, see section (5)
(b) uninstall the Web GUI, see section (7)
2. Update an existing Web GUI 8.1 installation to Web GUI 8.1 Fix Pack
======================================================================
The update of the existing Netcool/OMNIbus Web GUI, includes the in-place upgrade that would preserve the current configuration and data. In case of an issue occurred that cannot be resolved, a manual restore back to a pre-fix pack state may be needed, see section (5), thus a manual backup is strongly recommended for this purpose, see section (4).
After the update installation over an existing installation, there won't be a launch page to execute the post-installation configuration tool. This is working as designed because the configuration is not required and already preserved.
After a successful update installation, a roll back to a previous Netcool/OMNIbus Web GUI version will be supported, where the current configuration and data will be preserved. Note: This is not necessarily the same as pre-fix pack state.
2.1 Before you begin
--------------------
1. Extract all the files from the OMNIbus-v8.1.0-WebGUI-FP1-IM-<platform>-UpdatePack.zip
archive into a temporary directory (the <FP_dir> directory).
o <platform> is a code for the operating system of the machine where you are installing the fix pack.
2. Please backup the existing version before installing this fix pack, see section (4)
2.2 Updating using the GUI
--------------------------
1. Change to the "eclipse" sub-directory of the Installation Manager installation directory and use the following command to start Installation Manager:
o UNIX / Linux: ./IBMIM
o Windows: IBMIM.exe
2. Configure Installation Manager to install from your extracted archive:
a. From the main menu, choose "File" > "Preferences".
b. In the Preferences windows, select the "Repositories" panel.
c. Click "Add Repository...".
d. Click "Browse..." and browse for <FP_dir>/OMNIbusWebGUIRepository/delta/repository.config
e. Click "OK".
f. Repeat steps d-e for the <FP_dir>/OMNIbusWebGUIRepository/serviceDelta/repository.config
repository.
g. Click "OK".
3. From the main menu, click "Update".
4. Select the package group (e.g. IBM Netcool) which contains the installation of Netcool/OMNIbus Web GUI you wish to update, then click "Next".
5. Select the version you wish to update.
6. Click "Next".
7. Accept the terms in the license agreements, and click "Next".
8. Select the optional features you want in your updated installation.
9. Specify the required details (for each panel prompted), and click "Next".
10. Review the summary information, and click "Update".
2.3. Updating using the console
-------------------------------
1. Change to the "eclipse/tools" sub-directory of the Installation Manager installation directory
and use the following command to start Installation Manager:
o UNIX / Linux: ./imcl -c OR ./imcl -consoleMode
o Windows: imcl.exe -c
2. Configure Installation Manager to install from your extracted archive:
a. Select "Preferences".
b. Select "Repositories".
c. Select "Add Repository".
d. Enter <FP_dir>/OMNIbusWebGUIRepository/delta/repository.config as the location.
e. Repeat steps c-d with <FP_dir>/OMNIbusWebGUIRepository/serviceDelta/repository.config as the
location.
f. Select "Apply Changes and Return to Preferences Menu", then "Return to Main Menu".
3. Select "Update" from the main menu.
4. Follow the installer instructions to complete the update.
2.4. Updating silently
----------------------
1. Pre-requisites
a. Create or record an Installation Manager response file.
b. Read the license agreement. The license agreement file, license.txt, is stored in the /native/license_version.zip archive, which is contained in the installation package.
2. Change to the "eclipse/tools" sub-directory of the Installation Manager installation directory.
3. Use the following command to update the Web GUI:
o UNIX / Linux: ./imcl -input response_file -silent -acceptlicense [-log full_path_to_log_file]
o Windows: imcl.exe -input response_file -silent -acceptlicense [-log full_path_to_log_file]
Where response_file is the directory path to the response file and full_path_to_log_file is the location in which the installation log is created.
3. Instructions for installing IBM Tivoli Netcool/OMNIbus Web GUI 8.1 FP in a load balancing environment
========================================================================================================
Before updating each Web GUI installation, you must make sure that the corresponding node is removed from the load balancing cluster.
1. Remove the first node from the load balancing cluster.
a. Remove the node. For more information about how to do this, see
http://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.3/com.ibm.psc.doc_1.1.0.3/tip_original/ttip_config_ha_unjoin.html
b. Remove the load balancing information of the node from the configuration database of the cluster.
For more information about how to do this, see
http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/webtop/wip/task/web_con_loadbal.html
Important: After the first node is disjoined, avoid making any changes to the load balancing environment other than the steps in these instructions.
2. Update the Web GUI on the node.
3. Verify that the patched, disjoined node is working as expected.
4. Remove each of the remaining nodes from the load balancing environment by following step 1 above for each node in turn. For the last node use the 'uninstall' command; for more information see
http://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.3/com.ibm.psc.doc_1.1.0.3/tip_original/ttip_config_ha_end.html
5. Rejoin the patched first node to the load balancing environment:
a. Join the node to the cluster. For more information about how to do this, see
http://www-01.ibm.com/support/knowledgecenter/SSEKCU_1.1.0.3/com.ibm.psc.doc_1.1.0.3/tip_original/ttip_config_ha_join.html
b. Start load balancing operations on the node. For more information about how to do this, see
http://www-01.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/webtop/wip/task/web_con_loadbal.html
6. Update the Web GUI on one of the disjoined nodes.
7. Verify that the patched, disjoined node is working as expected.
8. Rejoin the upgraded node to the load balancing environment by following step 5.
9. Repeat steps 5-8 for each node that was removed from the load balancing environment.
Important: To avoid long periods of down-time; ensure the first node is patched and ready to rejoin to the load balancing environment before the final node is removed.
4. Recommended backup procedure of the current Web GUI install, a pre-fix pack state
====================================================================================
Important: The paths referenced in these steps are for a default install. Ensure the correct paths are used for the Web GUI instance being backed up.
1. Ensure that all users are logged out of the Web GUI.
2. Stop the WebSphere Application Server.
3. Back up the existing installation:
o For UNIX operating systems
Use a suitable archive utility to compress the content of the following directories, and copy to a secure place:
___________________________________________________________________________
| Directory | Backup filename |
--------------------------------------------------------------------------|
| /opt/IBM/netcool/omnibus_webgui | omnibus_webgui.tar |
| /opt/IBM/JazzSM | JazzSM.tar |
| /opt/IBM/WebSphere/AppServer | AppServer.tar |
|-------------------------------------------------------------------------|
o For Windows operating systems
Use a suitable archive utility to compress the content of the following directories, and copy to a secure place:
___________________________________________________________________________
| Directory | Backup filename |
--------------------------------------------------------------------------|
| C:\IBM\netcool\omnibus_webgui | omnibus_webgui.zip |
| C:\Program Files\IBM\JazzSM | JazzSM.zip |
| C:\Program Files (x86)\IBM\WebSphere\AppServer | AppServer.zip |
|-------------------------------------------------------------------------|
5. Restoring a Web GUI install after applying this fix pack, to a pre-fix pack state
====================================================================================
This method can be used if the roll-back process fails. This would roll back to a pre-fix pack state, the backed-up instance as created by follow the instruction in section (4).
1. Stop the Websphere Application Server.
2. Rename the Web GUI, JazzSM and Websphere Application Server directories as follows:
Example:
o On UNIX and Linux:
mv /opt/IBM/netcool/omnibus_webgui /opt/IBM/netcool/omnibus_webgui.old
mv /opt/IBM/JazzSM /opt/IBM/JazzSM.old
mv /opt/IBM/WebSphere /opt/IBM/WebSphere.old
o On Windows:
rename C:\IBM\netcool\omnibus_webgui C:\IBM\netcool\omnibus_webgui.old
rename C:\Program Files\IBM\JazzSM C:\IBM\JazzSM.old
rename C:\Program Files (x86)\IBM\WebSphere C:\IBM\WebSphere.old
3. Use a suitable archive utility to restore the content of the following files to their original locations:
o On UNIX and Linux:
omnibus_webgui.tar
JazzSM.tar
AppServer.tar
o On Windows:
omnibus_webgui.zip
JazzSM.zip
AppServer.zip
4. Start the WebSphere Application Server.
6. Rolling back using Installation Manager
==========================================
This method can be used if the fix pack was installed by using the "update" facility provided by Installation Manager. This would roll back to the previous Web GUI version with current configuration and data preserved.
1. Change to the "eclipse" sub-directory of the Installation Manager installation directory and use the following command to start Installation Manager:
o UNIX / Linux: ./IBMIM
o Windows: IBMIM.exe
2. Select "Roll Back" from the main menu.
3. Select the package group within which you installed the Web GUI and click "Next".
4. Select the version of the package to roll back to.
5. Read the summary information and click "Roll Back" to roll back the package.
7. Uninstall Web GUI
====================
It is possible to uninstall Web GUI from the current installed version.
1 Uninstall Web GUI, using Installation Manager
If configuration and data preservation are required, please check section 1.2c. Please refer to the online instruction to uninstall Web GUI
2 Clean up the installed directory and files
These are required to be removed, if a new Web GUI is to be installed
o <omnibus_webgui>
o <OMNIbusWebGUI.war>
These are required to be removed, if exists, where configuration and data preservation are not required.
o <JazzSM_HOME>/ui/temp/*.zip
Product Synonym
OMNIbus_GUI 8.1.0;OMNIbus_GUI 8.1.0.1;OMNIbus_GUI 8.1.0 FP0001;OMNIbus_GUI 8.1.0 Fix Pack 1;8.1.0.1;Web GUI 8.1.0;Web GUI 8.1.0.1;Web GUI 8.1.0 FP0001;Web GUI 8.1.0 Fix Pack 1
Problems (APARS) fixed
Problems (APARS) fixed
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg24037920