Deleting data permanently from a DOORS Next Generation project

Answer

In order to actually remove data from the DNG database, you need to run the deleteJFSResources command using the repotools utility provided with the DOORS Next Generation server.

Review these important notes before running the command in a production environment:

• It is strongly recommended to only use this command on archived projects, as doing so on a live project might result in undesired behavior when navigating project baselines.
• In versions 5.x and below, the command can be run to delete archived resources or all resources by using the force parameter
• In 6.0 and above, the command can only be run to delete all resources in a project area, which requires use of the force parameter.
• The project area itself is never deleted even when using force
• There is no way to undo the results of running this command without reverting to a database backup
• The server must be shut down before running the command and a -reindex all is required once completed.

The utility is located in the following folder:

Windows: <install directory>\server (C:\Program Files\IBM\JazzTeamServer\server)

Linux: <install directory>/server (/opt/IBM/JazzTeamServer/server)

In order to run this command, you first must know the ID of the project area from which you want to permanently delete artifacts. This will be used for the contextURL parameter required by the command. See deleteJFSResources for the command reference. The ID can be obtained by using the following methods:

Warning: Always back up your data before running commands against your repository. To back up your data, either run the repotools export command or perform a database backup using your vendors database backup facility.

To get the ID of a project that is not archived:

1. In a browser, navigate to the DOORS Next Generation web UI using the following URL:
   
   https://server_name:port//
   
   Example: https://clmweb.ibm.com:9443/rm/
2. Hover over a project in the dashboard, and copy the URL to get the contextURL
   
   Example:
   https://clmweb.ibm.com:9443/rm/process/project-areas/_Ntu9UXgOEd-F1c9VY…
   
   

1. Navigate to archived projects in the JTS Admin interface by selecting Project Area Management > Archived Project Areas.
   
   
2. Copy the shortcut to get the ID of the project.
   
   Note: Use the URL in the example above
   (https://server_name:port/rm/process/project-areas/project ID)
   
   
3. Insert the ID you copied in place of project ID.

Execute the following command from a command prompt by navigating to the folder that contains the repotools-rm utility.

Below is a sample command that will delete all archived resources that are associated with the specified project.