Configuration for Internet site documents supporting on QD 8.5.1.x
Internet site documents are used to configure the Internet protocols supported by IBM® Lotus® Domino® servers. A separate Internet site document is created for each protocol -- Web (HTTP), IMAP, POP3, SMTP Inbound, LDAP, and IIOP -- which is then used to provide protocol configuration information for a single server, or for multiple servers in a Domino organization.
In this document, we provide guide about some typical configuration to enable Internet site documents. The sample only covers single server scenario. For example, the host name of Domino server is: server.cn.ibm.com.
2. Basic configuration
I. Creating an Internet site document
a. From the IBM® Lotus® Domino® Administrator, click Configuration - Web - Internet sites.
b. Click Add Internet site, and select the type of Internet site document to create.
c. Click the Basics tab, and complete these fields:
Descriptive name for this site
If you do not enter a name, the default name is the type of Internet site document with the host name or address appended.
(Required for all Internet site documents) Enter the name of the registered organization that hosts the Internet site document. The name must correspond to the organization's certifier.
This Organization is associated with Web SSO Configuration. The created Internet site document and Web SSO Configuration need to use the same organization.
Use this Web site to handle requests which cannot be mapped to any other Web sites
Host names or addresses mapped to this site
(Required for all Internet site documents) Enter the target host names or IP addresses that trigger a connection's use of this Internet site document.
If the site is set up for SSL, you must specify IP addresses.
Domino servers that host this site
(Required for all Internet site documents) Enter the name of one or more Domino servers that host this site. You can use any variation of distinguished name (for example, Server1/Sales/Acme) as well as wildcards (for example, */Acme).
The default is (*), which means that all servers in the domain can host this site.
d. Complete the settings on the Security tab.
For HTTP, we can leave it as default. For HTTPS, we had to configure SSL relative sections. Please refer to previous documents about the HTTPS enablement.
e. Configure HTTP Sessions on Domino Web Engine tab.
Here we need to enable MSSO. (MSSO is required for QD site document support)
So we need to create the Web SSO Configuration if it doesn't exist. Make sure the Internet Site document and Web SSO Configuration have the same organization.
II. Enabling Internet sites on a server
1. Open the Server document you want to edit, and click Edit Server.
2. Click the Basics tab.
3. In the Basics section, enable "Loads Internet configurations from Server/Internet sites documents."
4. Save the document.
5. Restart the server.
III. Configure “Sign In' Form mapping.
As we enable Internet site documents, so we need to map the Quickr Domino sign in form for QD sites.
1. Configure “Applies To:” to “Specific Web Site/Virtual Server”.
2. Configure “Web Site/Virtual Server” to the Host names or addresses of special site. For HTTP, we need to use host name like “server1.cn.ibm.com”, for HTTPS, we need to use IP address, like “192.168.0.1”.
Detailed configuration, please refer to http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin85.doc/H_INTERNET_SITES_OVERVIEW.html.
3. HTTP configuration sample
Considering the place catalog design, QD have some limitation to support Internet site documents. We have two typical configuration for single server scenario.
server.cn.ibm.com (site for QD)
For Quickr Domino, enable MSSO, the same as host name of Domino server,
For single server scenario, we will recommend customer to use Option A: using the host name of domino server as the host name of Quickr Domino site. But in the sample, we will use another approach.
server1.cn.ibm.com (site for QD)
For Quickr Domino, enable MSSO. Not the same as Domino's.
We need to add this host name as virtual cluster server in qpconfig.xml, please refer to Step III.
So we plan to create two sites:
For Domino names.nsf, enable MSSO
For Quickr Domino, enable MSSO
server.cn.ibm.com is the host name of domino server. Please add the two host names in hosts.
a. Create a site document for server.cn.ibm.com.
b. Change Home URL to “/names.nsf”
c. Create a Web SSO Configuration for server.cn.ibm.com
d. Configure HTTP Sessions
a. Create a site document for server1.cn.ibm.com.
b. Change Home URL to “/LotusQuickr”
c. Create a Web SSO Configuration for server1.cn.ibm.com
d. Configure HTTP Sessions
e. Map “Sign in” form
III. Configure qpconfig.xml
Add the following section in qpconfig.xml.
IV. Verify the configuration
Finally we have two site documents as below.
Let's restart the Quickr Domino and have a try.
When access “http://server.cn.ibm.com”, we will see to default Sign in form of domino. After login, we are accessing the names.nsf.
When accessing “http://server1.cn.ibm.com”, we are accessing the /LotusQuickr. Click “Login In”, we will see the Quickr Domino login form.