IBM Support

Rational Synergy Fix Pack 7 (7.2.0.7) for 7.2

Download


Abstract

IBM Rational Synergy Fix Pack 7.2.0.7 has been made generally available and contains fixes to version 7.2.

Download Description

Table of Contents
Sections Description

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.

The Prerequisites section provides important information to review prior to the installation of this release.

The Download package section provides the direct link to obtain the download package for installation in your environment.

The Installation instructions section provides the installation instructions necessary to apply this release into your environment.

The Known side effects section contains a link to the known problems (open defects) identified at the time of this release.

Supporting Documentation
Document Description

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.

IBM Knowledge Center provides an entry point to product documentation. You can view, browse, and search online information related to the product.

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.

Find technical developer content and resources.

Prerequisites

Prerequisites include:

Rational Synergy 7.2.

Installation Instructions

Review the Installing section of the IBM Knowledge Center for complete details.

Where to Apply this Fix Pack

Apply this Fix Pack 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.

Table of Contents


Deliverable Synergy Components Affected

Those marked with an asterisk (*) have changed since 7.2.0.6 ifix 002.

Database files affected by the Fix Pack:

   Database_path/lib/apilib.a
   
Database_path/lib/baselib.a
   
Database_path/lib/csetlib.a
   
Database_path/lib/dcmlib.a
   
Database_path/lib/focilb.a
   
Database_path/lib/mflib.a
   
Database_path/lib/ptlib.a

CCM_HOME files affected by the Fix Pack:

All Platforms

   
CCM_HOME/etc/logging.properties
 
 CCM_HOME/etc/CcmError.properties
   
CCM_HOME/etc/CcmError_ja.properties
   
CCM_HOME/etc/CcmError_zh.properties
   
CCM_HOME/etc/ccm.properties
   
CCM_HOME/etc/ccm_ja.properties
   
CCM_HOME/etc/ccm_zh.properties
   
CCM_HOME/etc/ccm_resource.properties
   
CCM_HOME/etc/ccm_resource_ja.properties
   
CCM_HOME/etc/ccm_resource_zh.properties
   
CCM_HOME/etc/ccm.help.files.properties
   
CCM_HOME/etc/cli/xml/mode6.5/attr.xml
   
CCM_HOME/etc/cli/xml/mode6.5/baseline.xml
   
CCM_HOME/etc/cli/xml/mode6.5/checkin.xml
   
CCM_HOME/etc/cli/xml/mode6.5/checkout.xml
   
CCM_HOME/etc/cli/xml/mode6.5/dcm.xml
   
CCM_HOME/etc/cli/xml/mode6.5/folder_template.xml
   
CCM_HOME/etc/cli/xml/mode6.5/folder.xml
   
CCM_HOME/etc/cli/xml/mode6.5/history.xml
   
CCM_HOME/etc/cli/xml/mode6.5/move.xml
   
CCM_HOME/etc/cli/xml/mode6.5/pg.xml
   
CCM_HOME/etc/cli/xml/mode6.5/process_rule.xml
   
CCM_HOME/etc/cli/xml/mode6.5/process.xml
   
CCM_HOME/etc/cli/xml/mode6.5/properties.xml
   
CCM_HOME/etc/cli/xml/mode6.5/release.xml
   
CCM_HOME/etc/cli/xml/mode6.5/task.xml
 
 CCM_HOME/etc/cli/xml/mode6.5/update_urls.xml
   
CCM_HOME/etc/cli/xml/mode6.5/common.xml
   
CCM_HOME/etc/TDSConfiguration.xml
   
CCM_HOME/etc/TDSResource_en_US.xml
   
CCM_HOME/etc/landing/devlanding.htm
   
CCM_HOME/etc/landing/devlanding_ja.htm
   
CCM_HOME/etc/landing/devlanding_zh.htm
   
CCM_HOME/etc/landing/bmlanding.htm
   
CCM_HOME/etc/landing/bmlanding_ja.htm
   
CCM_HOME/etc/landing/bmlanding_zh.htm
   
CCM_HOME/etc/welcome/documentation_ja.htm
   
CCM_HOME/etc/welcome/documentation_zh.htm
   
CCM_HOME/etc/welcome/index_ja.htm
   
CCM_HOME/etc/welcome/index_zh.htm
   
CCM_HOME/etc/welcome/nav_general_ja.htm
   
CCM_HOME/etc/welcome/nav_general_zh.htm
   
CCM_HOME/etc/welcome/support_ja.htm
   
CCM_HOME/etc/welcome/support_zh.htm
   
CCM_HOME/etc/welcome/welcome_ja.htm
   
CCM_HOME/etc/welcome/welcome_zh.htm

   
CCM_HOME/jetty/*
   
CCM_HOME/jetty/etc/cm.xml
   
CCM_HOME/jetty/etc/cm_https.xml
   
CCM_HOME/jetty/webapps/SynergyServer/images/cmlauncher.jar
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/admin_login.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/archive_conversion.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/blank.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/change_user_password.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/database_mapping.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/dump.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/frameset_user_administration.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/logout.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/redirect.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/resource_monitor.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/server_diagnosis.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/server_log.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/set_logger.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/synergy_main.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/user_administration_add_users.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/user_administration_delete_users.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/user_administration_list.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/user_administration_roles.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/user_administration_user_report.jsp
   
CCM_HOME/jetty/webapps/SynergyServer/jsp/user_administration_user_reporting.jsp
 *
CCM_HOME/jetty/webapps/help/synergyhelp.war
 *
CCM_HOME/jetty/lib/dwr.jar
 *
CCM_HOME/jre/*

   
CCM_HOME/lib/ccm_merge.jar
 *
CCM_HOME/lib/ccmjava.jar
   
CCM_HOME/lib/adminlib.a
   
CCM_HOME/lib/rfclib.a
   
CCM_HOME/lib/ccmlib.a
   
CCM_HOME/lib/c_ccmlib.a
   
CCM_HOME/lib/cilib.a
   
CCM_HOME/lib/copytools.jar
   
CCM_HOME/lib/cslib.a
   
CCM_HOME/lib/eislib.a
 
CCM_HOME/lib/libAPIac.a 
   
CCM_HOME/lib/objreglib.a
   
CCM_HOME/lib/aspectjrt.jar
   
CCM_HOME/lib/NetScapeBer.jar
   
CCM_HOME/lib/tdscommonlib.jar
   
CCM_HOME/lib/tdsjndilib.jar
   
CCM_HOME/lib/tdscryptolib.jar
   
CCM_HOME/lib/tdsloggerlib.jar
   
CCM_HOME/lib/uislib.a


UNIX & Linux


   
CCM_HOME/bin/ccm
 
CCM_HOME/bin/ccm_aci
   
CCM_HOME/bin/ccm_helpsrv
   
CCM_HOME/bin/ccm_install
   
CCM_HOME/bin/ccm_patch
   
CCM_HOME/bin/ccm_server
   
CCM_HOME/bin/ccmdb
   
CCM_HOME/bin/ccmdb_inf                   (Informix)
   
CCM_HOME/bin/ccmdb_ora                   (Oracle)
 
  CCM_HOME/bin/util/ccm_ci
   
CCM_HOME/bin/util/ccm_eng_inf            (Informix)
   
CCM_HOME/bin/util/ccm_eng_ora            (Oracle)
   
CCM_HOME/bin/util/ccm_platform
   
CCM_HOME/bin/util/ccm_receive
   
CCM_HOME/bin/util/ccm_sync_files
   
CCM_HOME/bin/util/ccm_util
   
CCM_HOME/bin/util/jetty_for_ccm
   
CCM_HOME/bin/util/ccmesd
   
CCM_HOME/bin/dbutil/ccmdb_backup         (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_backup_inf     (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_backup_rss_inf (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_backup_std_inf (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_check_inf      (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_load_inf       (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_names_inf      (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_names_ora      (Oracle)
   
CCM_HOME/bin/dbutil/ccmdb_pack           (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_restore        (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_restore_inf    (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_size           (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_table_inf      (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_table_ora      (Oracle)
   
CCM_HOME/bin/dbutil/ccmdb_unpack_inf     (Informix))
   
CCM_HOME/bin/dbutil/ccmdb_update         (Informix)
   
CCM_HOME/bin/dbutil/ccmdb_update_ora     (Oracle)

   
CCM_HOME/informix/*

   
CCM_HOME/lib/ccm_files
   
CCM_HOME/lib/jre_files

Microsoft Windows

 
CCM_HOME\bin\CMWinUtils.dll
 
CCM_HOME\bin\ccm.exe
 
CCM_HOME\bin\ccm_aci.exe
 
CCM_HOME\bin\ccmadm.exe
 
CCM_HOME\bin\ccmdb.exe
 
CCM_HOME\bin\ccmsrv.exe
 
CCM_HOME\bin\dbutils.dll

  CCM_HOME\bin\dbutil\ccmdb_load_inf.exe
 
CCM_HOME\bin\dbutil\ccmdb_names_inf.exe
 
CCM_HOME\bin\dbutil\ccmdb_table_inf.exe
 
CCM_HOME\bin\dbutil\ccmdb_update.exe

 
CCM_HOME\bin\util\cc_dff.bat
 
CCM_HOME\bin\util\cc_merge.bat
 
CCM_HOME\bin\util\ccm_ci.exe
 
 CCM_HOME\bin\util\ccm_eng_inf.exe
 
CCM_HOME\bin\util\ccm_receive.exe
 
CCM_HOME\bin\util\ccm_ess.exe
 
CCM_HOME\bin\util\ccm_helpsrv.exe
 
CCM_HOME\bin\util\ccm_objreg.exe
 
CCM_HOME\bin\util\ccm_router.exe
 
CCM_HOME\bin\util\ccm_sync_files.exe
 
CCM_HOME\bin\util\ccm_websrv.exe

 
CCM_HOME\lib\ccm_api.lib

Warning: This Fix Pack must be reapplied to any new databases you create after unpacking base.cpk.






Installation Instructions (UNIX and Linux)

Before you begin, make sure that you have performed a successful backup of your Synergy installation areas.

Note: If this fix pack is not upgraded from 7.2.0.6 iFix 001 or later, then it is required that RDS tdsadmin credentials are configured appropriately for authentication through RDS. Failing to do so, would result in authentication not working. Please refer to step 7 for more details. Refer to security bulletin http://www.ibm.com/support/docview.wss?uid=swg21681770 for details on security vulnerability in RDS.



This Fix Pack contains modifications to the software that must be installed in the installation directory (CCM_HOME changes).

Once you have installed Fix Pack 7.2.0.7, 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.0.7, unless informed otherwise by Synergy Support.

  1. To install this Fix Pack 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).

  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.2 databases.
    Verify that all users have exited by using the ccm monitor command.

    $ su - ccm_root
    ccm_root$ CCM_HOME=/usr/local/ccm72  
    # 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. Shut down the Informix database server.

    This step needs to be performed only for Linux and Solaris installations that use an Informix database, and have not already installed Fix Pack 7.2.0.6 (you are upgrading directly from 7.2 to 7.2.0.7).

    $ su - informix
    informix$ CCM_HOME=/usr/local/ccm72    
    # Adjust as appropriate
    informix$ PATH=$CCM_HOME/bin:$PATH
    informix$ export CCM_HOME PATH
    informix$ ccmsrv offline {-s servername}
    # Repeat per db server

  6. 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/ccm72    
    # 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 <PATH>/7.2-RATL-RATISYNE-AIX-
    FP0.7.tar.gz

    For HP-UX:
    # ccm_patch <PATH>/7.2-RATL-RATISYNE-HPUX-
    FP0.7.tar.gz

    For Linux:
    # ccm_patch <PATH>/7.2-RATL-RATISYNE-Linux-
    FP0.7.tar.gz

    For Solaris:
    # ccm_patch <PATH>/7.2-RATL-RATISYNE-Solaris-
    FP0.7.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

  7. Configure RDS tdsadmin user credentials

    Once the installation directory has been updated, configure RDS tdsadmin user credentials as the ccm_root user.


    ccm_root$ setup_rds


    Provide tdsadmin password when prompted.

    Restart the Synergy daemons as the ccm_root user.

    ccm_root$ ccm_start_daemons


  8. Restart the Informix database server.

    This step needs to be performed only for Linux and Solaris installations that use an Informix database, and have not already installed Fix Pack 7.2.0.6 (you are upgrading directly from 7.2 to 7.2.0.7).

    $ su - informix
    informix$ CCM_HOME=/usr/local/ccm72    
    # Adjust as appropriate
    informix$ PATH=$CCM_HOME/bin:$PATH
    informix$ export CCM_HOME PATH
    informix$ ccmsrv online {-s servername}
    #Repeat per db server

  9. Use the ccm_patch command to apply this Fix Pack to one or more databases.

    If you have a customized model using a custom model database, contact Synergy Support for assistance.

    Databases that were shut down in step 3 must be unprotected prior to patching.

    $ su - ccm_root
    ccm_root$ CCM_HOME=/usr/local/ccm72    
    # Adjust as appropriate
    ccm_root$ PATH=$CCM_HOME/bin:$PATH
    ccm_root$ export CCM_HOME PATH
    ccm_root$ ccmdb unprotect <dbpath>
    ccm_root$ ccm_patch -dbonly $CCM_HOME/patches/
    7.2.0.7 <dbpath>.

    Default value for range_for_keyword_expand attribute on misc and java cvtype is changed from -1 to 20480 in 7.2.0.7
  10. Inform users that they can restart their Synergy sessions.

    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://<helpserver>:<port#>/client/Update_7.2-0.7.exe

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


Post Installation Instructions (UNIX & Linux)

These steps apply only if you have not yet upgraded to Fix Pack 7.2.0.1 or 7.2.0.2 or 7.2.0.3 or 7.2.0.4 or 7.2.0.5 or 7.2.0.6 (if you are upgrading directly from 7.2 to 7.2.0.7).

  1. If you have a DCM cluster that has a mix of 7.2 databases with 7.0 or 7.1 databases, then create two attributes on the model object as follows.

    Attribute name            Attribute type  Value

    max_object_name_length    integer           155
    max_object_version_length integer            32

    This will ensure that objects created in the 7.2 database conform to the length restrictions in the 7.0 or 7.1 databases.

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

    CRCCM4004: An I/O problem occurred while communicating with IBM Rational Change at http://9.39.95.52:8600/central/servlet/com.continuus.websynergy.servlet… The reported error was: java.net.SocketTimeoutException:Read timed out


Reversing the Fix Pack (UNIX & Linux)

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.

  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/ccm72  
    # 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. Steps 2 - 4 need to be performed ONLY for Linux and Solaris installations that have an Informix database server, and installed this Fix Pack directly on top of 7.2, without first installing 7.2.0.1 or 7.2.0.2 or 7.2.0.3 or 7.2.0.4 or 7.2.0.5 or 7.2.0.6. Otherwise, skip to step 5.

    Delete all databases

    ccm_root$ ccm delete <dbpath>  # Repeat per database

  3. This step needs to be performed ONLY for Linux and Solaris installations that have an Informix database server and installed this Fix Pack directly on top of 7.2, without first installing 7.2.0.1 or 7.2.0.2 or 7.2.0.3 or 7.2.0.4 or 7.2.0.5 or 7.2.0.6. Otherwise, skip to step 4.

    Shut down the Informix database server.

    $ su - informix
    informix$ CCM_HOME=/usr/local/ccm72    
    # Adjust as appropriate
    informix$ PATH=$CCM_HOME/bin:$PATH
    informix$ export CCM_HOME PATH
    informix$ ccmsrv offline {-s servername}
    # Repeat per db server

  4. This step needs to be performed ONLY for Linux and Solaris installations that have an Informix database server and installed this Fix Pack directly on top of 7.2, without first installing 7.2.0.1 or 7.2.0.2 or 7.2.0.3 or 7.2.0.4 or 7.2.0.5 or 7.2.0.6. Otherwise, skip to step 5.

    Delete the Informix database server.

    Note: Before you delete an Informix Server, please print and save the server information so you can use the same parameters to recreate this Informix server later. If the server is offline, then bring the server online to get the information and then make it offline again.

    informix$ ccmsrv status -all {-s servername} > servername.info # Repeat per db server
    informix$ ccmsrv delete -y {-s servername}    # Repeat per db server

  5. Remove the following files from the directory $CCM_HOME/jetty/lib if they exist

      jetty-deploy-8.1.3.v20120416.jar
     jetty-http-8.1.3.v20120416.jar
     jetty-io-8.1.3.v20120416.jar
     jetty-security-8.1.3.v20120416.jar
     jetty-server-8.1.3.v20120416.jar
     jetty-servlet-8.1.3.v20120416.jar
     jetty-servlets-8.1.3.v20120416.jar
     jetty-util-8.1.3.v20120416.jar
     jetty-webapp-8.1.3.v20120416.jar
     jetty-xml-8.1.3.v20120416.jar
     servlet-api-3.0.jar
     slf4j-api-1.6.4.jar
     slf4j-jdk14-1.6.4.jar


    Also remove the following directories from $CCM_HOME/jetty/lib if they exist

      jndi
     jsp
     jta
     monitor
     policy
     spdy
     annotations
     ext


  6. Restore the installation files from before Fix Pack 7.2.0.7

    $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.0.7. 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. For example, $CCM_HOME/lib/ccmjava.jar was replaced. To replace it with the file from before this Fix Pack:

    $ su - ccm_root
    ccm_root$ CCM_HOME=/usr/local/ccm72     # 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.0.7 \ $CCM_HOME/lib/ccmjava.jar


    Repeat this step for each $CCM_HOME file listed in Deliverable Synergy Components Affected (UNIX and Linux) section. Create the following directory: ccm_root$ mkdir $CCM_HOME/jetty/work

    Remove the following directory, if present:

    ccm_root$ rmdir $CCM_HOME/jetty/temp

    For the deliverables informix/*, jre/* and jetty/* all the files from the save folder need to be copied and the existing files in these folders should not be deleted .

  7. Remove entries in patches.txt and patches.dat
    1. In the $CCM_HOME/etc directory are files patches.txt and patches.dat.
    2. Using an editor, for instance vi, edit these files.
    3. Remove the lines referencing this Fix Pack.
    4. Save this file and exit the editor.
    5. If the resulting files are empty then delete them.

  8. The upgrade to 7.2.0.7, if not done from 7.2.0.2 iFix 002 or later, then delete CCM_HOME/etc/cli/xml/mode6.5/update_urls.xml from the run area.

  9. 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/ccm72    
    # 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

  10. Steps 10 - 11 need to be performed ONLY for Linux and Solaris installations that have an Informix database server, and installed this Fix Pack directly on top of 7.2, without first installing 7.2.0.1 or 7.2.0.2 or 7.2.0.3 or 7.2.0.4 or 7.2.0.5 or 7.2.0.6. Otherwise, skip to step 12.

    Recreate the Informix database server(s) deleted in Step 4, using the database server information previously saved (rootdbs, logs, temp, ccm)

    $ su - informix
    informix$ CCM_HOME=/usr/local/ccm72    
    # Adjust as appropriate
    informix$ PATH=$CCM_HOME/bin:$PATH
    informix$ export CCM_HOME PATH
    informix$ ccmsrv create {-s servername}
    # Repeat per db server

  11. This step needs to be performed ONLY for Linux and Solaris installations that have an Informix database server and installed this Fix Pack directly on top of 7.2, without first installing 7.2.0.1 or 7.2.0.2 or 7.2.0.3 or 7.2.0.4 or 7.2.0.5 or 7.2.0.6. Otherwise, skip to step 12. If the patch 7.2.0.7 is directly installed on top of 7.2 then skip steps 12 and 13.

    Unpack all databases deleted in step 2 and add them to active database list once the daemon services are started

    $ su - ccm_root
    ccm_root$ CCM_HOME=/usr/local/ccm72    
    # Adjust as appropriate
    ccm_root$ PATH=$CCM_HOME/bin:$PATH
    ccm_root$ export CCM_HOME PATH
    ccm_root$ ccmdb unpack <db_packfile> -to <dbpath> {-s servername}  
    # Repeat per database

  12. Reverse Fix Pack 7.2.0.7 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 Fix Pack installation process. The files are saved with a suffix of _p7.2.0.7. 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 Fix Pack 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 Fix Pack:

    $ su - ccm_root
    ccm_root$ CCM_HOME=/usr/local/ccm72    
    # 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.0.7 <dbpath>/lib/baselib.a

    Repeat this step for each database file listed in the Deliverable Synergy Components Affected (Windows) section.
    • In the <database path>/db directory of each database is a file named MDL_INFO.
      1. Using an editor, for instance vi, edit these files.
      2. Remove the lines referencing this Fix Pack.
    • In the <database path>/etc directory of each database is a file named patches.dat.
      1. Using an editor, for instance vi, edit these files.
      2. Remove the lines referencing this Fix Pack.
      3. Save these files and exit the editor.
      4. If the resulting files are empty then they should be deleted.

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

    ccm_root$ ccmdb unprotect <dbpath>

    Repeat for every database that was patched.

  14. Start the Synergy daemons using the ccm_start_daemons command.

    ccm_root$ ccm_start_daemons

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

Note: If this fix pack is not upgraded from 7.2.0.6 iFix 001 or later, then it is required that RDS tdsadmin credentials are configured appropriately for authentication through RDS. Failing to do so, would result in authentication not working. Please refer to step 5 for more details. Refer to security bulletin http://www.ibm.com/support/docview.wss?uid=swg21681770 for details on security vulnerability in RDS.



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 that must be installed in Synergy databases (model changes).


Once you have installed Fix Pack 7.2.0.7, 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.0.7, 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 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-FP0.7.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. Configure RDS tdsadmin user credentials

    Once the installation has been completed, configure RDS tdsadmin user credentials

    > set CCM_HOME=c:\ccm72 # Adjust as appropriate
    > set PATH=%CCM_HOME%\bin;%PATH%
    > setup_rds.bat

    Provide tdsadmin password when prompted.


  6. Patch standard databases.

    If you do not have a customized model, apply this Fix Pack to each of your databases. ALL databases must be patched prior to use with this Fix Pack.

    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:\ccm72         # Adjust as appropriate
    > set PATH=%CCM_HOME%\bin;%PATH%
    > ccmdb unprotect <dbpath>
    > ccmdb_patch_
    7207 <dbpath>
    > postdb_
    7207.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.0.7
  7. 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-0.7.exe.

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


Post Installation Instructions (Microsoft Windows)

These steps apply only if you have not yet upgraded to Fix Pack 7.2.0.1 or 7.2.0.2 or 7.2.0.3 or 7.2.0.4 or 7.2.0.5 or 7.2.0.6 (if you are upgrading directly from 7.2 to 7.2.0.7).

  1. If you have a DCM cluster that has a mix of 7.2 databases with 7.0 or 7.1 databases, then create two attributes on the model object as follows.

    Attribute name            Attribute type  Value

    max_object_name_length    integer           155
    max_object_version_length integer            32


    This will ensure that objects created in the 7.2 database conform to the length restrictions in the 7.0 or 7.1 databases.

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

    CRCCM4004: An I/O problem occurred while communicating with IBM Rational Change at http://9.39.95.52:8600/central/servlet/com.continuus.websynergy.servlet… The reported error was: java.net.SocketTimeoutException:Read timed out


Reversing the Fix Pack (Microsoft Windows)

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.

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

  3. Restore the original files replaced by Fix Pack 7.2.0.7

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


    The %CCM_HOME%\patches\7.2.0.7 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 Fix Pack.

    This file is located in the %CCM_HOME%\lib directory. To replace the Fix Pack version of the file with the original file, copy or move the previously saved ccmjava.jar file from the directory

    %CCM_HOME%\patches\7.2.0.7\CCM_HOME\lib

    to the directory

    %CCM_HOME%\lib

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

    Create the following directory and make sure it is writable by the CM admin user:

    %CCM_HOME%\jetty\work

    Remove the following directory, if present:

    %CCM_HOME%\jetty\temp

    For The deliverables jre\* and jetty\*, all the files from the save folder need to be copied and the existing files in these folders should not be deleted .

  4. Remove the following files from the directory %CCM_HOME%\jetty\lib if they exist

      jetty-deploy-8.1.3.v20120416.jar
     jetty-http-8.1.3.v20120416.jar
     jetty-io-8.1.3.v20120416.jar
     jetty-security-8.1.3.v20120416.jar
     jetty-server-8.1.3.v20120416.jar
     jetty-servlet-8.1.3.v20120416.jar
     jetty-servlets-8.1.3.v20120416.jar
     jetty-util-8.1.3.v20120416.jar
     jetty-webapp-8.1.3.v20120416.jar
     jetty-xml-8.1.3.v20120416.jar
     servlet-api-3.0.jar
     slf4j-api-1.6.4.jar
     slf4j-jdk14-1.6.4.jar


    Also remove the following directories from %CCM_HOME%\jetty\lib if they exist

    jndi
    jsp
    jta
    monitor
    policy
    spdy
    annotations
    ext


  5. Remove entries in patches.txt and patches.dat
    1. In the %CCM_HOME%\etc directory are files patches.txt and patches.dat.
    2. Using a text file editor (such as Notepad.exe)
    3. Edit these files and remove the lines referencing this Fix Pack.
    4. Save this file and exit the editor.
    5. If the resulting files are empty, then delete them.

  6. The upgrade to 7.2.0.7, if not done from 7.2.0.2 iFix 002 or later, then delete CCM_HOME\etc\cli\xml\mode6.5\update_urls.xml from the run area.

  7. Remove 7.2.0.7 Key from the Registry.
    1. Start the registry editor (Click Start > Run type regedit)
    2. Browse to the appropriate key listed below.
    3. You will see a key labeled 7.2.0.7. Click it.
    4. Delete the key (press Delete on keyboard).
    5. Exit the registry editor.

      On 32 bit systems this key is located at:

      HKEY_LOCAL_MACHINE\SOFTWARE\Telelogic\CM SYNERGY\7.2\Install\Patches\7.2.0.7

      or

      HKEY_CURRENT_MACHINE\SOFTWARE\Telelogic\CM SYNERGY\7.2\Install\Patches\7.2.0.7


      On 64 bit systems this key is located at:

      HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Telelogic\CM SYNERGY\7.2\Install\Patches\7.2.0.7


  8. Reverse Fix Pack 7.2.0.7 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.

    If you used ccmdb_patch_7207.bat to install Fix Pack to your databases, the following steps are performed when "ccmdb_patch_7207 is run:
    • Before the Fix Pack is applied, affected database files are copied to <dbpath>\save\<filename>.p7207
    • 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.
      1. Log in as CM administrator on the database server machine, and bring up a command window.

      2. Remove the database files that were changed:

        > del <dbpath>\lib\baselib.a

        Move the saved copy of the these files back into their original locations:

        > move <dbpath>\save\lib\baselib.a.p7207 <dbpath>\lib\baselib.a

        Repeat this step for each database file listed in Deliverable Synergy Components Affected (Microsoft Windows).

        • In the <database path>\db directory, there is a file named MDL_INFO.
          1. Using a text file editor (such as Notepad.exe), edit this file and remove the lines referencing this Fix Pack.
          2. Save this file and exit the editor.

        • In the <database path>\etc directory is a file named patches.dat.
          1. Using a text file editor (such as Notepad.exe), edit this file and remove the line referencing this Fix Pack.
          2. Save this file and exit the editor.
          3. If the resulting files are empty, delete them.

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

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

    > ccmdb unprotect <dbpath>


    Repeat for every database that was patched.

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

Download Package

The following sections provide detailed information related to this release.

Click the FC link below to obtain the release from Fix Central.


How critical is this fix?

Impact Assessment
Impact Description

This is a maintenance release. It contains fixes for client-reported and internally found defects.

Test Results

Definitions

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

There are no known regressions to report.

Problems Solved

Defects resolved

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 following list of known issues and open defects:

No known issues.

Open defects

Review the following list of open defects for Rational Synergy on the IBM Support Portal.

Review technote 1461170: Open APARs for Rational products available on the Web for information on how to configure your MyNotifications subscription account and subscribe to the APARs you are interested in following.

Change History

What's new

This fix Pack includes the following product enhancements:

  • JRE is upgraded to SR16 FP2.
  • Discontinued support for Windows XP platform from this fix pack release onwards.

Click the link in the Download Options column:

On
[{"DNLabel":"Rational Synergy 7.2 fixes","DNDate":"26 Mar 2015","DNLang":"English","DNSize":"1","DNPlat":{"label":"Windows","code":"PF033"},"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.0.7","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Problems (APARS) fixed
PK82607;PM00514;PM27542;PM29242;PM31992;PM32198;PM35621;PM38966;PM39996;PM42727;PM43540;PM51284;PM50786;PM06193;PM06267;PM20041;PM23430;PM25711;PM43153;PM34480;PM44572;PM46360;PM47124;PM48298;PM48697;PM48698;PM48734;PM48991;PM49080;PM49085;PM49632;PM49847;PM50024;PM50599;PM50786;PM50825;PM51108;PM51284;PM51472;PM52746;PM53066;PM53328;PM53210;PM54553;PM55380;PM55566;PM55580;PM55916;PM56061;PM56235;PM56748;PM56934;PM56971;PM57168;PM57240;PM57317;PM57460;PM57679;PM57972;PM58430;PM59185;PM59194;PM59723;PM58867;PM62768;PM63353;PM63460;PM44759;PM50584;PM58030;PM61168;PM61230;PM61987;PM63480;PM63915;PM63922;PM64654;PM64859;PM65974;PM67614;PM68611;PM70219;PM70252;PM71241;PM72116;PM72481;PM59697;PM58867;PM63460;PM67614;PM58079;PM68656;PM69116;PM57822;PM57819;PM53376;PM58823;PM48991;PM36372;PM60623;PM63353;PM62737;PM62736;PM58859;PM60621;PM64397;PM63930;PM63045;PM63034;PM64282;PM24260;PM79381;PM71670;PM72715;PM73583;PM74485;PM75081;PM75978;PM77380;PM77404;PM77965;PM79032;PM80672;PM82935;PM44981;PM58404;PM71913;PM72482;PM73138;PM73310;PM74958;PM76205;PM77078;PM77872;PM79381;PM81066;PM84318;PM85048;PM85167;PM87416;PM78412;PM88488;PM90701;PM90757;PM91004;PM91478;PM91687;PM93585;PM94090;PI05842;PI08778;PM97257;PI04888;PI05933;PI08951;PI09598;PM83848;PM96374;PM96372;PM96732;PM96737;PM96841;PM96917;PM98242;PM99216;PI10988;PI12472

Document Information

Modified date:
22 December 2020

UID

swg24039200