The purpose of this document is to describe how the IBM® System Verification Test (SVT) team enabled Lotus® Quickr™ 8.2 services for Lotus Domino® 3 node Cluster environment and integrated in SamTime 8.0 Server, it provides you the configuration steps for your own deployment.
The test environment included the following components:
Lotus Domino 8.5 server
Lotus Quickr 8.2 services for Lotus Domino
IBM WebSphere Edge Components Load Balancer Server(Network Dispatcher)
IBM Lotus SameTime 8.0 Server
LDAP server: Sun One Directory Server 6.1
The picture below shows the configuration setup for our testing of Lotus Quickr 8.2:
The following table lists the specifications for the computers used in the infrastructure:
The Test team used the following steps to set up this test infrastructure:
Install and configure the Load Balancer(Network Dispatcher) Server
To install the Load Balancer(Network Dispatcher) on one separate machine, and do the blow steps:
Additional IP is required for Load Balancer, open network connection in Load Balancer server, double click Local Area Connection
Click Properties, select Internet Protocol(TCP/IP), click Properties, confirm your static IP setting, then Click Advanced…, switch to IP Setting tab, in IP address panel, click Add.., fill in the field with ND IP address and subnet mask, then click “Add” button to add this IP address in Load Balancer server. Make sure DNS knows this IP address to reflect “ND.cn.ibm.com”, or add reflection into hosts files.
Start the Load Balancer,Select Dispatcher in left panel , on top menu bar, Click Dispatch -> start Dispatch Wizard , click Next.
Click Create Configuration in this Wizard, confirm your Network Dispatcher server is selected in drop down list, then Click Update Configuration & Continue.
Fill in the input field with your New Cluster Hostname, ex: ND.cn.ibm.com, then Click Update Configuration & Continue, Confirm Cluster Added Successfully, then Click Next.
Select Port 80 (HTTP) in drop down list, then click Update Configuration & Continue, confirm Port Added Successfully, click Next.
Click Add a server, add all your three hostnames of quickr cluster’s nodes. Click Update Configuration & Continue, then Next as default until finish the Wizard.
Click Dispatch -> Connect to host in Load Balancer, select your Network Dispatcher server on port 10099, then OK, confirm your configuration, and will find the three Quickr Cluster nodes list in Port:80, edit the Port:80 Configuration Settings, set the Sticky time to “600” , then the Load Balancer server configuration is finished.
Install the Quickr Servers and Sametime server and configure the Quickr Servers work with NetWork Dispactcher Server
1. Install Lotus Domino8.5 on the three node separately, and configure the three Domino Server in the same domain.
Install the Domino8.5 server on quickr node1(ex: server1), configure it as the first domino server.
Register three server IDs for the other two quickr nodes and one for sametime server, in order to the three quickr nodes and sametime server in the same domino domain.
Configure the other two quickr nodes and sametime node as additional domino server using the IDs that from the server1.
2. Install Lotus Quickr 8.2 on the three nodes separately, and install the SameTime server(including the Sametime tookit), configure the three Quickr 8.2 server and the SameTime Server to connect the same LDAP Server(Sunone6.1 LDAP Server).
3. Start all the Domino Quickr, connect the first Domino Quickr 8.2 Server(Server1) using the Domino Administrator client.
From the Domino Administrator, make sure the administration server is current.
Click the Configuration tab.
Expand Server, and click All Server Documents.
In the Results pane, select one quickr node server.
Click Add to Cluster.
When asked to choose the cluster you want to add the servers to, choose Create New Cluster, and then click OK.
Type the name of the new cluster, and click OK.
Choose Yes to add the server to the cluster immediately, or choose No to submit a request to the Administration Process to add the servers to the cluster.
Note: Repeat the steps above to add all the quickr servers into same cluster.
4. Add "*/certification"(e.x. */ibm) into "Create databases & templates" and "Create new replicas" fields of Server Access in Server document's Security, we need edit them on the three quickr server's document.
5. Add four schedule programs in the first domino quickr server(ex: server1) , Click the Configuration tab, Expand Server, select the Programs view then Add Program. the detail info as below:
Notes: server2/ibm and server3/ibm are the other two quickr nodes name, please replicate manually if you do not schedule the programs.
Notes: the four program need different schedule time.
6. Edit the qpconfig.xml on the three Quickr server and enable the cluster section:
Notes: the hostname is the Netwok Dispatcher created, ex: "ND.cn.ibm.com" in Step 1.
7. Add a "Microsoft loopback Adapter" to accept traffic for ND.cn.ibm.com on every Quickr servers.
On both nodes servers, select Start -> Control Panel -> Add Hardware
Select “Yes,I have already connected the hardware”, then Click Next, Drag down scroll bar to the bottom, Select Add a new hardware device, then Click Next.
Select “Install the hardware that I manually select from a list(Advanced)”, then Click Next, select Network adapters, click Next.
Select Microsoft in Manufacturer list, Select Microsoft Loopback Adapter in Network Adapter list, then Click Next.
Complete installation, Click Finish.
8. Open the Microsoft loopback Adapte and set the loopback address to your cluster address(ex: ND.cn.ibm.com's IP address), set the subnet mask (255.255.255.0) and do not enter a gateway address, use the localhost IP as the default DNS server, do this step on all the three quickr servers.
To configure the loopback with the cluster IP, complete the following steps to alias(special for Windows 2008 Platform).
Issue the ipconfig /all command on the command line to determine the interface name of the loopback adapter. Locate the loopback adapter information in the results. For example:
Ethernet adapter Local Area Connection 2:
Description ...Microsoft Loopback Adapter
In the previous example, the interface name is "Local Area Connection 2."
Alias the cluster IP to the loopback using the following netsh command :
netsh interface ipv4 add address "Local Area Connection 2" cluster_ip_address
Enable forwarding for all of the interfaces on the machine. For example:
"netsh interface ipv4 set interface "Local Area Connection" forwarding=enabled"
"netsh interface ipv4 set interface "Local Area Connection 2" forwarding=enabled"
After each command, you should receive an "OK" message.
Configure the three Quickr Servers work with SameTime Server
1. Configure the three Quickr Servers' MSSO.
Startup the Lotus Domino Administrator client .
Point this Admin client at the server1/ibm server.
Login as Domino Administrator.
In the client click on FILE\Database\New
Under Section entitled "Specify New Database Name and Location" in Server field chose: server1/ibm, under Section entitled "Specify Template for New Database" in Server field chose: server1/ibm
Then make sure that you checkoff "Show Advanced Templates".
And chose the template: "Domino Web Server Configuration(8)"
(and you'll see the File name: domcfg5.ntf )
GO to the File name line,under Section entitled "Specify New Database Name and Location" and enter domcfg.nsf.
And for the title enter: R8 Dom config
Click OK to save the db to server server1/ibm.
Now setup this domcfg.nsf since it will open up in your view.
Click the ADD MAPPING icon at the top of the view to create a document.
Under the Section entitled FORM MAPPING,
in the field named Target Database enter: LotusQuickr/resources.nsf
in the field named Target Form enter: QuickPlaceLoginForm
Save the doucment and close the db.
Select the 'Configuraiotn - Server - All Server documents' view.
Pls create a Web MSSO document under the 'Web -Web Configurations' view
Click Web...Create SSO Configuration.
In the field Domino Server Names, add the Domino name of each server you want to share the LTPA token. Be sure to add all the quickr servers and sametime server to this field.
In the Token Domain field, enter the Internet domain suffix used by the servers, for example: cn.ibm.com
Create a new Domino SSO key and save&close
In the Admin client, on the FILES tab,
open server1/ibm names.nsf
Click on Configuration twistie
Click on Servers twistie
Click on ALL SERVER DOCUMENTS
Click EDIT SERVER when you have server1/ibm selected.
In the server document click on the Internet Protocols tab.
Under that click on the DOMINO WEB ENGINE tab.
In the HTTP SESSIONS section
in the SESSION AUTHENICATION field, enable Multiple Servers (SSO)
and under the MEMORY CACHES section,
in the CACHED USER EXPIRATION INTERVAL, change it to 10 seconds (default is 120 seconds). NOTE: this is for automation to work correctly.
Repeat the configure MSSO steps on all the Quickr Server except the step of create a Web MSSO document, we only need one Web MSSO document in one domino domain.
2 . Enabled the SameTime Awareness and Chat on Quickr Server.
Create the following subdirectory in the Domino data directory of the Sametime server:
Copy the STComm.jar and CommRes.jar files from the Sametime server to the QuickPlace\peopleonline subdirectory . These files can be found in the sametime tookit packet
Copy the PeopleOnline31.jar file From the Quickr server to the QuickPlace\peopleonline subdirectory. This file can be found in the following location: /Lotusquickr
Enter the URL of the quickr serve r in a browser. For example: http://quickrserver1.cn.ibm.com/LotusQuickr
Click SignIn and sign in as the quickr server administrator.
Click Server Settings-> Other Options->Edit Options in the table of contents.
Under the Sametime Servers heading, make sure that the name of the Sametime Community Server is in the community field. Use the full name of the server. For example: http://sametime.cn.ibm.com
Under Sametime Servers, enter the full URL of the Sametime Meeting Server.For example: http://sametime.cn.ibm.com
Do this Step 2 on all the three Quickr Servers.
3. Enabled the SameTime Online Meeting on Quickr Server.
Copy the StCore.jar and STMtgManagement.jar, ServiceLocator.properties, sametime.ini, 4 files from the ST to the Quickr server's Domino directory(copy to c:\lotus\domino).
Add the below to Notes.ini on the quickr server(c:\lotus\domino)
On the Quickr server, create a QPCONFIG.XML file if one does not exist, in the sametime section, change it to:
the username is your first domino server administrator name
Repeat the step 3 on all the Quickr Server.
Verify your configuration
1. Restart all the Quickr Servers and SameTime Server and Network Dispatcher Server.
2. Verify your configuration by URL http://ND.cn.ibm.com/LotusQuickr
, you should use the Quickr Server normally even if one or two quickr node are down.
3. Verify the Awareness and Chat and Online Meeting work well on all the Quickr Server.
The following references are useful when installing and configuring Lotus Quickr 8.2 services for Lotus Domino
Lotus Quickr 8.2 Information Center
Lotus Sametime8.0 Information Center
WebSphere Application Server Version 6.1 Information Center
Lotus Domino 8.5 Information Center
Lotus Quickr Best Practices wiki
Lotus Quickr: Product documentation, white papers, IBM Redbooks publications, and more