IBM Tivoli Software IBM Tivoli Software

[ Bottom of Page | Previous Page | Next Page | Contents ]


1. Getting started

The procedures in this section are all performed on the computer where the administration server is installed.

  1. Download migration package: If you have obtained this readme file other than by downloading the migration tool, you now need to download it. Go to the Tivoli License Manager support web site. The URL is
    http://www-306.ibm.com/software/sysmgmt/products/support/IBMTivoliLicenseManager.html
    The migration packages will be in the Downloads section of the page that is displayed. The following items are available:
    2.1-TLM-MigrationTool.tar
    This contains the scripts for use on AIX. The files are as follows:
    • catalogConverter.sh
      catalogConverter.xsl
      CatalogHandler.class
      checks_111_21.sql
      create_db.sql
      create_fct.sql
      create_tr.sql
      create_v.sql
      drop_111.sql
      ext_id_update_111.sql
      ext_id_update_111_21.sh
      migrate_111_21.sql
      migration_111_21.sh
      opt_field_def.dat
      swcat_create_fct.sql
      swcat_create_tr.sql
      META-INF
           MANIFEST.MF
      
    The main scripts that you will be using are as follows:
    catalogConverter.sh
    The catalog converter.
    ext_id_update_111_21.sh
    The script for updating the external ID fields in the database.
    migration_111_21.sh
    The script for migrating the database.
    2.1-TLM-MigrationTool.zip
    This contains the scripts for use on Windows. The files are broadly the same as in the corresponding tar file, except that the scripts are batch files with the extension .bat. The details are as follows:
    • catalogConverter.bat
      catalogConverter.xsl
      CatalogHandler.class
      checks_111_21.sql
      create_db.sql
      create_fct.sql
      create_tr.sql
      create_v.sql
      drop_111.sql
      ext_id_update_111.sql
      ext_id_update_111_21.bat
      migrate_111_21.sql
      migration_111_21.bat
      opt_field_def.dat
      swcat_create_fct.sql
      swcat_create_tr.sql
      META-INF
           MANIFEST.MF
      
    2.1-TLM-MigrationTool_readme.pdf
    The pdf of the readme file that you are now reading.
    2.1-TLM-MigrationTool_readme.zip
    A zipped file containing the html version of the readme file that you are now reading. If you unzip the file it will create a folder called 2.1-TLM-MigrationTool_readme. Open the file 2.1-TLM-MigrationTool_readme.htm in this folder with your Internet browser to access the html version. The folder contains all the files necessary for the html version.
    Download the readme file, package or packages that you require.
    Note:
    Two of these scripts are run on the administration server and one on the administration server database. If one of these components is on Windows and the other on AIX, you will need both packages, and you must ensure you use the scripts for the correct package on the appropriate computer.
  2. Unzip the package: Unzip the package extracting all of the files into the following directory on the V2.1 administration server computer:
    <INSTALL_DIR>\admin\cli
    Where <INSTALL_DIR> is the V1.1.1 installation directory.
  3. On AIX, set permissions: On AIX, run the following command to add read and execute permissions to the DB2 instance owner that will run scripts in later steps:

    chmod +rx <files>

    where <files> are all the files in the package.

  4. Download V2.1 IBM software catalog: Download the latest version of the V2.1 IBM software catalog from its Web site:
    http://www-306.ibm.com/software/sysmgmt/products/support/IBMTivoliLicenseManager.html
    and save the XML catalog file into the same directory where you unzipped the migration package.
    Note:
    Make sure you get the V2.1 catalog, as the catalogs for V1.1.1 and V2.1 are quite different in structure.
  5. Make another copy of the catalog: Make an additional copy of the IBM software catalog outside the V1.1.1 installation directory. In these instructions the location of this directory will be called <CAT_TEMP_DIR>.

[ Top of Page | Previous Page | Next Page | Contents ]