To integrate Sametime Advanced with Connections, you must give the Sametime Advanced administrator permissions to view all of the communities in Connections. Sametime Advanced then uses that administrator’s account to download the list of communities from Connections and display it in the Broadcast Communities panel in Sametime Advanced.
Integration between IBM Sametime and IBM Connections products is one of the features of the IBM Connections Suite V1.0.
1. Determine the name of the LDAP realm used by the Connections deployment:
a. On the Connections deployment manager, log in to the WebSphere® Integrated Solutions Console as the WebSphere administrator.
b. In the navigation list, click Security > Secure Administration, applications and infrastructure > Federated Repositories.
d. Click Configure.
e. On the main Federated repositories page, note the value for the realm name used for the Connections deployment.
f. Close the Federated repositories page by clicking Cancel.
2. Move to the computer hosting the Communities application for Connections, and start the wsadmin client by completing the following steps:
a. Open a command prompt, and then change to the following directory:
b. where WAS_install_root is the WebSphere Application Server installation directory and DM_profile is the Deployment Manager profile directory, typicallydmgr01. For example, on Microsoft Windows:
c. Attention: You must start the wsadmin client from this directory because the Jython files for the product are stored here. If you try to start the client from a different directory, the execfile() command that you subsequently call to initialize the administration environment for a Connections component does not work correctly.
d. Start the wsadmin client with the following command:
IBM AIX®, Linux
./wsadmin.sh -lang jython -user was_admin_user_id -password was_admin_password -port SOAP_CONNECTOR_ADDRESS_port
wsadmin -lang jython -user was_admin_user_id -password was_admin_password -port SOAP_CONNECTOR_ADDRESS_port
- was_admin_user_id is the user name of the WebSphere administrator account on the deployment manager.
- was_admin_password is the password of the WebSphere administrator account.
- SOAP_CONNECTOR_ADDRESS_port is the SOAP port for WebSphere Application Server. The default value of the SOAP port is 8879; if you are using the default port value, you do not need to specify this parameter.
If you are not using the default port and you do not know the port number, you can look up its value in the WebSphere Application Server Integrated Solution Console. To look up the SOAP port number, perform the following steps:
1. Open the Integrated Solution Console for the deployment manager, and select System Administration > Deployment Manager.
2. Under "Additional properties" expand Ports, and then look for the SOAP_CONNECTOR_ADDRESS port entry to find the port number.
./wsadmin.sh -lang jython -user primaryAdmin -password p@assword -port 8879
wsadmin -lang jython -user primaryAdmin -password p@assword -port 8879
3. Now access and check out the Communities configuration file:
a. Access the Communities configuration files with the following command:
b. 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, you must pick the node where the file is stored.
c. Check out the Communities configuration files using the following command:
- working_directory is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you make changes to them.
: AIX and Linux only: The directory must grant write permissions or the command will not run successfully.
- Cell_name is the name of the WebSphere Application Server cell hosting the Connections application. This argument is required. If you do not know the cell name, you can determine it by typing the following command in the wsadmin command processor:
d. Change to the working_directory where you stored the checked out files and open the communities-policy.xml file in a text editor.
e. Make sure the file contains the following grant statement; if not, copy the code below and paste it into the section containing grant statements, and fill in the realm and Sametime Advanced administrator’s user name.
Note: Even if the file already contains the grant statement, you will need to add the first line, which specifies the user who is receiving permissions.
<comm:principal class="com.ibm.ws.security.common.auth.WSPrincipalImpl" name=" Connections_Realm/ST_Advanced_admin_user_name " />
<comm:permission class="com.ibm.tango.auth.permission.CommunityManagementPermission" communityType="*" action="*" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityMembershipPermission" communityType="*" action="*" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityAccessPermission" communityType="*" action="*" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityReferencePermission" communityType="*" action="*" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityBroadcastPermission" communityType="*" action="*" />
<comm:permission class="com.ibm.tango.auth.permission.CommunityInvitePermission" communityType="*" action="*" />
- Connections_Realm is the Connections LDAP repository realm name that you identified in step 1.
- ST_Advanced_admin_user_name is the user name of the Sametime Advanced administrator who will have permissions to view Connections communities.
f. Save and close the file.
g. Check in the updated file using the following wsadmin client command:
4. Exit the wsadmin client with the following command: exit.
5. Stop and restart the server.
The Sametime Advanced administrator now has the access needed for retrieving the list of Connections communities for display, and for posting broadcast chats as updates communities.