The Video Chat Widget

How does the Video Chat Widget work?

Supported versions
IBM Connections 3.0.1 or later
IBM Sametime 8.5.2 IFR1

Installation

Prerequisites

Configure SSO between IBM Connections and IBM Sametime
The Login Properties field on the Connections Server needs to start with "mail" to match the Login Properties field on the Sametime server.

Install the widget

Install the SametimeVideo.xml file on the IBM Connections server in a web-accessible folder. For example:
.../IBM/WebSphere/AppServer/profiles/AppSrv01/installedApps//Communities.ear/comm.web.war/SametimeVideo.xml

Configure widget

1. To display this widget on every community's home page, edit the widgets-config.xml file. This file is typically found in two places:
   .../IBM/WebSphere/AppServer/profiles/AppSrv01/config/cells//LotusConnections-config/widgets-config.xml
   ..../IBM/WebSphere/AppServer/profiles/Dmgr01/config/cells//LotusConnections-config/widgets-config.xml
2. In each of these files, locate the resource tag with a type of community. Within that tag there is a widgets tag, and within that tag there is a definitions tag. To create a new Sametime Video widget definition, add a new widgetDef tag within the definitions section. The widget definition should look like this:

}
value="http://stmeetings.company.com:9080/stmeetings" /> }

1. Set the value of sametimeMeetingServerUrl to the appropriate fully qualified host name, port, and context-root of your Sametime Meeting server.
2. Ensure that the URL specified in the main widgetDef matches where you installed the SametimeVideo.xml file. If you placed the SametimeVideo.xml file somewhere other than the suggested location above, modify this URL in your widget definition.

For example (Sametime Video widget added as second definition):

...
} http://www.ibm.com/widgets-config">
http://stmeetings.company.com:9080/stmeetings" />
}
...

In the same widgets-config.xml files, define where the new widget will display. From within the widgets tag, find the layout tag (should be after the close of the definitions tag). On the page with an id of communityOverview, create a new widgetInstance tag like the following:


The uiLocation setting and the order of the widgetInstance tags determines where the widget shows up on the page.

For example (Sametime Video widget in right-hand column, above "Members"):

...
}} }
...

3. Restart the Communities application.

4. Install the latest Sametime Meetings 8.5.2 IFR 1 fix from IBM Fix Central. At the time of this writing, that fix is RPOH-8U4KJM. Installation instructions can be found online here.

5. Adjust service provider properties

If you plan to use an audio/video service provider other than Sametime AV, modify the properties file so that video rooms are created with the appropriate attributes.

1. On the Sametime Media server, where the Conference Focus Component is deployed, access this path: .../IBM/WebSphere/AppServer/profiles//sametime_tcspi
2. Open the Service Provider specific properties file, for example, myAV.properties.
   Note the Service Provider ID (SERVICE_PROVIDER_ID).
3. Open the ConferenceManager.properties file.
   Note the ServiceProvider name from the ConferenceServiceName property.
4. On the Sametime Meeting Server, locate the serviceProvider.json file in the stmeetings.webclient.war folder of the Sametime Meeting Server.ear deployment.
   For example,
   .../IBM/WebSphere/AppServer/profiles//installedApps//SametimeMeetingServer.ear/stmeetings.webclient.war/serviceProvider.json
5. Edit this file and set the following properties using the information from steps 2 and 3:
1. id = SERVICE_PROVIDER_ID from step 2
2. ConferenceServiceName = ConferenceServiceName from step 3
3. label = ConferenceServiceName from step 3