Table Of Contents
Installing and Configuring the Lotus Notes Plug-in for Cisco Unified Videoconferencing Manager Release 5.6
Overview
Prerequisites
System Requirements
How to Verify that the DIIOP Service is Running
How to Install the Cisco Unified Videoconferencing IBM Lotus Notes Plug-in
Creating NSF Objects via the Domino Designer Interface
Configuring a Template via the Domino Administrator Interface
Configuring Forms and Script Libraries via the Domino Designer Interface
How to Configure the Cisco Unified Videoconferencing IBM Lotus Notes Plug-in
Using a New Template
Configuring Domino Web SSO
Assigning an Execution Control List
Configuring the Domino Server
How to Uninstall the Cisco Unified Videoconferencing IBM Lotus Notes Plug-in
Reverting to the Default Mail Template
Removing the ivconfig Database
Removing the mail8_iv Template
Obtaining Documentation and Submitting a Service Request
Integration Note
Installing and Configuring the Lotus Notes Plug-in for Cisco Unified Videoconferencing Manager Release 5.6
1 Overview
The Cisco Unified Videoconferencing Manager IBM Lotus Notes Plug-in is a separately deployed plug-in that can work in a Cisco Unified Videoconferencing Manager deployment or in a standalone Desktop Server deployment without Cisco Unified Videoconferencing Manager.
In a Cisco Unified Videoconferencing Manager deployment, the IBM Lotus Notes Plug-in allows users to schedule, modify, cancel and manage Resource Manager meetings using the IBM Lotus Notes interface.
In a standalone Desktop Server deployment, the Cisco IBM Lotus Notes Plug-in allows users to send out meeting invitations using the IBM Lotus Notes interface.
2 Prerequisites
System Requirements
Lotus Domino Server
•
Supported versions: 7.0 and 8.0
•Running DIIOP HTTP services
•Configured as a Web SSO server with Ltpa token
•Administrator and Designer interfaces must be available
Each user should have a dedicated e-mail account for receiving meeting messages including meeting accept and decline messages.
For Cisco Unified Videoconferencing Manager deployments
•A dedicated Cisco Unified Videoconferencing Manager server which the IBM Lotus Notes Plug-in can connect to.
•This Cisco Unified Videoconferencing Manager server should be configured to work with IBM Domino server LDAP Directory service.
•Assign at least one virtual room to each user.
For Desktop Server deployments
•A dedicated Desktop Server server which the IBM Lotus Notes Plug-in can connect to.
3 How to Verify that the DIIOP Service is Running
Procedure
Step 1 Open the Lotus Domino Server command window.
Step 2 Enter "show task".
Step 3 Verify that the "DIIOP Server" entry is present.
Step 4 If the "DIIOP Server" entry is not present, contact your Domino Server administrator to run the service.
4 How to Install the Cisco Unified Videoconferencing IBM Lotus Notes Plug-in
•Creating NSF Objects via the Domino Designer Interface
•Configuring a Template via the Domino Administrator Interface
•Configuring Forms and Script Libraries via the Domino Designer Interface
Creating NSF Objects via the Domino Designer Interface
Procedure
Step 1 Open the Domino Designer interface to connect to the target Domino server.
Step 2 Log in using the LocalDomainAdmins account.
Step 3 Open the setup.nsf file locally and sign the following agents:
•Create IVConfig.nsf—Contains the Cisco IBM Lotus Notes Plug-in configuration screen.
•Create mail8_IV.ntf—New template file for scheduling meetings using the Cisco IBM Lotus Notes Plug-in.
Step 4 Locally create IVConfig.nsf as follows:
•Select the Create IVConfig.nsf agent and click Run.
•Select the IVConfig.dxl file provided on the Cisco Utilities and Documentation CD-ROM supplied with the product.
The agent completes the operation and IVConfig.nsf is created remotely.
Step 5 Remotely create mail8_IV.ntf as follows:
•Select the Create mail8_IV.ntf agent and click Run.
•Select the IVAgentLib.dxl file provided on the Cisco Utilities and Documentation CD-ROM supplied with the product.
The agent completes the operation and mail8_IV.ntf is created remotely.
Step 6 Close the Domino Designer interface
Configuring a Template via the Domino Administrator Interface
Procedure
Step 1 Open the Domino Administrator interface to connect to the target Domino server.
Step 2 Select File.
Step 3 Select the Properties window of mail8_IV.ntf template.
Step 4 Select Database file is master template.
Step 5 Select StdMail7_IV in the Template Name field.
Step 6 Close the Properties window.
Step 7 Save your changes.
Step 8 Close the Domino Administrator interface.
Configuring Forms and Script Libraries via the Domino Designer Interface
Procedure
Step 1 Open the Domino Designer interface to connect to the target Domino server.
Step 2 Log in using the LocalDomainAdmins account.
Step 3 Go to File > Database > Open.
Step 4 Select the remote Domino server that has the Cisco IBM Lotus Notes Plug-in installed from the Server list.
Step 5 Select and open the Mail (R8) IV Addon database from the Database list.
Step 6 Enter code into the _Calendar Entry Form as follows:
•Go to Top Menu > View > Go to > Forms for the Mail (R8) IV Addon database to display all forms in this database.
•Double-click _Calender Entry.
•Locate the Body field.
•Right-click above the Body field and select Insert Resource.
•Select - Current database - from the Database list.
•Select Subform from the Resource Type list.
•Select IVSubForm from the Available resources list.
•Click OK.
Step 7 Save and close the _Calendar Entry Form.
Step 8 Enter code into the ($Calendar) View as follows:
•Go to Top Menu > View > Go to > Views for the Mail (R8) IV Addon database to display all views in this database.
•Double-click ($Calendar).
•Verify that the View > Action Pane option is selected.
•Right-click Unfilter in the Action pane.
•Select Create Action.
•Enter Cisco Settings in the Name field.
•Select Hide action if formula is true in the second tab of the Action window.
•Click Formula Window.
•Paste the following code in the Edit Formula window:
@If(@TextToNumber(@Version) < 174;@True;@False) | @Environment("OEMClient") = "1" |
@IsNotMember("Notes_Video_conf_sched_group"; @UserNamesList)
•Close the Action window.
•Add the following code in the (Action): Click window:
@If(@ClientType = "Notes";@Command([Compose];"IVClientConfig") : @Return(0);"")
Step 9 Enter code into the _Calendar Entry Form as follows:
•Go to Top Menu > View > Go to > Forms for the Mail (R8) IV Addon database to display all forms in this database.
•Double-click _Calender Entry.
•Verify that the View > Programmer's Pane option is selected.
•Select (Global) Appointment > (Options) in the Objects tab.
•Add the following line to the code:
•Select Appointment (Form) > Queryopen in the Objects tab.
•Locate CSCalendarEntry and replace with IVCSWrapper.
•Save and close the form.
Step 10 Enter code into the CSUIViewClass Script Library as follows:
•Go to Top Menu > View > Go to > Script Libraries for the Mail (R8) IV Addon database to display all script libraries in this database.
•Double-click CSUIViewClass.
•Select CSUIViewClass > (Options) in the Objects tab.
•Add the following line to the code:
•Select CSUIViewClass > InitEventObject in the Objects tab.
•Locate CSEventNotes and replace with IVCalendarWrapper.
•Save and close the script library.
5 How to Configure the Cisco Unified Videoconferencing IBM Lotus Notes Plug-in
•Using a New Template
•Configuring Domino Web SSO
•Assigning an Execution Control List
Using a New Template
Procedure
Step 1 Create a user group called Notes_Video_conf_sched_group.
Any user that you assign to this group can see the user interface of the Cisco IBM Lotus Notes Plug-in.
Step 2 Use the Domino server console command to change the mail file template for all affected users.
For example, assume user John's mail file is John.nsf.
Send the following command from the Domino server console to convert the John.nsf template to mail8.ntf:
For Windows:
>> load convert mail\ John.nsf * mail8_IV.ntf
For Linux
>> load convert mail/ John.nsf * mail8_IV.ntf
Step 3 To change all the mail files in mail directory, send the following command:
For Windows:
>> load convert mail\*.nsf * mail8_IV.ntf
For Linux:
>> load convert mail/ *.nsf * mail8_IV.ntf
Configuring Domino Web SSO
The Web SSO configuration described here is R5 compatible.
Procedure
Step 1 Open the Domino Administrator interface to connect to the target Domino server.
Step 2 Click Configuration.
Step 3 Select Server > Current Server Document.
Step 4 Click Create Web and select SSO Configuration.
Step 5 Enter the Cisco Unified Videoconferencing Manager server DNS domain in the DNS Domain field.
For example, "mycompany.com".
Step 6 Verify that the Domino server with the Cisco IBM Lotus Notes Plug-in installed is configured in the Domino Server Names field.
For example, "Domino3/Test".
Step 7 Click Keys and select Create Domino SSO Key to generate a new key.
Step 8 Save your changes and close the Web SSO Configuration window.
Step 9 Select Server > Current Server Document.
Step 10 Click Internet Protocols.
Step 11 Click Domino Web Engine.
Step 12 Click Edit.
Step 13 Select Multiple Servers (SSO) in the Session authorization option.
Step 14 Select LtpaToken in the Set Web SSO Configuration option.
Step 15 Click Basics and verify that the Load Internet configurations from Server\Internet Sites documents field is set to Disabled.
Step 16 Click Save & Close to save your changes.
Assigning an Execution Control List
Assign an Execution Control List (ECL) to users so that they can execute the Cisco IBM Lotus Notes Plug-in client-side module.
Create a new policy which allows users to run the Cisco IBM Lotus Notes Plug-in, and then assign this policy to user group Notes_Video_conf_sched_group.
Procedure
Step 1 Open the Domino Administrator interface to connect to the target Domino server.
Step 2 Click Configuration.
Step 3 Select Policies > Create to create a new policy.
Step 4 Enter a name for the new policy in the Basics tab such as "IV_POLICY".
Step 5 Click New next to the Security field to create new security settings.
Step 6 Enter a name for the new security setting in the Basics tab such as "IV_SECURITY".
Step 7 Click Execution Control List.
Step 8 Set Update Mode to Replace.
Step 9 Click New next to Admin ECL.
Step 10 Select Allow user to modify.
Step 11 Select Workstation security.
Step 12 Select a workstation security setting for the domain admin user from the When signed by list, such as admin/Test.
Step 13 Select the following access options:
•Access to file system
•Access to current database
•Access to environment variables
•Access to external programs
•Ability to read other databases
•Ability to modify other databases
Step 14 Select Java applet security under Allow user to modify.
Step 15 Select all the Allow options.
Step 16 Click OK to save your changes and close the Execution Control List window.
Step 17 Click the People & Groups tab and select Groups.
Step 18 Right-click Notes_Video_conf_sched_group and select Assign Policy.
Step 19 Select IV_POLICY for this user group.
Step 20 Click OK to save your changes.
6 Configuring the Domino Server
Procedure
Step 1 Select File > Database > Open in the Lotus Notes interface.
Step 2 Select the remote Domino server that has the Cisco IBM Lotus Notes Plug-in installed from the Server list.
Step 3 Select and open the ivconfig database from the Database list.
Step 4 Configure the Cisco Unified Videoconferencing Manager or Desktop Server servers that end users can connect to for meeting scheduling in the Add Server section, as follows:
•Set the type of server URL that you want to add in the Server Type field.
•Enter a name for the server that you want to add in the Server Name field.
•Enter the server URL in the Server URL field.
For Cisco Unified Videoconferencing Manager use the format http://SERVER_URL:PORT_NUMBER
For Cisco Unified Videoconferencing Desktop use the format http://SERVER_URL:PORT_NUMBER/cuvm
•Click Add to List.
Step 5 (Optional) Click Remove from List to remove any defined server from the Select List section.
Step 6 (Optional) Click Check Server Status to verify that the server is reachable.
The server status is displayed in the Status field.
A server must be reachable for the Cisco IBM Lotus Notes Plug-in to function properly.
Step 7 (Optional) Click Generate Ltpa token in the Advanced section to verify that a secure communication mechanism has been properly configured between the Lotus Domino server and the Cisco Unified Videoconferencing Manager server working in Single Sign-on (SSO) mode.
If a new Ltpa token is displayed in the Status field, secure communication has been properly configured.
7 How to Uninstall the Cisco Unified Videoconferencing IBM Lotus Notes Plug-in
•Reverting to the Default Mail Template
•Removing the ivconfig Database
•Removing the mail8_iv Template
Reverting to the Default Mail Template
Procedure
Step 1 Use Domino server console command to change mail file template for all affected users.
For example, assume user John's mail file is John.nsf.
Send the following command from the Domino server console to convert the John.nsf template to mail8.ntf:
For Windows:
>> load convert mail\ John.nsf * mail8.ntf
For Linux
>> load convert mail/ John.nsf * mail8.ntf
Step 2 To change all the mail files in mail directory, send the following command:
For Windows:
>> load convert mail\*.nsf * mail8.ntf
For Linux:
>> load convert mail/ *.nsf * mail8.ntf
Removing the ivconfig Database
Procedure
Step 1 Open the Domino Administrator interface to connect to the target Domino server.
Step 2 Click File.
Step 3 Right-click ivconfig and select Delete Database.
Step 4 Select Also delete replicas of this database on all other servers.
Step 5 Click OK to delete this database.
Removing the mail8_iv Template
Procedure
Step 1 Open the Domino Administrator interface to connect to the target Domino server.
Step 2 Click File.
Step 3 Right-click Mail (R8) IV Addon and select Delete Database.
Step 4 Select Also delete replicas of this database on all other servers.
Step 5 Click OK to delete this template.
8 Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS Version 2.0.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0807R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2008 Cisco Systems, Inc. All rights reserved.
