The Change history section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.
The How critical is this fix section provides information related to the impact of this release to allow you to assess how your environment may be affected.
Click to review the detailed system requirements information for a complete list of hardware requirements, supported operating systems, prerequisites and optional supported software, with component-level details and operating system restrictions.
Apply this iFix to all Synergy installations (CCM_HOME) and clients. First install to the machine where the Synergy router daemon is running, then install to other server machines, and finally to client machines.
Before you begin, make sure that you have performed a successful backup of your Synergy installation areas.
This iFix contains modifications to the software that must be installed in the installation directory (CCM_HOME changes).
This iFix 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 iFix 7.2.1.3_iFix001, do not install any individual iFix or Fix Pack that does not clearly state that it may be installed on top of iFix 7.2.1.3_iFix001, unless informed otherwise by Synergy Support.
To install this iFix on UNIX, use the ccm_patch script. If you do not have the ccm_patch script, please download it from the Rational Synergy ccm_patch installer script (ccm_patch) for UNIX.
If you have previously downloaded a copy of ccm_patch, please check to see if it is still the most up to date version. If not, download the latest version and discard your previous version. At the time of writing, the latest version of ccm_patch is 47.
If you have downloaded a newer version, then copy the ccm_patch script to $CCM_HOME/bin in each server installation; make sure it is owned by ccm_root and has execute permission (mode 0755).
In preparation for the following steps, ask all users to exit their Synergy sessions.
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.1 databases.
Verify that all users have exited by using the ccm monitor command.
$ su - ccm_root
ccm_root$ CCM_HOME=/usr/local/ccm721 # Adjust as appropriate
ccm_root$ PATH=$CCM_HOME/bin:$PATH
ccm_root$ export CCM_HOME PATH
ccm_root$ ccmdb shutdown <dbpath> # Repeat per database
ccm_root$ ccm monitor
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_root$ CCM_HOME=/usr/local/ccm721 # 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
Update the Synergy installation directory.
Use the ccm_patch command. The argument to ccm_patch is the full path to the iFix 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/ccm721 # 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
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
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) $ su
ccm_root$ CCM_HOME=/usr/local/ccm721 # Adjust as appropriate
ccm_root$ PATH=$CCM_HOME/bin:$PATH
ccm_root$ export CCM_HOME PATH
ccm_root$ cd $CCM_HOME/bin
The tar file will be available in the Synergy run area under the path CCM_HOME/cacheserver
Default value for range_for_keyword_expand attribute on misc and java cvtype is changed from -1 to 20480 in 7.2.1.3.001
Inform users that they can restart their Synergy sessions.
This iFix contains a Windows client component. Users of Synergy Windows GUI will be prompted to download the iFix 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-1.3.001.exe
Alternatively, the executable, Update_7.2-1.3.001.exe, can be distributed to Windows CLI users, so they can execute it directly, to update their client installations.
This will ensure that objects created in the 7.2 database conform to the length restrictions in the 7.0 or 7.1 databases.
The ccm.properties setting ccm.changerequesttool.timeout, which controls the time-out for a Change operation initiated from Synergy, was replaced by a pair of settings:
ccm.changerequesttool.timeout -- used for operations after Change startup ccm.changerequesttool.startup.timeout - used for Change startup
If Synergy users invoking Change operations see errors such as the following in the log files, the time-out values should be adjusted.
If it is necessary to remove the iFix after it was installed, follow these steps. If you have a Windows client, see Reversing the iFix (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/ccm721 # Adjust as appropriate
ccm_root$ PATH=$CCM_HOME/bin:$PATH
ccm_root$ export CCM_HOME PATH
ccm_root$ ccmdb shutdown <dbpath> # Repeat per database
ccm_root$ ccm monitor
Stop the Synergy daemons using the ccm_stop_daemons command.
ccm_root$ ccm_stop_daemons
Restore the installation files from before 7.2.1.3 iFix001.
$CCM_HOME contains a save directory structure that contains all files that were removed or replaced during the iFix installation process. The files are saved with a suffix of _p7.2.1.3.001. 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 iFix. For a complete list of $CCM_HOME files that were changed, review the Deliverable Synergy Components Affected section.
For example, $CCM_HOME/lib/ccmjava.jar was replaced. To replace it with the file from before this iFix:
$ su - ccm_root
ccm_root$ CCM_HOME=/usr/local/ccm721 # Adjust as appropriate
ccm_root$ PATH=$CCM_HOME/bin:$PATH
ccm_root$ export CCM_HOME PATH
ccm_root$ cp $CCM_HOME/save/lib/ccmjava.jar_p7.2.1.3.001 $CCM_HOME/lib/ccmjava.jar
Remove entries in patches.txt and patches.dat in both Synergy server and also from cache servers if they were patched.
In the $CCM_HOME/etc directory are files patches.txt and patches.dat.
Using an editor, for instance vi, edit these files.
Remove the lines referencing this iFix.
Save this file and exit the editor.
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/ccm721 # 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
If the cache server waspatched thenLogin 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/ccm721 # Adjust as appropriate
# PATH=$CCM_HOME/bin:$PATH
# export CCM_HOME PATH
# cacheserver_install -c
# exit
Reverse iFix 7.2.1.3.001 in databases.
If you have a customized model, using a model database, reinstate your previous model by performing a model install from your original customized model project to each database.
Each database directory contains a save directory structure that contains all files that were removed or replaced during the iFix installation process. The files are saved with a suffix of _p7.2.1.3.001. In addition, the first time a particular file is saved it will also be saved with an extension of _orig. All files that were updated with this iFix should be replaced. For a complete list of database files that were changed, review the Deliverable Synergy Components Affected section.
For example <dbpath>/lib/baselib.a was replaced, to replace it with the file from before this iFix:
$ su - ccm_root
ccm_root$ CCM_HOME=/usr/local/ccm721 # Adjust as appropriate
ccm_root$ PATH=$CCM_HOME/bin:$PATH
ccm_root$ export CCM_HOME PATH
ccm_root$ cp <dbpath>/save/lib/baselib.a_p7.2.1.3.001 <dbpath>/lib/baselib.a
Before you begin, make sure that you have performed a successful backup of your Synergy Installation areas.
This iFix contains modifications to the software that must be installed in the installation directory (CCM_HOME changes).
This iFix 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 iFix 7.2.1.3.001, do not install any individual iFix or Fix Pack that does not clearly state that it may be installed on top of iFix 7.2.1.3.001, unless informed otherwise by Synergy Support.
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.
If Rational Change or Rational Synergy Integrations are running, shut them down.
To apply the iFix 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 iFix on your computer if you use a shared network installation; just install the iFix once on the network installation.
Once you have logged in as the appropriate user, run the iFix executable, 7.2.1.3-RATL-RATISYNE-Windows-IF001.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 iFix.
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-1.3.001-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 iFix on cache server. Start the cache server service once the installation is completed. cacheserver_7.2-1.3.001-windows.exe will be available in the Synergy server run area under the path CCM_HOME/cacheserver
Patch standard databases.
If you do not have a customized model, apply this iFix to each of your databases. ALL databases must be patched prior to use with this iFix.
If you have a customized model using a custom model database, contact Synergy Support for assistance.
To patch a database on a Windows server, use the batch script that was extracted when you ran the self-extracting patch executable on the server. This script needs to be given the database path of the database(s) to be patched.
Log in as CM administrator on the Main or Additional Server machine for the database being patched, and bring up a command window. Repeat the following commands for each database:
> set CCM_HOME=c:\ccm721 # Adjust as appropriate
> set PATH=%CCM_HOME%\bin;%PATH%
> ccmdb unprotect <dbpath>
> ccmdb_patch_7213_001 <dbpath>
> postdb_7213_001.bat <dbpath> <host> <admin_user> <admin_user_password>
Note that passwords often contain characters that are interpreted by the shell, such as spaces, semicolons, wild cards, etc.... If this is the case, then be sure to type your admin user password in quotes.
Default value for range_for_keyword_expand attribute on misc and java cvtype is changed from -1 to 20480 in 7.2.1.3.001
Inform users that they can restart their Synergy sessions.
This iFix contains a Windows client component. Users of the Synergy Windows GUI will be prompted to download the iFix 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-1.3.001.exe
Alternatively, the executable, Update_7.2-1.3.001.exe, can be distributed to Windows CLI users, so they can execute it directly, to update their client installations.
This will ensure that objects created in the 7.2 database conform to the length restrictions in the 7.0 or 7.1 databases.
The ccm.properties setting ccm.changerequesttool.timeout, which controls the time-out for a Change operation initiated from Synergy, was replaced by a pair of settings:
ccm.changerequesttool.timeout -- used for operations after Change startup
ccm.changerequesttool.startup.timeout - used for Change startup
If Synergy users invoking Change operations see the following errors in the log files, the time-out values should be adjusted.
Stop the 7.2.1 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.
Restore the original files replaced by 7.2.1.3 iFix001
Before replacing the original files, remove the hidden attribute from files stored under the %CCM_HOME%\patches\7.2.1.3.001 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.1.3.001
> attrib -h * /s /d
The %CCM_HOME%\patches\7.2.1.3.001 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 at this time.
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.
For example, the file ccmjava.jar was replaced by this iFix.
This file is located in the %CCM_HOME%\lib directory. To replace the iFix version of the file with the original file, copy or move the previously saved ccmjava.jar file from the directory
If you have a customized model, using a model database, reinstate your previous model by performing a model install from your original customized model project to each database.
If you used ccmdb_patch_7213_001.bat to install Fix Pack to your databases, the following steps are performed when "ccmdb_patch_7213_001 is run:
Before the Fix Pack is applied, affected database files are copied to <dbpath>\save\<filename>.p7213001
The updated files from the Fix Pack are copied to the database.
A line is appended to <database path>\db\MDL_INFO as a record of the Fix Pack.
To reverse these actions, perform the following steps for each patched database.
Log in as CM administrator on the database server machine, and bring up a command window.
Remove the database files that were changed:
> del <dbpath>\lib\apilib.a
Move the saved copy of the these files back into their original locations:
In the <database path>\db directory, there is a file named MDL_INFO.
Using a text file editor (such as Notepad.exe), edit this file and remove the lines referencing this Fix Pack.
Save this file and exit the editor.
In the <database path>\etc directory is a file named patches.dat.
Using a text file editor (such as Notepad.exe), edit this file and remove the line referencing this Fix Pack.
Save this file and exit the editor.
Restart the Synergy services
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.
Also, If the cache servers are installed, then the cacheserver service also need to be restarted from services dialog.
Unprotect the databases that were shut down in step 1
> ccmdb unprotect <dbpath>
Repeat for every database that was patched.
Inform users that they can restart their Synergy sessions.
Regression: An error in the Maintenance Delivery Vehicle (MDV) that produces incorrect or unexpected behavior causing a supported feature to stop functioning as designed.
This includes:
Coding errors that cause a regression
Documentation or packaging problems that cause a regression
Errors reported in a new function delivered in a MDV that cause a regression
Incomplete: An error in the MDV has not regressed, but does not work as designed.
This includes:
Fixed APARs which did not solve the original problem but did not break anything new
APARs reporting documentation errors, such as readme errors, that cause problems applying an MDV but do not lead to a regression
Notes:
Regression and incomplete APARs are considered fix-in-error or MDV-in-error
Definitions above apply only to valid APARs that result in product fixes (APARs returned as working-as-designed are not assessed for being fix-in-error)
Issues in major releases due to new functionality do not apply in this definition
[{"DNLabel":"Synergy 7.2 downloads and fixes","DNDate":"26 Mar 2015","DNLang":"English","DNSize":"1","DNPlat":{"label":"Linux","code":"PF016"},"DNURL":"http://www.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm~Rational&product=ibm/Rational/Rational+Synergy&release=7.2&platform=All&function=all","DNURL_FTP":" ","DDURL":null}]
[{"Product":{"code":"SSC6Q5","label":"Rational Synergy"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"7.2.1.3","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]