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. 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/dbutil/ccmdb_update $CCM_HOME/bin/dbutil/ccmdb_table $CCM_HOME/bin/dbutil/ccmdb_refchk $CCM_HOME/bin/dbutil/ccmdb_names $CCM_HOME/bin/dbutil/ccmdb_lock $CCM_HOME/bin/dbutil/ccmdb_load $CCM_HOME/bin/dbutil/ccmdb_info $CCM_HOME/bin/dbutil/ccmdb_index $CCM_HOME/bin/dbutil/ccmdb_dump $CCM_HOME/bin/dbutil/ccmdb_clear_binvals $CCM_HOME/bin/ccmdb $CCM_HOME/bin/ccmdb_ora INSTALLATION INSTRUCTIONS Before you begin, make sure that you have performed a successful backup of your Synergy installation areas. This Fix Pack contains modifications to the software that must be installed in the installation directory (CCM_HOME changes). 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). 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. In preparation for the following steps, ask all users to exit their Synergy sessions. 1.If Rational Change or Rational Synergy Integrations are running, shut them down. Login as user ccm_root and set CCM_HOME to point to your Synergy installation. Shut down all Synergy 7.2.2 databases. Verify that all users have exited by using the ccm monitor command. $ su - ccm_root ccm_root$ CCM_HOME=/usr/local/ccm722 # Adjust as appropriate ccm_root$ PATH=$CCM_HOME/bin:$PATH ccm_root$ export CCM_HOME PATH ccm_root$ ccmdb shutdown # Repeat per database ccm_root$ ccm monitor 2.Stop the Synergy daemons using the ccm_stop_daemons command. ccm_root$ ccm_stop_daemons If there are cache servers installed and running, they also need to be stopped. (Run the commands on the cache server system, if the cache servers are running on Windows platform, refer the Windows installation section) $ su - ccm_root $ CCM_HOME=/usr/local/ccm722 # Adjust as appropriate $ PATH=$CCM_HOME/bin:$PATH $ export CCM_HOME PATH $ cd $CCM_HOME/bin $ ./ccm_cache -stop Update the Synergy installation directory.Use the ccm_patch command. The argument to ccm_patch is the full path to the Fix Pack file that you are installing. Note: that ccm_patch must be run as root, since it needs to set ownership and permissions on the patched files. ccm_root$ su # CCM_HOME=/usr/local/ccm722 # Adjust as appropriate # PATH=$CCM_HOME/bin:$PATH # export CCM_HOME PATH If your database runs on Oracle then set ORACLE_HOME. # ORACLE_HOME=/usr/local/oracle # Adjust as appropriate # export ORACLE_HOME Use the tar file that is appropriate for your UNIX platform. For AIX: # ccm_patch /7.2-RATL-RATISYNE-AIX-FP2.1.tar.gz For Linux: # ccm_patch /7.2-RATL-RATISYNE-Linux-FP2.1.tar.gz Note for apply patch in informix database for Linux and AIX platform: ==================================================================== Find the following message while apply in informix database. please input "Yes" and allow to install Fix Pack . This patch includes platform and database specific portions, none of which match your current linux platform and informix database type. are you sure you want to apply this patch ? Repeat this command for each installation directory.Once the installation directory has been updated, restart the Synergy daemons as the ccm_root user. ccm_root$ ccm_start_daemons 3.If there are cache servers installed, they also need to be updated. (Run the commands on the cache server system, if the cache servers are running on Windows platform, refer the Windows installation section) ccm_root$ su # CCM_HOME=/usr/local/ccm722 # Adjust as appropriate # PATH=$CCM_HOME/bin:$PATH # export CCM_HOME PATH # cd $CCM_HOME/bin Use the tar file that is appropriate for your UNIX platform. The tar files will be available in the Synergy run area under the path CCM_HOME/cacheserver For AIX: # cacheserver_patch /cacheserver_7.2-2.1-aix.tar.gz For Linux: # cacheserver_patch /cacheserver_7.2-2.1-linux.tar.gz Repeat this command for each installation directory. 4.Once the installation directory has been updated, restart the Synergy cache server as the ccm_root user. ccm_root$ ccm_cache -start This Fix Pack contains a Windows client component. Users of 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://:/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 1.If it is necessary to remove the Fix Pack after it was installed, follow these steps. If you have a Windows client, see Reversing the Fix Pack (Microsoft Windows). Before you begin, make sure that you have performed a successful backup of your Synergy databases and installation areas. In preparation for the following steps, ask all users to exit their Synergy sessions. As ccm_root, shut down all Synergy databases that use this installation.Verify that all users have exited by using ccm monitor. $ su - ccm_root ccm_root$ CCM_HOME=/usr/local/ccm722 # Adjust as appropriate ccm_root$ PATH=$CCM_HOME/bin:$PATH ccm_root$ export CCM_HOME PATH ccm_root$ ccmdb shutdown # Repeat per database ccm_root$ ccm monitor 2.Stop the Synergy daemons using the ccm_stop_daemons command. ccm_root$ ccm_stop_daemons 3.If the cache servers are running, they also need to be stopped. (Run the commands on the cache server system, if the cache servers are running on Windows platform, refer the Windows installation section) $ su - ccm_root ccm_root$ CCM_HOME=/usr/local/ccm722 # Adjust as appropriate ccm_root$ PATH=$CCM_HOME/bin:$PATH ccm_root$ export CCM_HOME PATH ccm_root$ cd $CCM_HOME/bin ccm_root$ ./ccm_cache -stop 4.Reversing Fix Pack for Informix $CCM_HOME contains a save directory structure that contains all files that were removed or replaced during the Fix Pack installation process. The files are saved with a suffix of _p7.2.2.1. In addition, the first time a particular file is saved it will also be saved with an extension of _orig. Replace all files that were updated with this Fix Pack. For a complete list of $CCM_HOME files that were changed, review the Deliverable Synergy Components Affected section. $CCM_HOME/ save/etc was replaced. To replace it with the file from before this Fix Pack: Remove the patches.dat_p7.2.2.1 under $CCM_HOME/save/etc 5.Continue with the steps 7-10 given for Informix 6.Reversing Fix Pack 7221 for Oracle Database 12c and 19c $CCM_HOME contains a save directory structure that contains all files that were removed or replaced during the Fix Pack installation process. The files are saved with a suffix of _p7.2.2.1. In addition, the first time a particular file is saved it will also be saved with an extension of _orig. Replace all files that were updated with this Fix Pack For example, $CCM_HOME/bin/ccmdb was replaced. To replace it with the file from before this Fix Pack: $ su - ccm_root ccm_root$ CCM_HOME=/usr/local/ccm722 # Adjust as appropriate ccm_root$ PATH=$CCM_HOME/bin:$PATH ccm_root$ export CCM_HOME PATH ccm_root$ cp $CCM_HOME/save/bin/ccmdb_p7.2.2.1 $CCM_HOME/bin/ccmdb 7.Remove entries in patches.txt and patches.dat in both Synergy server and also from cache servers if they were patched. 1.In the $CCM_HOME/etc directory are files patches.txt and patches.dat. Using an editor, for instance vi, edit these files. 2.Remove the lines referencing this Fix Pack. 3.Save this file and exit the editor. 4.If the resulting files are empty then delete them. 5.Login as user root. You need to run $CCM_HOME/bin/ccm_install in order to reset the ownership and permissions of the original files you copied back: $ su - # CCM_HOME=/usr/local/ccm722 # Adjust as appropriate # PATH=$CCM_HOME/bin:$PATH # export CCM_HOME PATH If your database runs on Oracle then set ORACLE_HOME # ORACLE_HOME=/usr/local/oracle # Adjust as appropriate # export ORACLE_HOME # ccm_install -c # exit 8.If the cache server was patched then Login as user root on cache server. You need to run $CCM_HOME/bin/cacheserver_install in order to reset the ownership and permissions of the original files you copied back: $ su - # CCM_HOME=/usr/local/ccm722 # Adjust as appropriate # PATH=$CCM_HOME/bin:$PATH # export CCM_HOME PATH # cacheserver_install -c # exit 9.Unprotect the databases that were shut down in step 1, using: ccm_root$ ccmdb unprotect Repeat for every database that was patched. Start the Synergy daemons using the ccm_start_daemons command. ccm_root$ ccm_start_daemons 10.If the cache server was patched, then start the cache server using the ccm_cache command. ccm_root$ ccm_cache -start Inform users that they can restart their Synergy sessions. FIXED ISSUES: 1. Oracle 19c Server support with Oracle 12c client is added.