------------------------------------------------------------ IBM Rational Change Fix Pack 5.2.0.6 ------------------------------------------------------------ (C) Copyright IBM Corporation 2000, 2011 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.6 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.6 to Rational Change Release 5.2 fixes the following problems: PM42373: R#40797 CCM_RELATION directly after a new SECTION on a form is being right-alligned PM44909: R#41033 Inconsistent data in report 'DRP Summary with tasks and objects'. PM45280: R#41070 Outdated search index can cause HTTP 500 error when sorting search results. PM45996: R#41128 Cookies to support SSL in Rational Change 5.2 PM46136: R$41143 Error "Session Pool Balancer" with Change5.3 PM47215: R#41266 Unable to start Change session where RDS username differs in letter casing with database username This fix introduces functionality to allow Change check and accordingly lowercase RDS user names while comparing with Synergy user names. To enable this functionality, add the following configuration entry to pt.cfg, and then reload configuration data: "[CCM_SYSTEM][LOWERCASE_LDAP_USERNAMES]true[/LOWERCASE_LDAP_USERNAMES][/CCM_SYSTEM]" : R#41293 Error while executing perl API CreateCSObject PM47403: R#41299 "stopTransition" API function fails on Copy transition PM47916: R#41353 "New | Add" buttons of "Associated Tasks" don't show up in Transition Dialog : R#41430 Change 5.2 patch request for R#40815 Formatting problems with columns and sub-reports PM48751: R#41438 OSLC DB GUID changes when installing process package. : R#41511 Alias column is missing from optional and required attribute tables in the CR process help PM49367: R#41537 ReportOnTaskData and ReportOnObjectData Perl APIs are not running successfully PM49668: R#41544 Support/comply RFC 821 for the emailHelper.pm to makes more stable behavior with any SMTP servers PM49670: R#41545 CCM_RELATION Child cannot be created (this fix requires regeneration and reinstallion of your process package) PM49773: R#41564 The comments field are not being updated from QC to CS after performing the 'Sync' operation. This fix introduces the functionality to allow Change check for removal of control characters from XML. To enable this functionality, add the following configuration entry to pt.cfg and reload the configuration data: "[CCM_SYSTEM][REMOVE_XML_CONTROL_CHARACTERS]true[/REMOVE_XML_CONTROL_CHARACTERS][/CCM_SYSTEM]" : R#41573 CCM_READONLY field is corrupted when the field's Web Type in the previous state is CCM_EXTENDED_TEXT PM51525: R#41810 Task is always created if default value for _CREATE_TASK is set in transition dialog : R#41910 Certificate used to digitally sign applet expires on 2/24/2012 PM52467: R#41924 Fatal Rational Change Servlet Error Fix pack 5.2.0.6 includes fix pack 5.2.0.5, which fixes the following problems: : R#38490 Make provisions to associate central and remote servers with incompatible encodings. PM01779: R#40661 Capitalized attribute names are not searchable from Advanced Search menu. PM42710: R#40826 Rational Change 5.2.0.4-07: Impossible to submit CRs with Extended Text through webservices. PM43025: R#40857 Unhandled exception / Segmentation error at Change startup PM43696: R#40922 Active Users in Status Summary shows too many active users. : R#40941 Not able to insert image to CCM_EXTENDED_TEXT attribute PM44169: R#40959 Receiving "Failed to modify object" message when attempting tranistion. (this fix requires regeneration and reinstallion of your process package) PM44170: R#40960 Error "400 URL must be absolute" when running fixTdsForMigration.pl PM44939: R#41035 Some of the 'State' attributes in 'CR Process-specific Help' page are not correct. Fix pack 5.2.0.6 includes iFix 5.2.0.4.07, which fixes the following problems: PM34366: R#39881 Unnecessary updates to externalized shared report information : R#40338 Add option to disable task indexing. A new boolean entry called "search.enable_task_indexing" has been added to the file app.properties and the default value is "true". To disable task indexing, override the value in app.user.properties with a value of "false" and reload configuration data. PM37122: R#40344 Change login page shows wrong database if URL has no port PM37540: R#40387 Ad hoc query not saved for the correct database PM37542: R#40388 HTML tags in extended text attributes causing StackOverFlow exception PM39170: R#40524 Messages in event.log related to the loading of listboxes PM39674: R#40558 PreCRModify Exception: Unknown Error after applying 5.2.0.4 iFix 05 PM40077: R#40601 iFix 5.2.0.4.06 introduces a problem with the script transition_notice.pl Fix pack 5.2.0.6 includes iFix 5.2.0.4.06, which fixes the following problems: PM28870: R#38967 Pre-transition trigger with verify does not work with bulk transitions. PM29522: R#39058 User interface is inaccessible while the DisableDatabase and EnableDatabase Perl APIs are running. PM30676: R#39236 Fix JavaScript and message display bugs in CCM_PROGRESS_BAR webtype. PM32171: R#39512 Search index update may fail when JDBC indexing has been enabled. PM33029: R#39668 HTTP 500 error from Change when reloading show form launched from Synergy. PM33850: R#39762 Failed pre-transition trigger on submit has an inconsistent error message. PM34343: R#39877 Embedded URL within email may not be accessible to recipient. PM34349: R#39878 Incorrect user in 'Compare With Predecessor' menu for source objects. PM34929: R#39978 Clicking Home after a session timeout results in an HTTP 500 error. PM35192: R#40023 Multi-level sub-reports do not create borders around each report. PM35240: R#40030 Loading users for "Assign Default Home Pages" is slow. PM35763: R#40114 Invalid hyperlinks in Excel and Word reports when Change is configured to use relative links. Fix pack 5.2.0.6 includes iFix 5.2.0.4.05, which fixed the following problems: : R#38881 Attributes that are cleared or listbox attributes set to 'Any' are not sent to Perl triggers. : R#38892 Changed cookie format causes more frequent logins. PM29910: R#39122 New extended text attribute doesn't display correctly when it's not modifiable by the user. PM31567: R#39413 Downloading an attachment through the web services API deletes the file from the database cache. PM31764: R#39451 Change query tab should be using cache instead of executing external scripts. PM31977: R#39490 java.lang.NullPointerExecption in create_task.js script with a void date attribute. PM32346: R#39539 ChangeTriggerApi.getAttributes method sometimes fails when ACLs are enabled. PM33317: R#39703 "AddUser" in csapi.pm missing in 5.2. Fix pack 5.2.0.6 includes iFix 5.2.0.4.04, which fixed the following problems: : R#38817 Need ability in BSF triggers to create and delete relationships between change requests and existing attachments. PM28062: R#38834 Change 5.2.0.4.02: Altering a CR with a read only modify_time results in a "Failed to modify object" message. : R#38895 Change 5.2.0.4.02: A user's personal reports and folders may be lost when Change is restarted. Fix pack 5.2.0.6 includes iFix 5.2.0.4.03, which fixed the following problems: PM18801: R#37203 Query in Internet Explorer 8 fails when the format is Excel. PM18951: R#37228 'Go' button disappears when browser window is made smaller. PM21989: R#37729 Package generation fails when a submit dialog contains an attribute of type CCM_PAGE_NAVIGATE. PM24277: R#38139 'Allow Viewing of Associated Objects Only' no longer works after applying 5.2.0.4. : R#38253 A shared report with leading or trailing whitespace doesn't work. : R#38259 OSLC 2 rich hovers don't always work. PM25244: R#38341 Error running the DeleteObjectAttributes Perl API. : R#38365 "WARN: Failed to update profile cache: null" appears in event.log. : R#38404 Alert message about missing comments despite providing them on transition dialog. : R#38410 OSLC 2 rich hovers don't always work (wrong Content-Type for compact XML). : R#38594 Change event.log file is too small and rolls too often causing loss of information. (The size is now configurable in the file app.user.properties using the key 'logging.max_file_size_bytes'.) : R#38604 Provide context information (whether it's a pre or post trigger) for all events. : R#38605 Attributes that are cleared or listbox attributes set to 'Any' are not sent to triggers. PM27767: R#38788 Missing user settings in Change with RDS in OS authentication mode. Fix pack 5.2.0.6 includes iFix 5.2.0.4.02, which fixed the following problems: PM22631: R#37881 Change-Base license is not released after user logs out of Change (AIX only). PM23616: R#38019 Loading of "Choose Favorite Users" page can take a long time. PM23784: R#38040 Default value for attribute is lost when CR goes through any copy transition if the attribute is set as 'readonly'. PM24541: R#38203 Prompting query will fail when the option the user is selecting is from a drop down list. PM24636: R#38216 Perl API setValue function can corrupt HTML and XML tags. Fix pack 5.2.0.6 includes iFix 5.2.0.4.01, which fixed the following problem: PM23214: R#37943 After adding a new state, can't save CR process or edit that state. Fix pack 5.2.0.6 includes fix pack 5.2.0.4, which fixed the following problems: PM06608: R#35240: ReportBuilder Excel-Report cuts off attribute value after 1024 characters when value starts with mathematical sign PM15447: R#36573: Inconsistent results when using prompting queries in Internet Explorer in Change 5.2 PM16793: R#36624: Allow ACLs to be applied against attributes that are not marked as queriable and reportable : R#36841: OSLC-CM 2.0 PM16743: R#36900: Perl - setValue() function does not handle tags in text attr PM18487: R#37182: Deleting a database from Change does not remove it from the Trends list : R#37215: Rational Change 5.2.0.3 breaks DOORS/Change 5.7 integration : R#37477: Add a CR process (doors_oslc_process_10.xml) and package template (doors_oslc_template_10) for use with DOORS 9.3 Fix pack 5.2.0.6 includes fix pack 5.2.0.3, which fixed the following problems: PM00041: R#29986: Deleted listbox entries are not removed from users' General Preferences PM02735: R#34820: "Allow Task Disassociation" must be checked for "Allow Task Association" to work PM08838: R#35611: Running a shared format when no shared reports exist returns "Unexpected error: null" : R#35679: Sorting search results by relevance isn't working correctly PM11070: R#35920: Extra HTML line breaks in the Transition Log PM11389: R#35978: The Perl API 'exportReportsFromFolder' has an error if a personal folder is empty PM11450: R#35982: Mirrored attributes don't work on certain report formats (like matrix) PM12013: R#36083: Mirrored attributes cannot be used in the first column of reports PM12213: R#36146: Mirrored attributes are showing as "Do Not Use/Remove" in column reports PM12618: R#36174: Child listbox does not display parent listbox options PM12642: R#36177: Read only and printer friendly view CRs have right alignment (this fix requires regeneration and reinstallion of your process package) PM13607: R#36310: Allow the omission of the 'change' context from login URL PM13809: R#36335: Sibling relation is acting like child relation PM13890: R#36345: The 'New' and 'Add' links for the Associated Tasks control require the crstatus attribute on the dialog PM14474: R#36400: Excel report adds new rows for every carriage return PM14529: R#36408: Column-style format cannot be selected in a relation report after translation PM14545: R#36413: copy_attribute.js doesn't work in pre-transition trigger for the crstatus attribute PM15393: R#36564: Newly added database in Change does not show up on the User's tab PM15407: R#36568: The Description field for the CR process does not render completely on IE PM15489: R#36576: Not able to input negative number in fields with type CCM_NUMBER PM15526: R#36595: User with read security cannot download attachments : R#36878: Sorting search results by CR ID in descending order does not work Fix pack 5.2.0.6 includes iFix 5.2.0.2.04, which fixed the following problem: PM04319: R#34971: Dialogless transitions should not ignore required attributes on a show form. This fix introduces introduces a new option in the Lifecycle Editor: CR Process 'Edit' > General > How should dialogless transitions treat show dialog attributes? [Ignore|Apply] The default value is 'Ignore', which corresponds to the existing behavior. By choosing 'Apply', dialogless transitions will enforce required attributes on show forms and commit any other attribute changes made to the show form prior to clicking the transition link. The process package must be regenerated and re-installed for this change to take effect. Fix pack 5.2.0.6 includes iFix 5.2.0.2.03, which fixed the following problem: PM10571: R#35823: The cfg setting [CCM_LDAP_MAPPING][NAME] does not work after 5.2.0.2 is installed Fix pack 5.2.0.6 includes iFix 5.2.0.2.02, which fixed the following problems: : R#35549: Ability to disable updating of the DATE_LAST_RUN and saved reports to reduce writes to LDAP. This fix introduces functionality to allow Change to disable the updating the DATE_LAST_RUN field in a user's personal saved query to reduce read/write calls to LDAP when running a query/report. To disable this functionality, add the following configuration entry to pt.cfg, and then reload configuration data: [CCM_SYSTEM][ENABLE_DATE_LAST_RUN_UPDATING]false[/ENABLE_DATE_LAST_RUN_UPDATING][/CCM_SYSTEM] This fix also introduces functionality to allow Change to disable the saving of user run reports, also known in the interface as Previous Results. The reason for disabling this feature is to further reduce the amount of read/write calls made to LDAP when running a query/report. To disable this functionality, add the following configuration entry to pt.cfg, and then reload configuration data: [CCM_SYSTEM][ENABLE_USER_SAVED_REPORTS]false[/ENABLE_USER_SAVED_REPORTS][/CCM_SYSTEM] : R#35553: Running a report can produce a "Cannot read temp file: " message in the event.log. : R#35737: Apply RDS patch for XR#6406: "TdsMgr.getAllParentGroupsOfUser" is not returning the groups for users with the character ',' in their logon names. Fix pack 5.2.0.6 includes iFix 5.2.0.2.01, which fixed the following problems: PM04239: R#34966: Home page report links embed the user's token and thus aren't safe for sharing. : R#35308: Too many search results may cause memory and performance problems. : R#35340: Remnants of a deleted report may prevent reporting interface from loading. : R#35343: Shared TDS data may become corrupted when accessed by multiple Change servers. : R#35490: Extended text field loses all text when saving after performing a cut and paste from an external source. Fix pack 5.2.0.6 includes fix pack 5.2.0.2, which fixed 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.6 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.6 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.6 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 documentation (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.6 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.6 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.6 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, 5.2.0.1, 5.2.0.2, 5.2.0.3, 5.2.0.4 or 5.2.0.5. It can be safely applied over any previous patch. DELIVERABLE RATIONAL CHANGE COMPONENTS AFFECTED To see the fix pack components, traverse the directory structure of the fix pack package once it has been expanded. Note that if the fix pack replaces any manually customized components, said components will need to have the customization re-applied. The following components are included for the Rational DOORS 9.3 integration: - cr_process\doors_oslc_process_10.xml - package_templates\doors_oslc_template_10\ The package template is not automatically installed; it must manually be copied (recursively) or moved from the package into \WEB-INF\package_templates before it can be used. 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.6, 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.6, unless informed otherwise by Support. 1. Log in to the machine where Rational Change is installed as the user who installed Rational Change. 2. Unzip (Windows) or untar (UNIX) the patch file into /WEB-INF/packages. The resultant directory will have the name "rc5.2.0.6". 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.6 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/