Here is a summary of the changes in Rational® Synergy 7.2
or later that you must consider when planning your upgrade. These
changes require additional testing beyond the testing you have done
for previous releases.
- The database encoding used for text metadata has changed from Windows CP1252 to UTF-8. Upgrading
a database from 7.0 or 7.1 to 7.2 or later causes all such metadata
to be converted to use a UTF-8 encoding. If you are upgrading from
7.0 or 7.1, you will need to run the Illegal Character Detection Tool,
to determine whether any of your metadata contains characters that
are not in the CP1252 encoding. The procedure for running this tool
is described in Text encoding and the Illegal Character Detection tool.
- The limit on the length of a string in a query has changed from
64 characters in the CP1252 encoding to 72 bytes in the UTF-8 encoding.
The section Checking query limits and accelerated attributes explains
the issue in further detail.
- The classic client GUI and CLI are no longer supported in 7.2
or later, and are replaced by the Rational Synergy GUI
and Rational Synergy CLI.
A separate document, Migrating to the Rational Synergy
CLI, discusses the transition to the Rational Synergy CLI. Issues to consider before upgrading discusses the fact that the Rational Synergy CLI
and GUI don't yet provide all the functionality of the classic
CLI and GUI.
- Since the Rational Synergy GUI
and Rational Synergy CLI
do not support manual update properties or object status-based update,
users who relied on these features need to update their projects to
use process rules. This is discussed in a separate Technote, Conversion to Process Rules.
- Whereas Rational Synergy releases
7.0 and 7.1 supported two modes of operation, traditional mode and
web mode, 7.2 or later only support web mode. This change is mostly
transparent to users, except for the following:
- The syntax of the ccm start and cmsynergy commands
no longer support the -h option.
- Client-side triggers are now executed on the server machine.
- In release 7.2 or later, the page size for an INFORMIX database
server has changed from 2K to 4K on UNIX.
This means that UNIX databases
cannot be upgraded in place, and a new INFORMIX database server is
required. For the Windows platform,
upgrading an existing INFORMIX database server still remains an option.
- Rational Synergy 6.5
and earlier used GNU RCS and compress to archive checked-in files.
Release 7.0 used a BSD archiver. Release 7.1 used a new Rational archiver, ccm_delta.
Release 7.1 Fixpack 7.1.0.2 and Release 7.2 or later use an improved ccm_delta that
is more space efficient than the one in 7.1.
Release 7.2 or later
still uses the old utilities to read old archives, except that it
uses the BSD archiver to read GNU archives. If you have GNU archives
that were previously determined not to be readable by the BSD archiver,
and you have not converted them, then you must use ccm_copy_tools to
copy the GNU archiver from your old installation to your 7.2 or later
installation. This only applies if your database is from Release
6.5 or earlier.
You can use the Rational Synergy Web
Administration Interface to convert old archives to the new 7.2 or
later format. The conversion is required in Release 7.2 or later.
See Performing archive conversions.