Upgrading the Web GUI and migrating data

You can upgrade to the V8.1 Web GUI from V7.4, V7.3.1 or V7.3. You can also upgrade from IBM Tivoli Netcool/Webtop. If you upgrade from Netcool/Webtop, you need to migrate data to the V7.4 Web GUI.

Before you begin

Note:

The data source names on the source and target systems should match. If the names are not the same, all the configuration files containing the data source information must be manually edited to use the correct data source.
If you made modifications to the transform file ($TIP_HOME/tipv2/profiles/TIPProfile/installedApps/TIPCell/isc.ear/ISCWire.war/Transformations) in Web GUI V7.4 fix pack 2, you must manually reinstate your changes after migrating to V8.1.
If you have installed the beta V8.1 of Web GUI you must backup and remove the beta version before you install the full V8.1 Web GUI.
You can continue to run your existing Web GUI installation in parallel with the newly upgraded installation provided that you specify separate installation directories.

Procedure

The upgrade path differs, depending on which version of Web GUI or Netcool/Webtop you want to upgrade from.

If you want to upgrade from V7.3.1, the process differs depending on which version of Dashboard Application Services Hub hosts the Web GUI installation. The following table describes the upgrade path for each product version and version of Dashboard Application Services Hub.

Table 1. Upgrade paths from different versions of the Web GUI and Netcool/Webtop, differentiated by the version of Dashboard Application Services Hub
Product version	Tivoli Integrated Portal version	Upgrade path
7.4	2.2	Side-by-side upgrade only. Clean installation of V8.1, followed by data migration, which consists of: Installing V8.1 Web GUI in a different location than the V7.4.0 instance. Using the tipcli utility to export the data, files, and configuration options from V7.4.0 and using the consolecli utility to import them to the V8.1 installation.
7.3.1	2.2	Side-by-side upgrade only. Clean installation of V8.1, followed by data migration, which consists of: Installing V8.1 Web GUI in a different location than the V7.3.1 instance. Using the tipcli utility to export the data, files, and configuration options from V7.3.1 and using the consolecli utility to import them to the V8.1 installation.
7.3.1	2.1	Side-by-side upgrade only. Clean installation of V8.1, followed by data migration, which consists of: Installing V8.1 Web GUI in a different location than the V7.3.1 instance. Using the tipcli utility to export the data, files, and configuration options from V7.3.1 and using the consolecli utility to import them to the V8.1 installation.
7.3	1.1	Upgrade Web GUI to V7.4 or V7.3.1, followed by upgrade to Web GUI V8.1, which consists of: Installing V7.4 or V7.3.1 Web GUI in a different location than the V7.3 instance. Installing V8.1 Web GUI in a different location than the V7.4 or V7.3.1 instance. Using the tipcli utility to export the data, files, and configuration options from V7.4 or V7.3.1 and using the consolecli utility to import them to the V8.1 installation.
Netcool/Webtop V2.2	1.1	Upgrade Web GUI to V7.4 or V7.3.1, followed by upgrade to Web GUI V8.1, which consists of: Installing V7.4 or V7.3.1 Web GUI in a different location than the V7.3 instance. Installing V8.1 Web GUI in a different location than the V7.4 or V7.3.1 instance. Using the tipcli utility to export the data, files, and configuration options from V7.4 or V7.3.1 and using the consolecli utility to import them to the V8.1 installation.
Netcool/Webtop V2.1, V2.0, or V1.3.1	N/A	Use the migration tool to export the data, files, and configuration options and import them to the V7.4 or V7.3.1 installation. Upgrade the Web GUI to V8.1.