Attempts to open a formal module in IBM Rational DOORS results in the error "Unable to open module
No such file or directory C:\Program Files\IBM\Rational\...\data\v6\...\current.ver\treedata.dtc".
An administrator logs in to IBM Rational DOORS and attempts to open a module but can not.
A Rational DOORS Report message displays:
'Unable to open module '.../ModuleName' No such file or directory
The module is visible but cannot be open.
Diagnosing the problem
Files with extension .dtn should only exist during a transaction. The presence of any .dtn files beyond that time indicates a failed data update.
Treedata files contain 'cached' encrypted/compressed data.
There are crucial data files the database server creates or modifies during an update transaction.
- The current version of a file ends with a .dtc extension
- The backup version of a file ends with a .dtb extension
- The change version of a file ends with a .dtn extension
During a file modification transaction, updates are stored in a temporary file with a .dtn extension.
Upon completion of the transaction, the current data is saved for backup as a .dtb file and the changed .dtn file is saved as the current data file. Upon successful update the .dtn file then is removed.
This sequence is performed during the successful closing of a transaction 'cache'.
Resolving the problem
The current version of the file needs to exist for a DOORS module to open. If the current version of the data file is missing, a backup file may be used as a potential replacement.
The Rational DOORS Report Window error message should contain the location of the problem data file. Make a note of the data path as you will need to navigate to that location in the data area.
You can also use a module's unique ID to determine the folder location of the data files.
- Click File > Module Properties... (in the module)
- Select the General tab (on the module properties window)
The URL lists the module unique ID at the end of the string
Note: DOORS is the default type URL used for identification; however if you have enabled the optional DOORS redirector service the URL format will be either http or https.
Here are the steps to replace the missing file.
Note: No users should be logged into the project with the problem module opened until repairs are complete.
- Make a copy of the directory as a backup
- Navigate to the server data directory location identified for the problem module
- Open the Current Version directory
- Rename the treedata.dtn file (if it exists ) from this directory to treedata.dtc
- Restart the DOORS database server (ddbs)
When there is no .dtn file, or after renaming the change (.dtn) file, and the module still fails to open
you can attempt to use the backup treedata.dtb by renaming the file to treedata.dtc; then restart ddbs.
If the module opens successfully click save before performing any work.
If the problem is not resolved after renaming the file you need to obtain a working copy of the .dtc file from system backup of the last known good version of the data file and paste it in the directory.