Installing and configuring the IBM Sametime integration

You can install and configure IBM® Sametime® to enable chat services in Case Manager Client. To prepare for IBM Sametime integration, you must install and configure a Lotus® Domino® server, an IBM Sametime community server, and an IBM Sametime proxy server. You must also configure single sign-on (SSO) between your WebSphere® Application Server for IBM Case Manager and the Lotus Domino server.

To install and configure IBM Sametime integration:

1. Install the IBM Sametime server version 8.5.2 Interim Feature Release 1 (8.5.2IFR1). For complete instructions, see Administering Sametime Standard 8.5.2 Interim Feature Release 1 documentation.
   1. Install IBM Sametime Domino server. For an AIX® or Linux installation, see Installing a Domino server on AIX, Linux, or Solaris . For a Windows installation, see Installing a Domino server on Windows.
   2. Install the Notes® client and the Domino administrator client. For more information, see Installing the Notes client and Domino administrative client.
   3. Install the IBM Sametime community server. For more information, see Installing a community server on AIX, Linux, Solaris, or Windows.
   4. Install the IBM Sametime proxy server. For more information, see Installing a Lotus Sametime Proxy Server.
   5. Record the names of the of the IBM Sametime server and the IBM Sametime proxy server to use when you configure your case management system.
   6. Configure SSO. For more information, see Enabling Single Sign-on.
2. Confirm that SSO is enabled for your servers. Confirm that SSO is enabled on both the Lotus Sametime server and the case management server.
   1. In the WebSphere administration console, navigate to Security > Global Security > Web and SIP security > Single sign-on (SSO) and ensure that the following settings are selected:
      • Enabled
      • Interoperability Mode
      • Web inbound security attribute propagation
   2. In Domain name, specify the IBM Sametime server domain. For example, you might enter a server domain such as ibm.com.
      Tip: The IBM Sametime server and IBM Case Manager server must be in the same domain as specified in the Domain name field. For example, lotus.ibm.com and ecm.ibm.com are part of the ibm.com domain. However, if you specify lotus.ibm.com as the IBM Sametime server domain and ecm.ibm.com as the IBM Case Manager, SSO will not work between the two machines. You must use the common part of the domain name, ibm.com, to establish SSO.
   3. Save any changes and restart WebSphere Application Server. If you did not make any changes, you do not need to restart WebSphere Application Server.
3. Install the IBM Ajax proxy server to the WebSphere Application Server that is running the IBM Case Manager and IBM Content Navigator services. Configure the proxy-config.xml file in the IBM Ajax proxy service.

   For WebSphere Application Server V8.5.0 or higher, the AjaxProxy.war file is available in the $WAS_HOME\installableApps folder (for example, C:\IBM\WebSphere\AppServer\installableApps ).

   For earlier versions of WebSphere Application Server, the AjaxProxy.war file is available in the $WAS_HOME\web2mobilefep_1.1\installableApps\AjaxProxy folder (for example, C:\IBM\WebSphere\AppServer\ web2mobilefep_1.1\installableApps\AjaxProxy). If you are using WebSphere Application Server V8.0 or earlier, you must install the Web 2.0 and Mobile Feature Pack. You can download this feature pack from the following web page: http://www.ibm.com/software/products/en/web2mobile

   1. Install the AjaxProxy.war file as a web application on the WebSphere Application Server that is running the IBM Case Manager and IBM Content Navigator services. Use AjaxProxy as the context root. You can find the AjaxProxy.war file in the WebSphere Feature Pack for Web 2.0.
   2. Edit the proxy-config.xml file that is included in the AjaxProxy.war file with the following changes:
      • For security, remove the default mapping for any URL by removing or commenting out the following two lines:

        <proxy:mapping contextpath="/http/*">
        <proxy:mapping contextpath="/https/*"/>

      • Add the following proxy mapping to the IBM Sametime server URL. Replace 9082 with the port number of your IBM Sametime server.

        <proxy:mapping contextpath="/http/SametimeServer.yourCompany.com:9082/*">

      • Allow forwarding only for the IBM Sametime server by adding the following code to the proxy-config.xml file. Replace the URL with the URL of your IBM Sametime server. This code sets the proxy mapping to pass cookies and headers and to maintain states.

        <proxy:policy acf="none" basic-auth-support="true" 
                   url="http://SametimeServer.yourCompany.com:9082*">
           <proxy:actions>
               <proxy:method>GET</proxy:method>
        	   <proxy:method>HEAD</proxy:method>
        	   <proxy:method>POST</proxy:method>
               <proxy:method>PUT</proxy:method>
               <proxy:method>DELETE</proxy:method>
           </proxy:actions>
           <proxy:cookies>
               <proxy:cookie>LtpaToken</proxy:cookie>
               <proxy:cookie>LtpaToken2</proxy:cookie>
               <proxy:cookie>loginName</proxy:cookie>
               <proxy:cookie>sid</proxy:cookie>
               <proxy:cookie>selectorMap</proxy:cookie>
               <proxy:cookie>headUpdaterWindowName</proxy:cookie>
               <proxy:cookie>UnicaNIODID</proxy:cookie>
               <proxy:cookie>x-Q-App-Context</proxy:cookie>
               <proxy:cookie>flushedId</proxy:cookie>
               <proxy:cookie>JSESSIONID</proxy:cookie>
           </proxy:cookies>
           <proxy:headers>
               <proxy:header>User-Agent</proxy:header>
               <proxy:header>Accept*</proxy:header>
               <proxy:header>Content*</proxy:header>
               <proxy:header>Authorization*</proxy:header>
               <proxy:header>X-Method-Override</proxy:header>
               <proxy:header>Set-Cookie</proxy:header>
               <proxy:header>If-Modified-Since</proxy:header>
               <proxy:header>If-None-Match</proxy:header>
               <proxy:header>Rtc4web-Nonce</proxy:header>
               <proxy:header>Host</proxy:header>
               <proxy:header>Accept</proxy:header>
               <proxy:header>Keep-Alive</proxy:header>
               <proxy:header>Connection</proxy:header>
               <proxy:header>X-Requested-With</proxy:header>
               <proxy:header>Referer</proxy:header>
               <proxy:header>Cookie</proxy:header>
           </proxy:headers>
        </proxy:policy>

      • If IP address of the IBM Sametime server is required, add another copy of the preceding code and replace SametimeServer.yourCompany.com:9082 with the IP address of your Sametime server and its port number.
4. Register and configure the IBM Connections Plug-in for IBM Sametime in IBM Content Navigator:
   1. Log in to the IBM Content Navigator administrator desktop. Click the Open Administration View icon in Case Manager Client.
   2. Click Plug-ins and then click New Plug-in.
   3. Select the Jar file path radio button, and then enter the path to the ProfilePlugin.jar file. Typically, this file is in the IBM/ECMClient/plugins folder.
   4. Click Load.
   5. Set the IBM Sametime proxy server URL to your IBM Sametime server URL
   6. Set the context root for the Ajax proxy server to the IBM Ajax proxy service URL.
   7. Verify that the proxy-config.xml file is correctly configured in the IBM Sametime configuration setting in the profile plug-in by clicking the Test button in the configuration. The profile plug-in tests the configuration by fetching a JavaScript source on the IBM Sametime server through the Ajax proxy.
      Important: You must use a fully qualified URL to access the IBM Case Manager server. The test will fail if you are using an IP address or a non-qualified URL for your IBM Case Manager server. If the test is successful, this means that the proxy server is set up correctly.
   8. Select the IBM Sametime proxy server polling to one of the following values:
      • Disabled
      • Display Sametime status automatically
      • Display Sametime status after a click action
      If you choose to display IBM Sametime status after a click action, the IBM Sametime status f the user is displayed only when you click on the user name.
   9. Select the Display Name check box to show the display name instead of the login name.