IBM®
Skip to main content
    Country/region [select]      Terms of use
 
 
    
     Home      Products      Services & solutions      Support & downloads      My account     
 
developerworks > Dashboard > IBM Lotus Domino Web Application Development > ... > Best Practices for Building Web Applications for Domino 8 > 6.0 Server configuration
developerWorks
Log In   View a printable version of the current page.
Overview Spaces Forums Blogs Podcasts Wikis Exchange
6.0 Server configuration
Browse space Browse Space    
Added by heinsje, last edited by jservais on Apr 03, 2008  (view change)
Labels: 
(None)

 This is a community wiki. Be sure you are logged in to edit, comment, and add pages. Not a member yet? It's free and simple. Click Login in the upper right corner and Register.
View a PDF of the original wiki content produced in March 2008 by Lotus and IBM Redbooks.

Domino provides the ability to present information to users through a Notes client and Web browser. To enable the server to present Web pages, the HTTP task must be enabled. You can enable the HTTP task through the console, or to have it run whenever the server is started, add it to the ServerTasks line in the Notes.ini.

The Web server part of the Domino server provides for additional functionality and additional configuration settings and security concerns.

Tell HTTP commands

Command Result
Tell HTTP Dump Config Dumps the HTTP configuration to a text file so that you can see how the server is configured.
Tell HTTP Refresh Refreshes the Web server before the normal refresh. You can specify the refresh cycle interval in the server document.
During a Web server refresh cycle, all of the Web site documents, including File protection, authentication realms, and rules, are reloaded by the server.
Tell HTTP Restart Refreshes the Web server with changes made to settings in the:
  • Server document for the Web server
  • File protection, virtual server, and URL mapping documents in the Domino Directory
  • NOTES.INI file that affects the HTTP server task
  • HTTPD.CNF and BROWSER.CNF files
  • Servlets or the servlets.properties fileThis command produces mostly the same results as stopping and restarting the Web server but is faster since the HTTP server task remains in memory. All outstanding HTTP requests are processed before the HTTP task restarts. However no HTTP requests are processed during the restart.  This command deletes the in-memory page and user-authentication caches.
Tell HTTP Show File Access Displays information about file system protection on the machine and on virtual servers, if you set up virtual servers on the machine.
Tell HTTP Show Security Displays information about SSL and the server key ring file, including information about whether the server started SSL on the machine. Displays information about SSL for virtual servers if you set up virtual servers on the machine.
Tell HTTP Show Users Displays the names of users, IP addresses, and the session expiration time for users authenticated with session-based authentication. On servers that are using multiple servers (SSO), authentication may not report sessions accurately by using this command. If the authentication cookie is from the current server, it displays the user name, IP address, and session expiration time for that server. If the authentication cookie is not from the current server, then is does not display session information for users. After a user logs out, this command continues to display the cookie as valid on the server. The session is still valid even though the user has ended the session.
Tell HTTP Show Virtual servers display a list of virtual servers running on the machine.
Tell HTTP Quit Stops the Web server task.
Restart Task HTTP This is a general command and is shorthand for issuing a "tell http quit" followed by a "load http."


Notes.ini settings for HTTP

This following table provides a brief list of the notes.ini settings that effect the HTTP task on the Domino server. We recommend that you research the setting prior to implementing it and make sure it will not cause performance issues. The Domino resources section contains a list of sites hosting information about the Notes.ini setting for you to reference. These settings can be made to the Notes.ini directly or through the server's configuration document. The configuration document lets you easily see what is set, without having to access the Notes.ini directly.

Subject Release Description
DominoCompleteDocType 7 Use to have the Domino Web server generate a specific doctype string in the generated HTML. It does not cause the server to generate the correct html for each type.
DominoNoWebAdmin   Specifies whether the HTTP server task automatically creates and manages the Domino Web administrator (webadmin.nsf) application.
DominoStrictHTML 7 DominoStrictHTML=2 No additional information is known about this variable.
DominoDisableFileUploadChecks   Allows the file upload control to be disabled on pages served by the Domino Web server.
DominoXUrlProcess 7.0 To enable a Domino Web server's URL command parser to accept ! or ? in the URL. Put into the workstation notes.ini to test pages using the exclamation mark (!) with the Domino Designer. For servers, on the Web site document or server document, if "Using Internet Site" is not enabled. It is listed as "Make this site accessible to web search site crawlers."
HTTPDisableGlobalWebsiteRules 8.0.1 To have the default Web site not be applied to all Web sites when using Internet sites, set the variable "HTTPDisableGlobalWebsiteRules=1".
HTTPDisableSSIWarnings 7.0.2 Use to allow server-side include (SSI) files to include comments containing "<!--#" without warning to the console and browser.
HTTPDisableUrlCache   Set to "1" to disable the server side cache which was introduced to minimize redundant gzip compressions.
HTTPEnableConnectorHeaders 6.0 Enables the Domino HTTP task to process special headers that are added to requests by a WebSphere 4.0.3 plug-in installed on a foreign Web server. Valid Values are: 0
HTTPEnablePostDataLogging 6 HTTP request logging should be used only for troubleshooting
HTTPEnableResponseContentLogging 6 HTTP request logging should be used only for troubleshooting
HTTPEnableThreadDebug 6. HTTP request logging should be used only for troubleshooting.
HTTPFormulaCache   Enables ( 1 ) or Disables ( 0 ) the HTTP server formula cache
HTTPLogFormatAscii   HTTP log files are written in EBCDIC format by default on the i5/OS® platform. You can change the format of these files to ASCII by setting the following in the NOTES.INI file.
HTTPLogUnauthorized 6.0 When set to 1, the Web server logs Error 401 instances to the server console. These instances are generated in two cases:
  • A user attempts to access a resource but is not authorized for it.
  • A user has failed to authenticate.
HTTPMultiErrorPage 6 The original R5.x model or R6.x queue of requests model can be selected. This variable is for Notes 6.5.4 FP1 and later.
HTTPSkipTranslationOfNsfRequests 7.0.2 Remove NSF files from Web rules to allow backward compatibility with R5. The Notes.ini variable is "HTTPSkipTranslationOfNsfRequests=1".
HTTPUseNotesMemory   Setting this variable to 1 can prevent a excessive use of the general Memory pool. This excessive usually causes a "Panic: Insufficient Memory" error message.
HTTP_Port   This variable is only used during the collaboration server install. Example : HTTP_Port=8088
HTTP_Pwd_Change_Cache_Hours 6.0 Allows both the old and new passwords to be valid on a server after user request an HTTP password change for this number of hours.
SSLCipherSpec   Determines which SSL-compliant cipher to use to encrypt files on the server.
SSL_Load_Client_Cert 5 Enables LDAP lookups to be done properly when SSL is being used.
SSL_Resumable_Sessions   Specifies the number of resumable SSL sessions that will be cached on the server. Setting this variable to 1 disables SSL session resumption on the server.
ReportSSLHandshakeErrors 5 Reports HTTP SSL handshake errors to the console and LOG.NSF. You may want to set this by default, since it only reports errors.
WebAuth_Verbose_Trace   Use this setting to troubleshoot problems with Web server user authentication and Web server group searches for database access verification. With the setting enabled, a Domino Web server records detailed information about specific Web user authentication sessions at the server console.
WebSess_Verbose_Trace   When enabled, the setting allows a Domino Web server to record, at the server console, detailed information about specific Web session-based authentication sessions, such as unauthorized, unauthenticated, or session expiration information.


Topics in this section

Children   Hide Children | View in hierarchy
Docs Logging (IBM Lotus Domino Web Application Development)
Docs Performance considerations (IBM Lotus Domino Web Application Development)
Docs Security considerations (IBM Lotus Domino Web Application Development)
Docs Server error handling (IBM Lotus Domino Web Application Development)
Docs Topology (IBM Lotus Domino Web Application Development)
Docs Working with Web site rules (IBM Lotus Domino Web Application Development)


    About IBM      Privacy      Contact