IBM Support

Rational Synergy Interim Fix 1 for 7.1.0.6

Download


Abstract

IBM Rational Synergy 7.1.0.6_iFix001 has been made generally available and contains fixes to version 7.1.0.6.

Download Description

Table of Contents
Sections Description
This section provides an overview on what is new in this release with a description of any new functions or enhancements when applicable.
This section provides information related to the impact of this release to allow you to assess how your environment may be affected.
This section provides important information to review prior to the installation of this release.
This section provides the direct link to obtain the download package for installation in your environment.
This section provides the installation instructions necessary to apply this release into your environment.
This section contains a link to the known problems (open defects) identified at the time of this release.
Supporting Documentation
Document Description
Click the link to navigate to the system requirement report page. To run the report, select your Product, Version and Operating System. 
Note: Choose the parent version of your product to see the system requirements for interim fix releases. For example, for 7.0.1.1_iFix001, select the 7.0.1 version in the report.
Click to browse for the version of your product information center available on the product information library page.
Click to review a complete list of the defects (APARs) resolved in this release including a list of resolved defects for the entire version family.

Installation Instructions


Where to Apply this iFix

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 deploy to client machines.

Deliverable Synergy Components Affected

CCM_HOME files affected by the iFix:

All Platforms

  CCM_HOME/lib/ccmjava.jar
 
CCM_HOME/lib/tdscommonlib.jar
 
CCM_HOME/lib/tdscryptolib.jar
 
CCM_HOME/lib/tdsjndilib.jar
 
CCM_HOME/lib/tdsloggerlib.jar


UNIX

 
CCM_HOME/bin/ccmdb
 
CCM_HOME/bin/ccmdb_ora                                (Oracle)
 
CCM_HOME/bin/dbutil/ccmdb_load_inf                    (Informix)
 
CCM_HOME/bin/dbutil/ccmdb_update                      (Informix)
 
CCM_HOME/bin/dbutil/ccmdb_load_ora                    (Oracle)
 
CCM_HOME/bin/dbutil/ccmdb_update_ora                  (Oracle)

Microsoft Windows

 
CCM_HOME\bin\ccmdb.exe
 
CCM_HOME\bin\dbutil\ccmdb_load_inf.exe
 
CCM_HOME\bin\dbutil\ccmdb_update.exe

Installation Instructions (UNIX)

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

Once you have installed 7.1.0.6 iFix001, do not install any individual iFix that does not clearly state that it may be installed on top of 7.1.0.6 iFix001, unless informed otherwise by Synergy Support.

  1. 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 Synergy Support web site. 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).

  2. In preparation for the following steps, ask all users to exit their Synergy sessions.

  3. If Rational Change or Rational Synergy Integrations are running, shut them down.

  4. Login as user ccm_root and set CCM_HOME to point to your Synergy installation. Shut down all Synergy 7.1 databases. Verify that all users have exited by using the ccm monitor command.

      $ su - ccm_root
      ccm_root$ CCM_HOME=/usr/local/ccm71    # 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

  5. 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/ccm71     # 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_patch <PATH>/7.1.0.6-RATL-RATISYNE-UNIX-IF001.tar.gz
      # exit


    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

  6. Unprotect the databases that were shut down in step 1:

       ccm_root$ ccmdb unprotect <dbpath>

    Repeat for every database that was shut down.

  7. 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.1-0.6.001.exe

    Alternatively, the executable, Update_7.1-0.6.001.exe, can be distributed to Windows CLI users, so they can execute it directly, to update their client installations.

Reversing the iFix (UNIX)

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

  1. 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/ccm71  # 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

  2. Restore the installation files from before 7.1.0.6 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.1.0.6.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 see section Deliverable Synergy Components Affected.

    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/ccm71     # 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.1.0.6.001 \
               $CCM_HOME/lib/ccmjava.jar



    Repeat this step for each $CCM_HOME file listed in Deliverable Synergy Components Affected.

  3. Remove entries in patches.txt and patches.dat

    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. If the resulting files are empty then delete them.

  4. 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/ccm71    # 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

  5. Unprotect the databases that were shut down in step 1, using:

       ccm_root$ ccmdb unprotect <dbpath>

    Repeat for every database that was patched.

  6. Start the Synergy daemons using the ccm_start_daemons
    command.

       ccm_root$ ccm_start_daemons

  7. Inform users that they can restart their Synergy sessions.

Installation Instructions (Microsoft Windows)

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

Once you have installed 7.1.0.6 iFix001, do not install any individual iFix that does not clearly state that it may be installed on top of 7.1.0.6 iFix001, unless informed otherwise by Synergy Support.

  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 <dbpath>    # Repeat per database
      > ccm monitor


  2. If Rational Change or Rational Synergy Integrations are running, shut them down.

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

  4. Once you have logged in as the appropriate user, run the iFix executable, 7.1.0.6-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.

  5. 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.1-0.6.001.exe.

Alternatively, the executable, Update_7.1-0.6.001.exe, can be distributed to Windows CLI users, so they can execute it directly, to update their client installations.

Reversing the iFix (Microsoft Windows)

If it is necessary to remove the iFix after it was installed follow these steps; they must be performed by a Synergy database administrator.

  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 <dbpath>     # repeat per database
      > ccm monitor


  2. Stop the 7.1 Synergy services. This step must be performed by 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.

  3. Restore the original files replaced by 7.1.0.6 iFix001

    Before replacing the original files, remove the hidden attribute from files stored under the %CCM_HOME%\patches\7.1.0.6.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.1.0.6.001
      > attrib -h * /s /d


    The %CCM_HOME%\patches\7.1.0.6.001 directory contains two files and either three or four sub-directories.

    The two files are a README file and ccm_bp.ini. 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 \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

       %CCM_HOME%\patches\7.1.0.6.001\CCM_HOME\lib

    to the directory

       %CCM_HOME%\lib

    Restore all CCM_HOME files replaced by this iFix. For a complete list of CCM_HOME files replaced, please see the above section titled, Deliverable Synergy Components Affected (Microsoft Windows).

  4. Remove entries in patches.txt and patches.dat

    In the %CCM_HOME%\etc directory are files patches.txt and patches.dat. Using a text file editor (such as Notepad.exe), edit these files and remove the lines referencing this iFix.

    Save this file and exit the editor. If the resulting files are empty, then delete them.

  5. Remove 7.1.0.6.001 Key from the Registry

    On 32 bit systems this key is located at:

    HKEY_LOCAL_MACHINE\SOFTWARE\Telelogic\CM SYNERGY\7.1\Install\Patches\7.1.0.6.001.

    or

    HKEY_CURRENT_MACHINE\SOFTWARE\Telelogic\CM SYNERGY\7.1\Install\Patches\7.1.0.6.001.

    On 64 bit systems this key is located at:

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Telelogic\CM SYNERGY\7.1\Install\Patches\7.1.0.6.001.

    Start the registry editor program by selecting Run... from the Start menu and typing regedit.exe in the Open text field.

    When the Registry Editor starts, browse to the appropriate key listed above. You will see a key labeled 7.1.0.6.001. Select this key by clicking on it with the mouse. Now delete the key by pressing Delete on your keyboard. Exit the registry editor.

  6. Restart the Synergy services

    Restart the services that were stopped in an 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.

  7. Unprotect the databases that were shut down in step 1

       > ccmdb unprotect <dbpath>

    Repeat for every database that was patched.

  8. Inform users that they can restart their Synergy sessions.

Download Package

The following sections provide detailed information related to this release.

How critical is this fix?

Impact Assessment
Impact Description
This release is a maintenance release of Rational Synergy 7.1.0.6. It contains fixes for client-reported and internally found defects.

Problems Solved

Click the Fix List link in the table of contents above to review a list of the problems solved in this release.

Known Side Effects

Review the link to the parent release in the Prerequisites section for a list of known problems.

Change History

No new features or functions.

On
[{"DNLabel":"Link to Fix Central","DNDate":"23 Aug 2012","DNLang":"US 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.1&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":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF002","label":"AIX"}],"Version":"7.1.0.6","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
22 December 2020

UID

swg24033246