Configuring your web server for use with Tarantella

Read this topic to...
Learn how to configure your web server for use with Tarantella.

Before you can use Tarantella, you must configure your web server in two ways:

Add a Document directory for the Tarantella document root.
Add a Program (CGI) directory for the cgi-bin subdirectory of the document root.

How you do this depends on your web server. See your web server's documentation for full instructions, or read one of the following sections.

Apache web servers

You must add two configuration directives to one of your web server configuration files, for example httpd.conf:

ScriptAlias  /tarantella/cgi-bin  install_dir/var/docroot/cgi-bin
Alias        /tarantella          install_dir/var/docroot

Note The lines must be in the order shown.

Tarantella Setup displays what you must use as part of the "What you must do next" section.

You should also ensure the web server follows symbolic links. The Directory directive for / should include Options FollowSymLinks. These changes assume you are using the default configuration of Apache. See your web server documentation for more information.

You must restart the web server for the configuration change to take effect.

iPlanet™/Netscape web servers

Start the iPlanet™/Netscape Administration Server and connect to it, giving the Netscape server administrator's username and password.
Click the web server you want to use for Tarantella.
In the top frame, click Content Management. Then in the left frame, click Additional Document Directories.
- For URL Prefix, type "tarantella".
- In Map To Directory, type "install_dir/var/docroot". (Tarantella Setup displays what you must use as part of the "What you must do next" section.)
Click OK, then click Save.
In the top frame, click Programs. Then in the left frame, click CGI Directory.
- For URL Prefix, type "tarantella/cgi-bin".
- In Map To Directory, type the name of the cgi-bin subdirectory "install_dir/var/docroot/cgi-bin". (Tarantella Setup displays what you must use as part of the "What you must do next" section.)
Click OK, then click Save and Apply.

Known issues with web servers

For a list of known issues with web servers, see the Tarantella Base Component Release Notes.

Related topics
Configuring your web server for web applications