Installation Manual
Getting Started
Movi for
IBM Lotus Same-
time
With Movi for IBM Lotus Sametime users can enjoy both point to
point and multipoint video through their IBM Lotus Sametime client.
Video calls can be made from the IBM Lotus Samtime client to
other Sametime users, and also to meeting rooms with video appliances.
Movi for Sametime uses TMS for multipoint video calls to integrate
the enterprises’ videoconferencing infrastructure with IBM’s most
powerful instant messenger application.
Please see http;//www.ibm.com/lotus/sametime for more information about IBM Lotus Sametime.
Functional Overview
The components to be installed on the Sametime server will integrate TANDBERGs Movi client in to the Sametime Connect clients.
When enabled users can simply select a buddy, and press the icon
for starting a video chat.
D4068 Rev.4
This document is not to be reproduced in whole
or in part without permission in writing from:
TANDBERG Movi for Sametime supports both point to point and
multipoint conferences. It is also possible to dial into video meeting
rooms hosted on appliances available in these rooms.
11
Table of ConTenTs
Requirements 3
Server software requirements 3
Optional meeting room service requirements 3
Optional multiparty requirements 3
Client software requirements 3
Installing Movi for IBM Lotus Sametime 4
Server installation 6
Conguring the Sametime environment 9
Conguring the video integration 13
Video client installation 15
Troubleshoot 17
Appendix 19
2
Requirements
This documentation is written towards a Windows based installation of Movi
for IBM Lotus Sametime as TANDBERG only supports installation of the
Sametime integration on Windows Servers. The Sametime Connect client is
multi-platform, but TANDBERG only supports installations on Windows clients
using the stand-alone .exe version of the client.
Server software
requirements
Optional meeting room
service requirements
IBM Lotus Domino Server
IBM Lotus Domino Server Versions running on Windows 2000 or 2003 with
•
.NET framework 2 installed..
7.0
–
.NET framework 2 installed on the Sametime Server. If .NET framework V2
•
is not installed, the setup le will install this for you.
Support for other Domino server platforms are available on request from
•
TANDBERG.
IBM Lotus Sametime Server
IBM Lotus Sametime 7.5 Server.
•
TANDBERG Movi
A TANDBERG Movi server running software V 2.45.1.3 or later
•
TANDBERG Management Suite
TANDBERG Management Suite v11.7.1 or later installed on a separate
•
server from the Domino/Sametime server.
Optional multiparty
requirements
Client software
requirements
SIP Enabled endpoints
SIP endpoint(s) managed by TMS that have SIP support in TMS
•
TANDBERG Management Suite
TANDBERG Management Suite v11.7.1 or later installed on a separate
•
server from the Domino/Sametime server.
MCU Requirements
A TANDBERG MPS running software version J4.0 or later.
•
IBM Lotus Sametime Connect V7.5
Stand-alone Lotus Sametime Connect Client v7.5 running on Windows XP.
•
Installing Movi for IBM
Lotus Sametime
Installation Overview
Movi for IBM Lotus Sametime consits of three modules, where only the point
to point module is required.
Point to point video (Required)
Supports point to point calls between Sametime buddies
•
Supports direct dialing to SIP enabled appliances .
•
Meeting room Service (Optional)
Supports calling into meeting rooms with video appliances
•
SIP Enabled meeting rooms are shown as Sametime buddies in Sametime
•
Select meeting rooms, and press ‘Start video chat’ button to launch calls to
•
meeting room.
Multiparty video (TCSPI) (Optional)
Supports multi-participant conferences
•
Join the conference using Movi for Sametime video client, or another H.323
•
or SIP enabled appliance.
Ability to control conference using standard Sametime interface.
•
Meeting room Service and TCSPI may be installed independently of one an-
other, but to get full benet we recommend that both modules are installed.
The installation of the Movi for IBM Lotus Sametime consists of:
Installing the integration components on the Lotus Sametime server.
•
Conguring the Sametime environment
•
Congure the video integration
•
Completing the installation of the Integration requires a Lotus administrator who has the ability and permissions to:
Copy and move les to the Domino Server itself.
•
Access to the Domino Server itself to modify local les on the Windows
•
Server.
Administrator Access to the Sametime Databases.
•
Additional permissions for the optional Meeting rooms service
Ability to create Domino users for meeting room buddies
•
Additional permissions for the Multipart installation
Ability to create accounts on the TMS server
•
Setting up TANDBERG Management Suite and adding video
systems
The multipart installation of Movi for IBM Lotus Sametime relies on an existing
TMS v11.7.1 or newer installation. The TMS server should be congured and
operational before attempting to add the Sametime integration components.
1 Only required if either multipoint (TCSPI) or Meeting room service
module is installed
1
4
Any video conferencing systems that Meeting Room service will provide in
the Sametime clients must be operational in TMS before they are available to
Lotus Sametime Clients.
5
Server installation
The Domino Server must be stopped
prior to starting the Installation Wizard.
To complete the installation, the Domino
Server must be restarted - the Installation
Wizard will prompt you if you want the
server restarted automatically.
Installing Movi for Sametime on the IBM Lotus
Sametime server
Copy the installation les and extract them on the Sametime Server.
1.
Start setup by double clicking “Setup.exe” in the “MoviForSametime_
2.
ServerSideInstall” directory on the CD. Click “next” to start the installation.
Read the license agreement carefully, and then proceed by clicking “yes”.
3.
6
Point to point is required.
Meeting room service enables video
applicances in meeting rooms to be shown
in the Sametime buddy list. Only applicable if
the organization has video equipped meeting
rooms.
TCSPI is the multiparty feature, that lets you
have mutiple participants join the same video
chat. Only applicable if your organizations has
a TANDBERG MPS.
Select the features you want to install.
4.
Choose the location for where to install the conguration tool.
5.
Click “Next” to start copying les.
6.
You will now be promted with an option to restart the domino service to
7.
activate the Movi for IBM Lotus Sametime integration.
The installation is now complete. Click
8.
“Finish” to exit the installation wizard.
8
Conguring the
Sametime environment
Several Domino specic steps are required after the installation wizard is
complete in order to complete the Movi for Sametime installation procedure.
Update the URL for UIM Provisioning eld
Open the stcong.nsf database from the Lotus Notes/Administrator client.
1.
Open the database by File->Database -> Open…
2.
Choose the Sametime server’s name in the dropdown list (server), and
–
enter stcong.nsf in the Filename eld
Press Open
–
Open the CommunityClient Form by highlighting By Form,
3.
and double click CommunityClient in the Form Name column.
Update the URL for UIM Provisioning eld by entering the path to the
4.
site.xml le located in the plugins folder. These les are created by the
TANDEBERG installer. Update the UIM ProVisioning le to ‘http://<fully
qualied domain name to sametime server>/plugins/site.xml’.
Press ctrl+s to save the form and close the database2.
5.
Sign the new web service with appropriate id from your
organization (Optional)
To enable automatic creation of Domino accounts from the conguration utility, a web service is installed by the installer, but still must be signed with an
ID with appropriate permissions. This web service should only be signed if
you are using Meeting Room Service and wish to use the ‘Automatic Creation
2 It is important to notice that Sametime Connect will only automatically download plugins available on the Default Community server.
3 Only required if Meeting Room serviuce is installed.
3
9
of Domino Accounts’ feature of the conguration utility. Complete the following steps if you wish to enable this web service.
Open Domino Administrator and select the server that stores the
1.
databases or templates that you want to sign.
On the Files tab, select the data folder and select the le
2.
“TandbergCongTools” (tctools.nsf).
Right click on one of them and select “Sign…”.
3.
Choose one of the following:
4.
Active User’s ID to sign using your ID.
–
Active Server’s ID to sign using the ID of the server that stores the
–
database or template.
Choose ‘All design documents’ to sign the selected design elements.
5.
Click OK. A dialog box shows the number of databases processed and the
6.
number of errors that occurred (if any). See the Notes Log for details.
Enable conference calls (Optional)
4
To enable multiparty conference calls in the Sametime clients, some
documents must be manually updated on the Domino server.
Update Sametime policy document
Open the Lotus Sametime Administration page by pointing your borwser
1.
to http://<sametimeservername>/stcenter.nsf
Click “Administer server”
2.
Log in as a user with administrator rights to the Sametime server.
3.
Click on “Policies”
4.
Choose the policy document that is used for the video enabled users.
5.
Normally this will be the default policy document, but this can be
overridden by an administrator.
Allow telephony in the policy document (check “allow telephony for
6.
contact lists, instant messaging, and instant meetings”)
Click OK to save the policy document.
7.
Close the browser
8.
4 Only required if multipoint (TCSPI) module is installed
10
Update MeetingServices database
Open the stcong.nsf database from the Lotus Notes/Administrator client.
1.
Open the database by File->Database -> Open…
2.
Choose the Sametime server’s name in the dropdown list (server), and
–
enter stcong.nsf in the Filename eld
Press Open
–
Open the MeetingServices Form by highlighting By Form,
3.
and double click MeetingServices in the Form Name column
11
Update the two elds Audio Bridge Services
4.
and Telephony Services, set both to true.
Click ctrl+s to save
5.
Restart your Domino server.
6.
12
Conguring the video
integration
Conguration tool
Launch the conguration tool that comes with Movi for Sametime from Start
->All Programs -> TANDBERG -> Movi for Sametime conguration tool.
Video conguration
The video settings describe the general settings that apply to all the features,
point to point, Meeting room service and multipart (TCSPI).
IP-address/DNS of SIP Proxy Enter the IP address or DNS of the
Movi server
Video frame rate Number of video frames per second
Video Bandwidth Maximum bandwidth for video usage
Limit access to video by group Enable if you want to limit the video
integration to a certain group of users.
Controls which users in the
organization that will have video
installed. If checked, only members of the group dened will get
video enabled
If checked, enter the name of the
group that users must be member of
to have video enabled.
Echo cancellation Choose if the clients will use built in
echo cancellation or not.
Certain web cameras have inbuild echo cancellation. Uncheck
this option, if your cameras have
this feature.
13
TMS Connection (Optional5)
The Meeting Room service (MRService) and TCSPI require TMS to run. If
any of these modules are installed, the TMS Connection eld is enabled, and
the elds are required to be completed.
TMS hostname or IP address The address of the TMS server. E.g.
tms.tandberg.com
TMS User Name A windows user account with TMS
access.
Notice! This user is required to
have the BookOnBehalfOf role in
TMS
Password Windows password for the TMS user
specied above.
HTTPS Check this is you have congured
your TMS server with HTTPS.
Verify the TMS connection by pressing Test Connection.
Sametime connection settings (Optional6)
If you have the Conferencing service (TCSPI) installed, a service Account
is required. If there is no existing service account on Domino, create a new
account on the Sametime server. The account does not need mail, but is required to be able to log into the Sametime server, so it must have an internet
password.
Update the Sametime username and Password eld of the Domino connection settings with the username and password for the service account.
It is strongly suggested that the ‘Create account..’
option is checked so that Domino accounts are automatically created when enabling new TMS systems
for meeting rooms. If this option is unchecked, you
will still be prompted for a password that is saved
in the Integration’s conguration les. You must
manually create a Domino user with the matching
username and internet password to complete setup
of the meeting room.
TIP: If the password of an existing meeting
room account is changed, you must remove
the system from the Enabled Systems column
and re-add it with the new password. This will
not affect existing Sametime buddy lists, etc.
Sametime user name Name of Domino user
Password Password of Domino account
Meeting Rooms conguration (Optional7)
Use this to video enable meeting rooms, by exporting the appropriate system
from TMS into the Domino Directory making them available to users to add to
their buddy list in Sametime Connect.
Selecting this tab shows systems that are registered with TMS. Systems listed
under TMS Systems are available systems from TMS that have not yet been
added to the Domino Directory. Systems that are listed under Exported TMS
Systems have already been added to the Domino Directory.
To export a new TMS system to the Meeting Room service, simply choose the
system in the list of TMS systems, and click the “>>” button.
To remove the TMS system from the Meeting Room service, choose the sys-
tem in the list of Exported TMS Systems, anc click the “<<” button.
Removal of the TMS system will not delete the Domino accounts created
for the systems. The accounts must be deleted from the Domino Directory if you wish to fully remove it from Sametime clients.
5 Only available if either multipoint (TCSPI) or Meeting room service
module is installed
6 Only available if either multipoint (TCSPI) or Meeting room service
module is installed
7 Only available if Meeting room service module is installed
14
When exporting a TMS system to the Meeting Room service, a Sametime
account is required for this system. If the Create account automatically option
is enabled, A Sametime account is automatically created in the Domino Directory. You will be prompted for a password to assign to this account’. If the
create account option is unchecked, you will be prompted for the username
and password of the existing Sametime account to associate to this system.
If “Same Domino Password for all exported TMS Systems” is checked,
you will only be prompted once, and the password is reused for all the
exported systems.
By adding the systems new accounts are created in the Domino Directory.
Administrators can modify the user account properties freely except user-
name, password, lastname and also the title located under the Work tab.
If these values change, you must remove and readd the systems with the
conguration tool
Same Domino Password for all exported TMS Systems
Create account on Domino server
automatically
When enabled, all Domino accounts
created for exported systems are
created with the same password.
Automatically create new Domino
accounts for each exported TMS
system.
Video client installation
Video client
The Sametime integration requires two componets on the client machine.
The Video Plugin and the Movi video component. The video plugin will automatically be downloaded when the client connects to the Sametime server
where the plugin was installed (default community server). The Movi video
component must still be installed before the Sametime video integration will
function. If users have administrative permissions on their computers, they
can open Internet Explorer and browse to the hostname/IP address of the
Movi server itself.
15
The client interface will automatically open and the user will be prompted to
install the ActiveX component. Install the component and acknowledging any
security warnings. Once this is completed, users will see the video window
become active. Close the web browser, and the component setup is complete. The video component will now be available to the Sametime Connect
client on that client machine.
If users do not have ActiveX enabled in their browsers, they can install the
Movi component via a stand-alone installer. This installer is included on the
Movi4Sametime CD media under the MoviforSametime_VideoClient folder.
Users can run this MSI installer and the Movi video component will be installed on their computer.
If an administrator wants to push the Movi component out automatically to
user machines this can be accomplished by publishing the installer via Active
Directory. Please see the Microsoft KB article referenced on the CD Installation media for further details and instructions.
16
Troubleshoot How do I enable full logging for Conferencing (TC-
SPI)?
To help troubleshoot any problems with the Conferencing (TCSPI) module,
add the following lines to the SametimeDiagnostics_Telephony.properties:
# Default global logging level.
# This species which kinds of events are logged across
# all loggers. For any given facility this global level
# can be overridden by a facility specic level
# Note that the ConsoleHandler also has a separate level
# setting to limit messages printed to the console.
.level=FINEST
net.tandberg.tms.integration.caius.tcspi.level=FINEST
net.tandberg.tms.integration.caius.tcspi.post.level=FINEST
This will create a verbose tcspi log (telephony_0.log), found in the Trace
directory of the <Domino> directory, typically c:\program les\lotus\domino\
Trace\telephony_0.log
To undo the logging, set the values back to INFO.
Conference control center in TMS does not reect
my actions in Sametime Connect conferences
The TCSPI software uses the dial-in address to identify what TMS-ID each
Sametime user has in each conference. This is because there is no requirement to have the Sametime users imported into TMS for using the Movi for
IBM Lotus Sametime software.
If TMS does not update the actions in Sametime connect, verify that the SIP
proxy dened for the clients are the same as the one dened for TCSPI.
Open caius.properties (e.g. C:\Program Files\Lotus\Domino\data\domino\
1.
html\caius.properties)
Value SIPProxy=
–
Open conferenceManager.properties (e.g. C:\Program Files\Lotus\
2.
Domino\conferenceManager.properties)
Value SIPProxyServer=
–
Verify that these values are the same
3.
How do I turn on logging from the Movi for IBM
Lotus Sametime plugin?
To setup logging on each clients, perform the following steps
Open sametime.properties le, in the Sametime directory, typically c:\
1.
Program Files\ibm\Sametime Connect\sametime.properties
Update the following properties in the le to these values
2.
.level=FINEST
–
logger.level=FINEST
–
Restart your Sametime connect client
3.
Open C:\Documents and Settings\<username>\Application Data\
4.
17
Sametime
The current log le is sametime.log.0
–
The logles are rotated each time the Sametime Connect restarts, or
5.
when the size exceeds the limitation given in the sametime.properties le
The log entries by the Movi for IBM Lotus Sametime plugin is identied
6.
by “[net.tandberg.tms.integration.caius.” The entries are written to the
following format [date and time] [entry written by ID] loglevel Message
To reset the logging, set the loglevel values to INFO.
How do I know what version of the ActiveX compo-
nent Movi for IBM Lotus Sametime is using?
Open the client logle, see item ‘How do I turn on logging from the Movi
1.
for IBM Lotus Sametime plugin?’.
Search for the following log line in the le:
2.
[net.tandberg.tms.integration.caius.control.internal.CallControl.
init] ::CONFIG:: Running version 2.45.1.3 of the ActiveX component
In the above example the version 2.45.1.3 is used.
I have uninstalled the Movi for Sametime
integration on the server, but the video icon is still
shown disabled in the clients?
The integration also needs to be uninstalled from the clients. To uninstall the
plugin, do the following.
Select Congure under the File -> Manage updates... menu
1.
Locate Movi4IBMLotusSametime
2.
Click Disable
3.
You are asked to restart the workbench, restart and the icon is gone.
4.
18
Appendix
Suggested conguration values
Level Parameter Value
Low quality Video Bandwidth 128
Frame rate 8
Medium quality Video Bandwidth 256
Frame rate 15
High quality Video bandwiudh 768
Frame rate 30
19
Loading...