Home
IBM® Domino 10.0.1 Documentation
Welcome to the IBM® Domino 10.0.1 Administrator Help.
Configuring
Use this information to configure an IBM® Domino® network, users, servers (including Web servers), directory services, security, messaging, widgets and live text, and server clusters. Also use this information to set up IBM iNotes® on a server using Domino Off-Line Services (DOLS).
Configuring Web servers
This section describes how to set up the IBM® Domino® Web server, the Domino Web Navigator, and other Web servers such as IBM HTTP.
The Domino® Web server
Domino® provides an integrated Web application server that can host Web sites that both Internet and intranet clients can access, and that can serve up pages that are stored in the file system or in a Domino database.
Hosting Web sites
You can use Web Site documents to host Web sites on Domino®. The Web Site document is one type of Internet Site. Web Site documents contain Web site configuration information and are managed through the Servers\Internet Sites view along with other types of Internet site documents.
Configuring DSAPI, HTTP methods, and WebDAV in Web Site documents
You can set up a Web Site document to support the IBM® Domino® Web Server Application Programming Interface (DSAPI), various HTTP methods, and Web-based Distributed Authoring and Versioning (WebDAV).

IBM® Domino 10.0.1 Documentation
Welcome to the IBM® Domino 10.0.1 Administrator Help.
- What's new in IBM® Domino® 10?
  Learn about all of the new features for administrators in IBM® Domino® 10.
- Overview
  Welcome to IBM® Domino® Administrator Help.
- Installing
  Use this documentation to install the IBM® Domino® server and subsequently deploy the IBM Notes® client.
- Planning
  Use this topic as an overview of planning task.
- Configuring
  Use this information to configure an IBM® Domino® network, users, servers (including Web servers), directory services, security, messaging, widgets and live text, and server clusters. Also use this information to set up IBM iNotes® on a server using Domino Off-Line Services (DOLS).
  - Configuring a network
    This section presents the planning concepts and setup procedures necessary for a successful IBM® Domino® deployment over a network. It provides information on network protocols from a Domino perspective but does not attempt to provide general network information.
  - Configuring users and servers
    Topics in this section describe how to set up users and servers.
  - Editing the NOTES.INI file
    You should rarely, if ever, need to modify a server's or client's NOTES.INI file. The NOTES.INI file contains many settings that Domino® and Notes® rely on to work properly. An accidental or incorrect change may cause Domino or Notes to run unpredictably. Therefore, you should edit the NOTES.INI file only if special circumstances occur or if IBM® Support Services recommends that you do so.
  - Configuring directory services
    This section describes how to plan, set up, and use IBM® Domino® directory services.
  - Configuring messaging
    This section provides an overview of messaging and describes how to set up mail routing, how to set up and customize mail servers, and how to track mail.
  - Configuring iNotes®
    IBM® iNotes® (previously IBM Domino® Web Access) provides IBM Notes® users with browser-based access to Notes mail and to Notes calendar and scheduling features. Administrators specify mail policy and security policy settings as well as notes.ini file settings to complete the full implementation of IBM iNotes.
  - Configuring Web servers
    This section describes how to set up the IBM® Domino® Web server, the Domino Web Navigator, and other Web servers such as IBM HTTP.
    - The Domino® Web server
      Domino® provides an integrated Web application server that can host Web sites that both Internet and intranet clients can access, and that can serve up pages that are stored in the file system or in a Domino database.
      - Setting up a Domino® server as a Web server
        You can specify that you want to run the HTTP task on the Domino® server. Domino can then function as a Web server and allow browser clients to access databases on the server.
      - Hosting Web sites
        You can use Web Site documents to host Web sites on Domino®. The Web Site document is one type of Internet Site. Web Site documents contain Web site configuration information and are managed through the Servers\Internet Sites view along with other types of Internet site documents.
        Hosting multiple Web sites on a partitioned server
        You can set up multiple Web sites for each server's HTTP process on a partitioned server for Web Site documents or for Virtual Servers).
        Configuring HTML, CGI, icon, and Java™ files for Web Site documents
        IBM® 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.
        Configuring DSAPI, HTTP methods, and WebDAV in Web Site documents
        You can set up a Web Site document to support the IBM® Domino® Web Server Application Programming Interface (DSAPI), various HTTP methods, and Web-based Distributed Authoring and Versioning (WebDAV).
        Domino® Web Engine settings for Web Site documents
        On the Domino® Web Engine tab, you can set up session authentication, specify GIF or JPEG conversion and the number of lines to display in a view, limit the number of documents displayed when searching, redirect URLs, restrict data users can send to the Domino database, store preferences in cookies, set up language preferences, and specify an international character set.
        Setting up session authentication for Web Site documents
        You can enable session-based name-and-password authentication for a Web site document. Web clients must use a browser that supports cookies. You can customize an HTML login form for users to enter their credentials, address multiple login prompts, allow logout using the ?logout URL or formula, and log user sessions.
        Specifying GIF or JPEG conversion in Web Site documents
        You can control the format and method that Domino® uses to display images that appear in documents. The Domino Web server supports both GIF and JPEG image formats. This setting has no effect on images referenced using pass-through HTML. When you enable progressive or interlaced rendering, the image appears to download quickly and you can typically identify the image before it is completely downloaded.
        Specifying the number of lines to display in a view
        You can specify the default number of lines to display in a view when users do not specify a line count in a URL. The number of lines to display depends on your preference. Displaying many lines per view makes it easy to find an item in a large view. Displaying fewer lines per view make it easy to read the items in the view. You can also specify the maximum number of lines to display in a view when the user specifies a line count in a URL. Entering a maximum number of lines prevents users from overloading server resources by requesting a large number of lines to display.
        Limiting the number of documents displayed during a Web Site search
        You can specify a default and maximum number of documents to display as a result of performing a search on a database. Users can specify the number of documents for a search query to return using the SearchMax parameter with the SearchSite and SearchView commands.
        Finding links with the Redirect URL command
        You use the Redirect URL command to create anchor, document, view, and database links on a Web page. These links and the links for domain search results can direct users to a database on the same server or another server. Enable this option on any server that runs the domain search and on servers for which you want to resolve links to other servers.
        Restricting the amount of data users can send to a Domino® database
        The HTTP POST and PUT methods allow users to send data to the Domino® server. The Server record field Maximum size of request content sets a limit on the amount of data that can be sent using either POST or PUT. This limit is enforced for all POST and PUT methods, whether the target is a database, CGI program, or Java™ servlet, and applies to all Web sites.
        Specifying the character set to use when retrieving Web pages
        Domino® uses the default character set and character set mapping selection to generate HTML text for the browser. If you have international users who need to see text in nonwestern languages, you need to make changes to the settings. The character set setting affects all databases on the server.
        Storing Web user preferences in cookies
        Web users can configure their own time zone and regional preferences. Customized preferences are stored in cookies that reside in Web client browsers. Thus, your preferences can't be used if you access the server from a browser other than the one for which you set up cookies.
        Setting up language preferences
        The Web server uses language string resource modules to render Web pages in different languages. The Domino® Web server can support multiple languages and be configured to handle them on the fly.
        Table of character set mapping for Web server pages
        The default character set governs the available choices for character set mapping. If a character set group has mapping choices, you must also select which character set to use.
        Web Site rules and global Web settings
        Web Site rules are documents that help you maintain the organization of a Web site. They are created as response documents to Web Site documents, and apply only to that particular Web Site document. If you want to apply a rule to more than one Web Site document, copy and paste the rule document from one Web Site document to the other.
        Protecting files on a server from Web client access
        File protection documents control access to non-database files that users can access via Web browsers. Like database file (.NSF) access control lists (ACLs), which specify the names of the users who can access them and the level of access they have, you can enforce file protection for files that browser users can access -- for example, HTML, JPEG, and GIF -- also by specifying the level of access for these types of files and the names of the users who can access them.
        Creating a Web Site authentication realm document
        Using an IBM® Domino® Web Site authentication realm, you can specify the text string that appears when a user tries to access a certain directory, or file on a Domino Web server. When the browser prompts the user for a name and password, the browser's authentication dialog displays the text string. The browser uses the realm to determine which credentials -- that is, user name and password -- to send with the URL for subsequent requests. The Domino Web server caches the user's credentials to use for different realms, in order to avoid prompting the user repeatedly for the same credentials.
      - Custom Web server messages
        You can customize some of the error messages or responses that are generated by the Web server. If an Error & Response form-mapping document exists in DOMCFG5.NSF, then custom errors, not generic errors, are used.
      - Using gzip compression
        The Domino® Web server can serve files compressed by gzip (GNU zip). You must add the compressed file to the appropriate server directory. This feature is on by default.
      - HTML generation options
        The HTMLOptions capability was developed for the Web server as a general, extensible way for Web application developers to specify form and field specific options to control the Web engine's HTML generation. It allows users to select alternate behavior for the web server HTML generator, without requiring dedicated Domino® Designer events or info box controls.
    - The Web Navigator
      The Web Navigator lets Notes® workstations access the Web, without having a direct connection to the Internet. The Web Navigator server, which has a direct connection to the Internet, retrieves pages for users. The Web Navigator retrieves pages on Internet servers -- for example, servers that use Internet services such as HTTP, FTP, or Gopher.
    - Setting up Domino® to work with IBM® HTTP Servers
      You can install an IBM HTTP server module on the same computer as an IBM Domino server if the two servers must reside on the same computer and support TLS.
  - Setting up a cluster
    Setting up a cluster includes the tasks of creating and verifying that it is working correctly, and then setting up user access, mail, replications, size quotas, directory assistance, roaming, web navigation, and use of a private LAN in the cluster.
- Securing
  This section describes IBM® Domino® security features, including execution control lists, IDs, and SSL.
- Administering
  This documentation provides information about the administration tools for managing and monitoring IBM Domino® servers and databases.
- Tuning
  Use this information to improve IBM® Domino® server, Domino Web server, and messaging performance through the use of resource balancing and activity trends, Server.Load commands, advanced database properties, cluster statistics, and the Server Health Monitor.
- Troubleshooting
  This section describes how to find and solve problems with IBM® Domino® server and Administrator client.
- Glossary

Configuring DSAPI, HTTP methods, and WebDAV in Web Site documents

You can set up a Web Site document to support the IBM® Domino® Web Server Application Programming Interface (DSAPI), various HTTP methods, and Web-based Distributed Authoring and Versioning (WebDAV).

About this task

The Domino® Web Server Application Programming Interface (DSAPI) is a C API that you can use to write your own extensions to the Domino® Web Server. These extensions, or filters, let you customize authentication for Web users.

WebDAV is a set of extensions to the HTTP 1.1 protocol that allows users to collaboratively edit and manage files on remote Web servers. WebDAV clients can only access design elements in the design collection of a database. Users must have manager or designer level access rights to the database. Application developers are the typical uses of WebDAV.

Note: If you are using the Web Server Configurations view, the DSAPI fields appear in the Server document on the Internet Protocols > HTTP tab.

Procedure

From the Domino® Administrator, click the Configuration tab, expand the Web section and click Internet Sites.
Choose the Web Site you want to edit, and click Edit Document.

Click the Configuration tab and complete these fields:

Table 1. Web Site document fields
Field	Action
DSAPI filter file names	Enter the name of one or more DSAPI filter files.
Methods	Choose one or more: GET (default) HEAD (default) POST (default) OPTIONS (default) TRACE (default) PUT DELETE
WebDAV	Choose this option to enable Web-based Distributed Authoring and Versioning. Note: If you enable WebDAV, the following HTTP methods are also enabled: GET, HEAD, OPTIONS, PUT, and DELETE.