IBM Tivoli Software IBM Tivoli Software

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


2. Prepare the catalog

  1. Log on to V1.1.1 administration server computer: Log on to the computer where the V1.1.1 administration server is installed as Administrator (Windows) or root (AIX).
  2. Transform IBM software catalog: Generate a V1.1.1 IBM catalog from the V2.1 catalog using the transformer, as follows:
    1. Start the V1.1.1 administration server command line.
    2. Run the catalog transformer by issuing the following command:
      AIX:
      ./catalogConverter.sh <IBMCatalogFileName>
      Windows:
      catalogConverter.bat <IBMCatalogFileName>
      where <IBMCatalogFileName> is the name of the XML file that you downloaded from the IBM catalog Web site.
  3. Optionally import outstanding catalog changes: If you have any outstanding changes you have made to the catalog with the V1.1.1 catalog manager, use the impcat command to import them into the database.
  4. Clean up database: If you have identified any changes to make to the V1.1.1 administration server database in Plan to migrate to V2.1, prior to the migration, you should implement them now.
  5. Stop the V1.1.1 administration server: Use the following command:
    AIX:
    ./srvstop
    Windows:
    srvstop
  6. Log on to the V1.1.1 administration server database computer: Log on to the V1.1.1administration server database computer as the DB2 administration user (Windows: default is db2admin) or the DB2 instance owner (AIX: default is db2inst1).
  7. Backup database: Backup the V1.1.1 administration server database, saving the backup image outside the V1.1.1 installation directory
  8. Log on to V1.1.1 administration server computer: Log on to the computer where the V1.1.1 administration server is installed as Administrator (Windows) or root (AIX).
  9. Update the EXT_ID fields in the catalog Run a script to prepare the external ID fields in the catalog for use by the migration. The procedure differs according to the platform:
    AIX:
    1. Copy the following files to the home directory of the DB2 instance owner (default is /home/db2inst1):
      • checks_111_21.sql
      • ext_id_update_111.sql
      • ext_id_update_111_21.sh
    2. Change the ownership of those files by issuing the following command:

      chown <DB2_Instance_Owner>:<DB2_Instance_Owner_Group> <files>

      where

      <DB2_Instance_Owner>
      The user id of the DB2 instance owner.
      <DB2_Instance_Owner_Group>
      The user group to which the DB2 instance owner belongs.
      <files>
      The above-mentioned three files.
    3. Change user to the DB2 instance owner (default is db2inst1):

      su <DB2_Instance_Owner>

    4. Run the following command from the administration server command line:
    . ./ext_id_update_111_21.sh
    Windows:
    Run the following command from the administration server command line:

    ext_id_update_111_21.bat

  10. Start the V1.1.1 administration server: Use the following command:
    AIX:
    ./srvstart
    Windows:
    srvstart
  11. Update catalog: Update the catalog as follows:
    1. Use the expcat command from the V1.1.1 administration server command line to export the current catalog.
    2. Use the Import IBM Catalog option on the V1.1.1 catalog manager GUI to merge the exported catalog with the transformed catalog generated at step 2.
    3. Use the impcat command from the V1.1.1 administration server command line to import this catalog into the database.

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