Configuring Microsoft IIS for Helix ALM Web

After you install the Helix ALM web components, you need to configure the web server before users can log in to web clients.

See Supported Web Servers for information about supported Microsoft Internet Information Server (IIS) versions. Refer the IIS documentation for information about enabling CGI execution and authentication.

Enabling support for CGI executables

Creating a CGI directory alias

If you are configuring IIS for the Helix ALM License Server Web Admin Utility and Helix ALM Web, and the CGIs for both applications are in the same directory (e.g., C:\inetpub\scripts), you only need to create one CGI directory alias.

1. Open IIS Manager.

2. In the Connections pane, expand the server computer and Sites nodes.

3. Right-click Default Web Site and choose Add Virtual Directory.

The Add Virtual Directory dialog box opens.

4. Enter 'scripts' as the Alias.

5. Enter the path to the ttcgi.exe as the Physical Path. This is the path entered during the Helix ALM installation. The default path is C:\inetpub\scripts.

6. Click OK to save the changes.

Enabling the .exe CGI extension

1. Select the scripts virtual directory in the Connections pane.

2. Double-click Handler Mappings.

3. Click Add Module Mapping in the Actions pane.

The Add Module Mapping dialog box opens.

4. Enter 'ttcgi.exe' as the Request path.

5. Select CgiModule as the Module.

6. Enter 'ttcgi' as the Name.

7. Click OK to save the changes.

8. Repeat steps 3-7 for other web clients you use.

  • If you use the web server admin utility, add ttadmcgi.exe.
  • If you use SOAP, add ttsoapcgi.exe.
  • If you use an external source control provider, such as Git, add ttextpro.exe.

9. Select the server computer in the Connections pane.

10. Double-click ISAPI and CGI Restrictions.

11. Click Add in the Actions pane.

The Add ISAPI or CGI Restriction dialog box opens.

12. Enter the path to the ttcgi.exe program as the ISAPI or CGI path. This is the path entered for the ttcgi.exe program during the Helix ALM installation. The default path is C:\inetpub\scripts\ttcgi.exe.

13. Enter 'ttcgi' as the Description.

14. Select Allow extension path to execute.

15. Click OK to save the changes..

16. Repeat steps 11-15 for other web clients you use.

  • If you use the web server admin utility, add ttadmcgi.exe.
  • If you use SOAP, add ttsoapcgi.exe.
  • If you use an external source control provider, such as Git, add ttextpro.exe.

Changing the CGI response buffer limit

1. Select the scripts virtual directory in the Connections pane.

2. Double-click Configuration Editor.

3. In the Section list, expand system.WebServer and select handlers.

4. Select (Collection) and click Edit Items in the '(Collection)' Element pane.

The Collection Editor dialog box opens.

5. Select ttcgi.

6. Change the responseBufferLimit property value to 0.

7. If you use SOAP, select the ttsoapcgi item and change the responseBufferLimit property value to 0.

8. Close the Collection Editor dialog box to save the changes.

Troubleshooting