IBM Support

Using server.start batch file to start DWA launches Tomcat then disappears

Troubleshooting


Problem

Attempts to launch the server component of IBM Rational DOORS Web Access (DWA) using the server.start batch file fail to start with no error.

Symptom

The Tomcat window that should open when the server component of DWA launches and disappears very quickly. Also, no server logs are generated for DWA.

Cause

8.3 filenames (also known as short file names) on the DWA server or the DOORS Database server are disabled.

This behavior has been logged as APAR PM49629

Environment

All supported Windows operating systems.

Diagnosing The Problem

  1. Open the server.start.bat file in a text editor e.g. Notepad.

  2. Locate the line:
    set JAZZ_CONF_URL=file:///%SHORT_PATH_URL%conf

    Type "rem" before it so that the line now looks like this:
    rem set JAZZ_CONF_URL=file:///%SHORT_PATH_URL%conf

  3. After modfying the batch file start the DWA components again.The server component should start.
    However, this is not a solution as you will not be able to log into DWA
    (this just proves that 8.3 filenames are disabled).

Resolving The Problem

You need to enable 8.3 file names for the machine.

Note:You should confirm the festival.xml file has the correct database uniform resource name (URN) as described in Identifying the database uniform resource name section of the online Information Center.

Procedure:

  1. Click Start > Run

  2. Type regedit.

  3. Browse to the registry key. HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\FileSystem\NtfsDisable8dot3NameCreation

  4. Set the value equal to zero
    .
  5. Install DWA into a new directory which needs to be completely separate from the original path that was created when 8.3 filenames were disabled.

    For example, if you previously installed to C:\Program Files (x86)\IBM\Rational\DOORS Web Access while 8.3 filenames were disabled, you won't be able to install DWA again anywhere under the C:\Program Files (x86)\IBM\Rational structure since that whole path structure had 8.3 filenames disabled. Rather you will need to install it to an entirely different location e.g. C:\DWA.

  6. Remove the previous DWA installation because this can not be used.

REGISTRY EDITS:

This solution contains information about modifying the system registry. Before making any modifications to the Microsoft Registry Editor, it is strongly recommended that you make a backup of the existing registry. For more information describing how to back up the registry, refer to Microsoft Knowledge Base article 256986

[{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"General Information","Platform":[{"code":"PF033","label":"Windows"}],"Version":"1.4;1.4.0.1;1.4.0.2;1.4.0.3;1.4.0.4;1.4.0.5;1.5;1.5.0.1;9.5;9.5.1;9.5.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSKR2T","label":"IBM Engineering Requirements Management DOORS"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":null,"Platform":[{"code":"","label":null}],"Version":"","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Document Information

Modified date:
01 May 2020

UID

swg21590703

Page Feedback