IBM Support

Tivoli Netcool/OMNIbus_GUI 8.1.0 Fix Pack Installation Instructions

How To


Summary

Instructions for installing Tivoli Netcool/OMNIbus_GUI 8.1.0 fix pack.

Steps

1. IBM Tivoli Netcool/OMNIbus Web GUI 8.1 Fix Pack Installation Instructions
This section shows how to install the Fix Pack for IBM Tivoli Netcool/OMNIbus Web GUI 8.1. It is 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 on any unforeseen issue during the application of this fix pack. The steps for doing a manual restore are provided in section (5).
Note: See section (3) for special instructions on 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. And, 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: <JazzSM_HOME>/ui on UNIX systems. And, <JazzSM_HOME>\ui on Windows systems.
<OMNIBUS_WEBGUI> Refers to the directory where Netcool/OMNIbus Web GUI 8.1 is installed.
     Examples: /opt/IBM/netcool/gui/omnibus_webgui on UNIX systems. And, C:\IBM\netcool\gui\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_SUBDIR> Refers to OMNIbusWebGUIRepository (base) or OMNIbusWebGUI_NOIExtensionsRepository (NOI extension)
<REPOSITORY_FP> Refers to the "composite" or "delta and serviceDelta" repositories of this fix pack, from the update pack.
    Examples (on UNIX systems): For base product, either
    (i)
  <FP_dir>/<REPOSITORY_SUBDIR>/composite/repository.config
    or
    (ii)
     <FP_dir>/<REPOSITORY_SUBDIR>/delta/repository.config
     <FP_dir>/<REPOSITORY_SUBDIR>/serviceDelta/repository.config
1.2 Installing this fix pack:
The media (.zip) file of this fix pack includes the update pack and the available tools. These packages can be downloaded and extract to <FP_dir>.
Note: If the current installation of Web GUI V8.1 is the June 2014 GA version (build 493), you must uninstall Web GUI.

To check what version is installed click Troubleshooting and Support > System Information for Netcool/OMNIbus Web GUI. For instance, the September 2014 GA version has the following information displayed:
    "IBM Tivoli Netcool/OMNIbus V8.1 Web GUI build 615 (15:31 Sep 29 2014)".
Scenario a) Install Web GUI 8.1.0.x full installer (recommend 8.1.0.18) together with this update pack.
The update pack can be used along with an earlier full installer pack to create a new installation.
For instance, use Installation Manager to configure the "Preference" to add and select both <REPOSITORY_GA> repository from the full installer pack and <REPOSITORY_FP> repositories from the update pack, and then click "Install".
Scenario b) Update an existing Web GUI 8.1.0.x installation to this update pack.
The update pack can be used to update an existing installation for customers with the installed Web GUI 8.1.0.x.
For instance, use Installation Manager to configure the "Preference" to add and select only <REPOSITORY_FP> repositories from the update pack, and then click "Update".
Scenario c) Update to an existing Web GUI 8.1 unsupported (or corrupted) installation to this Fix Pack.
The update pack cannot be used to update an existing installation. You must uninstall the current Web GUI version, and either install with a refresh package for this fix pack (if released), or install with an older refresh package together with this update package.
Complete the following steps:
Prerequisite: Install or update of WAS/WAS-SDK/JazzSM components as required by this fix pack.
  1. Use the provided tools from this update pack to create preservation .zip files.

    The tools provided in the update package for this fix pack can be used to create the temporary files (e.g. <JazzSM>/ui/temp/*.zip), before an immediate re-install of Netcool/OMNIbus Web GUI. The configuration and data will be preserved when the current version of Netcool/OMNIbus Web GUI is uninstalled, and automatically restored after the next installation of Netcool/OMNIbus Web GUI.

    Run the following command to execute this tool:
    <FP_dir>/tools/update.sh|bat -dash <DASH_HOME> -webgui<OMNIBUS_WEBGUI>

    For example, with the default install directories on a Linux/AIX system:
    <FP_dir>/tools/update.sh -dash /opt/IBM/JazzSM/ui -webgui /opt/IBM/netcool/gui/omnibus_webgui
  2. Manual backup of the current Web GUI 8.1 version, see section (4).
  3. Uninstall the current Web GUI 8.1 version, see section (7).
  4. Complete the steps in section (2) or as outlined in section 1.2 scenario (a).
Addition notes:
  • A rollback to previous versions will be available if the "update" facility was used from the Installation Manager.
  • In GUI mode, the launch page to postinstallation configuration tool is available for a new install of Web GUI only.
  • To recover from a failed installation, perform one of the following steps:
    1. Manual restore, see section (5)
    2. Follow the steps in section 1.2 scenario (c)
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 postinstallation configuration tool. This is working as designed because the configuration is not required and already preserved.
After a successful update installation, a rollback 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 the data in pre-fix pack state.
2.1 Before you begin
  1. Extract all the files from the OMNIbus-v8.1.0-WebGUI-FP<number>-IM-<platform>-UpdatePack.zip archive into a temporary directory (the <FP_dir> directory).
    • <number> is a code for the fix pack number.
    • <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:
    • UNIX / Linux: ./IBMIM
    • Windows: IBMIM.exe
  2. Configure Installation Manager to install from your extracted archive:
    1. From the main menu, choose "File" > "Preferences".
    2. In the Preferences windows, select the "Repositories" panel.
    3. Click "Add Repository...".
    4. Click "Browse..." and browse for <REPOSITORY_FP>.
    5. 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 want to update, then click "Next".
  5. Select the version you want 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:
    • UNIX / Linux: ./imcl -c OR ./imcl -consoleMode
    • Windows: imcl.exe -c
  2. Configure Installation Manager to install from your extracted archive:
    1. Select "Preferences".
    2. Select "Repositories".
    3. Select "Add Repository".
    4. Enter <REPOSITORY_FP> as the location.
    5. 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
    1. Create or record an Installation Manager response file.
    2. 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:
    • UNIX / Linux: ./imcl -input response_file -silent -acceptlicense [-log full_path_to_log_file]
    • 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. Installing IBM Tivoli Netcool/OMNIbus Web GUI 8.1 FP in a load-balancing environment
For instructions on updating to a V8.1 fix pack in a load-balancing environment please see the following topic in the Netcool/OMNIbus Knowledge Center: http://www.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/webtop/wip/task/web_upg_dash_ha.html
Note:
You will get a message "cluster is in maintenance mode", after you update Web GUI in HA without disjoining it from the cluster and then try to update pages, filters, views etc, where different levels of WebGUI version exist on nodes in the same HA (DB2).
Fixed in DASH 3.1.3.4 or later, if WEBGUI is upgraded then customer have to run below command at least on one node and then WebSphere Application Server profile restart should be required on all nodes.
  1. Go to JazzSM/ui/bin/ directory
  2. Run consolecli.sh|bat ForceHAUpdate --username console_admin_user_ID --password console_admin_password
4A. Recommended backup procedure of the current Web GUI installation, a pre-fix pack state
Before you begin
Complete a backup of the Installation Manager. To complete the Installation Manager backup, complete the steps that are detailed in the Backing up and restoring Installation Manager topic within the IBM Knowledge Center for Installation Manager. See https://www.ibm.com/support/knowledgecenter/en/SSDV2W/im_family_welcome.html
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:
    • 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 file name
      /opt/IBM/netcool/omnibus_webgui omnibus_webgui.tar
      /opt/IBM/JazzSM JazzSM.tar
      /opt/IBM/WebSphere/AppServer AppServer.tar
    • 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 file name
      C:\IBM\netcool\omnibus_webgui omnibus_webgui.zip
      C:\Program Files\IBM\JazzSM JazzSM.zip
      C:\Program Files (x86)\IBM\WebSphere\AppServer AppServer.zip
4B. Use the tool provided in update pack to create preservation (backup) files
After the update pack from Fix Central have been downloaded, extract the pack to find "tools" directory. Execute the sh|bat command with relevant DASH and Web GUI home directories. The tool will create the following 3 .zip files in <JazzSM_HOME>/ui/temp
  1. preserveOMNIbusWebGUIHomeFiles.zip
  2. preserveOMNIbusWebGUIWarFiles.zip
  3. preserveOMNIbusWebGUIDashPrefFiles.zip
5A. Restoring a Web GUI installation after applying this fix pack, to a pre-fix pack state
This method can be used if the rollback process fails. This would roll back to a pre-fix pack state, the backed-up instance as created by following 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:
    • 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
    • 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:
    • On UNIX and Linux:
      omnibus_webgui.tar
      JazzSM.tar
      AppServer.tar
    • On Windows:
      omnibus_webgui.zip
      JazzSM.zip
      AppServer.zip
  4. Start the WebSphere Application Server.
5B. New WebGUI installation or In-place update with the 3 preserved .zip files from step 4B
Ensure the following 3 .zip files are placed in <JazzSM_HOME>/ui/temp
  1. preserveOMNIbusWebGUIHomeFiles.zip
  2. preserveOMNIbusWebGUIWarFiles.zip
  3. preserveOMNIbusWebGUIDashPrefFiles.zip
After the installation/Update process is completed, these 3 files will be extracted to restored and removed automatically.
6. Rolling back by 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.
Note: If the previous WAS-SDK (v7.0.x, v7.1.x, or v8.0.x) is used and removed, then it must be reinstalled before performing any rollback.
  1. Change to the "eclipse" sub-directory of the Installation Manager installation directory and use the following command to start Installation Manager:
    • UNIX / Linux: ./IBMIM
    • 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 empty or removed, if a new Web GUI is to be installed
    • <omnibus_webgui>
    • <OMNIbusWebGUI.war>
  3. These are required to be removed, when exists, where configuration and data preservation are not required.
    • <JazzSM_HOME>/ui/temp/*.zip

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB45","label":"Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSSHTQ","label":"Tivoli Netcool\/OMNIbus"},"ARM Category":[{"code":"a8m500000008a1DAAQ","label":"WebGUI"}],"ARM Case Number":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.1.0"}]

Product Synonym

OMNIbus_GUI 8.1.0; OMNIbus_GUI 8.1.0 FP; OMNIbus_GUI 8.1.0 Fix Pack

Document Information

Modified date:
22 June 2021

UID

ibm16465849

Page Feedback