Related Manuals for Cisco TELEPRESENCE MANAGEMENT SUITE EXTENSION - QUICK GUIDE FOR IBM LOTUS NOTES V11.3.1
Summary of Contents for Cisco TELEPRESENCE MANAGEMENT SUITE EXTENSION - QUICK GUIDE FOR IBM LOTUS NOTES V11.3.1
- Page 1 Cisco TelePresence Management Suite Extension for IBM Lotus Notes Version 11.3.1 Installation & getting started guide D13561.16 December 2010...
-
Page 2: Table Of Contents
Contents Contents Table of figures........................4 Introduction ......................... 5 How to use this document ........................5 Requirements ........................6 Server operating system .......................... 6 Domino server ............................6 Supported clients ............................. 6 Cisco TMS requirements ......................... 6 Naming of systems in IBM Lotus Domino and Cisco TMS ..........7 System IDs in Cisco TMS ........................ - Page 3 Contents Verification of the installation ...................29 Testing meetings from Lotus to Cisco TMS ..................29 Process overview for meetings created in Lotus ................... 29 Troubleshooting ..........................29 Testing meetings from Cisco TMS to Lotus ..................30 Process overview for meetings created in Cisco TMS ..............31 Frequently asked questions about Cisco TMSXN booking ..........32 Technical description of Cisco TMSXN ................34 Overview ..............................
-
Page 4: Table Of Figures
Contents Table of figures Figure 1: Turning on User Account Control ..................... 8 Figure 2: An updated java.policy file ..................... 10 Figure 3: An updated notes.ini file ......................10 Figure 4: The Files tab, with the two Cisco TMS templates highlighted ..........11 Figure 5: Adding user ID to the Full Access Administrators field ............ -
Page 5: Introduction
Introduction Introduction This document describes the Cisco TelePresence Management Suite Extension for IBM Lotus Notes (Cisco TMSXN) installation process. The software is an optional add-on component to Cisco TelePresence Management Suite (Cisco TMS), which gives users the ability to schedule video conferences, book meeting rooms and invite participants using their Lotus Notes client. -
Page 6: Requirements
Application Integration Package option key. Contact your Cisco TelePresence reseller to purchase this option key. For documentation about how to install license keys in Cisco TMS, see the Support > Documentation section of www.tandberg.com. Cisco TMS Extension for IBM Lotus Notes – Installation and getting started guide... -
Page 7: Naming Of Systems In Ibm Lotus Domino And Cisco Tms
Naming of systems in IBM Lotus Domino and Cisco TMS Naming of systems in IBM Lotus Domino and Cisco TMS The name of a system in Cisco TMS is only a label, therefore it can be changed without doing any Lotus resource re-configuration. -
Page 8: Installation
Installation Installation Complete the following steps to do a first-time installation and configuration of the Cisco TelePresence Management Suite Extension for IBM Lotus Notes package with the Cisco TelePresence Management Suite. The term “Domino directory” is used throughout this document. The location of this directory is user configurable during installation, and can for example be C:\Lotus\Domino\. -
Page 9: Copying The Required Files To The Ibm Lotus Domino Server (Version 8.5.X)
Installation Copy the template files extracted previously, tmsresrc7.ntf and tmsmail7.ntf to your Domino Data directory Verify the proper file security permissions on the copied template files by right-clicking on them and selecting Properties. In the Properties dialog, make sure Read-only is cleared. Go to the Security tab, and make sure that the Windows user (System user) that the Domino processes run under has full access to these files. -
Page 10: Editing The Notes.ini File
Installation Save and close the java.policy file. Figure 2: An updated java.policy file Editing the notes.ini file The notes.ini file is by default found in the Domino directory. Open the notes.ini file in a text editor and add these lines to the top of the file (see also the figure below): TMSResourceDatabaseName=Video Conference Resources TMSDeleteAgentName=RemoveConferenceParticipant... -
Page 11: Restarting The Domino Service
Installation Restarting the Domino Service Restart the Domino Service to apply the changes made either by using the restart server command in the Domino console, or by restarting the Lotus Domino Service in the Services Console found at Start > Administrative Tools > Services. Signing the templates The new template files must be signed with an appropriate ID from your organization. -
Page 12: Creating The Cisco Tms Resource Reservation Database
Domino Server logs for additional information if any errors occur. You may get a Cross Certificate Warning because your organization does not have a trust to /TANDBERG or /Cisco. This should be handled according to your organization’s policies. Creating the Cisco TMS Resource Reservation Database Open Domino Administrator and select the server hosting the installation files. -
Page 13: Creating A Service Account On The Domino Server
Installation In the Specify New Database Name and Location section, select the server that the integration package is being installed on. Set the Title field to the value that you specified in the TMSResourceDatabaseName variable in the notes.ini file (Video Conference Resources, if you followed the recommendation in this document). -
Page 14: Figure 7: The People > Register
Installation Figure 7: The People > Register… item from the right pane If prompted for a certifier, choose Supply certifier ID and password. Click Certifier ID… and provide the associated cert.id file. Enter the certifier’s password when prompted. In the Register Person page, Cisco TelePresence recommends setting the following properties: First Name: TMS Last Name: Service Short Name: TMS-Service... -
Page 15: Creating A Service Account On The Cisco Tms Server
Installation Figure 8: The Register Person page Creating a service account on the Cisco TMS server A user must be specified on the Cisco TMS server to be used as the login for Cisco TMSXN. This user must be able to log onto the Cisco TMS server and have access to all the systems you intend to make available through Lotus Notes. -
Page 16: Adjusting The Web Permissions On The Cisco Tms Server
Installation Figure 9: Creating a new user group having the Booking permission Adjusting the web permissions on the Cisco TMS Server The Java implementation on the Domino Server cannot support the default Integrated Authentication permissions set on the Cisco TMS web site. Therefore the web site must be altered to allow “Basic Authentication”... -
Page 17: Enabling Agents In Resource Database (Ibm Lotus Notes/Domino Versions 7.X And 8.0.X)
Installation When the wizard pops up, click Next, and then Assign an existing certificate. You can now see the certificate that was created in step 1, click Next to see information about the certificate, and click Next again to complete the installation. Cisco TMS is now configured for HTTPS. To set up the Notes server, the certificate chain must be added to the Java certificate store: Export the Cisco TMS server certificate to a .cer file. -
Page 18: Enabling Agents In Resource Database (Ibm Lotus Notes/Domino Version 8.5.X)
Installation agents should run — the server on which the database is created. The database and agents must be on the same server. Close the agent dialog. Double-click Scheduled Synchronizer. Make sure On schedule is selected. In the drop-down list to the right of Schedule… select More than once a day. Figure 11: Configuring the run-time of the Scheduled Synchronizer agent Click the Schedule…... -
Page 19: Figure 12: Listing The Agents Of The Database
Installation Figure 12: Listing the Agents of the database Hold down the Ctrl key, and click on Scheduled Synchronizer and TMS Trigger. Click the Enable button at the top of the list. The database and agents must be on the same server. Close the agent dialog. -
Page 20: Figure 13: Configuring The Run-Time Of The Scheduled Synchronizer Agent
Installation Figure 13: Configuring the run-time of the Scheduled Synchronizer agent Click the Schedule… button to open the Agent Schedule window. Set the interval to 0 hours and 15 minutes, and verify that the Run on drop-down list has the correct server selected. Click OK. Figure 14: The Agent Schedule window Save and close the Scheduled Synchronizer Agent. -
Page 21: Configuring The Cisco Tms Settings Of The Resource Database (All Versions)
Installation Configuring the Cisco TMS settings of the Resource Database (all versions) Open Domino Administrator using a server administrator ID. Open the resource reservation database that you created in the previous steps by going to File > Application > Open and select the server on which the database was created. Then select the database as you named it in the notes.ini file (default name: “Video Conference Resources”), and click Open. -
Page 22: Configuring The Domino Rooms For Cisco Tms Systems
Installation 10. If you have completed the Enable secure communication (Optional) section, select Yes for field HTTPS. If not, select No. 11. An additional option titled Automatic Update is displayed. Because of a known issue with Lotus Notes, the Free/Busy information for booked resources is not handled by the Room and Resources Manager. -
Page 23: Starting The Synchronizer
Installation Do not modify the remaining fields. Click Save and Close to save your changes. Repeat these steps for each Cisco TMS system you wish to represent in Notes. Starting the Synchronizer After all the resources have been added to the resource database, the synchronizer process must be started by going to Actions >... -
Page 24: Upgrading To 11.3 Or 11.3.1
Upgrading to 11.3 or 11.3.1 Upgrading to 11.3 or 11.3.1 Complete the following steps to upgrade the Cisco TMS IBM Lotus Notes integration from a previous version. The term “Domino directory” is used throughout this document. The location of this directory is user configurable during installation, and can for example be C:\Lotus\Domino\. -
Page 25: Sign The Templates
The status bar shows the number of databases processed and the number errors if any occurred. See the Domino Server logs for additional information if any errors occur. You will get a Cross Certificate Warning if /TANDBERG or /Cisco is not recognized as a trusted organization. This should be handled according to your organization policies. -
Page 26: Enable Agents In Resource Database
Upgrading to 11.3 or 11.3.1 Go to File > Application > Replace Design… Select the server on which the Cisco TMS templates were installed and then select TMS Mail 7 and click Replace. Enable agents in Resource Database Start Lotus Domino Designer and open the Resource Reservations Database that you created earlier (normally called “Video Conference Resources”) by going to File >... -
Page 27: Post Installation Setup
Post installation setup Post installation setup Calendar options in the Cisco TMS mail template Using the calendar to request a meeting does not change from standard Lotus Resource booking, therefore that process is not covered in this document. Please refer to your Lotus Notes help for information on using the Calendar and Address Book. -
Page 28: Figure 18: The Video Conference Advanced Options Window
Post installation setup ports for people to call into the meeting, both audio and video ports, by defining them to be External Dial-in participants. Figure 17: The Video Conference Advanced Options window Cisco TMS Extension for IBM Lotus Notes – Installation and getting started guide Page 28 of 45... -
Page 29: Verification Of The Installation
Verification of the installation Verification of the installation After completing the installation, it is recommended test by verifying that meeting changes populate both from Lotus to Cisco TMS and from Cisco TMS to Lotus. Testing meetings from Lotus to Cisco TMS To verify that meetings booked from Lotus are being saved in Cisco TMS, create a test meeting for a date in the future in your calendar using two rooms in Lotus that are integrated with Cisco TMS. -
Page 30: Testing Meetings From Cisco Tms To Lotus
Verification of the installation Check whether the user selected proper rooms. Check the Domino mail system to verify that email is being delivered. Step 4 Symptom: Requests show up in the Waiting for Approval but stay there indefinitely. Tips: Check the Domino Server Log of the Integration Server for signs that the Cisco TMS Trigger Agent has run. -
Page 31: Process Overview For Meetings Created In Cisco Tms
Verification of the installation Process overview for meetings created in Cisco TMS The steps taken when booking a meeting from Cisco TMS are described below. Use this workflow to help diagnose where a failure is occurring if your test meeting does not complete successfully. A booking change of some type is made in Cisco TMS. -
Page 32: Frequently Asked Questions About Cisco Tmsxn Booking
Frequently asked questions about Cisco TMSXN booking Frequently asked questions about Cisco TMSXN booking Question: Why do I get multiple meeting requests when I book a meeting? Answer: Lotus sends a separate meeting request for each room selected for the meeting. You will receive an email for each request, acceptance, or denial for each room selected in the meeting request. - Page 33 Frequently asked questions about Cisco TMSXN booking Question: Can I use the Cisco TMS Phone books when booking from my Lotus Notes Calendar? Answer: No, Cisco TMS Phone books are not available from Cisco TMSXN. Systems not listed in your Lotus Notes Address Book can be added to the meeting as External Participants. Alternatively, if there are numbers or sites that you use often that you would like to have available for booking in Lotus, Cisco TelePresence recommends defining a room in Cisco TMS to represent the contact and making a resource representation of that room in Cisco TMSXN.
-
Page 34: Technical Description Of Cisco Tmsxn
Technical description of Cisco TMSXN Technical description of Cisco TMSXN Overview The Cisco TelePresence Management Suite Extension for IBM Lotus Notes allows Lotus Notes Client users connected to a Domino Server to book, update and delete video conferences directly from within their Lotus Notes client. - Page 35 Technical description of Cisco TMSXN should not cross a public network, because HTTPS is not currently supported in the java communication library. The Lotus Notes clients do not communicate directly with Cisco TMS; all communication is done through the integration installed on the Domino server. Cisco TMS Extension for IBM Lotus Notes –...
-
Page 36: Troubleshooting Cisco Tmsxn
Troubleshooting Cisco TMSXN Troubleshooting Cisco TMSXN This chapter guides you through typical challenges faced during installation, and shows you how to identify and solve them. Understanding log files By default Lotus Domino Server logs are stored on server where Lotus Domino is installed. For example, if the Lotus Domino Server is installed in c:\IBM\Domino\, then the log files are located at c:\IBM\Domino\data\IBM_TECHNICAL_SUPPORT\. -
Page 37: Tms Admin View Is Not Available
Troubleshooting Cisco TMSXN Figure 19: Changing the log level Currently you can set values from 0 (minimal debug) to 3 (all available debug). If you experience problems and want to troubleshoot Cisco TMSXN, set this value to 3, click the Save and Close button and restart the Lotus Domino Server. -
Page 38: It Is Impossible To Book Resources After A Cisco Tmsxn Upgrade
Troubleshooting Cisco TMSXN Figure 20: Adding an Admin role It is impossible to book resources after a Cisco TMSXN upgrade Sometimes after upgrading from a previous Cisco TMSXN version, you may experience difficulties booking Cisco TMS resources from Lotus Clients. A typical case is: You create a meeting and book a Cisco TMS resource (room). -
Page 39: Expired Ssl Certificates
Troubleshooting Cisco TMSXN Open Domino Administrator and go to the Configuration > Server-Connections view. Check that the connection to your Domino Server is presented there, and if not, create it by clicking the Add connection button. Open the server connection (whether previously existing or created at step 2) and verify that the Use the port(s) parameter is set to TCP/IP. -
Page 40: Checking For Updates And Getting Help
Support sections of the web site which are kept up to date with the latest information from Cisco TelePresence customer support (www.tandberg.com > Support). If the information on the web site does not help you to solve your problem, contact your reseller. Make... -
Page 41: License Agreement
(previously known as TANDBERG Management Suite Lotus Notes Integration) TANDBERG is now part of Cisco Systems, Inc By installing, copying, or otherwise using the software program of TANDBERG and/or its affiliates (“TANDBERG”), or of its Licensors, provided hereunder (“Software”), You (“Licensee”) agree to be bound by the terms of this Shrinkwrap License Agreement (“Agreement”). - Page 42 Software and Documentation contain valuable proprietary information and trade secrets of TANDBERG and You shall protect the secrecy of, and avoid disclosure and unauthorized use of, the Software and Documentation, using at least those measures that You take to protect Your own most highly confidential information;...
- Page 43 TANDBERG or destroy all copies of the Software and Documentation. LIMITED WARRANTY. TANDBERG warrants that for a period of ninety (90) days from the date of delivery (“Warranty Period”), the Software will operate substantially in accordance with the Documentation.
- Page 44 AUDIT RIGHTS. You shall maintain complete and accurate books and records relating to compliance with the usage restrictions of the Software. TANDBERG shall have the right at its own expense, during Your normal business hours and upon reasonable written notice, to audit your computers, books and records to verify your compliance with the terms and conditions of this Agreement.
- Page 45 License agreement THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.