------------------------------------------------------------ IBM Rational Change Fix Pack 5.2.0.1 ------------------------------------------------------------ (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.1 and describes 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.1 to Rational Change Release 5.2 fixes 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.1 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.1 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.1 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. This fix pack can be safely applied over any previous Rational Change 5.2 patches. 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.1, 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.1, unless informed otherwise by Support. 1. Log in to the machine where Rational Change is installed as the user who installed Rational Change. 2. Untar the fix pack file (patch_rc5.2.0.1) into the packages folder. $ cd /WEB-INF/packages $ tar xvf patch_rc5.2.0.1 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. Restart Rational Change. 6. If you are using the new OSLC REST API (which is used to integrate with products such as Rational Publishing Engine and Rational Quality Manager), restart Rational Change a second time 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.1 package in the Installed Packages. Click the uninstall button. 3. Restart Rational Change. CONTACTING SUPPORT Please visit our Telelogic support overview site at: http://www.ibm.com/software/rational/support/telelogic/ You will find a one-sheet reference guide about how to best contact support in your geography.