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
- Open the server.start.bat file in a text editor e.g. Notepad.
- 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
- 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:
- Click Start > Run
- Type regedit.
- Browse to the registry key. HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\FileSystem\NtfsDisable8dot3NameCreation
- Set the value equal to zero
. - 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.
- Remove the previous DWA installation because this can not be used.
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 |
---|
Was this topic helpful?
Document Information
Modified date:
01 May 2020
UID
swg21590703