Cisco TELEPRESENCE MANAGEMENT SUITE EXTENSION - INSTALLATION GUIDE FOR IBM LOTUS NOTES 11.3.1, Installation And Getting Started Manual

Page 1: ...Cisco TelePresence Management Suite Extension for IBM Lotus Notes Installation and getting started guide Software version 11 3 1 D13561 16 December 2010 ...

Page 2: ...plates 11 Creating the Cisco TMS Resource Reservation Database 12 Creating a Service Account on the Domino Server 13 Creating a service account on the Cisco TMS server 15 Adjusting the web permissions on the Cisco TMS Server 16 Enable secure communication Optional 16 Enabling agents in Resource Database IBM Lotus Notes Domino versions 7 x and 8 0 x 17 Enabling agents in Resource Database IBM Lotus...

Page 3: ...n Cisco TMS 31 Frequently asked questions about Cisco TMSXN booking 32 Technical description of Cisco TMSXN 34 Overview 34 Synchronizing changes from Cisco TMS 34 Synchronizing changes to Cisco TMS 34 Communication between Cisco TMS and IBM Lotus Domino 34 Troubleshooting Cisco TMSXN 36 Understanding log files 36 Changing log level 36 TMS Admin view is not available 37 It is impossible to book res...

Page 4: ...Register Person page 15 Figure 9 Creating a new user group having the Booking permission 16 Figure 10 Listing the agents in Domino Designer 7 0 17 Figure 11 Configuring the run time of the Scheduled Synchronizer agent 18 Figure 12 Listing the Agents of the database 19 Figure 13 Configuring the run time of the Scheduled Synchronizer agent 20 Figure 14 The Agent Schedule window 20 Figure 15 Checking...

Page 5: ...ftware components installed on the Lotus Domino server Therefore client machines do not need to be modified This gives system administrators a centrally deployed solution simplifying maintenance See http www lotus com for more information about IBM Lotus Domino and IBM Lotus Notes How to use this document The installation procedure for Cisco TelePresence Management Suite Extension for IBM Lotus No...

Page 6: ...Access on the Domino Server An account with permissions to create and edit users create and sign databases and the ability to edit the Server Configuration Document Supported clients Tested with Cisco TelePresence Management Suite Extension for IBM Lotus Notes version 11 3 1 IBM Lotus Notes 7 0 4 IBM Lotus Notes 8 0 IBM Lotus Notes 8 5 2 Other minor versions within these major versions of Notes an...

Page 7: ...completely different system in Cisco TMS along with a new system ID If a system s ID changes and the system is also represented in Lotus you must update the ID listed for that system in the Lotus Resource database manually Adding systems to Cisco TMS after installation of Cisco TMSXN After completing the Cisco TMS Integration with Lotus the requirements for adding new systems to Cisco TMS change s...

Page 8: ...UAC is on by going to Control Panel User Accounts and clicking Turn User Account Control on or off Figure 1 Turning on User Account Control Copying the required files to the IBM Lotus Domino Server Versions 7 x and 8 0 x 1 Copy the TMSXN_ForDominoV70 zip file to your Domino Server and extract it to a temporary folder If using FTP make sure that binary mode is used 2 Extract the LotusNotesIntegrati...

Page 9: ... lib directory in the Javafiles zip archive to the jvm lib ext subdirectory of the Domino directory Do not overwrite existing files 4 Verify that the copied jar files have proper file security permissions by right clicking on them and selecting Properties Go to the Security tab and make sure that the Windows user System user that the Domino processes run under has at least Read access to these fil...

Page 10: ...gentName RemoveConferenceParticipant EXTMGR_ADDINS TMSEventCatcher dll It is important that only one instance of each of these statements exists in the notes ini file If one of these lines already exists in the notes ini file you must modify the existing line to include these values For the TMSResourcesDatabaseName variable the name must match the name you intend to give the resource reservation d...

Page 11: ...ration package Note If you ignore this requirement the agents are unable to run To sign the new mail agents you must create a utility account on the Domino Server However you can configure Domino to ignore this security requirement for mail agents running on the server Note that this will affect all new mail agents running on the server To disable the security check modify the notes ini file by ad...

Page 12: ...ANDBERG 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 Go to the Administration menu and select Full Access Administration If you cannot get full access permissions can be granted to the server 1 Go to the Configuration tab for the server an...

Page 13: ...late for New Application section a Select the server that the integration package is being installed on b Select the Show advanced templates check box c The template list updates Select the TMS Resource Reservations template d Click OK to create the database The Notes status bar shows progress updates Figure 6 Creating a new database Creating a Service Account on the Domino Server This account wil...

Page 14: ...e certifier s password when prompted 4 In the Register Person page Cisco TelePresence recommends setting the following properties a First Name TMS b Last Name Service c Short Name TMS Service d Password Enter a so called strong password 5 Click Register and click Yes to add person to the registration queue 6 The background job registering the new account may take several minutes to complete When y...

Page 15: ...co TMS server You can use any name and username for the account The account needs no special Windows permissions except being able to log into Cisco TMS IIS server Log into Cisco TMS using the new user account to verify the account s settings When prompted for user profile information specify a first and last name to identify the user as the Lotus Service account The email address can be any email...

Page 16: ... Authentication Methods window and then click OK again to close the bookingservice asmx Properties window Close the IIS Manager Enable secure communication Optional Note HTTPS is optional and if opting to use HTTP this section can be skipped In order to use HTTPS both the Cisco TMS server and Notes must be configured To set up the Cisco TMS server for HTTPS do the following 1 Use makecert exe to c...

Page 17: ... trustcacerts keystore cacerts alias myname file location of certificate file tmsserverauth cer It is advisable to give the certificate a proper alias for example TMS_server_certificate 6 Restart the Domino server Enabling agents in Resource Database IBM Lotus Notes Domino versions 7 x and 8 0 x 1 Start Lotus Domino Designer and open the Resource Reservations Database that you created earlier norm...

Page 18: ...hat the Run on drop down list is pointing to the correct server Click OK 8 Save and close the Scheduled Synchronizer Agent 9 Close the database and Domino Designer Enabling agents in Resource Database IBM Lotus Notes Domino version 8 5 x 1 Start Lotus Domino Designer and open the Resource Reservations Database that you created earlier normally called Video Conference Resources by going to File App...

Page 19: ...y 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 6 Double click Scheduled Synchronizer Locate the Properties section near the bottom Select the On Schedule radio button under Runtime Trigger and select More than once a day in the drop down list below ...

Page 20: ...he Scheduled Synchronizer agent 7 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 8 Save and close the Scheduled Synchronizer Agent 9 Close the database and Domino Designer ...

Page 21: ...current user ID to these roles for the database Optionally you can add additional users to these roles to enable those users to be able to modify the configuration document and add additional resources Adding additional user roles can also be done post installation In some installations one or both of the check boxes might be missing See the TroubleshootingError Reference source not found chapter ...

Page 22: ...ference for later steps in the installation 1 You must know the system ID of each system in Cisco TMS that you wish to integrate with Lotus This can be found on the View Settings page for each system in the System Navigator or see the above note 2 Using Domino Administrator open the resource reservation database by going to File Menu Application4 Open and select the server on which the database wa...

Page 23: ...il template This file is called tmsmail7 ntf for Notes 7 0 x and 8 0 x users and tmsmail85 ntf for Notes 8 5 x users The first method allows users to book rooms but they will not have any of the additional functionality for example being able to set conference parameters or specific additional sites such as external dial in or dial out sites The second method may be required if the organization is...

Page 24: ...d jar file by right clicking on it and selecting Properties Go to the Security tab and make sure that the Windows user System user that the Domino processes run under has at least Read access to this file 4 Delete the tmsresrc7 ntf and tmsmail7 ntf files in the Domino Data Directory 5 The copied template file depends of the version of Notes Domino you are using a If you are running version 7 0 x 8...

Page 25: ...sions to sign templates and that the user has a mailbox on this Domino server 4 Select the All design documents radio button 5 Click OK 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 orga...

Page 26: ...down the Ctrl key and click on Scheduled Synchronizer and TMS Trigger Click the Enable button at the top of the list You are prompted for the server on which the 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 6 Double click Scheduled Synchronizer Locate the Properties section near the bottom Select the On Sche...

Page 27: ...dial out Request a web conference from Cisco TMS Specify conference parameters such as bandwidth and layout This functionality is not required to be able to book meetings from Lotus in Cisco TMS but if you intend to give users the ability to override the conference defaults or use one of the additional features you must update the user s template After it has been updated the template includes a n...

Page 28: ...r IBM Lotus Notes Installation and getting started guide Page 28 of 45 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 ...

Page 29: ...ion Database under Reservations Waiting for Approval 4 The Waiting for Approval requests are processed by the Cisco TMS Trigger agent 5 The Integration components log into the Cisco TMS server and try to create a meeting using the details from the Lotus Meeting request 6 Cisco TMS tries to book the meeting request and will accept or reject the meeting if it is not possible to book 7 If the meeting...

Page 30: ...tion by trying to book the same meeting in Cisco TMS directly If the meeting is rejected Lotus can be excluded as the problem and either the conference settings are incompatible with the systems or the problem is permissions related For conference settings make sure that all systems are available have compatible dialing information and can support the conference type being requested For permission...

Page 31: ...co TMS provides all the booking changes and Cisco TMSXN processes the changes which are relevant for systems integrated with Lotus 6 The integration package directly modifies the reservations in the Reservation Database 7 If the test meeting does not carry through to the Domino Reservation Database use the symptoms and tips below to troubleshoot the issue Symptom Meetings do not show up in the Res...

Page 32: ...my meeting in Lotus Notes but it is not showing up in Cisco TMS under My Meetings Why Answer If you received the meeting accept emails the meeting has been booked in Cisco TMS The meeting is booked in Cisco TMS under the integration user not under your username By default normal users cannot see another user s bookings in Cisco TMS However if you are an administrator or a user with appropriate per...

Page 33: ...MSXN This allows a non managed device to be booked in both Cisco TMS and Lotus Notes Question Is resource booking via Domino Web Access iNotes supported Answer Resources set up with Cisco TMSXN can be booked via the iNotes web interface but the extra Video Conference Settings button will not be available Therefore the extra settings on that page are also unavailable and only conference defaults wi...

Page 34: ...omino Mail system to the Resource Reservation Database and queued After a request reaches the database the AgentManager initiates the Java agent TMSTrigger installed on the Domino Server to process the request This agent submits the booking or meeting update to Cisco TMS which in turn tries to commit the change to the Cisco TMS database After successfully booking in Cisco TMS this process moves th...

Page 35: ...d getting started guide Page 35 of 45 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 ...

Page 36: ...cated at c IBM Domino data IBM_TECHNICAL_SUPPORT If the Lotus Domino Server is running in console mode that is not as a Windows service you can also view log messages directly in the console Changing log level You can increase or decrease the number of log messages produced by the Cisco TMSXN component Log in to Lotus Notes as an Administrator and open the Video Conference Resources database Figur...

Page 37: ...n Cisco TMSXN installation or upgrade the TMS Admin view might not be available under the administrative role This is due to a missing installation step Please verify the following steps 1 Open Domino Administrator using a server administration ID 2 Open the Resource Reservation Database Video Conference Resources 3 Open Access Control for the database and select File Application Access Control 4 ...

Page 38: ... configuration There are two potential places to check First check that both Lotus Agents TMS Trigger and Scheduled Synchronizer are enabled and set to scheduled execution on your Domino Server default is 5 every minute Wait maximum 15 minutes in a default configuration and verify that bookings are processed If the booking is still not processed open Video Conference Resources database in Notes as...

Page 39: ...e and click Next again to complete the installation 6 Click Windows Start Run and type certmgr msc to run Certificates Manager 7 Expand Trusted Root Certification Authorities right click Certificates and choose All Tasks Import 8 When the wizard displays click Next and then point to the new certificate s cer file 9 Click Next and verify that the certificate will be stored in Trusted Root Certifica...

Page 40: ... using this version of the Lotus integration software package consult the online help for information on using the product If the documentation does not answer your question or you have a problem with one of our products refer to the 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 inform...

Page 41: ... Your order for the Software is placed on a single machine Designated Computer in the building in which the Designated Computer is located at the time of initial installation Site Use the Software at the Designated Computer under the scope of license granted herein permit third party service providers to utilize the Software at the Site on Your behalf within the scope of license granted herein and...

Page 42: ...mark and other proprietary rights notices included on the originals the 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: ...bstantially similar functionality or c if neither a nor b is commercially feasible refund the license fee paid to TANDBERG for the Software EXCLUSIONS TANDBERG will have no responsibility warranty or other obligations whatsoever if You a use the Software in a manner inconsistent with the Documentation or this Agreement b modify the Software or c cause a failure of the Software through accident abu...

Page 44: ...g executed by duly authorized representatives of both parties The provisions of any order document used by You shall be of no effect notwithstanding any provisions in such order document to the contrary except for license term and Site selection as well as pricing and ship to information This Agreement is governed by and is to be interpreted in accordance with the laws of the State of New York exc...

Page 45: ...ITH ALL FAULTS CISCO AND THE ABOVE NAMED SUPPLIERS DISCLAIM ALL WARRANTIES EXPRESSED OR IMPLIED INCLUDING WITHOUT LIMITATION THOSE OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING USAGE OR TRADE PRACTICE IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT SPECIAL CONSEQUENTIAL OR INCIDENTAL DAMAGES INCLUDING WITHOUT LIMITAT...