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

Technote (troubleshooting)


Problem(Abstract)

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."

Symptom

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 Continue or Cancel

Cause

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 or %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 http:// :8400/client ) which should provide you with the particular patch executable needed to update your client installation. Selecting the appropriate " Update xxxx " executable should allow you to update your client to the necessary and appropriate level.


This operation can also be done manually by browsing to the following URL:
http:// :

For example:
]http:// : will download and install ifix 7.1.0.2.04 for Rational Synergy


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.

Related information

Linux client update fails with file error in Rational

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational Synergy
General Information

Software version:

6.4, 6.5a, 6.5, 6.6a, 7.0, 7.1a, 7.1, 7.1.0.1, 7.1.0.2, 7.2

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows

Reference #:

1324891

Modified date:

2013-01-08

Translate my page

Machine Translation

Content navigation