Use these installation instructions to install and set up Sametime for Domino Web Access. For complete information on installing IBM Lotus Sametime, see the IBM Lotus Sametime 7.5 Installation Guide for your operating system, and the IBM Lotus Sametime 7.5 Administrator's Guide. To view or download the Sametime documentation, go to http://www.lotus.com/LDD/doc.

Note New in Domino 8, Domino Web Access has its own Contact List client that replaces Sametime Connect for browsers, which was used in 7.x.

Configuration Notes

• For Mozilla, you must have at least Sametime 3.1 to run instant messaging integration. Previous versions of Lotus Sametime are not supported in Domino Web Access on Mozilla.
• When you install Domino 8.0, the stlinks files that are installed in the stlinks directory (for example, C:\st\domino\Data\domino\html\sametime\stlinks), are overwritten. If you have modified stlinks files (for example, if the Sametime server is configured for tunneling) these files will be replaced. When you are upgrade to 8.0, these files are backed up in a file called stlinks.sav. For additional information, see the topic Customizing STLinks files for tunneling or reverse proxy servers.
• To access the Sametime server using a protocol that is different from the current Web page's protocol, use the NOTES.INI configuration setting iNotes_WA_SametimeProtocol.
• Sametime integration with Domino Web Access is not supported with JRE 1.4.1.

2. Register users with the Mail (R8) (MAIL8.NTF) mail template.

Part 2 - Set up the Sametime server
If possible, the Sametime server should be in the same Domino domain as the Domino Web Access server. Follow the instructions in the IBM Lotus Sametime 7.5 Installation Guide to install and configure instant messaging on a dedicated Domino server in the same Domino domain as the Domino Web Access server.

If the Sametime server is in a different domain than your Domino Web Access server, follow the instructions in Setting up Sametime and Domino Web Access in different domains.

Make sure the Sametime server is functioning properly before proceeding. If you have multiple Sametime servers in a single community, also make sure that Domino single sign-on (SSO) is functioning properly between the servers. For complete information on working with multiple Sametime servers, see the IBM Lotus Sametime 7.5 Administrator's Guide, available on http:\\www.lotus.com/ldd/doc.

Part 3 - Create Connection documents
You need Connection documents for the Domino Web Access and the Sametime server if the Sametime server is not in the same domain as the Domino Web Access server. Also, if the Sametime server is in the same domain as the Domino Web Access server, but is not clustered with the registration server, you need a Connection document in order to replicate the Domino Directory.

Create Connection documents using the standard procedure, and include the information below:

On the Domino Web Access server:

• Enter the Sametime server's name in the "Destination server" field. For example: Sametime/Acme.
• Enter the Domino Web Access server's name in the "Source domain" field.
• Enter the Sametime server's name in the "Destination domain" field.

• Enter the Domino Web Access server's name in the "Destination server" field.
• Enter the Sametime server's name in the "Source domain" field.
• Enter the Domino Web Access server's name in the "Destination domain" field.

Method 1

To enable instant messaging and set the Sametime server for all Domino Web Access users at one time, use the Instant Messaging settings in the Configuration Settings document, Domino Web Access tab. After you have done this, individual users can enable or disable instant messaging on their local Domino Web Access clients by setting a User Preference.

Method 2

If you choose not to enable instant messaging for all users, then you must edit the person document for each user who will use instant messaging:

1. From the Domino Administrator, click the People & Groups tab.

2. Select the Domino Web Access Domino directory, then click People.

3. Double-click a name to open the user's Person document.

4. Click Edit.

5. Enter the name of the Sametime server in the "Sametime server" field. For example, Sametime/Sales/Acme/UK.

6. Click "Save & Close."

7. Repeat Steps 3 though 6 for each person.

Part 5 - Set up the Instant Contact List in Domino Web Access
Domino Web Access 8.0 has its own Contact List client that replaces Sametime Connect for browsers, which was used in 7.0. Follow the steps below to set up the new Domino Web Access Contact List.

Configure Java servlet support

1. From the Domino Administrator client, open server document for the Domino Web Access server in edit mode.

2. Click the Internet Protocols - Domino Web Engine tab.

3. In the Java™ Servlets section, for the field Java servlet support, select "Domino Servlet Manager" from the list.

4. Save and close the document, and then restart the server.

Edit the Sametime Configuration file

5. Open the Sametime Configuration application (stconfig.nsf) on the Sametime server.

6. From the "By Form" view, open the ComunityConnectivity document.

7. Add the IP address of the Domino Web Access server to Community Trusted IPs field.

8. Save and close the document, and then restart the Sametime server.

Enable the Domino Web Access Contact List client for Mozilla Firefox

9. Add the NOTES.INI setting iNotes_WA_DisableFirefoxAwareness=0 to the NOTES.INI file on the Domino Web Access server.

10. Add the signed version of the stlinks.jar file into the stlinks directory wherever you have an stlinks directory (on the Sametime server and on the Domino Web Access server).

11. Create a text file in the data directory on the Domino Web Access server called servlets.properties that includes the following line:

servlet.DWABuddyList.code=com.lotus.dwa.stbuddy.DWABuddyList

For users whose mail file is based on the DWA7.NTF template on a Domino 8.0 server, you can disable Domino Web Access Contact List and use the Sametime 7.0 Connect for browsers. Sametime 7.0 Connect for browsers is not installed by default when you install the Sametime 7.5.x server.

Disable the Domino Web Access Contact List

12. From the Domino Administrator, click the Configuration tab.

13. Click the Configuration Settings document for the Domino Web Access server, and then click Edit Configuration.

14. Click the Domino Web Access tab.

15. In the Instant Messaging section, for the field Prefer DWA 8 Contact List, select Disabled.

16. Save and close the document, and then restart the server.

Deploy Sametime 7.0 Connect for browsers on a Sametime 7.5 server

Extract the file javaconnect.zip to the <server>\data\domino\html\sametime\javaconnect directory on the Sametime 7.5 server.

Enable the Sametime 7.0 Connect for browsers link for Sametime 7.5

17. Open the Sametime Configuration application (stconfig.nsf) on the Sametime server.

18. From the "By Form" view, open the ComunityClient document.

19. Set the Launch Connect link field to True.

20. Save and close the document, and then restart the Sametime server.

Part 7 - Set up Domino Web SSO authentication between the Domino Web Access server and IM server
Domino single sign-on (SSO) authentication allows Web users to log in once to a Domino or WebSphere server, and then access any other Domino or WebSphere server in the same DNS domain that is enabled for single sign-on (SSO) without having to log in again. In a multiple server environment, it is possible that one or more servers in your Domino domain are already configured for Domino SSO, and the Domino Directory already contains a Domino Web SSO configuration document. When you install Sametime, it creates a Web SSO configuration document called LtpaToken unless one already exists in the Domino directory. If an LtpaToken configuration document already exists, Sametime does not attempt to alter it.

For more information about Domino Web SSO authentication, see the topic Multi-server session-based name-and-password authentication for Web users (single sign-on).

Configure the Domino Web Access server for Web SSO

Complete the steps in this section if your Domino Web Access server is not configured for Web SSO, and you want to use the Web SSO document that Sametime created to configure it.

1. Ensure that the Domino Directory has replicated throughout the Domino domain since you installed Sametime.

2. Update the Web SSO Configuration document that was created when you installed Sametime (LtpaToken):

1. Open the Domino Directory and select the Configurations - Web - Web Configurations view.
2. From within this view, expand the list of Web SSO Configurations.
3. Open the "Web SSO Configuration for LtpaToken" document in edit mode. (If you are unable to edit the document, record the settings in the document, and then delete it and create a new one.)
4. Update these fields if necessary:

Domino Server Names -- make sure this field contains the name of all of the Domino Web Access servers and Sametime servers that should participate in Single Sign-on.

DNS Domain -- make sure this is the fully-qualified domain name of the Domino Web Access and Sametime server.

1. Click Save & Close.

4. Ensure that the updates replicate to all of the servers in the domain.

Update Domino Web Access server Web SSO configuration

Complete the steps in this section if your Domino Web Access server is already configured for Domino Web SSO. You must add the Sametime server to your configuration:

5. Update your existing Domino Web SSO Configuration document.

1. Open the Domino Directory and select the Configurations - Web - Web Configurations view.
2. From within this view, expand the list of Web SSO Configurations.
3. Open the Domino Web SSO document that you are using for your Domino Web Access server in edit mode.
4. Update these fields if necessary:

Domino Server Names -- make sure this field contains the name of all of the Domino Web Access servers and Sametime servers that should participate in Single Sign-on.

DNS Domain -- make sure this is the fully-qualified domain name of the Sametime server.

1. Click save & Close.

1. Open the server document.
2. Click Internet Protocols - Domino Web Engine, and select the Web SSO Configuration field.
3. From the drop-down list, select the Web SSO Configuration that you are using for the Domino Web Access server.
4. Click Save & Close.

Although Domino SSO is the preferred authentication method, you can continue to use secrets and tokens authentication databases, if you are already using them. For example, if any of the servers in your domain is configured for something other than multiple server SSO, (single server SSO for example) you must use secrets and tokens authentication. For information on setting up Secrets and Tokens authentication, see the topic Setting up Secrets and Tokens authentication for instant messaging in Domino Web Access.

Part 8 - Verify that instant messaging works with Domino Web Access
1. Make sure that replication is complete, the Person documents exist on the Sametime server, and that the updated Web SSO document exists on all of the servers that will participate in single sign-on..

2. If you have not already done so, follow the instructions in the IBM Lotus Sametime 7.5 Installation Guide to verify that instant messaging is working properly before you test whether it is working with Domino Web Access clients.

3. Launch Domino Web Access in a browser. In any view or document in which online awareness appears, click the Active status icon of the person you want to chat with to test the instant messaging connection.

Note If the instant messaging status does not appear next to the Welcome username text in Domino Web Access, check the user's Person document in the Domino directory. If you configured the Sametime server by populating this document, make sure the "Sametime server" field is correct (Basics tab, under Real-Time Collaboration).

See also

Creating a Web SSO configuration document
Customizing STLinks files for tunneling or reverse proxy servers
Setting up Sametime and Domino Web Access in different domains
Setting up Secrets and Tokens authentication for instant messaging in Domino Web Access
Troubleshooting Sametime in Domino Web Access
Using Domino Off-Line Services (DOLS) and Domino Web Access

Glossary