Tandberg Data IBM LOTUS NOTES-DOMINO V 11.3 - INSTALLATION AND 2010, Integration Manual

Page 1: ...TANDBERG IBM Lotus Notes Domino v 11 3 Installation getting started guide D13561 15 July 2010 ...

Page 2: ...he TMS Resource Reservation Database 13 Creating a Service Account on the Domino Server 15 Creating a service account on the TMS Server 17 Adjusting the web permissions on the TMS Server 18 Enable secure communication Optional 18 Enabling agents in Resource Database Notes V6 5 V7 0 and V8 0 19 Enabling agents in Resource Database Notes Domino V8 5 21 Configuring the TMS settings of the Resource Da...

Page 3: ...Appendix A Technical description of the IBM Lotus Notes integration package 38 Overview 38 Synchronizing changes from TMS 38 Synchronizing changes to TMS 38 Communication between TMS and Domino 39 Appendix B Modifying an existing Mail template to include the TANDBERG Advanced button functionality 40 APPENDIX C Troubleshooting 42 Understanding log files 42 Changing log level 42 TMS Admin view is no...

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

Page 5: ...king bookings The integration uses software 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 Lotus Domino and Lotus Notes How to use this document The installation procedure for the TANDBERG Lotus Notes Domino i...

Page 6: ...Tested on TANDBERG Lotus Notes Domino integration version 11 2 Notes client v6 5 1 Notes client v6 5 3 Tested on TANDBERG Lotus Notes Domino integration version 11 3 Notes client v7 0 Notes client v8 0 and v8 0 1 Notes client v8 5 Other minor versions within these major versions of Notes and Domino may be compatible but the versions above are the versions tested for compatibility by TANDBERG TMS r...

Page 7: ...rtant not to purge and re add a system to TMS unless absolutely necessary Doing so will make the system appear as a completely different system in 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 Adding systems to TMS after installation of the Notes Domino integration Aft...

Page 8: ...An administrator can go to Control Panel User Accounts and click Turn User Account Control on or off to turn the feature on Copying the required files to the Domino Server Version 6 x Note This section is only applicable if you are running version 6 x of Notes Domino 1 Copy the LotusNotesIntegrationForNotesV6x zip file to your Domino Server and extract it to a temporary folder If you are using FTP...

Page 9: ...5 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 6 Copy the extracted TMSEventCatcher dll file into your Domino Program Folder 7 ...

Page 10: ...k see Figure1 The TMSEventCatcher dll Copying the required files to the Domino Server Version 8 5 Note This section is only applicable if running version 8 5 of Notes Domino 1 Copy the LotusNotesIntegrationForNotesV85 zip file to your Domino server and extract the files to a temporary folder If using FTP use binary mode 2 Extract the LotusNotesIntegrationForNotesV85 Javafiles zip file to a tempora...

Page 11: ...n java util PropertyPermission java protocol handler pkgs write 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 the lines shown in Figure 3 An updated notes ini file to the top of the file TMSResourceDatabaseName Video Conference Resour...

Page 12: ...a mailbox located on the server where you are installing the integration package It is recommended you create a utility account on the Domino Server for the purpose of signing the new mail agents Alternatively you can configure Domino to ignore this security requirement for mail agents running on the server Note this will affect all new mail agents running on the server To disable this security ch...

Page 13: ...ross Certificate Warning if TANDBERG is not recognized as a trusted organization This should be handled according to your organization policies Creating the 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 th...

Page 14: ...et 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 4 In the Specify Template for New Application4 section see Figure 6 Creating a new database a Select the server that the integration package is being installed on b Select the Show advanced templates check bo...

Page 15: ... Account on the Domino Server This account will act as the owner of the video resources Make this account a normal restricted user 1 Open the server in Domino Administrator for example by using File Open Server 2 Under People Groups Select the People item and select Register from the right pane see Figure 7 The People Register item from the right pane ...

Page 16: ...sword when prompted 4 In the Register Person page see Figure 8 The Register Person page TANDBERG 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 comp...

Page 17: ... the 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 TMS IIS server Log into 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 address b...

Page 18: ...Access Control panel Click Edit 5 Make sure both the Integrated Windows Authentication and Basic Authentication check boxes are selected 6 Click OK to close the 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 skippe...

Page 19: ...and prompt on the Domino server 4 Change directory to Domino directory jvm lib security for example cd Program Files Lotus Domino jvm lib security 5 Import the certificate by writing bin keytool exe import 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...

Page 20: ...ick 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 Make sure On schedule is selected see Figure 11 Configuring the run time of the Scheduled Synchronizer agent In the drop down list to th...

Page 21: ...signer Enabling agents in Resource Database Notes Domino V8 5 1 Start Lotus Domino Designer and open the Resource Reservations Database that you created earlier normally called Video Conference Resources by going to File Application Open selecting the server where the database was created and then selecting the database from the list 2 From the Applications pane expand the Code item list to the le...

Page 22: ...d 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 see Figure 13 Configuring the run time of the Scheduled Synchronizer agent Select the On Schedule radio button under Runtime Trigger and select More than once a day in the drop down...

Page 23: ...uring the run time of the Scheduled Synchronizer agent 7 Click the Schedule button to open the Agent Schedule window see Figure 14 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 ...

Page 24: ...e Access Control List window 4 Select the current user ID from the list and select the Admin and Create Resource check boxes to add the current user ID to these roles for the database see Figure 15 Checking the Admin and Create Resource check boxes Optionally you can add additional users to these roles to enable those users to be able to modify the configuration document and add additional resourc...

Page 25: ...re delays consider turning off this option 5 12 Click Save and Close to save your changes to the document Configuring the Domino Rooms for TMS Systems Each system that will be bookable through Lotus Notes must be represented as a Room within Domino This step must be done by the userID who was added to the Reservation Database with the role of create resource completed in the previous section 1 You...

Page 26: ... restrictions Make sure this is set to Autoprocessing h List of names This must be set to the name of the TMS service user only i Owner s name This must be set to the name of the TMS service user only 6 Do not modify the remaining fields Click Save and Close to save your changes Repeat these steps for each TMS system you wish to represent in Notes Starting the Synchronizer After all the resources ...

Page 27: ...t users use can be updated in several ways but one method is as follows 1 Open Domino Administrator and select the Server containing the mail files of the user to be updated 2 Select the Files tab and then the mail folder 3 Select the user to be updated 4 Go to File Database Replace Design 5 Select the server on which the TMS templates were installed and then select TMS Mail X8 and click Replace 8...

Page 28: ...ip file is found on the installation media 2 Copy TMSConference jar found in the bin directory of the Javafiles zip file to the jvm lib ext directory of the Domino directory This is the only file from this archive that needs to be replaced 3 Verify the proper file security permissions on the copied jar file by right clicking on it and selecting Properties Go to the Security tab and make sure that ...

Page 29: ...trator and select the server that you copied the template files to 2 Go to the Files tab and select the data folder In the Show me drop down list change the view to Templates Only Highlight the two TANDBERG templates TMS Resource Reservations and TMS Mail X9 3 Right click on the templates and select Sign a Choose Active User s ID to sign using the current user s ID b Make sure that the user has su...

Page 30: ...lly called Video Conference Resources by going to File Application Open selecting the server where the database was created and then selecting the database from the list 2 From the Applications pane expand the Code item list to the left 3 Double click on Agents 4 The main frame lists all the agents in the database Approximately 8 depending on the Domino version of the agents have yellow icons next...

Page 31: ...onality is not required to be able to book meetings from Lotus in 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 new button Video Conference Advanced Options in the New Calendar Entry document see Figure 17 The Video Conference Advanced Op...

Page 32: ...Post installation setup TANDBERG IBM Lotus Notes Domino v 11 3 Installation getting started guide Page 32 of 49 Figure 18 The Video Conference Advanced Options window ...

Page 33: ...he meeting requests for the rooms show up in the Reservation Database under Reservations Waiting for Approval 4 The Waiting for Approval requests are processed by the TMS Trigger agent 5 The Integration components log into the TMS server and try to create a meeting using the details from the Lotus Meeting request 6 TMS tries to book the meeting request and will accept or reject the meeting if it i...

Page 34: ...ation of the TMS Service Account by manually trying to log into TMS s web page using the same account information Verify the installation steps to change the security settings of the TMS Booking page Step 6 Symptom TMS rejects the meeting request Tips Verify the rejection by trying to book the same meeting in TMS directly If the meeting is rejected Lotus can be excluded as the problem and either t...

Page 35: ... at 5 minute intervals and keeps track of the last booking change relayed by TMS 4 At a timed mark the Scheduled Synchronizer Agent runs and requests changes made since the last saved change from TMS 5 TMS provides all the booking changes and the Lotus Integration package processes the changes which are relevant for systems integrated with Lotus 6 The integration package directly modifies the rese...

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

Page 37: ...evice to be booked in both TMS and Lotus Notes Question Is resource booking via Domino Web Access iNotes supported Answer Resources set up with the Lotus Integration package 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 will be used Question ...

Page 38: ...iewed in the Domino Server log Synchronizing changes to TMS Bookings and updates from the Lotus Notes clients are delivered by the Domino 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 TMS wh...

Page 39: ...ication with the TMS server is done using web services HTTP implemented in Java on the Domino server The network link between the TMS server and the Domino server 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 TMS all communication is done through the integration installed on the ...

Page 40: ...ster template check box 12 Open the newly created database in Domino Designer This can be done in Administrator by double clicking the database and then going to View Design 13 Open the TANDBERG supplied template in Domino Designer File Open then select the server and the TMS Mail 6 template 14 From the TANDBERG supplied template copy the form _TMSAdditionalDialog by right clicking on it and selec...

Page 41: ... Then close the Property for the action 23 From the supplied TANDBERG template open the _Calendar Entry form select the Video Conference Settings action highlight and copy the formula code from the code pane and paste it into the code pane of the new Video Conference Settings action in the new template 24 Save and close the modified database 25 Sign the new database with a valid ID using Domino Ad...

Page 42: ... 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 LNI component Log in to Lotus Notes as an Administrator and open the Video Conference Resources database see Figure 19 The Video Conference Resources database Figure 19 The Video ...

Page 43: ...allation 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 Verify that the Ad...

Page 44: ...ck 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 Administrative user open Resources view select all resources an...

Page 45: ...te 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 Certification Authorities and click Next ...

Page 46: ...APPENDIX C Troubleshooting TANDBERG IBM Lotus Notes Domino v 11 3 Installation getting started guide Page 46 of 49 7 Click Save and Close ...

Page 47: ...Software at the Site on Your behalf within the scope of license granted herein and provided such third party service provider agrees to be bound by the terms and conditions of this Agreement make a copy of the Software for backup and or archival purposes copy and use the Documentation as reasonably necessary in connection with Your authorized internal use of the Software You may not Modify adapt d...

Page 48: ...antially 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 abuse ...

Page 49: ...idity shall not affect the validity of the remaining provisions of this Agreement and further agree to substitute for the invalid provision a valid provision which most closely approximates the intent and economic effect of the invalid provision Any terms in Your order document which are inconsistent with the terms of this Agreement are not accepted by TANDBERG and the terms of this Agreement will...