Workarounds and Limitations: Known issues in Rational DOORS Next Generation 6.0.2
The following known problems are related to the IBM Rational DOORS Next Generation 6.0.2 release.
Upgrading from a version 5 release
For details about known issues that relate to upgrading Rational DOORS Next Generation from a version 5 to a version 6 release, including specific defects and fixes, see the IBM Rational DOORS Next Generation 6.x migration defects Flash article from IBM Support.
Workarounds
The following problems in this release have workarounds:
- The Data Collection Component job that collects RM requirements data takes a long time to finish
- Permalinks to views do not display the views correctly in some browsers
- Closing the browser does not log out of the RM application
- After you deliver a change set in a personal stream, the configuration context remains in the personal stream when it should switch to the global stream
- CSV export files are not created properly in Turkish locales
- Rational DOORS Next Generation browser add-on does not install on Mozilla Firefox 43 and later
- Copying and pasting cells from Microsoft Excel does not retain cell borders
- WebSphere Application Server stops responding and logs an out-of-memory error
- Comments widget on a personal dashboard displays an incorrect label for the Configuration setting
- During the CSV import process, artifacts that were partially removed cannot be reinserted into a module
- Page Up and Page Down keys do not work when you edit an artifact in a module in Mozilla Firefox
- Report Builder might not show the correct artifacts when multiple RM servers with different contexts are registered to LQE
- Report Builder reports and LQE queries might show incorrect link validity status when using the query provided in IBM Knowledge Center
- Large change set deliveries on DB2 databases might fail with an SQL error
- The Alt+e keyboard shortcut does not insert the euro sign in the Module editor
- Anchor point connections cannot be changed by using keyboard shortcuts on a Turkish Q keyboard
- Table cells are pasted incorrectly from Microsoft Word when “Repeat as header row at the top of each page” is selected
- Links between artifacts in Rational DOORS 9 and Rational DOORS Next Generation do not work as expected when configuration management is enabled
- During an upgrade, the CRJAZ0554I timeout error might occur
- Concurrent changes to an artifact can cause version issues in configurations
- In some browsers, images cannot be pasted from the clipboard into an artifact
- Modules imported into a change set using ReqIF, discarded, and then reimported cannot be delivered
- Rational RequisitePro baselines cannot be imported
- Link columns might not display links if the link type has a URI defined
Limitations
The following problems in this release do not currently have workarounds:
- Symbols or special characters are not displayed in reports
- Workflow attributes are not merged in cross-project Jazz Reporting Service reports
- If a stream is open in multiple browser tabs or windows, you can associate a change set with a personal stream in each instance, which replaces any previously associated change set
- Jazz Reporting Service reports built by using Lifecycle Query Engine do not display tags for requirements
- The audit history of the Primary Text artifact attribute in modules shows additional markup
- Artifacts cannot be locked in streams that require changes in change sets
- Sharing the process configuration between Rational DOORS Next Generation project areas is not supported
- ReqIF imports of links and views into parallel configurations are not supported
- Microsoft Visio VDX and VSDX file formats have limited or no support for uploaded file previews
- Revision history of an artifact doesn’t show baseline icons
- Errors are displayed during TRS rebase operations if timeouts occur
- Changes made to artifacts or comments do not appear in a change set
- Quick Search results do not correctly include artifacts that have a format of Diagram
- If PDF documents are viewed in Microsoft Internet Explorer, the PDF document might hide menus or controls
- Module baselines were replaced with project baselines
- ReqIF import feature does not support importing data into multiple configurations of a project
- A module cannot have multiple templates
- The number of a tags for a project is no longer visible
- Text searches do not support queries that include certain characters
- Large ReqIF files or Rational DOORS migration files cannot be imported into Rational DOORS Next Generation
Workaround summary
Problem
If the Data Collection Component job that extracts requirements data from the RM server takes several hours to finish, an internal cache might have expired on the RM server while the data is being processed. This expiration causes the cache to be populated repeatedly, which can take a considerable period of time depending on the number of projects and amount of data on the RM server.
Workaround
As a Jazz admin user, complete these steps:
- On the /rm/web page, go to the Administration menu and select Manage Server Administration.
- From the menu on the left, select Advanced Properties.
- Scroll to or search for this value: RDMPublishLinksCacheExpiration
- Click the value and change it to 7200000 (=2 hours).
- At the top of the page, click Save.
- Restart the RM server for the new value to take effect.
Related information
Workaround summary
Problem
If you use a permalink URL to navigate to a view in some browsers, the project dashboard might not load properly and the view contents might not be displayed.
Workaround
Complete these steps to load the view:
- From the Artifacts menu, select Browse Artifacts.
- In the browser address field, paste the permalink URL for the view and press Enter.
- Refresh or reload the browser page.
Related information
Workaround summary
Problem
In some cases, if a session cookie is persistent, closing the browser does not log out of the RM application.
Workaround
To avoid this issue, set the JVM property named com.ibm.team.jfs.app.auth.cache.identity.lifetime to -1. Complete the instructions for the application server that hosts the RM application.
WebSphere Liberty:
- In the installation_directory/server/server.startup.bat|sh file, add the following line: JAVA_OPTS=%JAVA_OPTS% -Dcom.ibm.team.jfs.app.auth.cache.identity.lifetime=-1
- Restart the application server for the new value to take effect.
WebSphere Application Server:
- In the WebSphere Admin Console, add the following JVM custom property: com.ibm.team.jfs.app.auth.cache.identity.lifetime=-1
- Restart the application server for the new value to take effect.
Related information
Workaround summary
Problem
When you work in a personal stream, if you deliver a change set, the configuration context should automatically switch to the global stream that is associated with that personal stream. However, when you deliver a change set in a personal stream, the configuration context remains in the personal stream.
Workaround
To work in the global stream instead, manually switch the configuration context to the global stream.
Related information
Workaround summary
Problem
If you use Rational DOORS Next Generation in Google Chrome or Mozilla Firefox, and the browser is configured for Turkish and at least one other language, the CSV export operation produces unexpected results. For example, the CSV export operation does not create a metadata section and the Microsoft Excel export operation does not create content for selected artifacts.
Workaround
Select one of the following workarounds based on the browser that you use.
Google Chrome:
- Click Settings > Show advanced settings > Language and input settings.
- Ensure that Turkish is the only selected language. If another language is selected, remove it from the list.
- Click Done.
- Restart the browser.
Mozilla Firefox:
- Click Options > Content.
- In the language section, click Choose.
- Ensure that Turkish is the only selected language. If another language is selected, remove it from the list.
- Click OK.
- Restart the browser.
Related information
Workaround summary
Problem
When you attempt to install the Rational DOORS Next Generation browser add-on on Mozilla Firefox 43 or later, Firefox reports a corrupt download. Select one of the following workarounds based on the version of Firefox that you use.
Workaround 1: Mozilla Firefox 43, 44, and 45
Complete these steps:
- Open Firefox.
- In the address bar, type about:config and press Enter.
- Search for the property labeled xpinstall.signatures.required.
- Set the property to false by double-clicking it.
- Restart Firefox.
Workaround 2: Mozilla Firefox 46 and later
Use the Rational DOORS Next Generation browser add-on with Microsoft Internet Explorer instead.
Related information
Workaround summary
Problem
When you copy bordered cells from Microsoft Excel, the borders are lost when you paste the cells into the rich-text editor.
Workaround
Complete these steps:
- Open the context menu for the pasted Excel data.
- Click Table Properties and set the Border Size attribute to 1.
Related information
Workaround summary
WebSphere Application Server stops responding and logs an out-of-memory error
Workaround summary
Comments widget on a personal dashboard displays an incorrect label for the Configuration setting
Workaround summary
Workaround summary
Page Up and Page Down keys do not work when you edit an artifact in a module in Mozilla Firefox
Workaround summary
Workaround summary
Report Builder reports and LQE queries might show incorrect link validity status when using the query provided in IBM Knowledge Center
Return to the top of the page
Workaround summary
Large change set deliveries on DB2 databases might fail with an SQL error
Workaround summary
Anchor point connections cannot be changed by using keyboard shortcuts on a Turkish Q keyboard
Workaround summary
Workaround summary
Workaround summary
Workaround summary
Workaround summary
Workaround summary
Workaround summary
Workaround summary
Limitation summary
Problem
When you create reports for rich text artifacts that include symbols or special characters, the symbols or special characters might not be displayed in the report if the reporting font does not support them.
Related information
Limitation summary
Problem
Rational DOORS Next Generation workflow attributes do not have a defined external URI when they are published to Lifecycle Query Engine. Therefore, Jazz Reporting Service reports that run against multiple projects cannot combine or merge matching workflow attributes. When workflow attributes are selected from multiple projects, Report Builder shows multiple instances of workflow attributes: one for each project.
Related information
Limitation summary
Problem
If you are working in a personal stream or global stream and have not created a change set, the Current Configuration menu contains the option to create one. When you select this option, a change set is created and is associated with the personal stream (if a global stream does not contain a personal stream, one is created). Only one change set can be associated with a personal stream.
If the same stream is open in more than one browser tab or window, your actions in one tab or window are not reflected in other tabs or windows. Because of this disconnect, you can create another change set for the same stream in another tab or window, which replaces the change set that you specified in the original instance. To avoid this issue, be careful to create and deliver change sets in a single browser tab or window.
If you unintentionally replaced the change set for a personal stream, you can restore the association with the original change set in the Global Configuration Management application.
Related information
Limitation summary
Problem
If you use Lifecycle Query Engine to build a Jazz Reporting Service report, any tags that are associated with requirements in Rational DOORS Next Generation are not displayed in the report.
Related information
Limitation summary
Problem
If you edit the Primary Text attribute in an artifact that is in a module, the audit history shows the revision with additional markup tags.
Related information
Limitation summary
Problem
If a stream is configured to require changes in manual change sets, you cannot lock an artifact in that stream.
Related information
Limitation summary
Problem
The Manage Project Area page contains a Process Sharing section where you can specify to share a process configuration between project areas. Rational DOORS Next Generation does not fully support this feature. If you attempt to share a process configuration between project areas, the sharing partially functions. However, the permissions for some Save Artifacts and Save Link actions do not work. The permissions are not inherited for any action related to a specific artifact type or link type (whether built-in or custom).
Related information
Limitation summary
Problem
You cannot import links and views into parallel configurations of a project or component. Links and views are not imported if they were already imported into another configuration in that project.
Do not attempt to manually re-create links or views that were disallowed, because they will not replace the originals and will cause duplicate resources if you export them.
Do not include links or views in packages that are intended for parallel import: explicitly excluding them from the package makes it clear that they will not be shared.
A parallel import occurs when a ReqIF package is imported into more than one configuration of a project or component. It also occurs when a resource is included in two packages and those packages are imported into two configurations of the same project.
Before version 6.0.5, parallel imports were not supported. In version 6.0.5, more ReqIF operations are available for multiple-configuration environments.
ReqIF maintains metadata that is generated during import and export operations, and exists at the project scope. When a ReqIF import is performed in a change set and that change set is discarded, the metadata persists: any subsequent import into another configuration in that project is treated as a parallel import. Similarly, if a ReqIF import is applied and its content is deleted, any subsequent import into another configuration is treated as a parallel Import. Be aware that these subsequent import operations are subject to parallel import rules.
Related information
Limitation summary
Microsoft Visio VDX and VSDX file formats have limited or no support for uploaded file previews
Limitation summary
Limitation summary
Errors are displayed during TRS rebase operations if timeouts occur
Limitation summary
Changes made to artifacts or comments do not appear in a change set
Limitation summary
Quick Search results do not correctly include artifacts that have a format of Diagram
Limitation summary
Limitation summary
Limitation summary
ReqIF import feature does not support importing data into multiple configurations of a project
Limitation summary
Limitation summary
Limitation summary
Limitation summary
© Copyright IBM Corporation 2016, 2018
Yes