------------------------------------------------------------ IBM Rational Change Fix Pack 5.2.0.2 ------------------------------------------------------------ (C) Copyright IBM Corporation 2000, 2009 U.S. Government Users Restricted Rights - Use, duplication, or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. SUMMARY This README describes the contents of IBM(R) Rational(R) Change Fix Pack 5.2.0.2 and how to install the fix pack. The README has the following sections: PROBLEMS This section describes the problems fixed in this fix pack. SUPPORTED RELEASES This section lists the releases to which this fix pack may be applied. DELIVERABLE RATIONAL CHANGE 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 Rational Change server. REVERSING THE FIX PACK This section describes how to remove the fix pack. CONTACTING SUPPORT If you need assistance or have any problems with this fix pack, contact Support as described at the very end of this README. PROBLEMS Fix pack 5.2.0.2 to Rational Change Release 5.2 fixes the following problems: W#8693 Charting and matrix reports should be sortable. R#29535 Unreadable characters resulted after saving a prompting query as non-prompting query R#30394 Lifecycle attributes are not considered when creating a prompting query R#31780 Dependent listbox reverts to value 'Any' if not defined in database-specific values R#33270 Updating index and transitioning a CR at the same time causes indexing of the transitioned CR to fail R#33449 Include an attachment-less version of the copy base template R#33512 Warning about unencrypted data sent from a Change 5.2 server using https R#33713 Search index should not contain automatic tasks R#33882 'Message of the Day' text is duplicated when HTML formatted text is used R#33905 Increase the maximum number of items returned in a matrix report R#34191 Improvements to CR syncing when a firewall separates central and remote servers R#34208 Make user group update configurable and default to less frequent R#34234 Web services fail when results contain control characters R#34282 Message shown after package generation is misleading R#34306 The Perl API CreateAttachmentObject should not require a comment R#34431 Support password modification for local users when RDS 5.1 Apache is in corporate mode R#34442 Running the Perl API RefreshUser can cause performance issues with other Change commands to the database. R#34443 Long log in times possible when system contains many active users and the queries to get their groups takes a long time. R#34483 Problems with external listbox dependent values after applying 5.2.0.1 R#34529 DatabaseGetObjectBase method in the CSAPI should use get_object_source R#34753 Search index may lose data if indexing during shutdown R#34849 Apply RDS fix for "Local groups not working in corporate mode" problem R#34880 CR Migrate uses old license for SYNERGY-ChangeBase Fix pack 5.2.0.2 includes iFix 5.2.0.1 02, which fixed the following problem: R#34326 The trigger API 'buildCrQuery' constructs the wrong query Fix pack 5.2.0.2 includes iFix 5.2.0.1 01, which fixed the following problem: R#34158 DOORS-Change integration login fails when Synergy username and UID are not the same in RDS Fix pack 5.2.0.2 includes fix pack 5.2.0.1, which fixed the following problems: R#28157 Attribute legend missing from ad hoc matrix reports R#28369 Backwards transitions fail when done as a user with the lifecycle admin role R#28440 Matrix report links don't work if the number is greater than 341 R#28913 Invalid date field entries are being stored in the transition log R#29076 Sorting not working correctly on an external listbox attribute R#29299 Attribute labels incorrectly displayed in sorting dropdown R#30177 User's first name and last name don't appear in a relation report R#30635 Unable to set a date value when using BSF script R#30798 IE 6 intermittently gives an "Operation aborted" error when showing a CR or task R#31913 Subreport is rendering incorrectly when run R#32345 In the Perl API, make util.pm variables instance variables of the csapi class R#32426 Packages listed in "Available Packages" are not sorted on UNIX R#32501 The sort types "Integer back/Front middle" don't always work. R#32584 Task properties should be shown as read-only if they're not editable R#32989 Add Perl APIs to import/export report definitions and manage folders (see the Perl API help documentation for details): addFolder exportAReport createReport deleteFolder exportReportsFromFolder deleteReport moveFolderMembers importAReport renameFolder listFolders R#33023 CCM_TEMPLATE_INFO servlet should not emit absolute path to a template file R#33100 OSLC compliant REST API R#33243 Remote Change servers should be able to register with multiple central servers R#33294 Confusing message "Cannot edit CS 4.2 metrics" while trying to edit the metric "time in open state" R#33408 Add Perl APIs to retrieve and set security for folders (see the Perl API help documentation for details): getFolderSecurityRule setFolderSecurityRule R#33422 Various problems ensue when tasking is disabled R#33536 Process image hard to see in the flash help R#33562 Modify the GetNewCV Perl API doucmentation (output format) R#34003 "Compare with Predecessor" does not work until the Classic Client has started. W#8784 Admin trend chart for sessions doesn't display when there are too many databases Fix pack 5.2.0.2 includes patch 5.2 03, which fixed the following problems: R#33303 Extended text attributes appearing in subscription notifications contain HTML mark-up R#33330 Editing attribute of CCM_EXTENDED_TEXT type during transition causes junk markup to appear in the transition log R#33346 Address communication performance issues with TDS/RDS by caching the profiles of database users R#33347 Avoid unnecessary calls to TDS/RDS while listing users and assigning privileges from the Users tab R#33352 Inline reports on show dialogs can fail under high load, resulting in file not found errors R#33447 Supported browser inconsistency between the README and the URL on the login screen R#33573 'Users' tab in admin interface takes around 15 minutes to list 1000 users (XR#6157) R#33676 Poor performance due to privilege cache updates when database is disabled Fix pack 5.2.0.2 includes patch 5.2 02, which fixed the following problems: R#31545 Can't log in due to license server issue after restarting Change through WASCE or WAS R#31879 Home pages lost under certain circumstances when RDS is unavailable R#32149 Change should explicitly stop any threads it started during shutdown R#32652 Unable to migrate CRs from a remote database R#33029 Prompting queries created using an attribute type (not a specific attribute) can't be run R#33087 NullPointerException thrown when clicking on "Add Home Page" R#33120 getTransitionLog web service is missing line separators for attribute modification R#33242 Not all CCM_EXTENDED_TEXT displays correctly in transition log R#33259 Need a "SwitchUser" Perl API for the admin to run operations as other users Fix pack 5.2.0.2 includes patch 5.2 01, which fixed the following problem: R#33152 Change how preferences are updated to prevent RDS 5.0 Apache corruption SUPPORTED RELEASES This fix pack may only be applied to Rational Change Release 5.2 or 5.2.0.1. It can be safely applied over any previous patch. DELIVERABLE RATIONAL CHANGE COMPONENTS AFFECTED To see the fix pack components, traverse the the directory structure of the fix pack package once it has been expandand. Note that if the fix pack replaces any manually customized components, said components will need to have the customization re-applied. INSTALLATION INSTRUCTIONS Before you begin, make sure that you have performed a successful backup of your Rational Change databases. This fix pack contains a package that must be installed via the Rational Change package installation utility. Once you have installed fix pack 5.2.0.2, you should not install any individual patch that does not clearly state that it may be installed on top of fix pack 5.2.0.2, unless informed otherwise by Support. 1. Log in to the machine where Rational Change is installed as the user who installed Rational Change. 2. Uncompress the fix pack file (patch_rc5.2.0.2.zip) into the packages folder, \WEB-INF\packages. This should result in a folder named rc5.2.0.2. 3. Login to Rational Change as Admin, and click the Administration toolbar icon. 4. You can now select this package from the "Package Installer" tab which will show it under "Available Packages". Install the fix pack. 5. If Rational Change is running in the WAS or WASCE application server, restart the application server and ensure Rational Change is started. Otherwise, simply stop and start Rational Change. 6. If you are using the OSLC REST API (used to integrate with products such as Rational Publishing Engine and Rational Quality Manager) for the first time, stop and start Rational Change again to activate the API. REVERSING THE FIX PACK If it is necessary to remove the fix pack after it was installed, follow these steps. 1. Login to Rational Change as Admin, and click the Administration toolbar icon. 2. Uninstall the package. Click on the "Package Installer" tab. You should see the rc5.2.0.2 package in the Installed Packages. Click the uninstall button. 3. Stop and start Rational Change. CONTACTING SUPPORT Please visit our support overview site at: http://www.ibm.com/software/awdtools/change/support/