Upgrading from version 2 to 3.0.1 on IBM i using the upgrade script

You can use upgrade scripts on IBM® i to minimize the number of commands that you must manually run to upgrade your Jazz™ Team Server (JTS) and Change and Configuration Management (CCM) application data from version 2 to 3.0.1.

Before you begin

Before you upgrade the server, ensure that you have a complete up-to-date and valid backup of your Rational Team Concert™ for IBM i version 2.x repository database.

About this task

Follow these steps to upgrade the Rational Team Concert for Power Systems Software™ version 2.x Jazz Team Server to the Rational® solution for Collaborative Lifecycle Management (CLM) version 3.0.1 Jazz Team Server on IBM i:

Procedure

  1. Log in to the Administration page of the 2.0 Jazz Team Server at this URL: https://yourServerHostName:yourJazzServerPortNumber/jazz/admin.
  2. In the Configuration pane, click Advanced Properties.
  3. In a Current Value field for property Public URI Root, enter https://yourServerHostName:yourJazzServerPortNumber/jazz and click Save.
  4. Point to https://yourServerHostName:yourJazzServerPortNumber/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset and click Request Server Reset.
  5. Log on the WebSphere® administrative console for the Rational Team Concert for IBM i V2.0 server at http://yourServerHostName:yourWASAdminPortNumber/ibm/console.
  6. Expand Servers, select Application servers, and record the server name and node name.
  7. Expand Applications, select Enterprise Application and record the name for the Jazz application, such as jazz_war.
  8. Log on to the IBM i operating system using a user ID with QSECOFR authority.
  9. Stop the Rational Team Concert for IBM i 2.0 server.
  10. Install the Rational Team Concert 3.0.1 Licensed Program on IBM i.
  11. In QShell, navigate to the Rational Team Concert 3.0.1 installation directory /QIBM/UserData/JazzTeamServer301/server.
  12. Run the command _upgrade/jazz_upgrade_from_2.0.sh edition, where edition is the edition of the Rational Team Concert for IBM i 2.0 server. The value of edition can be standard, enterprise, or express.
  13. After finishing step 0 and before continuing with step 1, verify that /QIBM/UserData/JazzTeamServer301/server/conf/jts/teamserver.properties contains the correct jdbc location and password.
  14. Run through the rest of steps in jazz_upgrade_from_2.0.sh.
  15. Run the following command to update the 2.0 WebSphere Application Server and deploy the .war files for Rational Team Concert 3.0.1:
    upgrade/was_upgrade.sh profileName nodeName wasVersion wasOption maxHeapSize adminId adminPwd jvmVersion jazzAppName, 
    where:
    • profileName is the 2.0 server name
    • nodeName is the 2.0 server node name
    • wasVersion is the WebSphere Application Server version (V61 or V7)
    • wasOption is the WebSphere Application Server option (Base, ND or Express).
    • maxHeapSize is the maximum heap size you need for the Rational Team Concert 3.0.1 server
    • adminId and adminPwd are the ID and password you used to secure the WebSphere Application Server for Rational Team Concert for IBM i V2.0 server.
    • jvmVersion is the Java Virtual Machine (JVM) version (std64 for V6R1 /V7R1 and std32 for V5R4)
    • jazzAppName is the name of the Jazz application.
  16. You can access your migrated server setup at https://yourServerHostName:yourJazzServerPortNumber/jts/setup where your yourJazzServerPortNumber is the same port number as the port for the for Rational Team Concert V3.0.1 server.

What to do next

Run the setup wizard.

Feedback