Add Sametime awareness though the Sametime client

If we have an IBM Sametime 8.5.2 client or later and the Profiles application deployed, we can enable Sametime awareness in Connections.

This is an optional configuration.

When you enable Sametime awareness in Connections, a person's online status is indicated by a set of icons and an associated status message available from the person's profile and business card. Sametime awareness tells you whether the person is available to chat, busy in a meeting, or away from their computer.

You must have the following software enabled to be able to add Sametime awareness to IBM Connections:

• IBM Sametime 8.5.2 or later stand-alone client.

  Alternatively, we can use Sametime embedded in Notes if the Notes client version is Notes 8.5 or later.

• When using Sametime 8.5 or later the following limitations apply:

  • Users defined in the Sametime directory must have the same email address as the users defined in the Profiles directory.

• The Profiles application of Connections must be deployed.

SSL support: If we have configured the product to send traffic over SSL, Sametime awareness can be retrieved over SSL for the following Sametime clients:

• IBM Sametime 8.5 or later standalone client.

• Notes 8.5.1 or later embedded client.

For more information about enabling SSL for Sametime, refer to the documentation provided with the Sametime SDK, which is available from the following web site: http://www.ibm.com/developerworks/lotus/downloads/toolkits.html

After downloading the toolkit, the ConnectWebApiDevguide.pdf documentation can be found in the sdk/client/connectWebApi/doc directory.

1. Check out the Profiles configuration files:
   app_server_root/profiles/Dmgr01/bin
   ./wsadmin.sh -lang jython
   execfile("profilesAdmin.py")
   ProfilesConfigService.checkOutConfig("/tmp", "cell_name")

   To get cell name...

   print AdminControl.getCell()

2. From the temporary directory to which you checked out configuration files, open profiles-config.xml in a text editor.

3. Find the <sametimeAwareness> element, and then set the enabled attribute equal to true, specify web addresses for the href and ssl_href attributes, and specify which input type should be used for identifying the person: an email address or a user ID. For example:

   <sametimeAwareness 
    enabled="true" 
    href="http://localhost:59449/stwebapi"  
    ssl_href="http://localhost:59449/stwebapi" 
    sametimeInputType="email" />

   If IBM Connections is configured to hide email addresses, define the user ID as the input type by setting the sametimeInputType attribute equal to uid. For example:

   <sametimeAwareness 
    enabled="true" 
    href="http://localhost:59449/stwebapi"  
    ssl_href="http://localhost:59449/stwebapi" 
    sametimeInputType="uid" />

4. If we have configured the product to send traffic over SSL, edit the ssl_href attribute to specify the web address with the HTTPS protocol. For example:

   <sametimeAwareness 
    enabled="true" 
    href="http://localhost:59449/stwebapi"  
    ssl_href="https://localhost:59669/stwebapi" 
    sametimeInputType="email" />

   Do not make this change for releases earlier than Sametime 8.5 or the Notes 8.5.1 embedded client or awareness will stop working properly.

5. Save and close profiles-config.xml.

6. Check in the changed configuration files :
   ProfilesConfigService.checkInConfig()

7. To exit the wsadmin client, type exit at the prompt.

8. For a Sametime client that is embedded in a version of Notes later than 8.0.2 (IFR1), configure Notes to display awareness information because it is disabled by default. To do so:

   1. Exit the Notes client.

   2. Open the plugin_customization.ini file in a text editor.

      By default, the plugin_customization.ini file is stored in...

      C:\notes_install_directory\framework\rcp

   3. Search for the com.ibm.collaboration.realtime.webapi/startwebContainer property. If it is set to false, set it equal to true. If we do not find it, add the property using the follow syntax:
      com.ibm.collaboration.realtime.webapi/startwebContainer=true

   4. Save and close the plugin_customization.ini file.

9. Stop and restart the WAS hosting the Profiles application.

10. Start the stand-alone Sametime client or Notes client in which Sametime is embedded.

    It is not recommended that you run more than one Sametime client on a single machine at one time. If awareness does not seem to be enabled in Connections, make sure you do not have an earlier version of the Sametime client running on the machine. If we do, stop the clients and be sure to restart the Sametime Connect 8.0.1 client or the Sametime client embedded in Notes 8.0.2 (IFR1) or later before restarting any other clients.

11. Confirm that this procedure worked by accessing one of the Connections applications, and then opening a person's business card. It may take a few seconds for the person's awareness information to display the first time.

Parent topic:
Customize the deployment

Related:

Customize the Profiles business card

Related:

Start the wsadmin client

Related reference:

Common configuration properties