July 11, 2014
Rational Requirements Composer
Definition · Management · Analysis
Rational Requirements Composer 3.0 M12 Milestone
Rational Requirements Composer 3.0 M12 Release Notes
The following notes detail issues in the Rational Requirements Composer 3.0 M12 milestone (January 18, 2011) that users and consumers of Rational Requirements Composer should be aware of. Please ensure that you also read the Jazz Foundation 3.0.1 M12 Release Notes.
The server for z/OS is not available in this milestone. It will be made available in a future milestone.
The server for IBM i is not available as a LICPGM package. It will be made available in a future milestone. This milestone includes a plain zip version of the server for for IBM i. To install trial licenses for this plain zip server install, download the matching trial licenses zip so that the /server/conf/jts tree in the zip overlaps with the same directory tree in the server zip.
Collaborative Lifecycle Management (CLM)
- Need to refresh IE in between adding CLM Links. (36672)
- Starting RRC Server in headless mode on Linux, the action will silently fail. The Java process will need to be terminated. This problem occurs because the server requires a display component to catch graphic components that are being generated. This display is not accessible in a headless configuration. To resolve this issue, install X Virtual Frame Buffer (Xvfb) on your system to capture the display. You can view the Technote surrounding this issue here. (36356)
- When executing a query in the grid, the number of pages displayed in the search results heading can sometimes be greater than the actual number of pages. If you go past the 'actual' end of pages, no results will be displayed in the grid. When this happens you will have to clear the filter in order to view results again. (36653)
- Creating test cases from requirements occasionally fails to create backlinks. (36590)
- Rational Common Reporting cannot display data unless the Requirements Composer ETL jobs are run twice. (148475)
- Relationships to Requirements in Requirements Composer are currently unavailable. (43705)
- When using Data Warehouse in Derby, execution results will not be available for reports. (43709)
- Several reports aren't currently working due to the issues below:
- Request Coverage of Requirements and Test Case Coverage DW reports show no data for covered artifacts. (36549)
- Requirements Execution Results DW report cannot be run. (36554)
- Requirements Distribution report shows discrepancies when it comes to the number of artifacts. (36548)
- Request and Test Case Coverage drilling reports show no data for covered artifacts. (36545)
- Requirement Volatility Churn drilling report shows no data for a specific artifact type. (36547)
- Priority Type and Status drilling reports list fewer artifacts than available. (36544)
- Volatility Churn and Blocked by Open Defects DW reports show no data. (36553)
- After initial installation of RRC, once the setup has been performed, in some cases when creating new RRC Projects or Artifacts the browser will display the message: "An error occurred while processing a server request. The server returned error code 400." No projects or artifacts can be created once this occurs. To workaround this issue, clear the browser's cookies, restart the RRC server, and then restart the web browser and log back into RRC. (35120)
- There are problems completing setup when configuring CLM in a WAS configured to use LDAP. To workaround this issue, apply the RM internal license explicitly. (35398)
- After project creation, the browser might display the message "Loading Permissions.." and never indicate that the project has been created. To workaround this issue, the server can be restarted. (30598)
- Using Windows with Internet Explorer, the JTS Setup Wizard step 'Requirement Management - Finalize Application' occasionally redirects to a bad URL and fails. To workaround this issue, we strongly recommend to run the JTS Setup Wizard using Firefox. (33065)
- After installing the RRC application and configuring it with the JTS Setup Wizard, create a new user with the RRC Analyst license from /jts/admin pages. Next, login as this new user, and from /rm/web page create a new project with a template. Project creation fails stating it failed at "ERROR%". To workaround this issue, after the steps of installing, configuring and creating the new user, stop and restart the JTS server before creating the new project. (33914)
- Using IBM DB2 9.7 64 bit database under 64 bit Windows or Linux, the JTS Setup Wizard - Configure Database step may hang (the Next button is enabled, but does nothing). During this step, the creation of the JTS, CCM and QM database tables can take considerable time (more than 20 minutes, depending on your hardware) and may time-out, resulting in the hang. To workaround this issue, before running the JTS Setup Wizard, configure the properties files and create the database tables manually. See these instructions for information on performing these steps for JTS, CCM and QM. (34583)
- Empty enumeration values cause CSV import to fail. To workaround this issue, ensure all rows have a valid value (You can create a 'No Value' enum entry to indicate empty values). (35269)
- When migrating a RequisitePro project if the project has multiple requirement types that have attributes with the same name, then they might not get reused under certain conditions. Instead they will be migrated as different attribute definitions and will be prefixed with the RequisitePro requirement type prefix to avoid the attributes with the same names. (34815)
- Migrating a RequisitePro view that has a query referring to Package system attribute will not be migrated to RRC as it's not supported. (35591)
- Using IBM WebSphere Application Server (WAS), the JTS Setup Wizard fails to register applications. The error message in the JTS Setup Wizard -
Register Applications step is 'An error occurred while attempting to to register the applications', and the applications listed have an error icon in
front of them. To workaround this issue, before starting the JTS Setup Wizard, edit the teamserver.properties file for the JTS, CCM and QM applications.
This applies to both Windows and Linux.
Files to edit:
- JTS - /server/conf/jts/teamserver.properties
- CCM - /server/conf/ccm/teamserver.properties
- QM - /server/conf/qm/teamserver.properties
In each of these files, locate the first 'com.ibm.team.repository.db.jdbc.location' property under the 'DERBY Configuration' section. Change the property value to use an absolute path.
- These changes are necessary even if you choose to use an Enterprise Database in the JTS Setup Wizard.
- The RM application does not require this property change, as it does not have its own Derby database.
Under Linux, if you have installed under /opt/IBM/JazzTeamServer, the property values will be:
- JTS - com.ibm.team.repository.db.jdbc.location=/opt/IBM/JazzTeamServer/server/conf/jts/derby/repositoryDB
- CCM - com.ibm.team.repository.db.jdbc.location=/opt/IBM/JazzTeamServer/server/conf/ccm/derby/repositoryDB
- QM - com.ibm.team.repository.db.jdbc.location=/opt/IBM/JazzTeamServer/server/conf/qm/derby/repositoryDB
Under Windows 32 bit, if you have installed under C:\Program Files\IBM\JazzTeamServer, the property values will be:
- JTS - com.ibm.team.repository.db.jdbc.location=C:\\Progra~1\\IBM\\JazzTeamServer\\server\\conf\\jts\\derby\\repositoryDB
- CCM - com.ibm.team.repository.db.jdbc.location=C:\\Progra~1\\IBM\\JazzTeamServer\\server\\conf\\ccm\\derby\\repositoryDB
- QM - com.ibm.team.repository.db.jdbc.location=C:\\Progra~1\\IBM\\JazzTeamServer\\server\\conf\\qm\\derby\\repositoryDB
Under Windows 64 bit, if you have installed under C:\Program Files (x86)\IBM\JazzTeamServer, the property values will be:
- JTS - com.ibm.team.repository.db.jdbc.location=C:\\Progra~2\\IBM\\JazzTeamServer\\server\\conf\\jts\\derby\\repositoryDB
- CCM - com.ibm.team.repository.db.jdbc.location=C:\\Progra~2\\IBM\\JazzTeamServer\\server\\conf\\ccm\\derby\\repositoryDB
- QM - com.ibm.team.repository.db.jdbc.location=C:\\Progra~2\\IBM\\JazzTeamServer\\server\\conf\\qm\\derby\\repositoryDB
No support for Graphical Editing in IE 7
Users will not be able to edit graphical artifacts in IE 7 for this milestone. This does not affect viewing graphical artifacts in read-only mode. Collaboration around graphical artifacts is still fully functional. (36340)
RRC Browser Add-Ons
The RRC Browser Add-Ons are unavailable for Unix-based platforms at this time
To use the graphical editors, ensure that your browser security settings are compliant with the following:
Internet Explorer 8:
- Internet Security Levels:
- The default levels of Medium and Medium-High for the Internet Zone are acceptable as they come.
- If using the default level of High, you will need to enable the following settings by clicking the 'Custom Level' button:
- Run ActiveX controls and plug-ins - must be set to something other than 'Disabled' (Either enabled or prompt)
- Script ActiveX Controls marked safe for scripting
- Run ActiveX controls and plugins
- The same acceptable security levels and exceptions apply to the Local intranet Zone as well.
- Note: If you choose to add your RRC server as a trusted site in Internet Explorer, you may set Internet security levels in any way you choose as all sites listed in the Trusted category use their own settings.
- Ensure the following settings under the Content tab of Options are enabled:
- Load images automatically
- Read-only version of artifact is not rendered correctly after hitting 'Cancel' in edit mode after a several minute delay. To workaround this issue, refresh the browser by using the resource viewer's refresh button or by refreshing the entire browser page. (33729)
- A copy of a graphical requirement artifact created by "Copy Artifact" cannot be edited. Copying graphical artifacts using this command is not supported for this milestone. (35649)
- If you have RFT (Rational Function Tester) installed, ensure that the RFT browser plugin is disabled in Firefox. If it is not disabled, editing a graphical artifact will cause the browser to crash. Disabling the RFT plugin will allow graphical editing to work normally. (35127)
- Graphical editing capabilities do not function correctly when the browser add-ons are installed into the default location on Windows Vista or
Windows 7 with User Access Control enabled. There are two workarounds for this issue:
- Run your browser (either Firefox or Internet Explorer) as administrator (right click on the start menu shortcut and "Run as Administrator")
- For IE and Firefox on Vista, and for Firefox on Windows 7, you can alternately choose to install the browser add-ons to an alternate location (on a path that does not include one of the windows standard virtualized folders such as c:\Program Files). (34502)
- Hitting the browser refresh button from the administrative UI of an RRC project causes the graphical artifact formats to be missing from the admin UI. To workaround this issue, you may either go back to the project dashboard for the project, refresh the browser and then navigate back to the admin page, or alternately you may restart your browser, navigate to the project dashboard and then navigate to the admin page. (35601)
- Hover for Link information from the link panel shows up under the graphical editors. (34463)
- Editing a graphical requirement after loading a Java enabled page (such as a Java Applet) can cause graphical editors not to load when
editing the graphical requirement. Conversely, going to a Java enabled page after editing a graphical requirement can crash the browser.
The problem stems from a single process launching multiple JVMs which is not supported by JVM vendors. The behavior will vary by browser.
- Mozilla Firefox:
- If you go to a Java enabled page and then try to edit a graphical requirement in the same tab or in another tab, the error checking code will alert you that the JVM could not be launched.
- If you edit a graphical artifact, and later go to a java page, this can crash the browser.
- Disable Java plugins
- Run Firefox in a new instance using the command line below with a different profile than is already running.
firefox -no-remote -ProfileManagerThis instance can edit graphical Requirements even if Java enabled pages are open in the other instance. Opening a Java enabled page in this instance will result in the same issues.
- Microsoft Internet Explorer 8:
- If you go to a Java enabled page and then try to edit a graphical requirement in the same tab, the error checking code will alert you that the JVM could not be launched.
- If you edit a graphical artifact, and later go to a java page in the same tab, this can crash the browser.
- Disable Java plugins
- Launch RRC in a new tab and do not load any Java enabled pages in that same tab.
- Mozilla Firefox:
The online help for this milestone is available, along with the help for the other Collaborative Lifecycle Management products, in the following information center. Please note that the information center is currently under development and may be incomplete or inaccurate. Your feedback is welcome. The same information center is also available from the Help menu in the Rational Requirements Composer web client.
The best way to guide yourself through using the requirements management function in this milestone is to use the Beta 2a Task Guide
There is a known limitation with context-sensitive help: the text within context-sensitive help bubbles, if working, is back-level, and the links to help topics will not work.