This topic describes how to upgrade IBM® Rational® Requirements Composer from version 2 to version 3.0.1 by using the rm_upgrade script.
Before you begin the upgrade, ensure that the clocks on all machines are synchronized by using the Network Time Protocol (NTP). Time is the critical element that allows an event on one network node to be mapped to a corresponding event on another. To avoid problems, these challenges can be overcome by the enterprise deployment of the NTP service. For more information about NTP, visit http://www.ntp.org/ In addition, all servers must use the same authentication method for their users.
If you plan to upgrade multiple products, see Upgrade order to help you decide what to upgrade first.
You can follow these upgrading instructions for using the upgrade script if you have a single server deployment or if you are have a distributed deployment and you can mount a drive from Jazz Team Server and Requirements Management.
If you are using a distributed network deployment and you are not allowed to mount the drive or if you are an advanced administrator and you plan to complete each step manually, then you can follow the Upgrading offline to 3.0.1 manually instructions. The manual steps detail what the scripts are performing.
In an IBM WebSphere® Application Server environment, change the installation path to one that contains no spaces, such as C:\IBM\JazzTeamServer. However, if any file name or file path parameter contains a space, you must surround the parameter with double quotation marks, for example, "C:\Program Files\IBM".
You must use the same public URI in version 3.0.1. If a public URI was not set, use the version 2 administrative web interface (Advanced Properties) to set the qualified host name URI (https://hostname.example.com:port) before upgrading.
com.ibm.team.repository.server.webapp.url=https\://hostname.example.com\:9443/jazz
Windows: repotools -export toFile=c:\tmp\rrcdata.tar
AIX or Linux: repotools -export toFile=/tmp/rrcdata.tar
where the toFile variable specifies the name of the .tar file that the database is exported to.
Databases are required for the Jazz Team Server and the data warehouse. You do not have to create a database for Requirements Management application because that application uses the Jazz Team Server database for data storage. See the topics in Setting up the database for details about each database.
During installation, select Use Rational Requirements Composer 2.x context root. This selection will install the RM application with the required option to preserve the /rdm version 2 context root for RM, which is necessary for preserving links to RM artifacts. Failure to select this option will result in a failed upgrade. For details, see Understanding the deployment and upgrade process.
If you installed the Jazz Team Server version 3.0.1 together with the RM application, and this upgrade is for the first or only application you are upgrading, the command syntax is as follows:
Windows:
upgrade\rm_upgrade.bat -oldApplicationHome RRC2InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables
AIX or Linux:
./upgrade/rm_upgrade.sh -oldApplicationHome RRC2InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables
If you installed the Jazz Team Server version 3.0.1 separately from the RM application, such as in a distributed deployment, you must specify the location of the RM application and run the script from the Jazz Team Server version 3.0.1 installation directory. In this case, include the -newApplicationHome argument.
Windows:
JTS301InstallDir\server upgrade\rm_upgrade.bat -oldApplicationHome RRCS2InstallDir\server\conf -importFromFile c:\tmp\export.tar -newApplicationHome RRC301InstallDir\server\conf -jtsURL https://fully qualified domain name:port/jts
AIX or Linux:
JTS301InstallDir/server ./upgrade/rm_upgrade.sh -oldApplicationHome RRCS2InstallDir/server/conf -importFromFile /tmp/export.tar -newApplicationHome RRC301InstallDir/server/conf -jtsURL https://fully qualified domain name:port/jts
For more details about command-line options, type one of these commands:
Windows: upgrade\rm_upgrade.bat -help
AIX or Linux: ./upgrade/rm_upgrade.sh -help
This script completes the following tasks:
The English and translated versions of the parameters files are located in the JazzInstallDir\server\upgrade\params\rm_params.bat directory on Windows or the ./params/rm_params.sh directory on AIX or Linux systems.