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
- Log in to the Administration page of the 2.0 Jazz Team Server at
this URL: https://yourServerHostName:yourJazzServerPortNumber/jazz/admin.
- In the Configuration pane, click Advanced
Properties.
- In a Current Value field for property Public
URI Root, enter https://yourServerHostName:yourJazzServerPortNumber/jazz and
click Save.
- Point to https://yourServerHostName:yourJazzServerPortNumber/jazz/admin?internal#action=com.ibm.team.repository.admin.serverReset and
click Request Server Reset.
- Log on the WebSphere® administrative
console for the Rational Team Concert for IBM i V2.0
server at http://yourServerHostName:yourWASAdminPortNumber/ibm/console.
- Expand Servers, select Application
servers, and record the server name and node name.
- Expand Applications, select Enterprise
Application and record the name for the Jazz application, such as jazz_war.
- Log on to the IBM i operating
system using a user ID with QSECOFR authority.
- Stop the Rational Team Concert for IBM i 2.0
server.
- Install the Rational Team Concert 3.0.1
Licensed Program on IBM i.
- In QShell, navigate to the Rational Team Concert 3.0.1
installation directory /QIBM/UserData/JazzTeamServer301/server.
- 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.
- 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.
- Run through the rest of steps in jazz_upgrade_from_2.0.sh.
- 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.
- 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.