WEB SERVERS


Configuring HTML, CGI, icon, and Java files for Web Site documents
IBM® Lotus® Domino® looks for individual HTML, CGI, and icon files in specific directories on the server's hard drive. You can change the URL path for icons and CGI program files. The URL path is where Domino looks for icons or CGI programs when it encounters a reference in the HTML code to one of these.

Specifying icon and CGI URL paths is useful if you change the directory location of icons or CGI programs and you do not want to modify HTML code that references the previous location of these files.

You need to add an extension to the file name for any files stored in the server CGI directory in order to be able to execute them. For example, .exe must be added to the file names for executable files, .pl must be added to the file names for Perl programs, and so on.

1. From the IBM® Lotus® Domino® Administrator, choose Configuration - Web - Internet Sites.

2. Choose the Web Site document you want to edit and click Edit Document.

3. Click Configuration. Under "Default Mapping Rules," complete these fields:
FieldAction
Home URLEnter the URL command to perform when users access the Web site without specifying a resource -- for example, the user just requests

    http://www.acme.com

Usually the home URL points to the Web site's home page -- for example

    /welcome.nsf/hello?OpenPage
HTML directorySpecify the directory that will be used to find HTML files if a URL does not specify a path -- for example, http://www.acme.com/welcome.html. Default is domino\html. The path can be relative to the Domino data directory, such as domino\myhtml, or it can be fully qualified, such as c:\websites\html.

Service providers: This directory is relative to the main Domino data directory, not to the hosted organization's data directory.

Icon directoryEnter the directory where icon files are located. You can specify the path for the icon directory using either the fully qualified path or a relative path. Default is domino\icons.

Service providers: This directory is relative to the main Domino data directory, not to the hosted organization's data directory.

Icon URL pathEnter the URL path that is used to map to the icon directory. The default is /icons.

For example, the URL


    http://<servername>/icons/abook.gif

returns the file c:\lotus\domino\data\domino\icons\abook.gif.
CGI directory Enter the default directory where CGI programs are located. The default is domino\cgi-bin.

Service providers: This directory is relative to the main Domino data directory, not to the hosted organization's data directory.

CGI URL pathEnter the URL path that is used to map to the default CGI directory. The default is cgi-bin.

For example, the URL


    http://<servername>/cgi-bin/test.pl

runs the CGI program c:\lotus\domino\data\domino\cgi-bin\test.pl.
Java applet directoryEnter the directory where the Domino Java applets are located. The default is domino\java.
Java URL pathEnter the URL path that is used to access files in the default Java directory. The default is /domjava.
Note If you are using the Web Server Configuration view, open the Server document, choose Internet Protocols - HTTP, and complete the fields in the "Mapping" section.

Related topics