Start of developer client session results in "Changes have been made to your IBM Rational Synergy server that require you to update your client installation" error
Attempts to start a developer client session results in the fatal error "Changes have been made to your IBM Rational Synergy server that require you to update your client installation."
Attempts to start a Developer/Java client using the cmsynergy command or executable a dialog box is displayed with the message:
Changes have been made to your IBM Rational Synergy server that require you to update your client installation.
See your IBM Rational Synergy administrator for information about updating to the current version.
You get an option to
When you start a Rational Synergy client session the software version on the Client and Server must be the same and the Database must have been updated or upgraded to the same version.
Since the release 6.4 of Telelogic Synergy there is a check on client startup to see if they are the same release. If they are not the same then you will get this error.
In previous releases of Synergy the client session would fail with Accent errors.
Technote 1325535: Starting a client crashes with "Unknown function name" ACcent abort messages in Rational Synergy
Diagnosing the problem
When a patch or interim fix is installed on a Rational Synergy client or server installation, the installation process updates a file,
%CCM_HOME%\etc\patches.dat on Windows, with an entry for the particular ifix or patch version.
When a Developer Client client is started the
patches.dat file on the client is compared with the
patches.dat file on the server installation. If the contents of these files are not the same, then you get the error message.
Resolving the problem
When you select
Continue the client deployment module will download the appropriate patch from the server to the client and update the necessary files.
You can also point a web browser to your Rational Synergy Help server (typically installed as
This operation can also be done manually by browsing to the following URL:
When you start a Rational Synergy in
-nogui mode on Windows, you are notified that an update is required. The client cannot continue, and the update must be installed manually.
If you still see the message then run the
ccm version command on the client and server to see what version is reported.
Make sure that your client session is pointing to the correct Rational Synergy server by ensuring that the address in the
router.adr files are the same on the client and server. This file is
.router.adr in a UNIX installation and
_router.adr on a Windows installation.
More support for:
Software version: 6.4, 6.5a, 6.5, 6.6a, 7.0, 7.1a, 7.1, 22.214.171.124, 126.96.36.199, 7.2
Operating system(s): AIX, HP-UX, Linux, Solaris, Windows
Reference #: 1324891
Modified date: 08 January 2013