Lotus Domino Administrator 8 Help - Creating a Web Site Rule document

WEB SERVERS

Creating a Web Site Rule document
You can keep database files, HTML files, CGI scripts, and other related Web files in multiple locations or move them to new locations without breaking URL links or changing documents. IBM® Lotus® Domino™ displays the Rules document as a response to the Web Site document on the Configuration tab in the Web - Internet Sites view.

Redirecting a URL displays the page in the new location and displays the URL in the location box for the user. Mapping a URL or directory displays the page in the new location and hides that new location from the user.

To create a Web Site Rule document

1. From the Domino Administrator, click the Configuration tab, expand the Web section and click Internet Sites.

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

3. Click the Web Site button and choose Create Rule.

4. Click the Basics tab and complete the following fields:

Field Action

Description Enter a name that differentiates this rule from others you create.

Type of Rule Choose one:

Directory -- To allow a server file-system directory to be accessed by a URL path.
Redirection -- Resource identified by the URL has been moved to a different location or Web site.
Substitution -- To replace a string in the URL with another string.
HTTP response header -- To add an Expire header or custom headers to HTTP responses that match specified URL patterns and response codes.
Override session authentication -- To set up basic authentication for a specific Web site when session-based authentication is enabled for the server.

Incoming URL pattern Pattern that describes the URLs affected by this rule.
If you are defining many rules, specify the longest unique pattern for each rule. Do not include http or the host name in the pattern.

Redirect to this URL (Redirection only) Enter the new URL location. If the URL pattern in this field starts with a slash, the rule is treated as internal redirection. Otherwise, the rule is assumed to be external redirection.
The pattern for an external redirection needs to start with an Internet protocol string that the browser understands, such as http: or ftp.

Replacement pattern (Substitution only) Enter the string that replaces the matching part of the incoming URL.

Target server directory (Directory only) Enter the file-system directory path being mapped. This can be specified as a fully-qualified path or a path relative to the data directory. If you want to map a directory that isn't under the Domino data directory, specify the fully qualified path.
Service providers: Use the organization's data directory.

Access level (Directory only) Choose one:

Read access -- To allow browser users to read files from the directory are displayed in the browser or downloaded. When a user requests a file from the directory, the server sends the contents of the file back to the browser.
Execute access -- To allow browser users to load and run CGI programs in the directory. The server relays the output from the program to the browser.

HTTP response codes (HTTP Response Header only) Enter the HTTP response codes to which you want your response headers applied.

Expires header (HTTP Response Header only) Choose one:

Don't add header -- Files in the directory are displayed in the browser or downloaded.
Add header only if application did not -- Files in the directory are CGI files to be executed on the server.
Always add header (override application's header)
Note If you choose to add a header, you must specify an expiration period -- either by specifying the number of days for which you want to enable this header, or a date after which you want to disable this header.

Custom header (HTTP Response Header only) For each custom header you want to use, specify:

Name -- The name of the response header.
Value -- The value of the response header.
Override -- Override application's header.

5. Save the document.

See also

Web Site rules and global Web settings

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary

Field	Action
Description	Enter a name that differentiates this rule from others you create.
Type of Rule	Choose one: Directory -- To allow a server file-system directory to be accessed by a URL path. Redirection -- Resource identified by the URL has been moved to a different location or Web site. Substitution -- To replace a string in the URL with another string. HTTP response header -- To add an Expire header or custom headers to HTTP responses that match specified URL patterns and response codes. Override session authentication -- To set up basic authentication for a specific Web site when session-based authentication is enabled for the server.
Incoming URL pattern	Pattern that describes the URLs affected by this rule. If you are defining many rules, specify the longest unique pattern for each rule. Do not include http or the host name in the pattern.
Redirect to this URL	(Redirection only) Enter the new URL location. If the URL pattern in this field starts with a slash, the rule is treated as internal redirection. Otherwise, the rule is assumed to be external redirection. The pattern for an external redirection needs to start with an Internet protocol string that the browser understands, such as http: or ftp.
Replacement pattern	(Substitution only) Enter the string that replaces the matching part of the incoming URL.
Target server directory	(Directory only) Enter the file-system directory path being mapped. This can be specified as a fully-qualified path or a path relative to the data directory. If you want to map a directory that isn't under the Domino data directory, specify the fully qualified path. Service providers: Use the organization's data directory.
Access level	(Directory only) Choose one: Read access -- To allow browser users to read files from the directory are displayed in the browser or downloaded. When a user requests a file from the directory, the server sends the contents of the file back to the browser. Execute access -- To allow browser users to load and run CGI programs in the directory. The server relays the output from the program to the browser.
HTTP response codes	(HTTP Response Header only) Enter the HTTP response codes to which you want your response headers applied.
Expires header	(HTTP Response Header only) Choose one: Don't add header -- Files in the directory are displayed in the browser or downloaded. Add header only if application did not -- Files in the directory are CGI files to be executed on the server. Always add header (override application's header) Note If you choose to add a header, you must specify an expiration period -- either by specifying the number of days for which you want to enable this header, or a date after which you want to disable this header.
Custom header	(HTTP Response Header only) For each custom header you want to use, specify: Name -- The name of the response header. Value -- The value of the response header. Override -- Override application's header.