If an Sametime® Proxy server is configured in
your enterprise and the Profiles application is deployed, you can enable presence awareness and
simple chats in HCL Connections.
Before you begin
The following software must be enabled before you add presence awareness to HCL Connections:
Complete the following procedures before enabling awareness.
About this task
When you enable presence awareness by 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.
Encrypted connection support: If you configure the product to send encrypted traffic,
presence awareness can be retrieved as an encrypted connection. For more information
about enabling encrypted connections 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
Procedure
- Start the wsadmin client from the
following directory of the system where 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. For more information, see
the Starting the wsadmin client topic.
- Use the wsadmin client to access and check out the HCL Connections extension configuration
files.
-
Enter the following command to load the HCL Connections
configuration file: execfile("connectionsConfig.py")
If you are prompted to
specify a service to connect to, type 1 to
select 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 by using
a local file path, you must select the node where the file is stored.
This information is not used by the wsadmin client when you are making
configuration changes.
- Enter the following command to check out the LotusConnections-config.xml file:
LCConfigService.checkOutConfig("working_directory","cell_name")
where:
For example:
- AIX or Linux:LCConfigService.checkOutConfig("/opt/temp","foo01Cell01")
- Microsoft Windows:LCConfigService.checkOutConfig("c:/temp","foo01Cell01")
- From the directory you specified as the working directory
in the previous step, open the LotusConnections-config.xml file
in a text editor, and then find the
sametimeProxy service
section:
<sloc:serviceReference enabled="false" isConnectClient="false" serviceName="sametimeProxy" ssl_enabled="false">
<sloc:href><sloc:hrefPathPrefix/>
<sloc:static href="admin_replace" ssl_href="admin_replace"/>
<sloc:interService href="admin_replace"/>
</sloc:href>
</sloc:serviceReference>
- Specify the attributes according to the following example:
<sloc:serviceReference enabled="true" isConnectClient="false" serviceName="sametimeProxy" ssl_enabled="true">
<sloc:href><sloc:hrefPathPrefix/>
<sloc:static href="http://sametimeProxyServer.enterprise.example.com"
ssl_href="https://sametimeProxyServer.enterprise.example.com:9444"/>
<sloc:interService href="https://sametimeProxyServer.enterprise.example.com:9444"/>
</sloc:href>
</sloc:serviceReference>
Where:
sloc:serviceReference enabled="true"
displays the Sametime action bar in Connections and connects to Sametime using the specified Sametime Proxy server.
ssl_enabled="true"
connects to the Sametime proxy server on the secure port.
isConnectClient="false"
automatically connects to the Sametime Proxy Server rather than using the UIM client.
-
If your Connections environment is configured to a reverse proxy but the Sametime server is not, or if
dynamicHosts
is enabled in the
LotusConnections-config.xml, add the
isExternal attribute to the configuration as shown in
following example. The isExternal attribute is set so that
the Sametime proxy server URLs are
not overwritten by the dynamic host URLs.
<sloc:serviceReference enabled="true" isConnectClient="false" serviceName="sametimeProxy" ssl_enabled="true">
<sloc:href> <sloc:hrefPathPrefix/>
<sloc:static href="http://sametimeProxyServer.enterprise.example.com"
ssl_href="https://sametimeProxyServer.enterprise.example.com:9444" isExternal="true"/>
<sloc:interService href="https://sametimeProxyServer.enterprise.example.com:9444"/>
</sloc:href>
</sloc:serviceReference>
- Save and close the LotusConnections-config.xml file.
- To check in the changed configuration files, use the following
command:
LCConfigService.checkInConfig(working_directory,cell_name)
-
Type the following command to deploy the changes:
- To exit the wsadmin client, type
exit
at
the prompt. - Stop and restart all of the HCL Connections
application servers.
-
Confirm that this procedure worked by accessing one of the Connections
applications, and then opening a person's business card. It might 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.