IBM Support

How to Rerun the Migration Process for Rational Team Concert 2.0.0.x (DB2)

Technote (troubleshooting)


When ram.setup stops its migration process due to repotools failures, this technote provides instructions that users can use to recover from the failure and rerun the migration process.

Resolving the problem

Use this method only if the repotools script failed to migrate your IBM Rational Team Concert (RTC) v2.0.0.x while upgrading your IBM Rational Asset Manager (RAM) to version If you use an external RTC instance that is not packaged with RAM, please do not use this technote, and instead, contact Jazz Support Team for further assistance.

Also, it is important to ensure that the database server has enough disk space to host RAMDB, RTCDB, and JTSDB. Note, your database account should have DBA to these databases.

For SQLServer and Oracle users, contact your Database Administrator when you need to complete steps 2 and 3 of this document.

  1. Stop your IBM WebSphere Application Server
    $ /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/ server1
  2. This is the most important step; you MUST not skip it.
    Go to [profile_home]/temp and then delete the rtc2To4Migration.txt file
    $ cd /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp
    $ rm rtc2To4Migration.txt
  3. Restore the Rational Team Concert v2.0.0.2 database
    $ db2 restore database RTCDB from ~/backup_folder/ on /home/db2inst1/ into RTCDB redirect without prompting
    $ db2 restore DATABASE RTCDB continue
  4. Drop the JTS database and recreate it
    $ db2 drop db JTS
    $ db2 create database JTS using codeset UTF-8 territory en pagesize 16384
  5. Start your WebSphere Application Server
    $ /opt/IBM/WebSphere/AppServer/profiles/AppSrv01/bin/ server1
  6. Stop RAM1WebApplication, ramccm_war and ramjts_war application
  7. Start
  8. Use your web browser and go directly to ram.setup/wizard/database/NewDatabaseSetupServlet
  9. Select "You have already created all three databases and want to modify the settings.”
  10. Verify the Rational Team Concert installation locations and then add RTC and Jazz Team Server (JTS) URLs
  11. Rerun the migration by clicking the Migrate button

Document information

More support for: Rational Asset Manager

Software version:

Operating system(s): AIX, Linux, Windows

Reference #: 1634240

Modified date: 03 May 2013

Translate this page: