........................................................................... PATCH DESCRIPTION FOR PATCH 7.0.1-RATL-RRP-IFIX03 Product: IBM(R) Rational(R) RequisitePro(R) Release: 7.0.1 iFix03 Platform: Windows(R) Prerequisite: 7.0.1 ........................................................................... This document contains the following sections: - About this Interim Fix (iFix) - What's new in this iFix - Documentation update - Installing this iFix - Installation limitation - Prerequisites to installation on the RequisiteWeb server - Information on installing from a release area - Fixed defects - Known problems ........................................................................... About this Interim Fix (iFix) This IBM Rational RequisitePro Interim Fix03 (iFix03) is a patch for version 7.0.1. Version 7.0.1 is required for this update. This iFix includes fixes from the previous Interim Fixes and new, previously unreleased fixes. The iFix download contains content for upgrading only RequisitePro; it can be installed independent of other Rational products. This iFix does not include the entire product, but rather a subset of fixed components and files. iFixes, Fix Packs, and other maintenance releases are available for IBM Rational Support on the Web at http://www.ibm.com/software/rational/support/upgrades/. ........................................................................... What's new in this iFix This iFix contains fixes to internally identified defects. There are no fixes to customer-reported problems (APARs - Authorized Program Analysis Reports). ........................................................................... Documentation update Requirement revision notification from the Rational RequisitePro client for Web Project administrators can configure requirement types for revision notification using the Rational RequisitePro client for Web (RequisiteWeb). This enhancement is included in the administrative capability in v7.0.1. Administrators can create a list of users who will receive change notification for all requirements of a specific type, or users can subscribe to notification for individual requirements. For details, see technote #1265919 (http://www-1.ibm.com/support/docview.wss?uid=swg21265919). ........................................................................... Installing this iFix You can install RequisitePro v. 7.0.1 and this iFix03 from a software package download from IBM Rational Support on the Web (http://www.ibm.com/software/rational/support/upgrades/). You can perform a single client or server installation using the Windows Installer service, or create a release area for performing multiple installations. For details on installing Rational software, see the IBM Rational RequisitePro Installation and Upgrade Guide v. 7.0.1, which is available at the IBM Publications Center (http://www.elink.ibmlink.ibm.com/publications/servlet/pbi.wss). You must install this iFix on a computer that has RequisitePro v. 7.0.1 installed. To roll back to previous version of the product after installing an iFix, you must uninstall the full product. You can then install a previous version that includes the full product. ........................................................................... Installation limitation: When installing RequisitePro, do not use non-ASCII or double-byte characters for the installation path. (RATLC01005677) ........................................................................... Prerequisites to installation on the RequisiteWeb server Prior to upgrading the installation of the RequisiteWeb components, perform the following steps: 1. Verify that all RequisiteWeb users are logged out of RequisiteWeb. 2. Reboot the RequisiteWeb server before installing iFix03. 3. Verify that all RqProxy.exe processes have been ended in the Task Manager. This information is also available in technote #1256183 (http://www-1.ibm.com/support/docview.wss?uid=swg21256183). ........................................................................... Information for installing from a release area: RATLC00991284: In most cases, a release area created from a version 7.0.0 installation package will support all languages that a product is available in. However, when a release area is created from CD media or ISO files, and the product spans more than one CD/ISO, the release area will support only the language that the release area was created with. For example, if a release area is created on a Japanese operating system, in Japanese, then the release area will support only the Japanese language. The following two workarounds are available to create a multi-language release area with CD media or ISO files: 1. Create the release area using an image that was downloaded as a Web download. The problem that occurs when spanning CD/ISO files is not encountered when a Web download is used to create a release area. 2. Create the release area using CDs or ISO files. Place the IBM/Rational Product CD Disc 1 in the CD drive ~or~ mount the IBM/Rational Product CD Disc 1 ISO image. Run the MUI_RA_Console.exe tool that will update the release area with information to support all languages a given product is available in. For example: MUI_RA_Console where is the letter of the CD drive that contains IBM/Rational Product CD 1 or the drive mapped to IBM/Rational Product CD 1 ISO image, and is the root directory location of the pre-existing release area created using a version 7.0.0 GA product installation CD. For more information, please see technote #1239528, available at http://www-1.ibm.com/support/docview.wss?&uid=swg21239528. ........................................................................... Fixed defects This iFix03 release includes all fixes from the previous v. 7.0.1 iFix01 through iFix02, as well as the new fixes for the following software defect APARs and change requests. See the summaries below for more information. PK24017 (RATLC00760015), PK47603 (RATLC01205484), PK50746 (RATLC01031565), PK51771 (RATLC01210743), PK52216 (RATLC01211198), PK54796 (RATLC01258105), RATLC01039454 The following list provides summaries of the fixed software defect APARs: PK24017 (RATLC00760015) - After canceling a login to an external project, if the user opened a view that contains traceability to requirements in the external project, a runtime error occurred. The error did not occur if the external project was disconnected manually before opening the view. The disconnect process is now invoked when a user cancels a login to an external project. This resets the requirement collections so that the user can open the traceability view without errors. PK47603 (RATLC01205484) - Traceability views in the Rational RequisitePro client for Web (RequisiteWeb) were not returning correct results when tracing to a requirement type and adding a filter on an attribute. All "trace to" results were displayed; there was no filtering for the specified attribute values. The "trace to" query function has been modified to recognize all attribute filter criteria. PK50746 (RATLC01031565) - After upgrading Rational RequisitePro, non-administrative users of the client for Web (RequisiteWeb) could only open a project in read-only mode if it had a connection to an external project. The security validation function has been modified to allow users to successfully open project with appropriate security permissions. PK51771 (RATLC01210743) - When using the RequisitePro Extensibility Interface (RPX) API to add an external project connection to a project, an error occurred if the external project did not include the default "admin" user name and password. The project connection function has been modified to successfully validate administrator credentials with non-default administrator names. PK52216 (RATLC01211198) - When viewing revision history for multiple requirements in RequisiteWeb, incorrect revision history is displayed. This occurs when opening a requirement from a view in a new window and clicking the Revision tab and History button. After viewing a second requirement in the same manner, if you return to the first requirement, the history window displays the content from the second requirement. The revision history display function has been modified to correct this problem. PK54796 (RATLC01258105) - When logging in to a project using the Rational RequisitePro client for Web (RequisiteWeb), if the user's password contained only numeric content, the user might have been identified with a previous user's profile. The user identification function has been modified to retrieve the correct user profile, regardless of the alphanumeric content of the password. To search for information on these and other APARs, see the Web site: http://www-950.ibm.com/search/SupportSearchWeb/SupportSearch?pageCode=SBD&brand=rational The fix for the following change request is included in this iFix patch release: RATLC01039454 - It was possible to access external Web site content in the RequisiteWeb help, causing a possible security risk known as cross-site request forgery. The help has been modified to check context changes so that if there is an attempt to reference another site or an invalid help file, the user is directed to the main help page in RequisiteWeb. ........................................................................... Defects fixed in iFix02 Fixed but not reported: PK52216 (RATLC01211198) - When viewing revision history for multiple requirements in RequisiteWeb, incorrect revision history is displayed. This occurs when opening a requirement from a view in a new window and clicking the Revision tab and History button. After viewing a second requirement in the same manner, if you return to the first requirement, the history window displays the content from the second requirement. The revision history display function has been modified to correct this problem. Other defects fixed in iFix02: PK49207 (RATLC01149858), PK50038 (RATLC01208497), PK51044 (RATLC01032464) ........................................................................... Defects fixed in iFix01 PK24337 (RATLC00987137), PK43110 (RATLC01019160), PK43721 (RATLC01020428), PK44034 (RATLC01005201), PK44736 (RATLC01022389), PK45199 (RATLC01021807), PK46203 (RATLC01024616), PK47070 (RATLC01023607), PK47980 (RATLC01026839), PK48452 (RATLC01011240), PK48650 (RATLC01189591), PK48904 (RATLC01207027) Fixed indirectly: PK47616 (RATLC01026329), PK48151 (RATLC01206051) Unreproducible: PK45195 (RATLC01202815) Works as designed: PK39347 (RATLC01012446) - submitted as RFE RATLC01025516, PK40608 (RATLC01014621), PK41704 (RATLC01198399) - see RATLC00982782 in the 7.0.1 release notes for workarounds Duplicate: PK48646 (RATLC01149169) - see PK48650 (RATLC01189591) ........................................................................... Known problems RATLC00252369 - Users are unable to open RequisitePro on the Japanese version of the Windows Vista(R) operating system in the if the Japanese version of Microsoft Word 2007 is installed. Microsoft engineers are aware of the problem and will publish a response when available. ....................... PK45199 (RATLC01021807) - Users could not navigate from a URL Link requirement attribute in RequisiteWeb to a linked file (\\server\path\file.ext). This problem has been resolved for Internet Explorer(R). Due to a Mozilla Firefox(TM) Security Policy, the problem still exists in Firefox. RequisiteWeb does not display an error; however, a security exception is recorded in the Firefox Error Console. See the following mozillaZine article to work around this limitation for file-type URL Link attributes in RequisiteWeb: http://kb.mozillazine.org/Links_to_local_pages_don't_work. Also, see the technote #1265839 .......................... PK47070 (RATLC01023607) - When exporting a view to CSV using RequisiteWeb in Internet Explorer in a Hebrew server locale, the exported file has a Microsoft Excel(R) extension (.xls), causing it to open in Excel with incorrect formatting. To correct this problem, replace the file extension with a .csv extension. ......................... RATLC01009865 - When integrating the Rational ClearQuest(R) Web client with RequisiteWeb, the View, Refresh, and (Add from) RequisitePro buttons do not work in an associated record, such as a defect or enhancement request, in ClearQuest Web. To perform the View and Refresh operations, navigate to the ClearQuest requirement for the association. The use of the (Add from) RequisitePro button for creating associations is not supported in ClearQuest Web. .......................... RATLC01011175 - When you attempt to reach RequisiteWeb using the URL to the login page, an Internal Error 500 might be displayed. The error might include the following string: "%1 Is Not a Valid Win32 Application". This issue might occur if the path of the executable file for the service contains spaces. When Windows starts a service, it parses the path of the service from left to right. If both of the following conditions are true: - The path of a service’s executable file contains spaces. - There is a file or folder on your computer’s hard disk that has the same name as a file or folder in the path to the service's executable file. Windows may locate and try to run the file or folder before it locates and runs the executable file for the service; for example, if the path to the RequisiteWeb executable file is C:\Program Files\Rational\RequisitePro\bin\RqProxy.exe, and if a folder that is named C:\Program also exists on your hard disk, then the Windows operating system locates the C:\Program folder on your hard disk before the C:\Program Files\Rational\RequisitePro\bin\RqProxy.exe file, and the executable is not found. The same error may occur with the path to the RequisiteWeb application service: C:\Program Files\Rational\common\rwp\IHS\bin\apache.exe. For more details, see the Microsoft Knowledge Base article: http://support.microsoft.com/kb/812486. .......................... RATLC01136349: Business Modeling project template is unavailable after upgrading. The Business Modeling project template is now available in Rational RequisitePro when installing version 7.0.1 as a new installation; however, when installed as an upgrade from version 7.0.0.1, the project template is unavailable. To obtain the template after upgrading from 7.0.0.1, see the technote #1252382 at the following link: http://www-1.ibm.com/support/docview.wss?uid=swg21252382 .......................... RATLC01200999 - Japanese project templates are unavailable after upgrading a release area. The project templates are not available after upgrading a Japanese version of a Rational RequisitePro release area to version 7.0.0.1 or later, including this version 7.0.1. To obtain the templates after upgrading a release area, see the technote #1260686 at the following link: http://www-1.ibm.com/support/docview.wss?uid=swg21260686. The templates are available if you create a new installation of 7.01, rather than upgrading from a previous version. ---------------------------