This section is a summary of changes in IBM® Rational® Synergy 7.2 or later or
later release that you must take into account 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 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 must 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 or
later, and are replaced by the Rational Synergy GUI
and Rational Synergy CLI.
A separate document, Migrating to the Rational Synergy
CLI, describes the transition to the Rational Synergy CLI. Issues to consider before upgrading describes the fact that the Rational Synergy CLI
and GUI do not yet provide all the capabilities 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 must update their projects to use
process rules. This is described in a separate technote, Conversion to Process Rules.
An upgrade
advisor is available to assist with this process. See Upgrade Advisor User Guide.
- Whereas Rational Synergy releases
7.0 and 7.1 supported two modes of operation, traditional mode and
web mode, Rational Synergy 7.2 or later or
later supports only web mode. This is not apparent to users in most
cases, except for these situations:
- The syntax of the ccm start and cmsynergy commands
no longer support the -h option.
- Client-side triggers are now executed on the server.
- In Rational Synergy 7.2 or later 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 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 or
later uses an improved ccm_delta that is more space
efficient than the one in 7.1.
Release 7.2 or later 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 determined not to be readable by the BSD archiver previously,
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 or
later installation. This applies only 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 or
later format. The conversion is required in Release 7.2 or later or
later. See Performing archive conversions.