Edit
Attach
P
rintable
r14 - 2014-08-21 - 18:49:54 - Main.bsilverm
You are here:
TWiki
>
Deployment Web
>
DeploymentInstallingUpgradingAndMigrating
>
RunningTheRMUpgradeScriptForVersion50
<div id="header-title" style="padding: 10px 15px; border-width:1px; border-style:solid; border-color:#FFD28C; background-image: url(<nop>https://jazz.net/wiki/pub/Deployment/WebPreferences/TLASE.jpg); background-size: cover; font-size:120%"> ---+!! <img src="https://jazz.net/wiki/pub/Deployment/WebPreferences/new.png" alt="new.png" width="50" height="50" align="right"> Running the RM upgrade script for version 5.0 %DKGRAY% Authors: Main.BenjaminSilverman<br> Build basis: Version 5.0 of the Collaborative Lifecycle Management (CLM) products: IBM Rational Team Concert, IBM Rational Quality Manager, and IBM Rational DOORS Next Generation %ENDCOLOR%</div></sticky> <!-- Page contents top of page on right hand side in box --> <sticky><div style="float:right; border-width:1px; border-style:solid; border-color:#DFDFDF; background-color:#F6F6F6; margin:0 0 15px 15px; padding: 0 15px 0 15px;"> %TOC{title="Page contents"}% </div></sticky> <sticky><div style="margin:15px;"></sticky> When you upgrade to version 5.0 of the Requirements Management (RM) application from a release of version 4.x, you must run the RM upgrade script for version 5.0. This article outlines the steps to run the script, provides sample input and output, and describes steps that require special attention. ---++ Before you begin * When you upgrade, your first step must always be to follow the <a href="http://www-01.ibm.com/support/knowledgecenter/SSYMRC_5.0.0/com.ibm.jazz.install.doc/topics/roadmap_clm_upgrade.html" target="_blank">interactive upgrade guide</a>. This article focuses on the "Upgrading the Requirements Management application" step in the upgrade guide. Before you follow the steps in this article, complete all of the steps before the "Upgrading the Requirements Management application" step. * You can use the upgrade script only if all of the following conditions are met. To confirm that you can use the script in your environment, check the <a href="http://www-01.ibm.com/support/knowledgecenter/SSYMRC_5.0.0/com.ibm.jazz.install.doc/topics/roadmap_clm_upgrade.html" target="_blank">interactive upgrade guide</a>. * Jazz Team Server (JTS) was upgraded to version 5.0 * All applications are installed on the same server *OR* the applications are distributed and you can mount shared directories between servers * Your server is not running on a double-byte character set Windows server * Make sure that Jazz Team Server is shut down. * Copy the =teamserver.properties= file from =JTS_5.0_install_dir\server\conf\jts= to =RM_5.0_install_dir\server\conf\rm=, replacing the existing file. If you do not plan to use the upgrade script, see <a href="RM4to5MigrationTipsTricksProblemsAndSolutions" target="_blank">Migrating the RM application to V5 from V4.x: Tips, common problems, and workarounds</a>. ---++ About this task The following procedure contains the steps to use the upgrade script to upgrade a 4.0.6 server to version 5.0. The details of the environment in this example are as follows: | *Version* | *Installation directory (Windows)* | *Database name (DB2)* | | 4.0.6 | E:\IBM\JazzTeamServer406 | !JTS406GA (Original JTS database) | | 5.0 | E:\IBM\JazzTeamServer50 | !RM50GA (New RM database) | <img alt="Image1.jpg" src="%ATTACHURL%/Image1.jpg" /><br> Throughout the process, the upgrade script prompts you to provide and confirm input values, as shown in the following image.<br> <img alt="Image2.jpg" src="%ATTACHURL%/Image2.jpg" /><br> ---++ Procedure To upgrade the Requirements Management application: 1. Log in as a user who has administrative privileges and open a command prompt. 1. Go to the =RM_5.0_install_dir\server= directory and enter this command: <verbatim> upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_4.0.6_install_dir\server\conf </verbatim><br> *Exceptions:* * If the requirements management context root is not =/rm=, set the following variables before you run =rm_upgrade=: <verbatim> set JAZZ_PROVISION_PROFILES=5.0_install_dir\server\conf\rdm\provision_profiles set JAZZ_CONTEXT_PATH=rdm </verbatim> * If your Jazz Team Server context root is different from the defaults, use the =oldJTSContextRoot= and =newJTSContextRoot= parameters to ensure that the RM configuration files are correctly upgraded. For example: <verbatim> upgrade\rm\rm_upgrade.bat -oldApplicationHome RM_4.0.6_install_dir\server\conf -newJTSHome JTS_5.0_install_dir\server\conf -oldJTSContextRoot jazz1 -newJTSContextRoot jts2 </verbatim> 1. As shown in the next image, you are prompted to enter a JDBC location, which is the location of your new RM database. That database was created in a previous step of the interactive upgrade guide. RM-specific data will be copied from your Jazz Team Server database to the new RM database. The format of the connection string will vary by vendor:<br><br> | <b>DB2</b> | //localhost:50000/RM50:user=db2inst1;password={password}; | | <b>SQL Server</b> | //localhost:1433;databaseName=RM50;user=jazzDBuser;password={password} | | <b>Oracle</b> | thin:jazzDBuser/{password}@//localhost:1521/ORCL | <br><img alt="Image3.jpg" src="%ATTACHURL%/Image3.jpg" /><br><br> 1. After you enter and confirm your database connection string, you are prompted to enter the password for the database user that is specified in the connection string. In this case, the user is =db2admin= and the password is =Rat1onal=. <br><br><img alt="Image4.jpg" src="%ATTACHURL%/Image4.jpg" /><br><br> 1. If you configured a data warehouse, you are prompted to enter the JDBC location. Because the data warehouse connection string is already written to the =teamserver.properties= file that you copied from Jazz Team Server before you ran the upgrade script, the value is pre-filled and you can press Enter to accept the default value shown. If the value is not pre-filled, enter the JDBC location by using the vendor specific format as shown in the previous table. <br><br><img alt="Image5.jpg" src="%ATTACHURL%/Image5.jpg" /><br><br> 1. Enter and confirm the password for the database user that is specified in the connection string for the data warehouse: <br><br><img alt="Image6.jpg" src="%ATTACHURL%/Image6.jpg" /><br><br> 1. When you are prompted to enter the new indices directory to use to store the RM indices, accept the default value, which will store the indices in the version 5.0 =JAZZ_HOME/server/conf/rm/indices= directory. If you want to specify an absolute path for the index files, ensure that the path is different from the path for the Jazz Team Server indices. A later step in the upgrade script will reindex the RM data to store the indices in the specified directory. <br><br><img alt="Image7.jpg" src="%ATTACHURL%/Image7.jpg" /><br><br>After you confirm the indices location, the =teamserver.properties= file is configured by using the values that you specified in previous steps. <br><br><img alt="Image8.jpg" src="%ATTACHURL%/Image8.jpg" /><br><br> 1. Verify that the values in the =teamserver.properties= file are correct. If you notice problems with any of the properties, correct them and save the file. Otherwise, close the editor and the upgrade script will continue.<br><br> _Figure 1. Notification that the file was merged successfully_ <br><img alt="Image9.jpg" src="%ATTACHURL%/Image9.jpg" /><br><br> _Figure 2. The teamserver.properties file_ <br><img alt="Image10.jpg" src="%ATTACHURL%/Image10.jpg" /><br><br> _Figure 3. Updating the database schemas_ <br><img alt="Image11.jpg" src="%ATTACHURL%/Image11.jpg" /><br><br> _Figure 4. Confirming that you want to update the database tables_ <br><img alt="Image12.jpg" src="%ATTACHURL%/Image12.jpg" /><br><br> _Figure 5. Starting the migration of the local RM project to RM project associations_ <br><img alt="Image13.jpg" src="%ATTACHURL%/Image13.jpg" /><br><br> _Figure 6. Initializing the publishing service_ <br><img alt="Image14.jpg" src="%ATTACHURL%/Image14.jpg" /><br><br> *Note:* In the next step, the application has been finalized. Although the text in red suggests that you must run the finalize command, you do not need to run that command when you are using the upgrade script. That text comes from the underlying command that is being run by the upgrade script. <br><br><img alt="Image15.jpg" src="%ATTACHURL%/Image15.jpg" /><br><br> 1. At this point, you can reindex the RM data. The RM indices will be created in the directory that you specified in the "Enter RM Root Index Directory" step. You can also skip the reindex step; however if you do, the data will be reindexed when you start the server. At that point, you cannot use the application until the indices are built. <br><br><img alt="Image16.jpg" src="%ATTACHURL%/Image16.jpg" /><br> <br><br><img alt="Image17.jpg" src="%ATTACHURL%/Image17.jpg" /><br><br> 1. Start the server or servers for the applications that host linked data (ie - CCM/QM/JTS), and then log in to the Jazz Team Server application. By doing so, you ensure that the Jazz Team Server application is initialized and is ready to process requests. <br><br><img alt="Image18.jpg" src="%ATTACHURL%/Image18.jpg" /><br><br> 1. Enter the ID and password of a user with the !JazzAdmin role on the server. If the default ADMIN/ADMIN user ID and password are enabled (Tomcat only), you can accept the defaults. Otherwise, specify a valid user ID and password for a valid user in your directory with the !JazzAdmin role. <br><br><img alt="Image19.jpg" src="%ATTACHURL%/Image19.jpg" /><br> <br><br><img alt="Image20.jpg" src="%ATTACHURL%/Image20.jpg" /><br><br> The project back links that point to the RM server are updated. At this point, all applications that reference the newly upgraded RM server must be up and running. These applications may be at either 4.x or 5.0.<br><br>Please make sure that your 4.x licenses have been replaced with 5.x licenses or you will receive the following error:<br><verbatim>ERROR(s): One or more remote project links could not be updated. Please ensure that all linked applications server are online, check your username and password, and ensure that the user you are using has a valid license in the target application(s).</verbatim><br>Log in to the JTS application before completing this step to ensure there are no errors on the status page. If the upgrade is successful, the following message is shown. <br><br><img alt="Image21.jpg" src="%ATTACHURL%/Image21.jpg" /><br> ---+++++!! Related topics: [[DeploymentWebHome][Deployment web home]], [[RM4to5MigrationTipsTricksProblemsAndSolutions][Migrating the RM application to V5 from V4.x: Tips, common problems, and workarounds]] ---+++++!! External links: * [[https://www.ibm.com][IBM]] ---+++++!! Additional contributors: <sticky></div></sticky>
Edit
|
Attach
|
P
rintable
|
V
iew topic
|
Backlinks:
We
b
,
A
l
l Webs
|
H
istory
:
r15
<
r14
<
r13
<
r12
<
r11
|
More topic actions...
Deployment
Deployment web
Planning and design
Installing and upgrading
Migrating and evolving
Integrating
Administering
Monitoring
Troubleshooting
Community information and contribution guidelines
Create new topic
Topic list
Search
Advanced search
Notify
RSS
Atom
Changes
Statistics
Web preferences
NOTE: Please use the Sandbox web for testing
Status icon key:
To do
Under construction
New
Updated
Constant change
None - stable page
Smaller versions of status icons for inline text:
Copyright © by IBM and non-IBM contributing authors. All material on this collaboration platform is the property of the contributing authors.
Contributions are governed by our
Terms of Use.
Please read the following
disclaimer
.
Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more
here
.