Migrating from IBM Tivoli Netcool/Webtop version 1.3.1

You use the migration tool to export the data, files, and configuration options and import them to the V7.4 or V7.3.1 installation. When this process is complete, you upgrade the Web GUI to V8.1. To migrate Netcool/Webtop version 1.3.1 data to the V7.4 Web GUI, run the migration tool export module on the host on which Netcool/Webtop version 1.3.1 is installed. After the data is migrated, you import the migration data into the V7.4 Web GUI.

Before you begin

Install the V7.4 Web GUI.

About this task

The migration process migrates all files that are generated by Netcool/Webtop and some user-modified files. However, some manual migration steps might be required.

Procedure

The procedure to migrate from Netcool/Webtop version 1.3.1 to the Web GUI has the following parts:

  1. Install the migration tool.
  2. Export the data from the Netcool/Webtop server.
  3. Copy the data to the Web GUI server.
  4. Configure the import module.
  5. Import the data.
  6. Remove migration tool.

Installing the migration tool

Procedure

  1. On the Web GUI host, copy the WEBGUI_HOME/integration/migration_tool/migration_tool_export.zip file to the Netcool/Webtop host.
  2. Extract the migration_tool_export.zip file to any suitable directory.

    This directory is referred to as MIGRATION_TOOL_HOME.

Exporting the data

Procedure

  1. As an administrative user, log in to the server where Netcool/Webtop is installed as an administrative user.
  2. Set WEBTOP_HOME to the installation directory of Netcool/Webtop.
  3. If WAAPI is not installed, edit export.lst in MIGRATION_TOOL_HOME/etc, and comment out the following line:

    com.ibm.tivoli.nc.migration.plugin.webtop.WAAPIInit13ExportPlugin

  4. Navigate to MIGRATION_TOOL_HOME/bin and enter:

    For UNIX operating systemFor Linux operating systemwebtop13_migration_export

    For Windows operating systemwebtop13_migration_export.cmd

    The data is exported to a file named data.zip in MIGRATION_TOOL_HOME/output.

Copying data to the Web GUI server

Procedure

Copy data.zip to the Web GUI server.

Put the file in WEBGUI_HOME/integration/migration_tool/output.

Configuring the import module

About this task

In this task, MIGRATION_TOOL_HOME refers to WEBGUI_HOME/integration/migration_tool.

Procedure

On the Web GUI server:

  1. Set the following variables:
    Table 1. Environment variables for importing data
    Variable Value
    TIPHOME The installation directory of the Dashboard Application Services Hub.
    WEBTOP_HOME The installation directory of the Tivoli Netcool/OMNIbus V7.4.0 Web GUI.
  2. Edit settings.properties in MIGRATION_TOOL_HOME/etc and set the following values:
    Table 2. Migration tool settings for importing data
    Property Value
    TIP.WSAdmin.user The Dashboard Application Services Hub administrative user, such as tipadmin.
    TIP.WSAdmin.password The password for the Dashboard Application Services Hub administrative user, such as tippass.
    Importer.Destination.Choice The registry into which the Netcool Security Manager is imported. Use one of the following values:
    FBAUTH
    Imports the data into the default Dashboard Application Services Hub file-based repository.
    NCOS
    Imports the data into the ObjectServer. The users are created automatically in the ObjectServer.
    NONE
    Does not import the data.
    LDAP
    Imports the data into an LDAP registry. The user data is imported into a .ldiff file, which you must import into LDAP.
    Set the following properties if the value of Importer.Destination.Choice is NCOS:
    Importer.NCOS.Server The name of the server that runs the ObjectServer.
    Importer.NCOS.Port The port number that the ObjectServer uses.
    Importer.NCOS.Admin The ObjectServer root user.
    Importer.NCOS.Password The password for the ObjectServer root user.
    Importer.NCOS.defaultPassword A default Web GUI password to generate for all imported users.
    Set the following properties if the value of Importer.Destination.Choice is FBAuth:
    Importer.FBAUTH.defaultPassword A default Web GUI password to generate for all imported users.
    Importer.FBAUTH.DefaultWIMRealm Do not change this property.
    Set the following property if the value of Importer.Destination.Choice is LDAP:
    Importer.LDAP.BaseDn The Distinguished Name (DN) of the LDAP server.
  3. If WAAPI was not installed on the Netcool/Webtop server, edit import.lst in MIGRATION_TOOL_HOME/etc and comment out the following line:

    com.ibm.tivoli.nc.migration.plugin.webtop.WAAPIInitImportPlugin

Importing the data

About this task

In this task, MIGRATION_TOOL_HOME refers to WEBGUI_HOME/integration/migration_tool

Procedure

On the Web GUI server:

  1. Ensure that the Web GUI and Dashboard Application Services Hub server is running.
  2. Review the file WEBGUI_HOME/etc/illegalChar.prop and ensure that it is appropriate for your installation.

    For most installations, it is sufficient to remove the space character from the list of invalid characters.

  3. Go to the MIGRATION_TOOL_HOME/bin directory and run the following command for your operating system:

    For UNIX operating systemFor Linux operating systemwebtop13_migration_import -migration

    For Windows operating systemwebtop13_migration_import.cmd -migration

  4. If you set the property Importer.Destination.Choice in settings.properties to LDAP, import the file generatedUsersAndGroups.ldif into the LDAP server.

    Refer to the documentation for your LDAP server for instructions on how to import an .ldif file.

  5. To import the users and groups from Netcool/Webtop, go to the MIGRATION_TOOL_HOME/import/roles directory and run the following command for your operating system:
    • For UNIX operating systemFor Linux operating systemaddAllRolesAndRelationships.sh TIP_HOME tipadmin tippass
    • For Windows operating systemaddAllRolesAndRelationships.bat "TIP_HOME" tipadmin tippass
    Replace TIP_HOME with the installation directory of the Dashboard Application Services Hub. Replace tipadmin with the user ID of the Dashboard Application Services Hub administrative user and replace tippass with the password for that user.
  6. Restart the Web GUI and Dashboard Application Services Hub server

Results

After you restart the server, the configuration data that is migrated from Netcool/Webtop is in place along with the migrated users.

What to do next

To obtain the complete default V7.4 Web GUI configuration artifacts, merge the files that are contained in WEBGUI_HOME/etc/default folder with the configuration artifacts that were migrated from Netcool/Webtop. For example, to obtain the default global filters, merge the WEBGUI_HOME/etc/default/data/global/filter.xml file with the WEBGUI_HOME/etc/data/global/filter.xml file.

Removing the migration tool

Procedure

After the migration ran successfully, delete the settings.properties file, which contains the login and password information. You can also remove the migration tool from all hosts.

Rerunning the migration tool

Procedure

If needed you can rerun the migration tool. Before you can rerun the tool:

  1. Rollback the migration on the Web GUI server.
  2. Remove the following files and directories:
    1. On the Netcool/Webtop server, remove the MIGRATION_TOOL_HOME/output directory before you rerun the webtop13_migration_export command.
    2. On the Web GUI server, remove the MIGRATION_TOOL_HOME/output directory before you rerun the migration_import command. You must also remove the migratedRoles.war file before you rerun the addAllRolesAndRelationships script.