Search:     Advanced search

Customizing the TestTrack Pro Web Configuration

Article ID: 555  |  Last updated: 05 Jan, 2015

Note: The following information only applies to TestTrack 2013.0.2 and earlier.

This article includes information about customizing the TestTrack Pro Web configuration and using an alternate Web alias. In IIS, aliases are often referred to as Virtual Directories.

TestTrack's CGI relies on two registry settings to determine the location of the TestTrack Pro Web HTML files: the Forms path and the HTML forms path.

The Forms path is listed in the registry as FormsPath. This key is used to determine the logical path to the TestTrack Pro Web HTML files. For example: C:\Inetpub\wwwroot\tweb\.

The HTML forms path is listed in the registry as HTMLPath. This key is used to determine the alias the TestTrack Pro Web files are hosted on. A popular customization is to create a TestTrack Pro alias to host ttweb in TestTrack/ttweb. The TestTrack CGI uses that HTMLPath to resolve the %HTMLPATH% field code in TestTrack Pro Web pages. This customization is most commonly used in the TestTrack Pro HTML pages to determine the location of images and Help files.


You want to install TestTrack into its own alias. You create a new alias, named TestTrack. You create a subalias, off the TestTrack alias, named secure. The secure alias has a logical path that points to your TestTrack Pro Web HTML files, for example C:\Inetpub\wwwroot\tweb\. Depending on how your web server handles the sharing of subdirectories, you may also need to create subaliases off secure for the images and Help directories.

The location for the Help button in any TestTrack Pro Web HTML page is defined as:

For this example, %HTMLPATH% is defined in the registry as TestTrackPro/secure. The address is interpreted as:

The HTMLPath default value is ttweb. This value does not need to be set. If the HTMLPath key is blank, the TestTrack CGI automatically assumes ttweb is the default value.

Changing the HTMLPath settings

The HTMLPath registry key was added to help when installing TestTrack into a non-default alias, such as TestTrackPro in the above example. The TestTrack installer asks some basic questions about your web server. The installer cannot resolve the entire virtual directory configuration or guess which virtual directory to use.

To avoid conflicts, TestTrack installs into the root web directory. If you choose to host TestTrack in a location other than ttweb, the HTMLPath is always blank after an installation. Configuring TestTrack to use alternate aliases and file paths requires you to manually configure the HTMLPath setting.

  • Windows - The FormsPath and HTMLPath can be set using the TestTrack Registry Utility, which is located in the TestTrack directory.
  • Unix - The HTMLPath and FormsPath settings are stored in /etc/ttstudio.conf.
Article ID: 555  |   Last updated: 05 Jan, 2015
configuration alias FormsPath HTMLPath

Prev   Next
Configuring IIS for TestTrack RM Reviewer and TestTrack TCM Test...     Automatically Logging Into TestTrack Pro Web