------------------------------------------------------------------------------------ IBM Corporation Rational Change for DOORS Interface 5.7.0.7 iFix005 ------------------------------------------------------------------------------------ SUMMARY This README describes the contents of Rational Change for DOORS Interface 5.7.0.7 iFix005 and describes how to install the iFix. The README has the following sections: PROBLEMS This section describes the problems fixed in this iFix. SUPPORTED RELEASES This section lists the releases to which this iFix may be applied. DELIVERABLE COMPONENTS AFFECTED This section lists the files that will be replaced by this iFix. INSTALLATION INSTRUCTIONS This section describes how to apply the iFix to your DOORS installation. REVERSING THE IFIX This section describes how to remove the iFix. CONTACTING TECHNICAL SUPPORT If you need assistance or have any problems with this iFix, contact IBM Technical Support as described at the very end of this README. PROBLEMS Rational Change for DOORS Interface 5.7.0.7 iFix005 fixes the following problems: * Packaging error in the Change package was causing the .cfg file not to be loaded. 5.7.0.7 iFix 005 also include 5.7.0.7 iFix004 which fixes the following problems: * PM32510 (R39572) Permission Denied error messages when clicking on associated RC after installing iFix003 NOTE: This iFix ensures that all new RCRs will not have the same permission denied errors, however it does not alter existing RCRs. After installing this iFix the permission denied errors will still be seen for existing RCRs that have these errors. * PM30835 (R39274) Usernames with space can no long login after installing iFix003 5.7.0.7 iFix 004 also include 5.7.0.7 iFix003 which fixes the following problems: * R38440 - DOORS displays insufficient memory error then stops working * PM22080 (R37742) Ghost Changes when reviewing RCR * PM19676 (R37322) Single RCR modification results in multiple RCs changes * PM22136 (R37776) Unintended Apply (Handle partial apply. User should be able to apply when earlier attempt to apply has failed) * PM22137 (R37777) Exclusive Edit Warning (Load log error part was fixed by re-installing patch 8. About the other part, the RCR fails to load) * PM22140 (R37778) Unable to Select Default RCR (A CR which can not be applied, fails to load as well.) * PM22141 (R37779) Requirements Change Request submenu becomes greyed out (Caching Issue) * PM22143 (R37780) Greyed out “select default RCR” menu (Caching issue) * PM22145 (R37781) Lost Proposed Changes * PM22149 (R37782) Unable to apply RCR unassigned variable (newAttrs) * PM22150 (R37783) Stack overflow * PM22151 (R37784) Problem with DOORS Request Lock feature * PM25838 (R38467) unassigned variable (objId) error when trying to apply * PM21774 (R37683) Cannot apply one RCR in one DOORS module * PM18935 (R37227) Requirements Change Request" submenu becomes greyed out in read-only mode * PM25004 (R38308) Unable to see proposed changes while two users using the same Windows System * PM26646 (R38618) Requirements Change Request" menu becomes greyed out * PM06517 (R35218) User has to select default RCR twice 5.7.0.7 iFix 004 also include 5.7.0.7 iFix002 which fixes the following problems: * Change for DOORS Interface cannot run when DOORS is not configured to run RDS After this iFix is installed, it is possible to use the integration when DOORS is not configured to use RDS. If you choose to use the integration in this way you must either manually keep the users and groups consistent between Change and DOORS or you must use the "Export Users" button for each configuration template whenever modifications are made to DOORS users or groups. IMPORTANT NOTE: The "Export Users" button will only work with Rational Change 5.2.0.4-02 or higher. 5.7.0.7 iFix005 also includes 5.7.0.7 iFix001 which fixes the following problems: * The Change for DOORS Interface 5.7.0.7 FixPack for Version 5.7 fails to install on DOORS 9.3. * PM18805 (R37204) Readme defect: Change for DOORS Interface 5.7.0.7 FixPack for Version 5.7. * R35869 DOORS-Change5.7patch05- Add two attributes to the module and save the module, DXL error gets displayed. * R35870 DOORS-Change5.7Patch05 - "doors_change_57_patch_change_package" no such folder exists after extracting the patch to a temp directory, Readme of the patch need to be modified. * R35885 DOORS-Change Interface 5.7- DXL error gets displayed after selecting 'Get Requirements' option. * R35927 DOORS/Change 5.7 Patch 07: Upgrade RCR report is not created and so path to the report is not shown in upgrade RCR success dialog. * R36648 Section locks can not be accquired messaging when applying RCR. * R37204 Readme defect: Change for DOORS Interface 5.7.0.7 FixPack for Version 5.7. 5.7.0.7 iFix005 also includes FixPack 5.7.0.7 which fixes the following problems: * R37022 Review View does not display all changes to the module 5.7.0.7 iFix005 also includes FixPack 5.7.0.6 which fixes the following problems: * R35397 Performing Display Multiple RCRs operation on more than one RCR raises DXL errors * PM12433(R36154) Performing Configure All Modules operation raises DXL errors * R36629 Performing Review and Apply RCR displays a warning dialog box about section locks that is confusing to the user 5.7.0.7 iFix005 also includes Patch 5.7-05 which fixes the following problems: * R29005 Recording an unmanaged change in shareable edit mode raises a DXL error and managed changes gets saved on the module without RCR apply * R34892 Always prompt for a default RCR when opening a module * R34893 Allow the display of redlined differences during Review RCR and Display Multiple RCRs to be an option * R34901 Discarded changes dialog is not shown when objects are moved in unmanaged mode * R34939 Lock debug errors are displayed on locking a section in shareable edit mode * R34940 DXL errors appear when recording and applying an RCR on a module with managed and unmanaged attribute changes * R34958 In-Links are not discarded in Unmanaged Edit mode * R34960 Recording in Shareable Edit mode displays debug statements * R34980 Unwanted structural changes are made to a module * R35348 Open for Unmanaged Changes mode, large sections of the module being edited can vanish * R35349 RCs in the RCR in the Change DB will completely disappear when accessed through ActiveX by users who upgraded from Rational Change for DOORS Interface 5.6 * R35834 Remove Packages from Client menu option is not available to users 5.7.0.7 iFix005 also includes Patch 5.7-04 which fixes the following problems: * R33834 Users cannot modify objects which have prior rejected changes NOTE: * The user must specify the desired RCR Rejected State. This may be done by modifying the Configuration Template being used. Simply select the Define Configuration Template menu, then select the Template Name and click Modify. In step 3, which is Requirements Change Management, there will be a new listbox called RCR Rejected State. Make the desired selection and save. * R33842 DXL errors appear when performing a copy module configuration * R34510 DXL errors appear after performing undo modify on an object * R34513 DXL errors appear when sending an RCR to Review state from DOORS * R34515 DXL errors appear after modifying an object attribute that has previously been modified * R34687 DXL errors appear regarding locked log files when the Integration has debugging turned on NOTE: * When there is more than one DOORS session running at the same time, the Integration will write all debugging information in the same log file. * Patch 5.7-04 replaces %DOORSHOME%\lib\dxl\startupfiles\csintStartup.inc file. Configuration changes applied to this file will be lost after applying Patch 5.7-04. Please update the required settings manually after applying the patch. * R34758 Changes are automatically applied into DOORS during Record instead of into Rational Change 5.7.0.7 iFix005 also includes Patch 5.7-03 which fixes the following problems: * R34154 Changes cannot be recorded properly in shareable edit mode 5.7.0.7 iFix005 also includes Patch 5.7-02 which fixes the following problems: * The integration is unable to connect to Rational Change 5.1 * IR synchronization fails when the module contains deleted objects * RCRs cannot be reviewed in shareable edit mode * RCRs cannot be applied in shareable edit mode Note: If the RCR being reviewed or applied contains modules that are not setup for sharing, the Integration will re-attempt to review or apply the RCR in exclusive edit mode; otherwise, review or apply will continue in shareable edit mode. It is the user's responsibility to setup the module for sharing if they want to review or apply RCRs in shareable edit mode. WHO SHOULD INSTALL THIS IFIX This iFix should be installed by all users of the Rational Change for DOORS Interface release 5.7. SUPPORTED RELEASES This iFix may only be applied to Rational Change for DOORS Interface release 5.7 DELIVERABLE COMPONENTS AFFECTED %DOORSHOME%\lib\dxl\addins\synergy\add_CR.dxl %DOORSHOME%\lib\dxl\addins\synergy\attr_mapping.dxl %DOORSHOME%\lib\dxl\addins\synergy\complete_RCR.dxl %DOORSHOME%\lib\dxl\addins\synergy\custom_cr_attributes.dxl %DOORSHOME%\lib\dxl\addins\synergy\display_additional_rcps.dxl %DOORSHOME%\lib\dxl\addins\synergy\ecpsCustomAttrsDialog.dxl %DOORSHOME%\lib\dxl\addins\synergy\get_requirements.dxl %DOORSHOME%\lib\dxl\addins\synergy\rcr_create_report.dxl %DOORSHOME%\lib\dxl\addins\synergy\rcr_create_report_docexp.inc %DOORSHOME%\lib\dxl\addins\synergy\rcr_create_report_rpe.inc %DOORSHOME%\lib\dxl\addins\synergy\remove_CR.dxl %DOORSHOME%\lib\dxl\addins\synergy\review_rcp.dxl %DOORSHOME%\lib\dxl\addins\synergy\select_default_rcp.dxl %DOORSHOME%\lib\dxl\addins\synergy\show_CR.dxl %DOORSHOME%\lib\dxl\addins\synergy\show_rcp.dxl %DOORSHOME%\lib\dxl\addins\synergy\about\about.inc %DOORSHOME%\lib\dxl\addins\synergy\apply\ecpsapplyDialog.inc %DOORSHOME%\lib\dxl\addins\synergy\apply\ecpsapplyprepareutils.inc %DOORSHOME%\lib\dxl\addins\synergy\apply\ecpsapplyutils.inc %DOORSHOME%\lib\dxl\addins\synergy\misc\csintconfigdialogs.inc %DOORSHOME%\lib\dxl\addins\synergy\misc\csintconfigdialogs_all_module.inc %DOORSHOME%\lib\dxl\addins\synergy\misc\csintcopyconfigdialog.inc %DOORSHOME%\lib\dxl\addins\synergy\misc\csintStringTable.txt %DOORSHOME%\lib\dxl\addins\synergy\misc\csint_upgrade_rc_52.inc %DOORSHOME%\lib\dxl\addins\synergy\misc\packageManager.dxl %DOORSHOME%\lib\dxl\addins\synergy\misc\syncir_rcr.inc %DOORSHOME%\lib\dxl\addins\synergy\packages\uninstall_package.dxl %DOORSHOME%\lib\dxl\addins\synergy\record_mode\edit_conflict_warning.inc %DOORSHOME%\lib\dxl\addins\synergy\record_mode\mrc.inc %DOORSHOME%\lib\dxl\addins\synergy\record_mode\rcm_open_trigger.dxl %DOORSHOME%\lib\dxl\addins\synergy\record_mode\warning_cache.inc %DOORSHOME%\lib\dxl\addins\synergy\submit\submit_CR.dxl %DOORSHOME%\lib\dxl\addins\synergy\submit\submit_RC_dialog.inc %DOORSHOME%\lib\dxl\addins\synergy\submit\submit_RCP.dxl %DOORSHOME%\lib\dxl\addins\synergy\Utils\conflict_detect_dialog.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\conflict_report.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\csint_util.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\deploy_utils.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\ecpsutils.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\ecpsconfigutils.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\ecpsModuleConfiguration.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\lib.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\m_ir_sync.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\obj_sync_cr.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\rcm_utils.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\rcr_cache_util.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\rcr_report.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\review_util.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\select_query.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\select_rcp_dialog.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\submit_CR_utils.inc %DOORSHOME%\lib\dxl\addins\synergy\Utils\view_config.inc %DOORSHOME%\lib\dxl\startupfiles\csintStartup.inc %DOORSHOME%\lib\dxl\startupfiles\csintStartupPrivate.inc %DOORSHOME%\lib\dxl\finishfiles\csintFinish.inc %WINDIR%\system32\csapi.dll trapeze\ TelelogiCECPSActiveXControl.cab wsconfig\templates\pt\include\attr_controls base.DOORS_DATA_CONTROL INSTALLATION INSTRUCTIONS Once you have installed 5.7.0.7 iFix005, you should not install any individual iFix or FixPack that does not clearly state that it may be installed on top of 5.7.0.7 iFix005, unless informed otherwise by IBM Technical Support. Before installing 5.7.0.7 iFix005, you must first install DOORS client version 9.2.0.5 or higher. To use the Export Users function you must have Change 5.2.0.4-02 or higher. If the DOORS client version is less than 9.2.0.5, the integration will not attempt to install the patch and will not notify the user that the patch is available. You can use the DOORS database login policy settings to enforce a minimum client version if desired. 1. Extract the iFix files into a temporary directory. Use Winzip (or another zip tool) to extract the files. 2. Start DOORS as a user with database manager privilege 3. Click Rational Change Interface->Package Manager. 4. Remove all previous Rational Change for DOORS Interface 5.7 FixPacks or iFixes from the Package Manager. You can do this by clicking Rational Change Integration->Package Manager, selecting each of the Installed Packages, then clicking Remove. NOTE: It is not necessary to remove the iFix or FixPacks currently installed from all the DOORS clients. 5. Click the Add button, browse to the package_info.xml file located in the temporary directory from step 1. 6. Restart your DOORS session, you will be prompted to install the iFix on the client. All users who have the Change for DOORS Interface installed and have appropriate privileges to modify their DOORS installation area will be prompted to install the iFix the next time they start DOORS. NOTE: If the DOORS client version 9.2.0.5 or higher is not installed, you will not be prompted to install the FixPack after restarting your DOORS session. NOTE: After installing Rational Change for DOORS Interface 5.7.0.7 iFix005, the Integration will ask the user to restart DOORS in order for the iFix to be properly installed. When you attempt to exit your DOORS session, a DXL error will briefly appear and DOORS will exit. The instructions below explain how to install the Rational Change for DOORS Interface iFix 5.7 Change Package. 1. Login to the machine where Rational Change is installed as the user who installed Rational Change. 2. Unzip the iFix file into a temporary directory. Copy the folder named doors_change_5707_ifix005_change_package to your Rational Change installation packages directory (e.g. \cs_app\webapps\ synergy\WEB-INF\packages) 3. Login to Change as Admin, and click the Administration toolbar icon. 4. You can now select this iFix package from the "Package Installer" tab which will show this iFix package under "Available Packages". Install the iFix. NOTE: Because this iFix modifies files included in doors_cs_template, this iFix must be reinstalled every time a CRProcess package is installed in Change. REVERSING THE IFIX If it is necessary to remove the iFix after it was installed, follow these steps. 1. Start DOORS, click Rational Change Integration->Remove Packages From Client 2. Select this iFix and click Remove. If you have installed other iFixes or FixPacks after installing this iFix, you must remove them first. The instructions below explain how to remove the Rational Change for DOORS Interface Patch 5.7 Change Package. 1. Login to Change as Admin, and click the Administration toolbar icon. 2. Uninstall the iFix package. Click on the "Package Installer" tab. You should see the doors_change_5707_ifix005_change_package in the Installed Packages. Click the uninstall button. CONTACTING TECHNICAL SUPPORT Please visit our Rational 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.