Configuring Sametime Integration

You can integrate your IBM Sametime instant messaging platform with Jive. When you do, Sametime users in your community will be able to begin chats with their community connections, as well as with people associated with activities listed on community pages. You configure Sametime integration by using the admin console. (Everyone participating in chat must be a Sametime user.)

Note: This content assumes that you've installed the Sametime integration plugin.
Note: For more information on how Sametime users experience chat integration, see How do I start a Sametime chat from the community?

Users need to be logged into a Sametime client 8.0.2 or above to chat with others. Jive does not connect directly with your Sametime server. Instead, it communicates with a user's Sametime client to get presence information and begin chats. For example, when someone starts a chat with a second Sametime user, the application contacts the Sametime client, identifying the second user by passing an identifying value to the Sametime client, which in turn communicates with the server to begin the chat. To support this, you must configure the application to know how to locate the value through which to identify the user to the Sametime client.

Setting Up Sametime Integration

You configure Sametime integration in the admin console. Use the steps below.

Fastpath: Admin Console: System > Settings > Connects for IBM Sametime
Note that if the application uses LDAP, installing the plugin and restarting the system will prompt the application to synchronize its database with the LDAP data store. For more information, see Synchronizing with User Authentication Systems in the Jive documentation.
  1. Install the Jive Connects for IBM Sametime plugin. For more on installing plugins, see the Jive documentation.
  2. In the admin console, on the Jive Connects for IBM Sametime page, specify the user field or attribute that holds the value that uniquely identifies a user to the Sametime server. How you do this differs depending on whether or not your community is connected to the same LDAP data store as the Sametime server (note that what's on the Admin Console page differs depending on whether an LDAP connection exists):

    Specify the field using one of the following options:

    • If the community is connected to the same LDAP server as Sametime, you need only enter the name of the LiveName LDAP attribute:
      • Under Configuration, in the LiveName LDAP Attribute box, enter the name of the LDAP attribute that the application should use for discovering presence and starting chat with other users.

        A value here is required. By default, the mail attribute is used. Keep in mind that the attribute name you enter here is not validated against the LDAP data store itself. In other words, be sure that the attribute exists in LDAP.

    • If the community isn't connected to the LDAP server, you'll need to choose a user profile field that contains a value identifying the user to Sametime. If none your existing profile fields will work, you can create a new field for the purpose. For example, you could create a "Sametime User Name" or "LiveName ID" field in which user's could enter the value that would work.
      • Under LiveName Profile Field, select the user profile field that corresponds to the Sametime LiveName field. If the profile field you need isn't visible, you can click the link in the description text to create a new profile field for the purpose.
  3. Click Save.
Note: Regardless of whether the community is connected to the LDAP server, you can force the use of a particular application user profile field by specifying that field using a system property. For more information, read about the jive.chat.presence.force.livename.field.selection system property in System Properties for Sametime Integration.

Configuring the Maximum Number of Connections

You can set the maximum number of connections that will be displayed from the chat bar. By default, the chat bar will list up to 200 of a user's community connections. You can set this to another value by using the jive.chat.presence.max.connections.analyzed system property. When a user's number of connections exceeds the maximum number, they'll see a link through which they can view more connections in the list. You might want to set the number to a lower value, for example, to help improve performance if your people in the community tend to have a large number of connections.

For more on system properties, see Fine-Tuning with System Properties in the Jive documentation and System Properties for Sametime Integration.

Disabling Sametime Integration

If you already have the Jive Connects for IBM Sametime plugin installed, but you want to disable the functionality, you can do so in the admin console.