Add Sametime awareness through the Sametime server
If you have a Sametime Proxy server configured in your enterprise and have the Profiles application deployed, you can enable presence awareness and simple chats in IBM Connections.Before starting
Note: This is an optional configuration.
You must have the following software enabled to be able to add presence awareness to IBM Connections:
- Domino Server 8.5 or later.
- Refer to Install and setting up Domino servers.
- Sametime Community Server 8.5.1 or later.
- Refer to Install a Lotus Sametime Community Server and supporting software.
Attention: You must install the following interim fix on the Sametime server for awareness to work: http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=ibm/Lotus&product=ibm/Lotus/Lotus+Sametime&release=All&platform=All&function=fixId&fixids=8.5.1-Lotus-ST-Proxy-IF-WHOS-8GYM38&includeSupersedes=0
- Sametime Proxy Server 8.5.1.
- Refer to Install a Lotus Sametime Proxy Server.
- Profiles application of IBM Connections
Attention: If you enable awareness using this method, then you cannot set up single sign-on with Tivoli Access Manager, Computer Associates' SiteMinder, nor Windows™ desktop.
Complete the following procedures before attempting to enable awareness.
- Set up the WebSphere Edge proxy server by completing the following procedures:
- Install Edge components
- Configure a reverse caching proxy
- Attention: You cannot configure the traffic between the caching proxy and the Sametime server to be sent through the IBM HTTP Server. The Sametime server must communicate directly with the caching proxy.
Make sure the Sametime server is installed before you install the caching proxy.
- While the ibmproxy.conf file is still checked out as part of the previous step, add the following entries. (If you already checked the file back in, you can find it in the following directory: /opt/ibm/edge/cp/etc/<language_code>):
# for Sametime Web Proxy
Proxy /stwebclient/* <ST_Proxy_URL>:9080/stwebclient/* Proxy /stwebapi/* <ST_Proxy_URL>:9080/stwebapi/* Proxy /stbaseapi/* <ST_Proxy_URL>:9080/stbaseapi/*
About this task
When you enable presence awareness using the Sametime Proxy server, a person's online status is indicated by a set of icons and an associated status message that is available from the person's profile and business card. Presence awareness tells you whether the person is available to chat, busy in a meeting, or away from their computer. In addition to seeing a person's availability, you can carry on a chat with that person even when no Sametime client is installed.
SSL support: If you have configured the product to send traffic over SSL, presence awareness can be retrieved over SSL. 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
Note: After downloading the toolkit, the documentation can be found in the <sdk>/client/connectWebApi/doc/ConnectWebApiDevguide.pdf directory.
Procedure
- Start the wsadmin client from the following directory of the system on which you installed the deployment manager:
- app_server_root>\profiles\<dm_profile_root>\bin
Note: You must start the client from this directory or subsequent commands that you try to run will not execute properly. See Starting the wsadmin client for more details.
- Use the wsadmin client to access and check out the IBM Connections extension configuration files.
- Enter the following command to access the IBM Connections configuration file: execfile("connectionsConfig.py")
- If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored. This information is not used by the wsadmin client when you are making configuration changes.
- Check out the user interface extensions configuration files:
LCConfigService.checkOutUIextensionsConfig(<working_directory>,<cell_name>)
where:
- <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.
- AIX and Linux only: The directory must grant write permissions or the command does not run successfully.
- <cell_name> is the name of the WAS cell hosting the IBM Connections application. This argument is case-sensitive, so type it with care. To obtain the cell name:print AdminControl.getCell()
For example:
- AIX or Linux:LCConfigService.checkOutUIextensionsConfig("/opt/temp","foo01Cell01")
- Microsoft Windows:LCConfigService.checkOutUIextensionsConfig("c:/temp","foo01Cell01")
- <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.
- Enter the following command to access the IBM Connections configuration file: execfile("connectionsConfig.py")
- From the directory you specified as the working directory in the previous step, open the uiextensions-config.xml file in a text editor, and then find the extensions with the names global.pageRendering and lc.IMAwareness. Set the enabled attributes for both extensions to true. For example:
<extension
name="global.pageRendering" jsCallback="lconn.profiles.sametime.sametimeProxyInit" invokeDelay="2000" enabled="true" /> <extension name="lc.IMAwareness" jsCallback="lconn.profiles.sametime.sametimeProxyAddLiveName" invokeDelay="4000" enabled="true" id="stProxy"> <params> <param name="disableXDomain" value="true" /> <param name="isConnectClient" value="true" /> <param name="lconnProxySvcUrl" value="admin_replace"/> <param name="lconnProxySvcUrlSSL" value="admin_replace"/> </params> </extension>
- Determine the web addresses for the HTTP and HTTPS protocols of the Edge proxy server configured in your environment. Update the lconnProxySvcUrl parameter with the http web address and the lconnProxySvcUrlSSL parameter with the https web address. For example:
<extension
name="lc.IMAwareness" jsCallback="lconn.profiles.sametime.sametimeProxyAddLiveName" invokeDelay="4000" enabled="true" id="stProxy"> <params> <param name="disableXDomain" value="true" /> <param name="isConnectClient" value="true" /> <param name="lconnProxySvcUrl" value="http://sandbox.enterprise.example.com"/> <param name="lconnProxySvcUrlSSL" value="https://sandbox.enterprise.example.com"/> </params> </extension>Do not edit the disableXDomain parameter value. When the isConnectClient parameter is set to true, the product can use the native Sametime client when a chat is started.
- Save and close the uiextensions-config.xml file.
- Update the value of the version stamp configuration property to force users' browsers to pick up this change. See Required post-customization step for more details.
- To check in the changed configuration files, use the following command:
LCConfigService.checkInUIextensionsConfig(<working_directory>,<cell_name>)
- After making updates, type the following command to deploy the changes:
synchAllNodes()
- To exit the wsadmin client, type exit at the prompt.
- Stop and restart all of the IBM Connections application servers.
- Confirm that this procedure worked by accessing one of the IBM Connections applications, and then opening a person's business card. It may take a few seconds for the person's presence information to display the first time. If you can start a chat with the person, then enabling awareness through the proxy server was successfully completed.