Downloading and installing the TM1 Database 12 Migration Utility

The TM1 Database 12 Migration Utility is available for both Linux and Windows.

About this task

The Windows version of the TM1 Database 12 Migration Utility requires the Visual C++ Redistributable for Visual Studio 2015, available from https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170.

Procedure

  1. Download the TM1 Database 12 Migration Utility from IBM Passport Advantage.

    The utility is available as an archive named migration-tool-<version>.zip. This archive contains two migration tool archives, one each for the Windows (migration-tool-windows.zip) and Linux (migration-tool-linux.tgz) platforms .

  2. Extract the migration tool archive for your platform from migration-tool-<version>.zip.
  3. For Windows, use the Windows File Explorer to extract the migration-tool-windows.zip contents into the desired location. The extracted contents include \bin64\migrate_tm1.exe, which you will run to execute the migration.
  4. For Linux, start a terminal session on the machine where you will be running the migration utility.

    In that session, unpack the migration-tool-linux.tgz with:

    mkdir -p <utility_installation_directory> 
tar xf <path_to_gzip file> -C <utility_installation_directory>

    For example, 

    mkdir -p ~/migration_tool/linux
tar xf ~/Downloads/migration_tool-linux.tgz -C ~/migration_tool/linux

    This example creates the /migration_tool/linux directory and extracts the migration_tool-linux.tgz archive to that new directory. The directory includes /bin64/migrate_tm1.exe, which you will run to execute the migration.