17.2 Configuring the Web Server

Each of the supported Web servers has a different configuration mechanism.

Note that a Windows Web server must run as a service and must be configured to log on as the System account. This is the default for the Microsoft and iPlanet Web servers; the instructions below for configuring an Apache Web server include this setup. If you start a Windows Web server as a console application, rather than as a service, it is not likely to have the rights required to perform logons for client users.

Apache

Configure the Apache server by editing the httpd.conf text file in the conf subdirectory of the Apache installation area. Add the following two lines to the file, substituting appropriate values for ccase-home-dir and ccbase-url.

ScriptAlias /ccbase-url/bin/ "ccase-home-dir/web/bin/"
Alias /ccbase-url/ "ccase-home-dir/web/"

Note that:

• On Windows as well as UNIX, all pathname component separators must be slashes (/); Apache on Windows does not recognize backslashes (\).

• The ScriptAlias directive must precede the Alias directive.

For example, on a Windows system where ccase-home-dir is C:\Program Files\Rational\ClearCase and ccbase-url is ccase, add these lines to httpd.conf:

ScriptAlias /ccase/bin/ "C:/Program Files/Rational/ClearCase/web/bin/"
Alias /ccase/ "C:/Program Files/Rational/ClearCase/web/"

For a ClearCase LT server running UNIX where ccase-home-dir is /usr/atria and ccbase-url is ccaseweb, add these two lines to httpd.conf:

ScriptAlias /ccaseweb/bin/ "/usr/atria/web/bin/"
Alias /ccaseweb/ "/usr/atria/web/"

For a ClearCase LT server running Windows, configure the Apache Web server as a Windows service. To do so, execute the Install Apache as Service entry in the Apache folder which was added to the Start menu during installation. (Newer versions of the Apache Web server provide an install-time option to install the Web server as a service.)

Restart the Apache server if it is running. (Note that only Apache servers require restarting.)

Microsoft Internet Information Server (IIS)

Configure IIS by running the Internet Service Manager; you must be logged on using the same account that you use to perform standard Web administrative operations. There is both a Microsoft Management Console version and an HTML version of the interface. These instructions apply to the MMC version. The tasks are the same in the HTML version, but the navigation is somewhat different.

NOTE: Configuration options are slightly different for IIS4 (supported on Windows NT) and IIS5 (supported on Windows 2000 and Windows XP).

Configuration Steps for IIS4

To configure the ClearCase Web Interface in IIS4:

1. Start the Internet Service Manager.

2. From the list presented, select the Web site in which you want to place the ClearCase interface.

3. Click the Action button in the toolbar, and then click New > Virtual Directory. The New Virtual Directory Wizard starts.

4. In the New Virtual Directory Wizard, enter the value of ccbase-url (for example, ccase), and click Next.

5. Enter the pathname of the ccase-home-dir\web directory (for example, C:\Program Files\Rational\ClearCase\web). To find the directory, click Browse; then click Next.

6. Make sure that the Allow Read Access and Allow Execute Access check boxes are selected, and that Allow Write Access and Allow Directory Browsing are cleared. (It doesn't matter whether Allow Script Access is selected.) Click Finish.

7. The new virtual directory appears as a folder under the chosen Web site. Right-click the folder and select Properties from the shortcut menu. On the Virtual Directory page, under Content Control, make sure that the Directory browsing allowed and Index this directory check boxes are cleared.

8. Click the Directory Security tab, and then click Edit. In the Authentication Methods dialog box, clear Allow Anonymous Access and select Basic Authentication.

Basic authentication requires client users to supply a user name and password to access the Web site. Windows Challenge/Response authentication allows Internet Explorer clients, if they are running on Windows and logged on to a domain, to access the Web site as the client user without having to specify a user name and password. Access to other network resources from the Web server is not allowed. ClearCase LT supports both forms of authentication.

NOTE: ClearCase Web interface users do not need permission to Log On Locally to the Web server host if

9. Click OK to close the Authentication Methods dialog box. Then click OK to close the Properties sheet.

IIS4 is now configured for ClearCase Web access.

Configuration Steps for IIS5

To configure the ClearCase Web Interface in IIS5:

1. Start the Internet Service Manager.

2. From the list presented, select the Web site in which you want to place the ClearCase interface.

3. Click the Action button in the toolbar, and then click New > Virtual Directory. The New Virtual Directory Creation Wizard starts.

4. In the New Virtual Directory Creation Wizard, enter the value of ccbase-url (for example, ccase), and click Next.

5. Enter the pathname of the ccase-home-dir\web directory (for example, C:\Program Files\Rational\ClearCase\web). To find the directory, click Browse; then click Next.

6. Make sure that the Read and Execute check boxes are selected and the Write and Browse check boxes are cleared. (It doesn't matter whether Run Scripts is selected.) Click Next to get to the confirmation page, then click Finish.

7. The new virtual directory appears as a folder under the chosen Web site. Right-click the folder and select Properties from the shortcut menu. On the Virtual Directory page, make sure that the Directory browsing and Index this resource check boxes are cleared.

8. Click the Directory Security tab, and then click the Edit button in the Anonymous access and authentication control group. In the Authentication Methods dialog box, clear Allow Anonymous Access and select Basic Authentication.

Basic authentication requires client users to supply a user name and password to access the Web site. Integrated Windows authentication allows Internet Explorer clients, if they are running on Windows and logged on to a domain, to access the Web site as the client user without having to specify a user name and password. Access to other network resources from the Web server is not allowed. ClearCase LT supports both forms of authentication.

NOTE: ClearCase Web interface users do not need permission to Log On Locally to the Web server host if

9. Click OK to close the Authentication Methods dialog box. Then click OK to close the Properties sheet.

IIS5 is now configured for ClearCase Web access.

iPlanet Enterprise Server

Configure the iPlanet Web server by connecting to the iPlanet administration server. The procedure is the same for both Windows and UNIX. Connect to the URL for the administration server with a browser.

To configure the ClearCase Web Interface in iPlanet:

1. Select the server to configure from the drop-down list of servers, and then click the Manage button.

2. On the next page, click the Class Manager link in the upper right.

3. Click the Programs tab.

4. Make sure the CGI Directory option is selected.

5. In the CGI Directory form, enter the value of ccbase-url/bin as the URL prefix, and enter ccase-home-dir/web/bin as the CGI directory. For example, if ccbase-url is ccase, and ccase-home-dir is /usr/atria, enter ccase/bin as the URL prefix and enter /usr/atria/web/bin as the CGI directory.

6. Click OK, and then click OK in the confirmation dialog box.

7. In the row of tabs at the top of the page, click Content Management.

8. Click Additional Document Directories at the left of the page.

9. Enter the value of ccbase-url in the URL prefix box, and enter ccase-home-dir/web in the Map To Directory box.

10. Click OK, and then click OK in the confirmation dialog box.

11. Click the Apply link at the upper right of the page, and then click the Apply Changes button the next page.

12. Click the OK button in the confirmation dialog box.

The iPlanet server is now configured for ClearCase Web access.