Client and server version compatibility

You can connect to a newer version server by using an older version client, but you cannot connect to an older version server by using a newer version client.

The same principle applies between servers. Jazz™ Team Server must be at the same level as or newer than the applications that are registered with it, but the applications cannot have a newer version than Jazz Team Server.

Client N-1 compatibility is supported, which means that you can upgrade a server to the next release without upgrading the clients. This backward compatibility applies to the following clients:
  • Client for Eclipse IDE
  • Client for Microsoft Visual Studio IDE
  • SCM command line
  • ISPF client
  • Jazz Build Engine
  • Windows shell

Clients are also compatible across fix packs for a release. When combined with N-1 compatibility, this means that client R works with all future fix packs for server R in addition to server R+1 and all future fix packs for server R+1. Note that servers must always be at the same level as or newer than clients. For example, client 6.0 can connect to server 6.0.5, but if client 6.0.5 attempts to connect to server 6.0 a message informs you that the versions do not match.

Rational® Team Concert® repository workspaces are compatible from version 2. This means that if you have a version 2 repository workspace, you can still use it with your upgraded Eclipse client.

The following table shows the client and server compatibility for version 5.0 and later. The table applies to the clients that are listed earlier in this topic.

Note: Rational Software Architect Design Management client began its backward compatibility support in version 4.0 interim fix 1.

Compatibility between version 4.x to 6 is not supported. You must first upgrade your version 4.x server to the latest release of version 5, then upgrade to version 6.

Table 1. Client and server compatibility
Client version Server version
  5.0 5.0.1 5.0.2 6.0 6.0.1 6.0.2 6.0.3 6.0.4 6.0.5 6.0.6 6.0.6.1
5.0 Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
5.0.1 No Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
5.0.2 No No Yes Yes Yes Yes Yes Yes Yes Yes Yes
6.0 No No No Yes Yes Yes Yes Yes Yes Yes Yes
6.0.1 No No No No Yes Yes Yes Yes Yes Yes Yes
6.0.2 No No No No No Yes Yes Yes Yes Yes Yes
6.0.3 No No No No No No Yes Yes Yes Yes Yes
6.0.4 No No No No No No No Yes Yes Yes Yes
6.0.5 No No No No No No No No Yes Yes Yes
6.0.6 No No No No No No No No No Yes Yes
6.0.6.1 No No No No No No No No No No Yes
The following table shows the version compatibility between different servers.
Note: Rational DOORS® Next Generation first became available in version 4.0.1, so the compatibility for that product begins with that version.

Jazz Reporting Service (JRS) which includes Data Collection Component, Lifecycle Query Engine, and Report Builder first became available in version 5.0, so the compatibility for those products begins with that version. You can install JRS and the JTS at a higher level than the applications themselves, but JRS and the JTS must be at the same level. For example, JRS 7.0 and JTS 7.0 works with CCM 6.0.6.1.

Rational Engineering Lifecycle Manager became available in version 4.0.3, so the compatibility for that product begins with that version.

As of version 5.0, IBM® Rational Requirements Composer is renamed to IBM Rational DOORS Next Generation. For more details, read this Jazz.net blog post.

Rhapsody Model Manager first became available in version 6.0.5, so the compatibility for that product begins with that version.

Table 2. Server and server compatibility
Server version  
  JTS 5.0 JTS 5.0.1.x JTS 5.0.2.x JTS 6.0 JTS 6.0.1 JTS 6.0.2 JTS 6.0.3 JTS 6.0.4 JTS 6.0.5 JTS 6.0.6 JTS 6.0.6.1
RTC, RQM, DNG,JRS, RELM 5.0 Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
RTC, RQM, DNG,JRS, RELM 5.0.1.x No Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes
RTC, RQM, DNG,JRS, RELM 5.0.2.x No No Yes Yes Yes Yes Yes Yes Yes Yes Yes
RTC, RQM, DNG,JRS, RELM 6.0 No No No Yes Yes Yes Yes Yes Yes Yes Yes
RTC, RQM, DNG,JRS, RELM 6.0.1 No No No No Yes Yes Yes Yes Yes Yes Yes
RTC, RQM, DNG,JRS, RELM 6.0.2 No No No No No Yes Yes Yes Yes Yes Yes
RTC, RQM, DNG,JRS, RELM 6.0.3 No No No No No No Yes Yes Yes Yes Yes
RTC, RQM, DNG, JRS, RELM 6.0.4 No No No No No No No Yes Yes Yes Yes
RTC, RQM, DNG, JRS, RELM, RMM 6.0.5 No No No No No No No No Yes Yes Yes
RTC, RQM, DNG, JRS, RELM, RMM 6.0.6 No No No No No No No No No Yes Yes
RTC, RQM, DNG, JRS, RELM, RMM 6.0.6.1 No No No No No No No No No No Yes
Note: Jazz Team Server must be at the same level as or newer than the applications that are registered with JTS. Even if you are upgrading to the next fix pack level, you must first upgrade Jazz Team Server.

Server compatibility for distributed Source Control Management (SCM)

Future releases might not support backwards compatibility with respect to distributed SCM, if there are significant changes to how SCM manages its data.

If you need to perform distributed SCM operations between a server that is running Rational Team Concert 4.0.4 or earlier and a server that is running Rational Team Concert 4.0.6 or higher, you must upgrade your version 4.0.4 server to version 4.0.6 or higher.

Note: In general, it is a good practice that all servers involved in a distributed SCM be at the same version level. Also note that the N-1 compatibility is not supported in a distributed SCM. This means that distributed SCM does not work between version 4.x and 5.x servers or future releases. For more information about flowing changes across repositories with Rational Team Concert, see this Jazz.net article.Distribute SCM does not work between 4.x and 5.x servers.

Acronyms used in this topic

  • JTS: Jazz Team Server
  • RTC: Rational Team Concert
  • RQM: Rational Quality Manager
  • RRC: Rational Requirements Composer
  • DNG: Rational DOORS Next Generation
  • JRS: Jazz Reporting Service
  • DCC: Data Collection Component
  • LQE: Lifecycle Query Engine
  • RELM: Rational Engineering Lifecycle Manager
  • RMM: Rhapsody Model Manager

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki