Setting up iNotes® with Sametime®

IBM® iNotes® integrates an instant messaging (IM) capability so that users can chat with others online and maintain an instant messaging list that shows the online status of others.

About this task

The instant messaging awareness feature also displays online status next to the names of people in mail messages, views and folders. In addition, Web conferencing capabilities are available if your organization purchased IBM® Sametime®.

To access the Sametime® server using a protocol that is different from the current Web page's protocol, use the notes.ini file setting iNotes_WA_SametimeProtocol.

Use these installation instructions to install and set up Sametime® for iNotes®.

For information about installing Sametime®, see the Sametime® product documentation and wiki.

Set up iNotes® on a Domino® server


  1. Set up iNotes® on a server by making the appropriate selections during server setup.
  2. Register users with the latest version mail template, for example, mail85.ntf.

Set up the Sametime® server

About this task

The Sametime® server should be in the same Domino® domain as the iNotes® server.


  1. Install and configure instant messaging on a dedicated Domino® server in the same Domino® domain as the iNotes® server.
  2. If the Sametime® server is in a different domain than your iNotes® server, follow the instructions in the procedure Setting up Sametime® and iNotes® in different domains.
  3. Make sure the Sametime® server is functioning properly before proceeding. If you have multiple Sametime® servers in a single community, make sure that Domino® single sign-on (SSO) is functioning properly between the servers.

Create connection documents

About this task

Create connection documents for the iNotes® and Sametime® servers if the Sametime® server is not in the same domain as the iNotes® server. If the Sametime® server is in the same domain as the iNotes® server, but is not clustered with the registration server, create a connection document to replicate the Domino® directory.

Create connection documents and include the following information.


  1. On the iNotes® server, complete these steps:
    1. Enter the Sametime® server's name in the Destination server field. For example: Sametime/Renovation.
    2. Enter the iNotes® server's name in the Source domain field.
    3. Enter the Sametime® server's name in the Destination domain field.
  2. On the Sametime® server, complete these steps:
    1. Enter the iNotes® server's name in the Destination server field.
    2. Enter the Sametime® server's name in the Source domain field.
    3. Enter the iNotes® server's name in the Destination domain field.

Specify the Sametime® server for iNotes® users

About this task

There are two ways to specify a Sametime® server for iNotes® users:
  • To enable instant messaging and set the Sametime® server for all iNotes® users at one time, use the instant messaging settings in the configuration settings document, IBM iNotes tab. Then users can enable or disable instant messaging by setting a user preference.
  • If you do not enable instant messaging for all users, edit the person document for each user who will use instant messaging, as detailed this procedure.


  1. From the Domino® Administrator, click the People & Groups tab.
  2. Select the IBM iNotes 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.
  6. Click Save & Close.
  7. Repeat Steps 3 though 6 for each user.

Set up the Instant Contact List in iNotes®

About this task

iNotes® has its own contact list that replaces Sametime® Connect for browsers. Use these steps to set up the iNotes® contact list.


  1. Configure Java servlet support by completing these steps:
    1. From the Domino® Administrator client, open the server document for the iNotes® server in edit mode.
    2. Click the Internet Protocols - Domino Web Engine tab.
    3. In the Java Servlets section, Java servlet support field, select Domino Servlet Manager from the list.
    4. Save and close the document, and then restart the server.
  2. Edit the Sametime® configuration file by completing these steps:
    1. Open the Sametime® Configuration application, stconfig.nsf, on the Sametime® server.
    2. From the By Form view, open the Community Connectivity document.
    3. Add the IP address of the iNotes® server to the Community Trusted IPs field.
    4. Save and close the document and restart the Sametime® server.
  3. Edit the servlet configuration file by completing these steps:
    1. Create a text file in the data directory on the iNotes® server called that includes this line: servlet.DWABuddyList.code=com.lotus.dwa.stbuddy.DWABuddyList
    2. If you are using reverse proxy servers in your environment, you may need to add the following line with the fully-qualified domain name or IP address of the Sametime® server in the file:

Set up Domino® Web SSO authentication between the iNotes® server and IM server

About this task

Domino® single sign-on (SSO) authentication allows Web users to log in once to a Domino® WebSphere® Application Server, and then access any other Domino® or WebSphere® Application 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.

If your iNotes® server is not configured for Web SSO, and you want to use the Web SSO document that Sametime® created to configure it, complete the steps in this section:

Configure the iNotes® server for Web SSO by completing these steps:
  1. Ensure that the Domino® Directory has replicated throughout the Domino® domain since you installed Sametime®.
  2. Update the Web SSO Configuration document, LtpaToken, that was created when you installed Sametime®:
    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.
      Note: If you are unable to edit the document, record the settings in the document, and then delete it and create a new one.
  3. Update these fields if necessary:
    • Domino® Server Names -- make sure this field contains the name of all of the iNotes® servers and Sametime® servers that should participate in Single Sign-on.
    • DNS Domain -- make sure this is the fully-qualified domain name of the iNotes® and Sametime® server.
  4. Click Save & Close.
  5. Enable single sign-on and basic authentication in the Server document for the iNotes® server. When you update the Web SSO Configuration field, select LtpaToken from the list.
  6. Ensure that the updates replicate to all of the servers in the domain.

If your iNotes® server is already configured for Domino® Web SSO, update iNotes® server Web SSO configuration by completing these steps. You must add the Sametime® server to your configuration:

  1. Update your existing Domino® Web SSO Configuration document, LtpaToken.
  2. Update the Server document for the Sametime® server.
  3. Ensure that the updates replicate to all of the servers in the domain.

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 server in your domain is configured for something other than multiple server SSO, for example, single server SSO, you must use secrets and tokens authentication.

Verify that instant messaging works with iNotes®

About this task

If the instant messaging status does not appear next to the Welcome username text in iNotes®, 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. See the Basics tab, Real-Time Collaboration section.


  1. Make sure that replication is complete, the person documents exist on the Sametime® server, and the updated Web SSO document, LtpaToken, exists on all of the servers that will participate in single sign-on.
  2. Verify that instant messaging is working properly before testing it with iNotes® clients.
  3. Launch iNotes® 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.