Download
Abstract
This fix pack is a cumulative fix release and addresses some new APARs and internally found issues since the release of OMNIbus_GUI 7.4.0.1
Download Description
Known Issues
================
Recommend to use Tivoli Integrated Portal IFix PI12213-IFix.zip and SmartCloud Analytic Log Analysis Hot Fix 1.2.0.0-CSI-SCALA-IF0002 on top of WebGUI 7.4.0.2 to avoid known issues.
1. APAR PM96715: TIP2.2.0.11: Unable to join HA cluster
More information and the workaround can be found in the following technote
link: http://www-01.ibm.com/support/docview.wss?uid=swg21649391
2. APAR PM78026: TIP2.2.0.11: WAAPI add ilter failed for user with inverted comma, user'10
More information and the workaround can be found in the following interim fix
link: http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm~WebSphere&product=ibm/WebSphere/WebSphere+Application+Server&release=7.0.0.25&platform=AIX&function=all
Note: APAR IV30590 is affected by this issue
3. alm00304777 / IV55855: INTEGRATION OF PROMPTS AND METRICS - INVALID PROMPTS AND METRICS (APAR=IV55855)
Summary:
Further changes to the new integration of Prompts and Metrics. The following have been included:
Error message prompt is not user friendly in Metrics GUI.
Error page displayed when adding new Label for 2nd time onwards for type of Fixed Choice on IE8
When dynamic/real time prompt has blank/empty values, prompts dialog not displayed on event viewer. Cause: Fails to parse JSON
4. alm00304773 / IV55860: INTEGRATION OF PROMPTS/METRICS: HELP BOOK (APAR=IV55860)
Summary:
Further changes to the new integration of Prompts and Metrics. The following have been included:
Insufficient info in Help book.
5. alm00304775 / IV55863: INTEGRATION OF PROMPTS/METRICS - ALIGNMENT (APAR=IV55863)
Summary:
Further changes to the new integration of Prompts and Metrics. The following have been included:
Alignment distorted on Prompt GUI and Gauge page
Issues and Enhancements addressed in 7.4.0.2 FP2
================================================
Enhancements
=============
alm00300253 / IV50646
=====================
Short Description: METRICS CURI PROVIDER MADE AVAILABLE FOR OMNIBUS 7.4 WEB GUI
Summary:
Integration of Metrics CURI Provider
alm00300284 / IV50662
=====================
Short Description: INTEGRATION OF PROMPTS/METRICS
Summary:
The Prompts and Metrics are only modifiable via WAAPI as no GUI exists.
alm00299842 / IV50273
=====================
Short Description: CONFIGURE WEB GUI DATA SOURCES TO RECORD SYSTEM STATISTICS AND PROVIDE OUT-OF-THE-BOX DASHBOARD TO VISUALIZE THEM
Summary:
There should be a way to provide information about the health of Web GUI and its services that it runs as events in the ObjectServer so that the administrator can see those events in
the Event Viewer and take actions. In addition to these self monitoring events generation, Web GUI should also provide an out-of-the-box dashboard with some vital
statistics about overall health of the Netcool system.
alm00299480 / IV49936
=====================
Short Description: LAUNCH IN CONTEXT TOOLS FOR SCA-LA INTEGRATION
Summary:
Implementation of launch in context tools for integration with SmartCloud Analytic Log Analysis
Defects
=========
alm00295881 / IV43817
=====================
Short Description: MIGRATION FROM WEB GUI 7.3 TO WEB GUI 7.4 FAILS
Summary:
The APAR is required to reduce the SEVERE error to WARNING error, so that the Import can continue as there is no "customised" Web Resource to import. In most cases, there are no customised web
resource files (customised files under OMNIbusWebGUI.war directory), so the exported zip file does not contain web resource directory as expected.
alm00300500 / IV50898
=====================
Short Description: CONFIGURE WEB GUI DATA SOURCES TO RECORD SYSTEM STATISTICS AND PROVIDE OUT-OF-THE-BOX DASHBOARD TO VISUALIZE THEM
Summary:
There should be a way to provide information about the health of Web GUI and its services that it runs as events in the ObjectServer so that the administrator can see those events in
the Event Viewer and take actions. In addition to these self monitoring events generation, Web GUI should also provide an out-of-the-box dashboard with some vital
statistics about overall health of the Netcool system.
alm00299133 / IV48847
=====================
Short Description: WEBGUI 7.4 - FILTER, VIEW CREATION FAILED
Summary:
Omnibus webGUI 7.4.0 - Filter, View creation failed
Filter and views creation fails on OMNIbus webGUI 7.4.0 and
below error is noticed in webtop logs:
- HEMEA0044E
- com.micromuse.wave.acl.UserException: User null does not exist
alm00299147 / IV49396
=====================
Short Description: MOBILE EVENT LIST - CHANGING DEVICE ORIENTATION RESTRICTS EVENT FILTERING CAPABILITY
Summary:
Changing the device orientation to landscape and back to standard mode on a mobile while viewing the mobile event list
causes some of the severity icons not to appear at the top. This prevents filtering capability based on the severity
alm00301979 / IV52572
=====================
Short Description: NEWLY CREATED USER CAN'T EXECUTE SQL TOOLS IN AEL UNTIL OS RESYNC HAPPEN.
Summary:
Newly created WebGUI User (with all role) unable to Acknowledge or any other SQL tools on events in AEL although
WebGUI is using Object Server as users repository. Unless OS-resync happen via waapi or auto re-sync happen
alm00301160 / IV51878
=====================
Short Description: DEADLOCK INVOLVING COM/MICROMUSE/NCW/DATASOURCE [Duplicate of IV47893]
Summary:
Deadlock occurring between threads for com/micromuse/ncw/datasource/NCWSSDataSource and
com/ibm/tivoli/nm/logging/LogFileHandler TIP crashing up to twice per day.
alm00301984 / IV52587
=====================
Short Description: JAVA APPLET SECURITY REQUIREMENT WITH JAVA 7U45
Summary:
On Oracle Java 7u45, a warning windows popping up when web page interacts with Java applet using Javascript (communication from
Javascript to Java) aka LiveConnect.
The warning message: "Allow access to the following application from this web site?"
alm00303964 / IV54955
=====================
Short Description: INTEGRATION OF PROMPTS/METRICS
Summary:
Further changes to the integration of Prompts and Metrics GUIs:
1.GUI unstable when mouse pointer is hovering above it - Scrollbar removed
2. GUI give wrong error message on thresholds - Validation corrected
3.Unable to support Chinese characters for Unique name - Validation corrected
4. The Help Book disappear after installed FP2 - ua.zip updated
5. Changes to the appearance of the Prompts Dialog
alm00301856 / IV52533
=====================
Short Description: CGI TOOL FAILS WITH NULLPOINTEREXCEPTION WHEN USE SMARTPAGE COMMAND CHECKED BUT WITH NO SMARTPAGE CONTENTS
Summary:
CGI tool fails to execute and NullPointerException thrown in trace log when the CGI tool registered with "Use Smartpage
command" checked while the CGI tool does not contains any Smartpage commands.
alm00302039 / IV52633
=====================
Short Description: INTEGRATION OF PROMPTS/METRICS
Summary:
Further changes to the new integration of Prompts and Metrics. The following have been included:
1. Hover help has been provided for selected Prompts and Metrics
Dialog fields.
2. The link to the Infocenter has been updated on the Prompts
and Metrics GUIs
3. The Prompt types listed in the Prompts Dialog is now in
alphabetical order
4. The warning message received when creating a prompt
incorrectly has been updated.
5. The calculation and validation of minimum and maximum values
when creating a metric have been corrected
alm00302544 / IV53411
=====================
Short Description: INTEGRATION OF PROMPTS/METRICS
Summary:
Further changes to the new integration of Prompts and Metrics. The following have been included:
1. On line documentation for Prompts and Metrics updated. Files
accessible via the ? icon on both GUIs
2. Unexpected results from creating and modifying a metric have
now been resolved.
3. Changes to the labels for Prompts and Metrics
alm00302627 / IV53517
=====================
Short Description: The reported Cross-Site Scripting security vulnerability issues were fixed in WebGUI 7.4.0 Fix Pack 2
Summary:
The issue is fixed in WebGUI 7.4.0 FP2. LEL table header is now moving in same direction (in synch) with its table data on
horizontal scrolling when the Component and Text Direction set to Right to Left on all supported browsers.
alm00302693 / IV53420
=====================
Short Description: SECURITY VULNERABILITIES EXIST IN EVENT VIEWER
Summary:
The reported Cross-Site Scripting security vulnerability issues were fixed in WebGUI 7.4.0 Fix Pack 2
alm00302750 / IV53418
=====================
Short Description: SECURITY VULNERABILITIES EXIST IN THE AEL
Summary:
The reported security vulnerabilities have been fixed in WebGUI 7.4.0 FP2.
alm00295923 / IV43813
=====================
Short Description: OMNIBUS WEBGUI 7.4.0.1 (B): SINGLE-CLICK AND DOUBLE-CLICK ACTION IN AEL NOT WORKING PROPERLY
Summary:
AEL not able to differentiate between Single and Double click. In situation when both Single and Double click events been turned on, both events will activated during Double click.
alm00298229 / IV47180
=====================
Short Description: OMNIBUS WEBGUI 7.4.0.1 (B): DEFAULT DATASOURCE FOR RELATIONSHIP CREATED VIA WAAPI IS NOT RECOGNIZED IN GUI
Summary:
Relationship creation via waapi without datasource attribute specified cause the Relationship config store been created with no data Source attribute. Which later cause the Relationship been listed on any selected data sources during View creation.
alm00298338 / IV47304
=====================
Short Description: OMNIBUS WEBGUI 7.4.0.1 (B): UNABLE TO ATTACH IMAGE TO MAP WHERE ITS NAME HAVE SPACE CHARACTER.
Summary:
HTTP response code 505 returned (visible on Java Console) when Map applet try to get image for the Map with space in the name.
alm00300623 / IV51181
=====================
Short Description: IMPROVE SUPPORT FOR TABLE AND LIST WIDGETS IN WEB GUI CURI PROVIDER
Summary:
It is possible to populate the table and list widgets in the JazzSM DASH UI with data from a remote OMNIbus Web GUI connection.
However, the data supplied by Web GUI for this purpose could be improved to enhance usability. Examples of improvements are: display of icons for Event Summary and Filter Summary datasets;
use of large icons in datasets for display in list widgets; use of node status for dataset items to enable list widget quick filter bar; ability for event-related datasets to receive context from other widgets.
alm00300894 / IV51526
=====================
Short Description: ORACLE JAVA 7U51 NEED 'PERMISSIONS' ATTRIBUTE IN JAR MANIFEST FILE
Summary:
Starting Oracle Java 7u51, and error will be shown and the RIA is blocked, if "Permissions" attribute does not set or the value does not match the permissions level requested in the JNLP file or the applet tag. The "Permissions" introduced in Oracle Java 7u25.
alm00299813 / IV50207
=====================
Short Description: AEL PRODUCES WARNING MESSAGE "WARNING: VIEW <VIEW NAME> OF CATEGORY 'SYSTEM' WAS NOT FOUND"
Summary:
With WAAPI running regularly to perform config modification of views and filters, users report regularly seeing the following message in the AEL: "WARNING: View 'XXXX' of
Category 'system' was not found". The message remains for a short time and then disappears.
alm00206234 / IZ85487
=====================
Short Description: RESTRICTION FILTERS ARE LOST WHILE WEBTOP ATTEMPTS TO RESYNCHRONIZE WITH ITS DATA SOURCES.
Summary:
Restriction filters are lost while Webtop attempts to resynchronize with its data sources. This problem happens on ObjectServer
which has huge number of users. Webtop takes a long time to resync with ObjectServer when there are a lot of users in the ObjectServer.
When AEL attempts to refresh while OS Resync is still in progress, these restriction filters are lost for a while. Hence, users are able to see
the events that they are not suppose to view and manage these events.
alm00300062 / IV50499
=====================
Short Description: WEBGUI FILTER CREATION WITH 2000 GROUPS FAILS WITH SYSTEM ERROR.
Summary:
WebGUI Filter Creation with 2000 Groups fails with System Error. It works fine with 1000 Groups. The System Error Message on browser was thrown at New Filter Creation)
with message "System Error, please contact administrator".
alm00298603 / IV47772
=====================
Short Description: TIP ROLES INHERITED BY SIMILARLY NAMED GROUPS
Summary:
There is flaw on comparing group name in DCI during checking the user if it is member of ncw_admin.
The current comparison will return true if it found any subset of the compared string (group name). The right comparison is it should only
return true if the comparing string are identical. This cause the group "Level 2" been mistakenly matched with "Level 2 Tech" group and
result WebGUI identified user as member of ncw_admin role.
alm00258667 / IV11719
=====================
Short Description: CLIENT CLAIMS THAT IT TAKING LONGER TO EXECUTE 7.3.1 WAAPI
Summary:
WAAPI commands to add or modify filters take a very long time to execute if there are a large number of elements within a WAAPI command.
The affected WAAPI commands are:
- filter.addFilter
- filter.deleteFilter
- filter.modifyFilter
- filter.setDefaultView
- filter.createOrReplaceFilter
- entity.addEntity
- entity.deleteEntity
- entity.modifyEntity
- entity.setDefaultView
- entity.createOrReplaceEntity
alm00299205 / IV49605
=====================
Short Description: EVENTVIEWER CAN'T COMMUNICATE WITH MQ. MICROBROKER AND DISPLAYS ERRORS IN THE LOGS AND BROWSER CONSOLE
Summary:
Eventviewer can't communicate with MicroBroker (for updating summary toolbar and groupings) .
Errors are seen in SystemOut.log ---> Client 'HTTP_885240_6002' failed to authenticate. and there are few more exceptions as below..
javax.jms.JMSSecurityException: Create connection to tcp://localhost:17564 failed: Not authenticated.
[21/11/12 09:02:32:431 GMT] 0000001d SystemErr R at com.ibm.msg.client.mqtt.internal.ProviderConnectionMqttImpl.
connectToBroker(ProviderConnectionMqttImpl.java:166)
Firebug shows following errors: event_router.js (line 316) ***** event_router - HTTP error=502 responseText=MQHTTP50201: There has been an unexpected problem in the connection to MQ. Please contact your administrator.
alm00296147 / IV44079
=====================
Short Description: MAP PORTLETS DISPLAY WITH AN EXTRA REDUNDANT SCROLLBAR
Summary:
Create a new page in TIP via Page Management. Add a map portlet. When opening the page in Firefox, an extra, redundant scrollbar can be clearly seen.
On customer site this has also been seen once or twice in IE, though this has not so far been replicated in Support.
alm00295256 / IV42916
=====================
Short Description: TOOL STOP WORKING WHEN CHANGED FROM GET TO POST
Summary:
CGI tool fails to execute properly in POST method.
Sometimes fatal javascript error message is thrown to user and sometimes browser freezes while executing POST CGI tools.
alm00297603 / IV46096
=====================
Short Description: MULTIPLE SCROLL BARS AT THE BOTTOM OF THE EVENT DETAILS
Summary:
Sometimes, viewing the event details from 'Service details' (Lightweight Event List), creates two scroll bars on the bottom of the window.
This happens only if there is a long string in the summary that contains no spaces.
alm00297982 / IV46771
=====================
Short Description: CGI TOOL FAILS TO EXECUTE WHEN THE CGI COOKIE HEADER IS SET.
Summary:
When setting a cookie via a header with in a perl CGI script, an exception is output to the log file and the CGI fails to execute.
Example CGI script: #!/usr/bin/perl use strict; use CGI; my $w=CGI->new(); print $w->header(-cookie => [ 'name=cookie; HttpOnly' ]);
Output in $TIPHOME/profiles/logs/ncw/ncw.0.trace:
[2013-07-24T14:59:04.783] [WebContainer : 3] com.micromuse.wave.servlets.CGIServlet.runCgi
SEVERE: HEMJS0266E=Failed to execute CGI "/cgi-bin/mojo_gateway.cgi". Check that the file exists and is executable.
[2013-07-24T14:59:04.784] [WebContainer : 3] com.micromuse.wave.servlets.CGIServlet.runCgi F
INE: HEMJS0266E java.lang.StringIndexOutOfBoundsException at java.lang.String.substring(String.java:1092)
at com.micromuse.wave.servlets.CGIServlet.buildCookie(CGIServle t.java:757)
at com.micromuse.wave.servlets.CGIServlet.processNonBinaryData( CGIServlet.java:381)
at com.micromuse.wave.servlets.CGIServlet.runCgi(CGIServlet.jav a:284)
at com.micromuse.wave.servlets.CGIServlet.service(CGIServlet.ja va:168)
alm00298061 / IV46843
=====================
Short Description: DELAY IN DISPLAYING THE AEL (7.4) RIGHT-CLICK MENU
Summary:
When selecting multiple alarms and right clicking, there is a delay in presenting the pop-up alerts menu on the Active Event List.
This problem occurs if one or more tools on the menus contains 1000s of entries.
Typically this might be the User Assign Tool if there are a large number of users in the system.
alm00298496 / IV47579
=====================
Short Description: GREYOUTS LAUNCHING EVENT DASHBOARDS WITH JRE 1.6
Summary:
Event Dashboards are grayed out intermittently, just after loading.
alm00298728 / IV47893
=====================
Short Description: WEB GUI GRADUALLY SLOWS DOWN AND HANGS INTERMITTENTLY
Summary:
WebGUI becomes gradually slow and hangs overtime. At this point the logs shows the deadlock situation with the WebGUI threads which results in the thread
buildup due to the same reason. TIP restart is then required to recover from this situation. It is not always possible to try an replicate this situation
and this occurs randomly over the period of 3-4 weeks. Initial analysis of the problem and looking at the logs it seems there is a 3 way deadlock between
threads which results into all the subsequent threads being blocked and eventually hanging WebGUI
alm00298924 / IV48126
=====================
Short Description: UNABLE TO DISPLAY EVENT VIEWER USING DIRECT URL ON BROWSER
Summary:
The Event Viewer is not able to display with "(HEMDP0225E) The Event Grouping REST Service was called with an invalid 'view' parameter."
exception thrown in SystemOut.log file when the URL format below is used (viewname and viewtype are NOT specified). https://localhost:16311/ibm/console/webtop/eventviewer/eventViewer.jsp?…
alm00299145 / IV49393
=====================
Short Description: COPY FROM EVENT VIEWER DOES NOT CONTAIN VALUE FOR SEVERITY
Summary:
When an event is copied from the Event Viewer and pasted in the text editor, all the fields for the event is copied as Field:Value pair except for the Severity field
alm00299191 / IV49555
=====================
Short Description: SCROLLBAR NOT WORKING FOR EVENT VIEWER ON IE
Summary:
Click on the empty area of vertical and horizontal scrollbar cannot be used to scroll through the table of events in the Event Viewer on IE8 browser.
The arrows for the scroll bar also don't appear to work when clicked. It is therefore not possible to slowly navigate through a long list of alarms
(apart from dragging and dropping the scroll bar).
alm00299195 / IV49601
=====================
Short Description: UNABLE TO QUICK FILTER LARGE NUMBERS OF EVENTS IN THE EVENTVIEWER USING SEVERITY FILTER BUTTONS
Summary:
When we have a large number of events being displayed in the Event Viewer, say more than 10k events, and the events for some of the severity are in equally
large number. Selecting that severity button to filter the events leads to a timeout and error dialog is displayed.
alm00299197 / IV49569
=====================
Short Description: EVENT VIEWER TRIGGERING THE BROWSER TO DISPLAY UNRESPONSIVE SCRIPT PROMPTS
Summary:
'Unresponsive script' prompts constantly pop up in the browser when scrolling up/down the list of events as events appear to load.
This was more apparent when viewing >1000 events. On IE: Stop running this script? (Yes/No)
FF: Warning: Unresponsive script (Stop script/Continue) + option to not ask again Annoyingly in IE, hitting 'No' at the prompt results in a
few more events being loaded into the event viewer and the prompt reappearing over and over again if 'No' is repeatedly selected.
alm00291661 / IV37645
=====================
Short Description: WEBGUI 7.4 RUNWAAPI UTILITY INCORRECT ENCODING
Summary:
While executing waapi commands for prompts, whereby the waapi xml file contains some non-english characters, the nova file that is created for the prompts
contains junk characters instead of correctly encoded non-english characters. This issue was not limited to prompts but for all available WAAPI commands.
Prerequisites
This Fix Pack requires 7.4.0.0 GA release
Installation Instructions
IBM Tivoli Netcool/OMNIbus Web GUI 7.4.0.2 Fix Pack 2 Installation Instructions
===============================================================================
This section shows how to install the Fix Pack 2 for IBM Tivoli Netcool/OMNIbus Web GUI 7.4.0
It is strongly recommend to perform a backup of TIP/Web GUI and COI/DE before the installation of this fix pack. The steps for doing this are towards the end of this section.
The installation has the following stages:
1. Stop the Tivoli Integrated Portal and its associated services.
2. Extract the installation files from the archive.
3. Install the fix pack in silent mode.
4. Restart the Tivoli Integrated Portal server.
Note: See the end of this section for special instructions about how to apply fix packs in a load balancing environment.
Terminology:
These instructions use the following terms to refer to directories used during installation:
TIP_HOME Refers to the directory where the Tivoli Integrated Portal is installed.
This directory is known as the Tivoli Integrated Portal home directory.
Examples:
/opt/IBM/tivoli/tipv2 on UNIX environments.
C:\IBM\tivoli\tipv2 on Windows systems.
FP_dir Refers to the temporary directory where you extract the contents of the fix pack's archive.
1. Stop the Tivoli Integrated Portal and its associated services
--------------------------------------------------------------------------------------
Follow the instructions for your operating system.
Unix-based systems:
1. Log in as an administrator and stop the Tivoli Integrated Portal by entering the following command:
TIP_HOME/bin/stopServer.sh server1 -username <tipadmin> -password <tippass>
2. Wait for 30 seconds for the Tivoli Integrated Portal and its subprocesses to stop.
Windows systems:
1. Log in as a user with administrative privileges.
2. Open the Services control panel by clicking Start-->Control Panel-->
Administrative Tools-->Services.
3. Stop the service named Tivoli Integrated Portal - V2.2_TIPProfile_Port_16310.
4. Wait 30 seconds for the Tivoli Integrated Portal and its subprocesses to stop.
5. Close the Services control panel.
2. Extract the installation files
--------------------------------------------------------------------------------------
Extract the installation files from their archives, ready to install on your system.
1. Extract all the files from the OMNIbus-v7.4.0-WebGUI-FP2-<platform> archive into a temporary directory (the FP_dir directory).
o The extension for the fix pack's archive is .tar or .zip, depending on the operating system.
o <platform> is a code for the operating system of the machine where you are installing the fix pack.
o On Unix-based systems, use GTAR to extract the archives to avoid any long link problems.
2. Navigate to FP_dir.
3. Install the fix pack in silent mode
--------------------------------------------------------------------------------------
1. Use sample_response.txt to create a response file. Set up the responses in that file appropriate for your system.
Note that IAGLOBAL_UPDI_HOME_23 variable in response file is commented out.
DO NOT uncomment the IAGLOBAL_UPDI_HOME_17 variable and adjust the path UNLESS the installed version of UPDI is 7.0.0.17.
2. Please backup existing version before installing fix pack.
3. Run the installer for the fix pack in silent mode. Use the appropriate command for your operating system:
Unix-based systems:
./install.sh [-i|-I] <full_path_JRE> <response file>
Optional parameter -i or -I can be used for interactive mode installation. This gives an opportunity to the administrator to verify the values of the variables configured in the response file
Replace <response file> with the name of the response file you created in step 1.
<full_path_JRE> refers to such as /opt/Java/jre (up to but not including the bin directory)
Only IBM JRE 1.6 is supported. A JRE 1.6 that can be used for the Fix Pack installation is in : <TIP_HOME>/java/jre
Windows systems:
install.bat [-i|-I] <full_path_JRE> <response file>
Optional parameter -i or -I can be used for interactive mode installation. This gives an opportunity to the administrator to verify the values of the variables configured in the response file
Replace <response file> with the name of the response file you created in step 1.
<full_path_JRE> refers to such as C:\Java\jre (up to but not including the bin directory)
Only IBM JRE 1.6 is supported.
A JRE 1.6 that can be used for the Fix Pack installation is in: <TIP_HOME>\java\jre
4. Restart the Tivoli Integrated Portal server
--------------------------------------------------------------------------------------
When the installation is complete restart the Tivoli Integrated Portal server.
Instructions for installing IBM Tivoli Netcool/OMNIbus Web GUI 7.4.0.2 FP2 in load balancing environment
================================================================================================
1. Disjoin the first node from current load balancing environment, use the disjoin option :
a. Remove the node. For more information about how to do this, see
http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/tip/ttip_config_ha_unjoin.html To restore the removed node to normal operation, restart the server.
b. Remove the load balancing information of the node from the configuration database from the cluster. For more information about how to do this, see http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/webtop/wip/task/web_adm_loadbalpreventnode.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. Install the fix pack on the disjoined first node
3. Verify that the patched, disjoined node is working as expected.
4. Disjoin one of the remaining nodes from current load balancing environment :
a. Remove the node. For more information about how to do this, see
http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/tip/ttip_config_ha_unjoin.html To restore the removed node to normal operation, restart the server.
b. Remove the load balancing information of the node from the configuration database from the cluster. For more information about how to do this, see http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/webtop/wip/task/web_adm_loadbalpreventnode.html
5. Repeat step 4 for each node in the load balancing environment until no nodes remain.
Important: use the uninstall option for the last node
6. Rejoin the patched first node to the load balancing environment, use the configHA option:
a. Join the node to the cluster. For more information about how to do this, see http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/tip/ttip_config_ha_join.html
b. Start load balancing operations on the node. For more information about how to do this, see http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/webtop/wip/task/web_adm_loadbalconfigurenewnode.html
7. Install the fix pack on one of the disjoined nodes.
8. Verify that the patched, disjoined node is working as expected.
9. Rejoin the upgraded node to the load balancing environment, use the join option:
a. Join the node to the cluster. For more information about how to do this, see http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/tip/ttip_config_ha_join.html
b. Start load balancing operations on the node. For more information about how to do this, see http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/webtop/wip/task/web_adm_loadbalconfigurenewnode.html
10. Repeat steps 7 to 9 for each node that was disjoined from the load balancing environment.
Important: To avoid long downtime periods, ensure the first node is patched and ready to rejoin to the load balancing environment before the final node is disjoined.
Recommended backup procedure for an existing 7.4.0 install (pre-FP2)
================================================================================================
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 server.
3. Back up the existing installation:
For UNIX operating system
Use tar or a similar archiving tool to create backup copies of the following directories:
Table 1. Directories to back up on UNIX and Linux
Directory Backup filename
/opt/IBM/tivoli/netcoool/omnibus_webgui webgui.tar
/opt/IBM/tivoli/tipv2 tipv2.tar
/opt/IBM/tivoli/tipv2Components tipv2Components.tar
For Windows operating system
Use a suitable archive utility to create .zip files of the following folders and all their subfolders in the specified file:
Table 2. Directories to back up on Windows
Directory Backup filename
C:\IBM\tivoli\netcool\omnibus_webgui webgui.zip
C:\IBM\tivoli\tipv2 tipv2.zip
C:\IBM\tivoli\tipv2Components tipv2Components.zip
For example, the following command backs up the omnibus_webgui directory on Linux. Use a similar command for the other directories.
tar -cvf webgui.tar /opt/IBM/tivoli/netcool/omnibus_webgui
4.Back up the Deployment Engine (DE):
Follow backup instructions documented in the following link:
http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/omnibus/wip/admin/task/omn_adm_backupde.html
Restoring a Web GUI install to pre-fix pack state
================================================================================================
If the upgrade to 7.4.0.2 fails, you can restore your backed-up 7.4.0.0 instance.
1. Stop the Tivoli Integrated Portal server.
2. Restore the DE.
Follow the instructions documented in the following link:
http://www.ibm.com/support/knowledgecenter/SSSHTQ_7.4.0/com.ibm.netcool_OMNIbus.doc_7.4.0/omnibus/wip/admin/task/omn_adm_restorede.html
3. Rename the Web GUI and Tivoli Integrated Portal directories as follows:
Example :
On UNIX and Linux,
mv /opt/IBM/tivoli/netcoool/omnibus_webgui /opt/IBM/tivoli/netcoool/omnibus_webgui.old
mv /opt/IBM/tivoli/tipv2 /opt/IBM/tivoli/tipv2.old
mv /opt/IBM/tivoli/tipv2Components /opt/IBM/tivoli/tipv2Components.old
On Windows,
rename C:\IBM\tivoli\netcool\omnibus_webgui C:\IBM\tivoli\netcool\omnibus_webgui.old
rename C:\IBM\tivoli\tipv2 C:\IBM\tivoli\tipv2.old
rename C:\IBM\tivoli\tipv2Components C:\IBM\tivoli\tipv2Components .old
4.Restore the content of the following files to their original locations by using a suitable archive utility to restore the content of the following files to their original locations:
On UNIX and Linux,
webgui.tar
tipv2.tar
tipv2Components.tar
On Windows,
webgui.zip
tipv2.zip
tipv2Components.zip
5.Start the Tivoli Integrated Portal server.
Product Synonym
OMNIbus_GUI 7.4.0;OMNIbus_GUI 7.4.0.2;OMNIbus_GUI 7.4.0 FP0002;OMNIbus_GUI 7.4.0 Fix Pack 2;7.4.0.2;Web GUI 7.4.0;Web GUI 7.4.0.2;Web GUI 7.4.0 FP0002;Web GUI 7.4.0 Fix Pack 2
Problems (APARS) fixed
Problems (APARS) fixed
Was this topic helpful?
Document Information
Modified date:
15 June 2018
UID
swg24035243