IBM(R) Rational(R) Synergy Fix Pack 7.2.2.1 ------------------------------------------- SUMMARY This README describes the contents of Synergy Fix Pack 7.2.2.1 and describes how to install the Fix Pack on Windows. SUPPORTED RELEASES This section lists the releases to which this Fix Pack may be applied. WHO SHOULD APPLY THIS Fix Pack This section describes for whom this Fix Pack is applicable WHERE TO APPLY THIS Fix Pack This section describes where to apply this Fix Pack DELIVERABLE SYNERGY COMPONENTS AFFECTED This section lists the files that will be replaced by this Fix Pack . INSTALLATION INSTRUCTIONS This section describes how to apply the Fix Pack to your Synergy server and client installations and to your Synergy databases. REVERSING Fix Pack This section describes how to remove the Fix Pack . FIXED ISSUES This section describes the problems fixed in this Fix Pack . SUPPORTED RELEASES This Fix Pack may only be applied to Synergy Release 7.2.2 with Fix Pack 7.2.2.1 installed. This Fix Pack may be installed directly on top of Synergy 7.2.2 WHO SHOULD APPLY THIS Fix Pack This Fix Pack should be installed at all sites running Synergy Release 7.2.2 WHERE TO APPLY THIS Fix Pack This Fix Pack should be installed to all Synergy installations (CCM_HOME) and clients. This Fix Pack should first be installed to the machine where the Synergy router daemon is running followed by installation to other server machines and finally deployed to client machines. DELIVERABLE SYNERGY COMPONENTS AFFECTED CCM_HOME files affected by the Fix Pack : %CCM_HOME%\bin\util\ccm_exec %CCM_HOME%\bin\ccmdb %CCM_HOME%\bin\ccmsrv INSTALLATION INSTRUCTIONS Important Points before you begin 1. Make sure that you have performed a successful backup of your Synergy Installation areas. 2. This Fix Pack contains modifications to the software that must be installed in the installation directory (CCM_HOME changes). 3. This Fix Pack also contains changes for cache server and if there are any cache servers installed then they must be updated (Cache server changes). Note: Once you have installed Fix Pack 7.2.2.1, do not install any individual iFix or Fix Pack that does not clearly state that it may be installed on top of Fix Pack 7.2.2.1, unless informed otherwise by Synergy Support. Installation of Fix Pack 7.2.2.1 1.Request that all users exit their Synergy sessions before you begin the installation. Shutdown all Synergy databases using the "ccmdb shutdown" command. Verify that all users have exited by using the "ccm monitor" command. > ccmdb shutdown # Repeat per database > ccm monitor 2.If Rational Change or Rational Synergy Integrations are running, shut them down. 3.To apply the Fix Pack to a Windows Synergy server installation, you must log in as a user in the Local Administrator group on the Main or Additional server machine. Do not install the Fix Pack on your computer if you use a shared network installation; just install the Fix Pack once on the network installation. 4.Once you have logged in as the appropriate user, run the Fix Pack executable, 7.2-RATL-RATISYNE-Windows-FP2.1.exe from the command prompt or by double clicking it. This brings up the Patch Installation Utility which guides you through the steps of installing the Fix Pack . 5.Open CM Command prompt as administrator on the main server and run > ccm_addsrv 6.If you have additional Database server, Open Command Prompt as administrator on the additional database server and run below command after installing the Fix Pack 7.2-RATL-RATISYNE-Windows-FP2.1.exe > ccm_addsrv 7.Start the Windows services ccm7.2.2_* from service control manager. 8.If the cache servers are installed, then the cacheserver service need to be stopped from services dialog. Once the cacheserver service is stopped, the cache server run area need to be patched by running the executable cacheserver_7.2.2.1-windows.exe from the command prompt or by double clicking it. This brings up the Patch Installation Utility which guides you through the steps of installing the Fix Pack on cache server. Start the cache server service once the installation is completed. Cacheserver_7.2.2.1-windows.exe will be available in the Synergy server run area under the path %CCM_HOME%\cacheserver 9.Inform users that they can restart their Synergy sessions. This Fix Pack contains a Windows client component. Users of the Synergy Windows GUI will be prompted to download the Fix Pack when they start a session. Users of the Windows CLI will be requested to patch their clients by browsing to: http://helpserver:port#/client/Update_7.2-2.1.exe. Alternatively, the executable, Update_7.2-2.1.exe, can be distributed to Windows CLI users, so they can execute it directly, to update their client installations. REVERSING Fix Pack If it is necessary to remove the Fix Pack after it was installed follow these steps; they must be performed by a Synergy database administrator. Reversing of Fix Pack 7.2.2.1 1.Request that all users exit their Synergy sessions before you begin the uninstallation. Shutdown all Synergy databases using the ccmdb shutdown command. Verify that all users have exited with ccm monitor. > ccmdb shutdown # repeat per database > ccm monitor 2.Stop the 7.2.2 Synergy services. Perform this step as an admin user.Open the services dialog and stop the Synergy services. If you are unfamiliar with these services refer to the Synergy Administration Guide for Windows for additional details. If the cache servers are installed, then the cache server service also need to be stopped from services dialog. 3.Restore the original files replaced by Fix Pack 7.2.2.1 Before replacing the original files, remove the hidden attribute from files stored under the %CCM_HOME%\patches\7.2.2.1 directory and its subdirectories. Do this as user who has local admin rights.Use the attrib command to remove the Hidden attribute from the files. From a command prompt:> cd %CCM_HOME%\patches\7.2.2.1 > attrib -h * /s /d The %CCM_HOME%\patches\7.2.2.1 directory contains two files and either three or four sub-directories. The two files are a README file and ccm_bp.in. You do not need to be concerned with the ccm_bp.ini file. The three sub-directories that every installation will have are CCM_HOME, util, and WINSYS. If your installation contains the Synergy Database Administration Tools, there will be an additional sub-directory named database. This last directory is not hidden and the files it contains are not hidden. The util and WINSYS directories are empty, and can be ignored. The database directory may also be ignored for 7.2.2.1 as there are no database components in this Fix Pack 4.The CCM_HOME directory contains a directory structure similar to that of your Synergy installation area. Any files that were removed or replaced from your installation area are under this directory. After removing the hidden attribute from all of the files stored under this CCM_HOME directory and its sub-directories, copy or move all of these files into the Synergy installation area directory structure, replacing the files that are currently there. Example: a.Replace “ccm_exec” from %CCM_HOME%\patches\7.2.2.1\CCM_HOME\bin\util to %CCM_HOME%\bin\util b.Replace "ccmdb" and "ccmsrv" from %CCM_HOME%\patches\7.2.2.1\CCM_HOME\bin to %CCM_HOME%\bin\ c.Remove ccm_addsrv file from %CCM_HOME%\bin d.Change the name of file “sqlhosts.” to "sqlhosts" from %CCM_HOME%\informix\etc 5.Edit the registry Key value "INFORMIXSQLHOSTS" from >HKEY_LOCAL_MACHINE\SOFTWARE\Informix\OnLine\\Environment Modify key value to %CCM_HOME%\informix\etc\sqlhosts 6.Remove entries in patches.txt and patches.dat in both Synergy server and also from cache servers if they were patched. 7.In the %CCM_HOME%\etc directory are files patches.txt and patches.dat. a. Using a text file editor (such as Notepad.exe) b. Edit these files and remove the lines referencing this Fix Pack . c. Save this file and exit the editor. d. If the resulting files are empty, then delete them. Remove 7.2.2.1 Key from the Registry. a.Start the registry editor (Click Start > Run type regedit) b.Browse to the appropriate key listed below. c.You will see a key labelled 7.2.2.1. Click it.( HKEY_LOCAL_MACHINE\SOFTWARE\Telelogic\CM SYNERGY\7.2.2\Install\Patches\7.2.2.1) d.Delete the key (press Delete on keyboard). e.Exit the registry editor. NOTE: Repeat the above steps for Additional DB server also while reversing Fix Pack 8.Restart the services that were stopped in step 2. Open the services dialog and start the Synergy services. If you are unfamiliar with these services refer to the Synergy Administration Guide For Windows for additional details. 9.Also, If the cache servers are installed, then the cacheserver service also need to be restarted from services dialog. 10.Unprotect the databases that were shut down in step 1 > ccmdb unprotect Repeat for every database. Note: Inform users that they can restart their Synergy sessions. FIXED ISSUES: 1. Additional DB server issue fixed 2. APAR PH24476 (CQAPAR NO: CQPAR00250061) FILES CANNOT BE OPENED FROM WITHIN THE SYNERGY CLIENT GUI ON WINDOWS 10 VERSION 1903