Table Of Contents
Installing and Configuring the Cisco Unified MeetingPlace Integration for IBM Lotus Notes
Prerequisites for Installing the Cisco Unified MeetingPlace Integration for IBM Lotus Notes
Restrictions for Using the Cisco Unified MeetingPlace Release 8.5 Integration for IBM Lotus Notes
Reviewing System Requirements
Gathering Installation Values
Creating an IBM Lotus Notes Gateway Account
Moving the Mail Templates
Installing the Cisco Unified MeetingPlace Gateway for IBM Lotus Notes
How to Configure the Cisco Unified MeetingPlace Integration for IBM Lotus Notes for Automatic Authentication
Preparing the System for IBM Lotus Domino Authentication
Importing the User IDs
Verifying the Import
Setting the Authentication Method
Preparing to Configure the Mail and Database Templates
Copying the Mail and Database Templates and Java SSL Files to the IBM Lotus Domino Server
Setting Up the Database and Mail Templates for IBM Lotus Notes
Granting Permission to Run Agents on the IBM Lotus Domino Server
Signing the MeetingPlace Server Agent (MPSA) Database Template
Signing the Cisco Unified MeetingPlace Mail Template
Configuring SSL Support for IBM Lotus Notes
Installing the Sun SDK File
Adding Certificates to the IBM Lotus Domino Keystore
Editing the java.policy File
How to Configure the IBM Lotus Notes Gateway Account to Use the Mail Template
Configuring the Account From Cisco Unified MeetingPlace
Configuring the Account From the IBM Lotus Domino Server
How to Set up the MeetingPlace Server Agent (MPSA) Database for IBM Lotus Notes
Creating the MeetingPlace Server Agent (MPSA) Database
Accessing the Administration Interface for the MeetingPlace Server Agent (MPSA) Database
Assigning Access Control to the MeetingPlace Server Agent (MPSA) Database
Configuring the Design Properties for the MeetingPlace Server Agent (MPSA) Database
Adding a Cisco Unified MeetingPlace Profile to the MeetingPlace Server Agent (MPSA) Database
About Replicating the MeetingPlace Server Agent (MPSA) Database
Modifying the Cisco Unified MeetingPlace Server Settings
Enabling the Admin CleanUp Agent
How to Add Cisco Unified MeetingPlace Features to the IBM Lotus Notes Mail Template
Modifying the wPreferences Form
Adding the MPNewPassword Subform
Adding the MPCalendarEntry and MPNotice Subforms
Adding the Cisco Unified MeetingPlace Section to the Calendar Entry Form
Modifying the Calendar Profile Form
Adding New Cisco Unified MeetingPlace Script Libraries
Modifying the Notice Form
Modifying Existing Script Libraries
Adding the MeetingPlace Agent to the Mail Template
How to Migrate IBM Lotus Notes Users to Cisco Unified MeetingPlace
Migrating a Pilot Group to the Cisco Unified MeetingPlace Mail Template
Replacing the Standard Mail Template with the Cisco Unified MeetingPlace Mail Template
How to Update the System to Use the New Template
Manually Updating a Single System to Use the New Template
Updating the System to Use the New Template for All Users
How to Customize Meeting Notifications
About Using Multiple Notification Programs
About Meeting Notification Formats
About Notifications for Rescheduled Meetings
Notifications for Meetings Rescheduled From IBM Lotus Notes
Notifications for Meetings Rescheduled From Cisco Unified MeetingPlace
About Meeting Notification Templates
Customizing the Meeting Notification Templates
Troubleshooting IBM Lotus Notes for Cisco Unified MeetingPlace
Troubleshooting: What to Do First
Verifying That the Windows Services Are Running
Verifying That MPNotify and MPAgent Can Sign In
Checking the Windows Event Viewer for Errors
Resolving Error Messages
Error Messages Related to Joining Meetings
Error Messages Related to Scheduling Problems
Error Messages Related to Incorrect Profile Information
Error Messages Related to System Setup
Error Messages Related to Errors Validating a User Agent Execution Access
Error Messages Related to Java AccessControl
Error Messages Related to the Connection Between Cisco Unified MeetingPlace and IBM Lotus Domino
JavaScript Error Messages When Selecting the URL to Attend the Meeting
Error Messages Related to Installing the Lotus Notes Client
Troubleshooting Mail Template Settings
Resolving Scheduling Errors When the "Allow Internet Access" Option is Checked
Resolving Problems when LNNotify Does not Start
Resolving Java.io.fileNotFound Exception
Resolving Cross Certify Errors
Problems With Meeting Notifications
Problem Accessing Online Help From the "About This Database" Page
About Upgrading to the Cisco Unified MeetingPlace Release 8.5 Integration for IBM Lotus Notes
Obtaining Documentation and Submitting a Service Request
Integration Note
Installing and Configuring the Cisco Unified MeetingPlace Integration for IBM Lotus Notes
Release 8.5
Revised: July 28, 2011 6:25 pm
1 Prerequisites for Installing the Cisco Unified MeetingPlace Integration for IBM Lotus Notes
Note 
Multiple clusters are not supported for the IBM Lotus Notes integration with Cisco Unified MeetingPlace Release 8.5.
•Restrictions for Using the Cisco Unified MeetingPlace Release 8.5 Integration for IBM Lotus Notes
•Reviewing System Requirements
•Gathering Installation Values
•Creating an IBM Lotus Notes Gateway Account
•Moving the Mail Templates
Restrictions for Using the Cisco Unified MeetingPlace Release 8.5 Integration for IBM Lotus Notes
Be sure to communicate the following restrictions to users who schedule meetings from the Cisco Unified MeetingPlace Release 8.5 integration for IBM Lotus Notes:
•You cannot use the integration with deployments that use Cisco WebEx for scheduling. For a description of the different web deployments, see the Planning Guide for Cisco Unified MeetingPlace Release 8.5 at http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_implementation_design_guides_list.html
•Any invitees you add when scheduling from the Lotus Notes client do not display when viewing meeting details from the end-user web interface.
•The method of attending option to "Have system find user" is not supported for users who are invited to a meeting from Lotus Notes.
•The integration has the following limitations on the number of occurrences users can schedule of particular recurring meeting types:
Meeting recurrence type
|
Maximum number of meetings
|
Daily
|
200
|
Weekly
|
100
|
Bi-weekly
|
50
|
Monthly
|
23
|
Reviewing System Requirements
Before installing the Cisco Unified MeetingPlace Release 8.5 integration for IBM Lotus Notes, read the System Requirements for Cisco Unified MeetingPlace Release 8.5 at http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_device_support_tables_list.html.
Gathering Installation Values
Gather and record the information below to prepare for your installation of the Cisco Unified MeetingPlace Release 8.5 integration for IBM Lotus Notes.
Description
|
Your Value
|
The location of the notes.ini file for your IBM Lotus Notes account. This file is usually in C:\Lotus\Notes or C:\Program Files\Lotus\Notes.
Note You must already have run the IBM Lotus Notes client (that is, opened the client, connected to the IBM Lotus Domino Server, and closed the client) to create the notes.ini file.
Note The installation program only prompts you for the location of this file if it cannot find it or if it detects more than one .ini file on your system.
|
|
Hostname, IP address, or FQDN of the internal Cisco Unified MeetingPlace Web Server.
|
|
Hostname, IP address, or FQDN of the external Cisco Unified MeetingPlace Web Server.
|
|
Password for the IBM Lotus Notes account on the IBM Lotus Domino Server.
|
|
URL for the internal Cisco Unified MeetingPlace Web Server (required for the click-to-attend links).
|
|
URL for the external Cisco Unified MeetingPlace Web Server (required for the click-to-attend links).
If you did not install an external Web Server, enter the URL for the internal Web Server.
|
|
Creating an IBM Lotus Notes Gateway Account
This task describes how to create an account for the Cisco Unified MeetingPlace Release 8.5 gateway on the IBM Lotus Domino Server. You must create this account so that the gateway can access the IBM Lotus Notes application and send back-end notifications.
Tip If you have more than one Cisco Unified MeetingPlace Application Server, each with its own installation of the Release 8.5 integration for IBM Lotus Notes, create an IBM Lotus Notes gateway account for each installation with a unique identifying name, such as MP-Boston or MP-Atlanta.
Restriction
You must have Administrator permissions on the IBM Lotus Domino Server.
Procedure
Step 1 Sign in to the IBM Domino Administrator.
Step 2 Select the tab with the name of your domain (for example, CISCO_Domain).
Step 3 Select the People & Groups tab from the Domain tab.
Step 4 Select People from the left pane of the People & Groups tab.
Step 5 In the right pane of the People and Groups tab, select the arrow next to the People icon to expand the drop-down menu, then choose Register.
The system displays the Choose a Certifier window if this is the first time that you are registering a new account.
Step 6 Locate and choose the cert.id file.
•The default certifier ID is in C:\Program Files\IBM\Lotus\Notes\Domino\Data.
•If the path to the cert.id file does not appear next to the Certifier ID button, select Certifier ID to open the Choose Certifier ID window.
Step 7 Select Open.
Step 8 Select OK in the Choose a Certifier window when the cert.id file path is correct.
Step 9 Enter a new password for the certifier ID.
The system displays the Register Person window.
Step 10 Check Advanced to display all options on the page.
Step 11 Enter MeetingPlace in the Last name field.
We recommend that you leave the First name field blank. The system automatically populates the ShortName field, based on the First name and Last name values. The value in the ShortName field is used to name the mail database for this user account (for example, mail/MeetingPlace).
Step 12 Enter your password for this account.
Step 13 Select Password Options and adjust your Password Quality Scale.
Step 14 Check Set internet password, then select OK.
Step 15 Select Mail.
Step 16 Choose Manager from the Mail file owner access drop-down list.
Step 17 From the Mail file template list, choose the mail template that you want to associate with this account:
Name in the Mail file template list
|
Associated mail template
|
Mail(R8.5)
|
mail85.ntf
|
Mail(R8)
|
mail8.ntf
|
Mail(R7)
|
mail7.ntf
|
Mail(R6.5)
|
mail65.ntf
|
Mail(R6)
|
mail6.ntf
|
Step 18 Select the green checkmark button to add this user to the registration queue.
Step 19 Select Register, then Done.
Moving the Mail Templates
We recommend that you move your standard IBM Lotus Notes mail template to another directory to avoid causing confusion between this standard mail template and the Cisco Unified MeetingPlace mail templates. See the following table to figure out the name of your IBM Lotus Notes mail template:
IBM Lotus Domino Release
|
Name of Mail Template
|
Release 6
|
mail6.ntf
|
Release 6.5
|
mail65.ntf
|
Release 7
|
mail7.ntf
|
Release 8
|
mail8.ntf
|
Release 8.5
|
mail85.ntf
|
2 Installing the Cisco Unified MeetingPlace Gateway for IBM Lotus Notes
Before You Begin
•Complete all the tasks in the "Prerequisites for Installing the Cisco Unified MeetingPlace Integration for IBM Lotus Notes" section.
•You must have a user ID with administrator privileges to sign in to the Cisco Unified MeetingPlace Web Server.
•Install the applicable release of the IBM Lotus Notes client, which depends on the release of IBM Lotus Domino Server that you use.
Restrictions
•You must install the Cisco Unified MeetingPlace gateway for IBM Lotus Notes on the same hardware and in the same directory as the Cisco Unified MeetingPlace Web Server software. For example, if you install the Web Server software in the C:\Program Files\Cisco Systems directory, you must also install the Cisco Unified MeetingPlace Release 8.5 integration for IBM Lotus Notes in that directory.
•Passwords in the installer for the Release 8.5 integration are case-sensitive.
Note Multiple clusters are not supported for the IBM Lotus Notes integration for Cisco Unified MeetingPlace Release 8.5.
Procedure
Step 1 Insert the IBM Lotus Notes for Cisco Unified MeetingPlace Release 8.5 CD into the CD or DVD-ROM drive on the Cisco Unified MeetingPlace Web Server.
Step 2 Double-click the setup.exe file.
Step 3 Follow the instructions in the InstallShield wizard keeping the following in mind:
•You created the notes.ini file for the gateway account in the "Creating an IBM Lotus Notes Gateway Account" section. The system leaves the path blank if the installer cannot find or detects more than one notes.ini file on your system.
•You also created the password for the gateway account in the "Creating an IBM Lotus Notes Gateway Account" section.
Step 4 Select Finish on the last screen.
The system restarts the server.
What to Do Next
If your Cisco Unified MeetingPlace deployment includes two web servers or allows users to access external Cisco Unified MeetingPlace web meetings from their Lotus Notes client, install the Notes Gateway on the external server or manually copy all 33 Notes-related template files from the internal server located at C:\Program Files\Cisco Systems\MPWeb\Template to the same location on the external server.
3 How to Configure the Cisco Unified MeetingPlace Integration for IBM Lotus Notes for Automatic Authentication
You can improve the speed of the meeting scheduling process by configuring your IBM Lotus Domino Server to automatically authenticate users to Cisco Unified MeetingPlace. With automatic authentication, the IBM Lotus Domino Server can pass user IDs to Cisco Unified MeetingPlace for verification whenever a user schedules a meeting. If the user IDs on both systems match, the system automatically signs users in to Cisco Unified MeetingPlace.
Without automatic authentication, users must enter their Cisco Unified MeetingPlace user IDs and passwords in the calendar entry form when they schedule a Cisco Unified MeetingPlace meeting.
•Preparing the System for IBM Lotus Domino Authentication
•Importing the User IDs
•Verifying the Import
•Setting the Authentication Method
Preparing the System for IBM Lotus Domino Authentication
Before You Begin
You must have a user ID with administrator privileges to sign in to the Cisco Unified MeetingPlace Web Server.
Procedure
Step 1 Sign in to the Cisco Unified MeetingPlace Web Server as an administrator.
Step 2 Select Start > Control Panel > Administrative Tools > Component Services.
Step 3 Select console root > Component Services > Computers > My Computer > DCOM Config > LNNotify from the left pane.
Step 4 Right-click LNNotify and select Properties.
Step 5 Select the Security tab.
Step 6 Select Customize from Launch and Activation Permissions.
Step 7 Select Edit.
Step 8 Highlight the user ID called Local Service.
Step 9 Grant the Local Service user ID Local Launch and Local Activation permissions.
Step 10 Select OK twice.
Importing the User IDs
Restriction
You must configure the Cisco Unified MeetingPlace system to use Cisco Unified MeetingPlace authentication before you can enable IBM Lotus Domino authentication. IBM Lotus Notes does not support other authentication methods, such as Windows Integrated Authentication (WIA). For information on authentication, see the Configuration Guide for Cisco Unified MeetingPlace Release 8.5 or the online help in the administrator interface.
Before You Begin
You must have a user ID with administrator privileges to sign in to the IBM Lotus Domino Server.
Procedure
Step 1 Sign in to the IBM Lotus Domino Server as an administrator.
Step 2 Use one of the following methods to enter Cisco Unified MeetingPlace user IDs:
•Import the Cisco Unified MeetingPlace user IDs.
•Import the IBM Lotus Domino address book ShortName field into the Cisco Unified MeetingPlace profile of each user as their user ID.
Note Although any IBM Lotus Domino address book field can contain a Cisco Unified MeetingPlace user ID, we recommend using the ShortName field because it contains unique values, and has configurable security settings. If you decide to use another field that contains multiple values, make sure that the Cisco Unified MeetingPlace user ID is listed first. By default, Cisco Unified MeetingPlace uses the first value in the field for authentication.
Step 3 Set the security option in the ShortName field to Must Have at Least Editor Access to Use. This prevents users from changing their user IDs and signing in to Cisco Unified MeetingPlace as someone else.
Related Topics
For information about how to import Cisco Unified MeetingPlace user IDs, see the "Raw Data Export and Import Specifications" module in the Configuration Guide for Cisco Unified MeetingPlace Release 8.5 at http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_installation_and_configuration_guides_list.html
Verifying the Import
Before You Begin
You must have a user ID with administrator privileges to sign in to the Cisco Unified MeetingPlace Web Server.
Procedure
Step 1 Sign in to the Cisco Unified MeetingPlace Web Server.
Step 2 Open the Gateways Configuration utility.
Step 3 Select the Notes Gateway tab.
Step 4 Verify that the authentication field contains the Cisco Unified MeetingPlace user IDs.
Step 5 Close the Gateway Configuration utility.
Setting the Authentication Method
Before You Begin
You must have user IDs with administrator privileges to sign in to the IBM Lotus Domino Server, IBM Lotus Notes Server, and Cisco Unified MeetingPlace Administration Center.
Procedure
Step 1 Sign in to the IBM Lotus Domino Server as an administrator.
Step 2 Open the MeetingPlace Server Agent (MPSA) database.
Step 3 Select Use Domino Authentication.
Step 4 Select Save, then Close.
Step 5 Open a web browser.
Step 6 Connect to the Cisco Unified MeetingPlace Web Server by entering http://hostname, where hostname is the hostname of the internal Web Server.
Step 7 Select Sign In and enter an administrator username and password.
Step 8 Select Admin.
Step 9 Select Web Server.
Step 10 From the Web Server Administration page, select the name of your server on the bottom half of the page. Server information populates the top half of the page.
Step 11 Choose Yes in Set Trust Web Server Authentication.
Step 12 Select Web Server Name in the View area.
Step 13 Scroll to the Web Authentication area.
Step 14 Choose Web Page Form in Step 2: Login Method.
Step 15 Select Submit.
Step 16 Exit Cisco Unified MeetingPlace.
Tip After you synchronize the user IDs on Cisco Unified MeetingPlace and IBM Lotus Domino, you can develop a process to ensure that all new users have a Cisco Unified MeetingPlace profile. By developing scripts and using the Cisco Unified MeetingPlace import capabilities, you can automate this process so that IBM Lotus Domino and Cisco Unified MeetingPlace are synchronized. For information about how you can use scripts to update the Cisco Unified MeetingPlace database, contact Cisco Technical Support.
4 Preparing to Configure the Mail and Database Templates
•Copying the Mail and Database Templates and Java SSL Files to the IBM Lotus Domino Server
•Setting Up the Database and Mail Templates for IBM Lotus Notes
Copying the Mail and Database Templates and Java SSL Files to the IBM Lotus Domino Server
Copy the mail and database templates and the Java SSL files to the IBM Lotus Domino Server data directory where they will be used to set up the database and templates on your Cisco Unified MeetingPlace Web Server. These files are located in the drive:\Program Files\Cisco Systems\Cisco MeetingPlace for Notes\Files directory.
File
|
Description
|
MPSA.ntf
MPSA_SSL.ntf
|
The database template.
•Use the file called MPSA.ntf if you do not want to set up SSL support.
•Use the file called MPSA_SSL.ntf if you do want to set up SSL support.
|
mailxx_xxMP.ntf
|
The Cisco Unified MeetingPlace mail template for the version of IBM Lotus Notes that you are using:
•mail60_05MP.ntf
•mail65_5MP.ntf
•mail65_6MP.ntf
•mail70_2MP.ntf
•mail70_3MP.ntf
•mail80_01MP.ntf
•mail80_0MP.ntf
•mail85_0MP.ntf
|
jcert.jar
jnet.jar
jsse.jar
|
Additions to the Java setup for IBM Lotus Domino. These files allow you to support SSL.
|
Before You Begin
•Sign in to the Cisco Unified MeetingPlace Application Server as an administrator.
•Use FTP to connect to the IBM Lotus Domino Server.
•Sign in to the IBM Lotus Domino Server with a user ID that has rwx privileges in the Lotus\Domino\Data directory.
Procedure
Step 1 Copy the following files to your IBM Lotus Domino Server:
•If you do not want to set up SSL support, copy the MPSA.ntf and mailxx_xxMP.ntf files to the Lotus\Domino\Data directory on your IBM Lotus Domino Server.
•If you do want to set up SSL support, copy the MPSA_SSL.ntf and mailxx_xxMP.ntf files to the Lotus\Domino\Data directory on your IBM Lotus Domino Server. Copy the three Java extension files (jcert.jar, jnet.jar, jsse.jar) to the Lotus\Domino\jvm\lib\ext directory on your IBM Lotus Domino Server.
Step 2 Enter Exit at the console command prompt.
Step 3 Choose Start > Programs > Lotus Applications > Domino Server to restart the IBM Lotus Domino Server.
Setting Up the Database and Mail Templates for IBM Lotus Notes
•Granting Permission to Run Agents on the IBM Lotus Domino Server
•Signing the MeetingPlace Server Agent (MPSA) Database Template
•Signing the Cisco Unified MeetingPlace Mail Template
Granting Permission to Run Agents on the IBM Lotus Domino Server
Agents are the background processes in the Cisco Unified MeetingPlace plug-in for the IBM Lotus Notes integration that run on the IBM Lotus Domino Server. You must grant permission so that the agents can run on the server.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Administrator.
•Select your Domain tab (for example, CISCO_Domain).
Procedure
Step 1 Select Configuration.
Step 2 Expand the Server view.
Step 3 Select Current Server Document.
Step 4 Select Security in the right pane.
Step 5 Double-click the page to bring it in to edit mode.
Step 6 Scroll to the right until you see the Programmability Restrictions area.
Step 7 In the Who Can column next to the following restrictions, add MeetingPlace to give yourself these permissions:
•Run unrestricted methods and operations
•Run restricted LotusScript/Java agents
Step 8 Select Save & Close.
Signing the MeetingPlace Server Agent (MPSA) Database Template
You must sign the MeetingPlace Server Agent (MPSA) database template to verify that it has permissions to run agents on the IBM Lotus Domino Server.
Before You Begin
•Copy the MeetingPlace Server Agent (MPSA) database template to the IBM Lotus Domino Server. See the "Copying the Mail and Database Templates and Java SSL Files to the IBM Lotus Domino Server" section.
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Administrator.
•Select your Domain tab (for example, CISCO_Domain).
Procedure
Step 1 Select Files.
Step 2 Choose Templates Only.
Step 3 Right-click the file name of the MeetingPlace Server Agent (MPSA) database template (either MPSA.ntf or MPSA_SSL.ntf).
Step 4 Choose Sign.
Step 5 Select All Design Documents, then select OK.
Signing the Cisco Unified MeetingPlace Mail Template
Before You Begin
•Copy the mail template to the IBM Lotus Domino Server. See the "Copying the Mail and Database Templates and Java SSL Files to the IBM Lotus Domino Server" section.
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Administrator.
•Select your Domain tab (for example, CISCO_Domain).
Procedure
Step 1 Select Files.
Step 2 Choose Templates Only.
Step 3 Right-click the file name of the Cisco Unified MeetingPlace mail template (such as mail70_2MP.ntf or mail85_0MP.ntf).
Step 4 Choose Sign, then select OK.
Note To access the Cisco Unified MeetingPlace mail template from other IBM Lotus Domino Servers, replicate the mail template file to those servers. See the IBM Lotus Domino documentation for information about replicating files.
5 Configuring SSL Support for IBM Lotus Notes
Secure Socket Layer (SSL) increases the security of your transmissions by enabling HTTPS encryption. For HTTPS encryption to function properly, you must configure both IBM Lotus Domino and Cisco Unified MeetingPlace for SSL authentication. See the Configuration Guide for Cisco Unified MeetingPlace Release 8.5 or the online help in the administrator interface for information on configuring SSL support for Cisco Unified MeetingPlace.
•Installing the Sun SDK File
•Adding Certificates to the IBM Lotus Domino Keystore
•Editing the java.policy File
Installing the Sun SDK File
The Sun SDK file provides the keytool.exe tool which is used for importing certificates.
Before You Begin
•Copy the three .jar files onto your IBM Lotus Domino Server. See the "Copying the Mail and Database Templates and Java SSL Files to the IBM Lotus Domino Server" section.
•Sign in to the IBM Lotus Domino Server as an administrator.
Procedure
Step 1 Open a web browser.
Step 2 Navigate to http://java.sun.com/j2se/1.4.2/download.html.
Step 3 Select Download J2SE SDK.
Step 4 Select a platform.
Step 5 Select the option to agree to the license agreement.
Step 6 Select Continue.
Step 7 Choose a download file from the Windows Platform area.
Step 8 Follow the prompts until the file is completely downloaded.
Adding Certificates to the IBM Lotus Domino Keystore
After you obtain your certificates, use the keytool.exe tool to add the certificates to the list of trusted certificates (also called your keystore) on your IBM Lotus Domino Server. Your keystore is the cacerts file in the Lotus\Domino\jvm\lib\security directory of your IBM Lotus Domino Server.
For more information about obtaining certificates, see the Configuration Guide for Cisco Unified MeetingPlace Release 8.5 or the online help in the administrator interface.
Before You Begin
Sign in to the Cisco Unified MeetingPlace Web Server as an administrator.
Procedure
Step 1 Use FTP or a similar program to copy your certificate file from the Cisco Unified MeetingPlace Web Server to the IBM Lotus Domino Server.
Step 2 Sign in to the IBM Lotus Domino Server as an administrator.
Step 3 Choose Start > Run.
Step 4 Enter cmd.
Step 5 Select OK.
Step 6 Enter the following command, replacing values as indicated below:
<path>\jre\bin\keytool -import -alias [any_alias] -file [your_certificate.cer] -keystore [cacerts]
Replace
|
With
|
path
|
The path to your Java SDK files (for example, c:\j2sdk1.4.2_03)
|
any_alias
|
The alias that you are applying to the certificate (for example, WebHomePageCertificate). This is how your certificate will be listed in the keystore.
|
your_certificate.cer
|
The path to your .cer file for the Home Page hostname (for example, c:\temp\webhomepage.cer)
|
cacerts
|
The path to the cacerts file on your IBM Lotus Domino Server (for example, c:\Lotus\Domino\jvm\lib\ security\cacerts). cacerts is the name of your keystore.
|
For example:
c:\j2sdk1.4.2_03\jre\bin\keytool -import -alias Ciscocertificate -file c:\temp\newcertificate.cer -keystore c:\Lotus\Domino\jvm\lib\security\cacerts
Note Enter the default password, changeit, if your IBM Lotus Domino cacerts file requires a password.
Step 7 Enter yes at the IBM Lotus Notes client prompt.
Step 8 Repeat Step 6, replacing any_alias with a new alias and replacing your_certificate.cer with the path to your .cer file for the server hostname.
Step 9 Repeat Step 7.
Step 10 Close the command-line interface.
Editing the java.policy File
The java.policy file contains permissions to set the system properties. Edit this file to enable the MeetingPlace Server Agent (MPSA) database to be able to communicate over HTTPS with the IBM Lotus Notes for Cisco Unified MeetingPlace gateway.
Before You Begin
Sign in to the IBM Lotus Domino Server as an administrator.
Procedure
Step 1 Navigate to drive:\Lotus\Domino\jvm\lib\security.
Step 2 Double-click the java.policy file to open it in Notepad.
Step 3 Add the following line to the end of the file just before the closing brace (which looks like this "};")
permission java.util.PropertyPermission "java.protocol.handler.pkgs", "write";
Step 4 Save and close the file.
6 How to Configure the IBM Lotus Notes Gateway Account to Use the Mail Template
In the "Creating an IBM Lotus Notes Gateway Account" section, you created a dedicated account that will be used to access IBM Lotus Notes and to send back-end notifications. This section describes how to configure this account to use the Cisco Unified MeetingPlace mail template that you set up in the "Setting Up the Database and Mail Templates for IBM Lotus Notes" section.
Complete either of the following two procedures:
•Configuring the Account From Cisco Unified MeetingPlace
•Configuring the Account From the IBM Lotus Domino Server
Configuring the Account From Cisco Unified MeetingPlace
Note You only need to perform one procedure: either this one or the procedure in the "Configuring the Account From the IBM Lotus Domino Server" section.
Before You Begin
Sign in to the Cisco Unified MeetingPlace Web Server as an administrator.
Procedure
Step 1 Choose Start > Control Panel > Administrative Tools > Services.
Step 2 Stop the Cisco Unified MeetingPlace Notification Gateway service called MPNotify.
Note The Cisco Unified MeetingPlace for Notes Gateway service (called LNNotify) also stops when you stop MPNotify. For information about stopping services, see the Configuration Guide for Cisco Unified MeetingPlace Release 8.5 or the online help in the administrator interface.
Step 3 Open IBM Lotus Notes.
Step 4 Select Calendar.
Step 5 Choose File > Database > Replace Design.
Step 6 Choose the IBM Lotus Domino Server that contains your Cisco Unified MeetingPlace templates.
Step 7 Choose your Cisco Unified MeetingPlace mail template and select Replace.
Step 8 Complete the following steps:
a. Choose Tools > Preferences.
b. Select MeetingPlace.
c. Enter a username and password.
d. Choose a default server.
e. Select OK.
Step 9 Restart the LNNotify and MPNotify services.
Configuring the Account From the IBM Lotus Domino Server
Note You only need to perform one procedure: either this one or the procedure in the "Configuring the Account From Cisco Unified MeetingPlace" section.
Before You Begin
Sign in to the IBM Lotus Domino Server as an administrator.
Procedure
Step 1 Open a command-line interface window on the IBM Lotus Domino Server.
Step 2 Enter the following command:
load convert mail/mail_database * mail_template
Variable
|
Description
|
mail_database
|
The name of your mail database on the Web Server, for example, meetingplace.nsf.
|
mail_template
|
The name of your Cisco Unified MeetingPlace mail template, for example, mail85_0mp.ntf.
|
Note If you create another IBM Lotus Notes user, specify the Cisco Unified MeetingPlace mail template (mailxx_xxmp.ntf) you chose in this procedure as the default mail template.
7 How to Set up the MeetingPlace Server Agent (MPSA) Database for IBM Lotus Notes
The MeetingPlace Server Agent (MPSA) database, called MPSA.nsf, enables all communication between IBM Lotus Notes and Cisco Unified MeetingPlace. Use the MPSA.ntf template (or the MPSA_SSL.ntf template if you are using SSL) as the basis for the new database.
Tip Files with the .nsf suffix are databases and files with the .ntf suffix are database templates.
•Creating the MeetingPlace Server Agent (MPSA) Database
•Accessing the Administration Interface for the MeetingPlace Server Agent (MPSA) Database
•Assigning Access Control to the MeetingPlace Server Agent (MPSA) Database
•Configuring the Design Properties for the MeetingPlace Server Agent (MPSA) Database
•Adding a Cisco Unified MeetingPlace Profile to the MeetingPlace Server Agent (MPSA) Database
•About Replicating the MeetingPlace Server Agent (MPSA) Database
•Modifying the Cisco Unified MeetingPlace Server Settings
•Enabling the Admin CleanUp Agent
Creating the MeetingPlace Server Agent (MPSA) Database
Before You Begin
Open IBM Lotus Domino Administrator.
Procedure
Step 1 Choose File > Application > New.
Step 2 Choose the name of the IBM Lotus Domino Server to which you are signed in. The server is the location for the new database.
Step 3 Enter MeetingPlace Server Agent for the title.
Step 4 Enter MPSA.nsf for the file name.
Step 5 Choose the IBM Lotus Domino Server that contains your database template.
Step 6 Choose MeetingPlace Server Agent from the list of available templates.
Step 7 Check Inherit future design changes, then select OK.
Step 8 With the newly created MeetingPlace Server Agent database open, choose File > Application > Access Control.
Step 9 Choose Default from the list of Access Control List entries.
Step 10 Select at least Editor access in the Access field.
Accessing the Administration Interface for the MeetingPlace Server Agent (MPSA) Database
Before You Begin
Complete the procedure in the "Creating the MeetingPlace Server Agent (MPSA) Database" section.
Procedure
Step 1 Select the tab with your domain name, for example, CISCO_Domain.
Step 2 Choose File > Application > Open.
Step 3 Choose your IBM Lotus Domino Server from the Open Application window.
Step 4 Enter MPSA.nsf for the file name.
Step 5 Select Open.
Step 6 If a new tab opens, select the X in the corner to close it.
Step 7 Select Administration from the left pane of the MeetingPlace Server Agent window.
Step 8 Select Edit/Create Profile Document from the right pane.
You are now in the Administration Interface.
Assigning Access Control to the MeetingPlace Server Agent (MPSA) Database
Assign access control to the MeetingPlace Server Agent (MPSA) database to give users permissions to access the database.
Before You Begin
Complete the procedure in the "Creating the MeetingPlace Server Agent (MPSA) Database" section.
Procedure
Step 1 Select the tab with your domain name, for example, CISCO_Domain.
Step 2 Select Files.
Step 3 Choose Databases Only from the Show Me field on the top right.
Step 4 Choose MeetingPlace Server Agent. If you do not see the MeetingPlace Server Agent database in your list of databases, refresh the page.
Step 5 Right-click the database and choose Access Control > Manage.
The system opens the Access Control List window. The accounts are listed in the center of the window below People, Servers, Groups.
Step 6 Choose Default.
Step 7 Highlight Author for the Default account in the Access field.
Step 8 Select MeetingPlace from the account list.
Step 9 Highlight Manager from the Access field. Keep the MeetingPlace account highlighted.
Step 10 Verify in the Roles area in the bottom-right corner that the Administrator role is checked.
Step 11 Complete the following actions if the Administer role is not listed:
a. Select Roles.
b. Highlight Administrator.
c. Select Add.
d. Go back to the Basics tab and select Administrator.
Step 12 Select OK.
Configuring the Design Properties for the MeetingPlace Server Agent (MPSA) Database
Before You Begin
Complete the procedure in the "Assigning Access Control to the MeetingPlace Server Agent (MPSA) Database" section.
Procedure
Step 1 Select the MeetingPlace Server Agent database from the Files tab.
Step 2 Choose File > Application > Properties.
Step 3 Select the tab that sets the design properties.
Step 4 Verify that the following parameters are unchecked:
•List in Database Catalog
•Show in `Open Database' dialog
Adding a Cisco Unified MeetingPlace Profile to the MeetingPlace Server Agent (MPSA) Database
To schedule meetings from IBM Lotus Notes, you must provide the MeetingPlace Server Agent (MPSA) database with the URLs of the Cisco Unified MeetingPlace internal and external Web Servers.
Before You Begin
Complete the procedure in the "Configuring the Design Properties for the MeetingPlace Server Agent (MPSA) Database" section.
Procedure
Step 1 Update your Cisco Unified MeetingPlace account with the permissions you assigned earlier by closing and reopening the MeetingPlace Server Agent database.
Step 2 Choose File > Application > Open.
Step 3 Choose your IBM Lotus Domino Server.
Step 4 Enter MPSA.nsf for the file name.
Step 5 Select Open.
Step 6 If a new tab opens, select the X in the corner to close it.
Step 7 Select Administration in the left pane.
Step 8 Choose Edit/Create Profile Document in the right pane.
Step 9 Select Add Server.
Step 10 Fill in the following fields:
Parameter
|
Description
|
MeetingPlace Server Name
|
The name of the Cisco Unified MeetingPlace Web Server that you want users to see on the Calendar Entry form when they schedule a meeting.
|
MeetingPlace Web CGI URL
|
The URL of the internal Web Server in the format http://host_name/mpweb/scripts/mpx.dll, where host_name is the hostname or IP address of the internal Cisco Unified MeetingPlace Web Server.
|
External MeetingPlace Web CGI URL
|
The URL of the external Web Server in the format http://host_name/mpweb/scripts/mpx.dll, where host_name is the hostname or IP address of the external Cisco Unified MeetingPlace Web Server.
|
Notes Account for MeetingPlace
|
The name of the IBM Lotus Notes account for Cisco Unified MeetingPlace on the IBM Lotus Domino Server. For example, you can call this account MPNotes.
|
Use SSL (https)
Note There are two boxes: one next to the MeetingPlace Web CGI URL field and one next to the External MeetingPlace Web CGI URL field.
|
Check these boxes if you are using the SSL version of the template.
|
Step 11 Select OK.
Step 12 Choose Save and Close.
Step 13 Repeat Step 9 through Step 12 for each additional Cisco Unified MeetingPlace Web Server.
About Replicating the MeetingPlace Server Agent (MPSA) Database
If you have multiple IBM Lotus Domino Servers, use the Replication feature to replicate the MeetingPlace Server Agent (MPSA) database to the other IBM Lotus Domino Servers. See the online help for IBM Lotus Notes for information on doing this.
Modifying the Cisco Unified MeetingPlace Server Settings
The toolbar at the top of the Cisco Unified MeetingPlace system profile document allows you to add Cisco Unified MeetingPlace Web Servers and modify or delete existing ones. You added the Cisco Unified MeetingPlace system profile document in the "Adding a Cisco Unified MeetingPlace Profile to the MeetingPlace Server Agent (MPSA) Database" section.
When you add a Cisco Unified MeetingPlace Web Server, users can choose it from the server list display on the IBM Lotus Notes calendar entry form.
Before You Begin
Complete the procedure in the "Accessing the Administration Interface for the MeetingPlace Server Agent (MPSA) Database" section.
Procedure
Step 1 Complete one of the following actions:
•Select Add Server to add a Web Server.
•Select Modify Server to edit an existing Web Server.
Step 2 Enter or edit values. The following table describes the values.
Parameter
|
Description
|
Type of web conference server
|
Controls whether users see Cisco Unified MeetingPlace options or IBM Lotus Sametime online meeting options when configuring the web portion of a meeting. In either case, users can configure a Cisco Unified MeetingPlace meeting.
Note The system does not display the Allow Internet Access field if you select IBM Lotus Sametime.
|
Number of minutes before a meeting begins for the connect button to appear (Reservationless Only)
|
The number of minutes that the system displays the Connect button for reservationless meetings.
|
Hide Meeting Password field
|
Prevents users from assigning passwords to the meetings that they schedule.
|
Hide Billing Code field
|
Prevents users from entering a billing code for the meetings they schedule.
Uncheck this field if users need to specify billing codes on a per-meeting basis. Otherwise, Cisco Unified MeetingPlace uses the billing code listed in the profile of the meeting scheduler.
|
Hide Number of Participants field
|
Prevents users from specifying the number of callers for the meetings they schedule.
|
Hide Entry Announcement field
|
Prevents users from changing the entry announcement options for the meetings they schedule. By default, Cisco Unified MeetingPlace automatically sets up meetings based on the preferences specified in the scheduler profile. Displaying this field in the scheduling form allows the meeting scheduler to change the entry announcement options on a per-meeting basis.
|
Hide Departure Announcement field
|
Prevents users from changing the departure announcement options for the meetings they schedule. By default, Cisco Unified MeetingPlace automatically sets up meetings based on the preferences specified in the scheduler profile. Displaying this field on the scheduling form allows the meeting scheduler to change the departure announcement options on a per-meeting basis.
|
Hide Enable Recording field
|
Prevents users from recording meetings.
|
Hide Screened Entry field
|
Prevents users from using the screened entry option when scheduling meetings.
|
Hide Publicly Listed Meeting field
|
Prevents users from determining whether their individual meetings are listed on the Cisco Unified MeetingPlace search page. Instead, this determination is based on the default settings in their user profile.
|
Hide Allow Internet Access field
|
Prevents users from determining whether their individual meetings can be accessed from the Internet.
|
Make Meetings Web Only
|
Removes the following fields from the Calendar Entry template:
•Call Me
•Phone number
•Entry announcement
•Departure announcement
•Number of locations
•Record this meeting
This is a system-wide setting. If you have multiple Cisco Unified MeetingPlace systems, all systems will be affected. However, this setting only applies to Cisco Unified MeetingPlace. It does not change the web interface through the click-to-attend link.
|
Hide Who Can Attend field
|
Prevents users from choosing the user types who have access to meetings.
|
Hide Who Can Access MeetingNotes field
|
Prevents users from choosing the user types who have access to attachments and recordings associated with meetings.
|
Step 3 To customize the subject line that appears in all meeting notifications, enter or edit values in the following fields:
Parameter
|
Description
|
MeetingPlace Subject Prefix
|
Text entered in this field appears in the beginning of the notification subject line. To help users identify that they have been invited to a Cisco Unified MeetingPlace meeting, enter text such as MeetingPlace Meeting or Online Meeting in this field.
|
MeetingPlace Subject Postfix
|
Text entered in this field appears at the end of the notification subject line.
|
MeetingPlace Call Label
|
Text entered in this field appears before the Cisco Unified MeetingPlace phone number in the notification subject line. Use this parameter to enter a description, such as MeetingPlace Phone Number.
|
MeetingPlace Meeting ID Label
|
Text entered in this field appears before the meeting ID in the notification subject line. Use this parameter to enter a description, such as Meeting ID.
|
Step 4 Check Use Domino Authentication to enable the IBM Lotus Domino authentication feature. See the "How to Configure the Cisco Unified MeetingPlace Integration for IBM Lotus Notes for Automatic Authentication" section for information.
Step 5 Enter or edit the value for Max adv days:
•Max adv days: Determines how far in the future a user can schedule a meeting. A user cannot schedule a repeating meeting chain that extends past the number of days specified in this field.
Step 6 Enter a value in the Remove messages older than parameter field to periodically clean out the Cisco Unified MeetingPlace mailbox. The system cleans out messages older than the value you enter whenever the Admin CleanUp Agent runs. See the "Enabling the Admin CleanUp Agent" section for information.
Enabling the Admin CleanUp Agent
Before You Begin
Complete the procedure in the "Accessing the Administration Interface for the MeetingPlace Server Agent (MPSA) Database" section.
Procedure
Step 1 Choose File > Application > Open.
Step 2 Open the MPSA.nsf database.
Step 3 Navigate to Shared Code > Agents > Admin CleanUp.
Step 4 Double-click Admin CleanUp.
Step 5 Select Schedule in the Runtime area.
Step 6 Change the Start Running Agent At parameter to a time you wish to run this agent, then select OK.
Step 7 Close the agent.
Step 8 Choose Yes to confirm.
Step 9 With the agent name highlighted, select Enable.
Step 10 Choose the server on which you want to run this agent, then select OK.
8 How to Add Cisco Unified MeetingPlace Features to the IBM Lotus Notes Mail Template
You add Cisco Unified MeetingPlace features to the IBM Lotus Notes client interface by modifying the default IBM Lotus Notes mail template.
•Modifying the wPreferences Form
•Adding the MPNewPassword Subform
•Adding the MPCalendarEntry and MPNotice Subforms
•Adding the Cisco Unified MeetingPlace Section to the Calendar Entry Form
•Modifying the Calendar Profile Form
•Adding New Cisco Unified MeetingPlace Script Libraries
•Modifying the Notice Form
•Modifying Existing Script Libraries
•Adding the MeetingPlace Agent to the Mail Template
Modifying the wPreferences Form
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf template.
Step 2 Choose the wPreferences form.
Step 3 Locate the Calendar section. It contains three hotspots: FreeTime, Entries, and AutoProcess. Hotspots are URLs that can be programmed.
Step 4 Move the cursor to the end of the hotspot list.
Step 5 Enter MeetingPlace as a new hotspot.
Step 6 Double-click the new MeetingPlace hotspot.
Step 7 Choose Create > HotSpot > Action Hotspot.
Step 8 Select the lower-right pane.
Step 9 Enter the following formula to program the hotspot:
a. REM "DNT";
b. @If($PreferencesPage = "MeetingPlace"; @Return(""); "");
c. FIELD $PreferencesPage := "MeetingPlace";
d. @Command([RefreshHideFormulas])
Step 10 Save the mailx.ntf template.
Adding the MPNewPassword Subform
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Choose Shared Code > SubForms in the mailxx_xMP.ntf template to display the subforms.
Step 3 Select Edit > Copy.
Step 4 Highlight the MPNewPassword subform.
Step 5 Switch to mailx.ntf.
Step 6 Select Edit > Paste to add the subform in to the corresponding subform list for mailx.ntf.
Step 7 Save the mailx.ntf template.
Adding the MPCalendarEntry and MPNotice Subforms
Before You Begin
Sign in to the IBM Lotus Domino Server as an administrator.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Choose Shared Code > SubForms in the mailxx_xMP.ntf template to display the subforms.
Step 3 Choose Edit > Copy.
Step 4 Select and copy the MPCalendarEntry and MPNotice subforms.
Step 5 Switch to mailx.ntf.
Step 6 Choose Edit > Paste.
Step 7 Paste the subform into the corresponding subform list for mailx.ntf.
Tip Press the Ctrl key to select multiple subforms simultaneously.
Step 8 Save the mailx.ntf template.
Adding the Cisco Unified MeetingPlace Section to the Calendar Entry Form
You must modify the calendar entry form so that users who are scheduling meetings can see the Cisco Unified MeetingPlace fields.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Choose the Calendar Entry form in the mailx.ntf template.
Step 3 Scroll to the Scheduler area of the Calendar Entry form.
Step 4 Click in the space above the Scheduler area to create an insertion point.
Step 5 Choose Create > Resources > Insert Subform.
Step 6 Choose MPCalendarEntry, then select OK.
Step 7 Save the mailx.ntf template.
Modifying the Calendar Profile Form
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Choose the Calendar Profile form in the mailxx_xMP.ntf template.
Step 3 Select MP_ServerNames and MP_ServerAddress. The fields are in the last row of fields at the top of the mailxx_xMP.ntf template.
Step 4 Choose Edit > Copy.
Step 5 Switch to the mailx.ntf template.
Step 6 Add a line after the last row of fields at the top of the Calendar Profile form.
Step 7 Choose Edit > Paste.
Step 8 Paste the two Cisco Unified MeetingPlace fields in the Calendar Profile form.
Step 9 Select Calendar & To Do.
Step 10 Select MeetingPlace.
Step 11 Select all text and fields on this tab.
Step 12 Choose Edit > Copy.
Step 13 Switch to the mailx.ntf template.
Step 14 Insert a row:
a. Select Calendar & To Do.
b. Select To Do.
c. Click inside the tab.
d. Choose Table > Insert Row.
Step 15 Create a tab:
a. Click inside the new row.
b. Right-click and choose Table Properties.
c. Select Table Rows.
d. Enter MeetingPlace in Tab Label and Caption.
e. Close Properties.
Step 16 Configure the MeetingPlace tab properties.
a. Click inside the MeetingPlace tab.
b. Choose Edit > Paste.
c. Select Yes.
Step 17 Save the mailx.ntf template.
Adding New Cisco Unified MeetingPlace Script Libraries
Restriction
•Do not modify existing IBM LotusScript code, other than what is described in this document. Only add the Cisco Unified MeetingPlace code sections to existing code in the template.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Select Script Libraries in the Shared Code folder of the mailxx_xMP.ntf template to display the list of Script Libraries in the right pane.
Step 3 Locate the following Cisco Unified MeetingPlace script libraries:
•MeetingPlace
•MeetingPlaceBackGround
•MeetingPlaceBackGroundWeb
•MeetingPlaceGlobal
•MeetingPlaceWeb
Step 4 Press Shift+Click to select all the libraries.
Step 5 Right-click the selection.
Step 6 Choose Copy.
Step 7 Switch to the mailx.ntf template.
Step 8 Open the Script Libraries list.
Step 9 Right-click in the library list.
Step 10 Choose Paste.
Step 11 Save the mailx.ntf template.
Modifying the Notice Form
Add the MeetingPlace section to the Notice form if you want invitations to display Cisco Unified MeetingPlace information.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Copy the MeetingPlace section from the mailxx_xMP.ntf template.
Step 3 Paste the MeetingPlace section in the mailx.ntf template:
a. Choose the Notice form.
b. Scroll down to the Description section of the form.
c. Click in the area above the Description line.
d. Choose Create > Resources > Insert Subform.
e. Choose MPNotice.
f. Select OK.
Step 4 Choose Respond > Delegate in the Action Pane.
Step 5 (Optional) Choose View > Action Pane if the Action Pane is not visible to the right of the form.
Step 6 Right-click the menu choice.
Step 7 Choose Action Properties.
Step 8 Select Action When Hide.
Step 9 Select Formula Window.
Step 10 Scroll to the end of the current formula text in the Edit Formula window.
Step 11 Add a space.
Step 12 Add the following code to the script:
| MP_Include="1"
Step 13 Modify the formulas for the following actions in the same way, adding the same script as in Step 9:
•Respond > Propose New Time
•Respond with Comments > Delegate
Step 14 Save the mailx.ntf template.
Modifying Existing Script Libraries
You must add Cisco Unified MeetingPlace-specific code to the following functions in the following IBM Lotus Notes mail template script libraries.
Script library
|
Functions that need to be added to Cisco Unified MeetingPlace code
|
Common
|
Options, CSDocSave, CopyProfileValues, CSDocScanForUpdates
|
CSCalendarEntry
|
Options, Declaration
|
CSEventClass
|
Declarations, Options, RemoveFromMiniView
|
CSEventNotes
|
Options, Declarations
|
CSEventWeb
|
Options, Declarations
|
CSUIViewClass
|
Options, ProcessViewCommand, ViewDragPasteHandler
|
Restriction
Do not modify existing IBM LotusScript code, other than what is described in this document. Only add the Cisco Unified MeetingPlace code sections to existing code in the template. You can use any tool that merges text differences, such as Winmerge, to move the Cisco-modified script changes to your templates.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Choose Shared Code > Script Libraries in the mailxx_xMP.ntf template.
Step 3 Locate the Cisco Unified MeetingPlace-specific code for each library and function listed in the previous table between the "MeetingPlace Begin" and "MeetingPlace End" comment lines.
Step 4 Choose Edit > Copy.
Step 5 Select and copy the code (including comment lines, for later identification).
Step 6 Switch to mailx.ntf.
Step 7 Choose Edit > Paste.
Step 8 Paste the code in the corresponding script library functions in mailx.ntf.
Step 9 Choose Other > Database Resources in the mailxx_xMP.ntf template.
Step 10 Double-click the Database Script Library.
Step 11 Choose the Querydocumentdelete subquery.
Step 12 Locate the code between the "MeetingPlace Begin" and "MeetingPlace End" comment lines.
Step 13 Choose Edit > Copy.
Step 14 Select the code (including comment lines, for later identification).
Step 15 Switch to mailx.ntf.
Step 16 Choose Edit > Paste.
Step 17 Paste the code in the corresponding subquery in the Database Script library in mailx.ntf.
Step 18 Save the mailx.ntf template.
Adding the MeetingPlace Agent to the Mail Template
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Designer.
Procedure
Step 1 Open the mailx.ntf and mailxx_xMP.ntf templates.
Step 2 Choose Form > Shared Code > Agents in the mailxx_xMP.ntf template.
Step 3 Choose Edit > Copy.
Step 4 Select MPSendInvitations.
Step 5 Switch to mailx.ntf.
Step 6 Choose Edit > Paste to add the agent to the Forms > Shared Code > Agents section of the mailx.ntf template.
Step 7 Save the mailx.ntf template.
9 How to Migrate IBM Lotus Notes Users to Cisco Unified MeetingPlace
You must migrate users to the new Cisco Unified MeetingPlace mail template before they can schedule Cisco Unified MeetingPlace meetings from their IBM Lotus Notes calendar.
•Migrating a Pilot Group to the Cisco Unified MeetingPlace Mail Template
•Replacing the Standard Mail Template with the Cisco Unified MeetingPlace Mail Template
•How to Update the System to Use the New Template
Note For information about integrating IBM Lotus Notes code in standard IBM Lotus Notes mail templates, see the "How to Add Cisco Unified MeetingPlace Features to the IBM Lotus Notes Mail Template" section.
Migrating a Pilot Group to the Cisco Unified MeetingPlace Mail Template
Before you migrate an organization to the new Cisco Unified MeetingPlace mail template, you can deploy the new mail template to a pilot group. If you choose this approach, you must choose the Cisco Unified MeetingPlace mail template for each user individually.
Before You Begin
•Identify the members of the pilot group.
•Sign in as an administrator to the computer of each pilot group member.
Procedure
Step 1 Open the IBM Lotus Notes client.
Step 2 Select Calendar.
Step 3 Choose File > Application > Properties > Design.
Step 4 Check Inherit Design from Template.
Step 5 Do the following:
If the User Is Using
|
Do This
|
IBM Lotus Domino Release 6 or 6.5
|
Replace StdR60Mail with the applicable version of the Cisco Unified MeetingPlace mail template, such as Cisco Unified MeetingPlace Notes Gateway Mail Template Release 6.0.5 or 6.5.5.
|
IBM Lotus Domino Release 7
|
Replace StdR70Mail with the applicable version of the Cisco Unified MeetingPlace mail template, such as Cisco Unified MeetingPlace Notes Gateway Mail Template Release 7.0.2.
|
IBM Lotus Domino Release 8
|
Replace StdR80Mail with the applicable version of the Cisco Unified MeetingPlace mail template, such as Cisco Unified MeetingPlace Notes Gateway Mail Template Release 8.0.
|
IBM Lotus Domino Release 8.5
|
Replace StdR85Mail with the applicable version of the Cisco Unified MeetingPlace mail template, such as Cisco Unified MeetingPlace Notes Gateway Mail Template Release 8.5.
|
Replacing the Standard Mail Template with the Cisco Unified MeetingPlace Mail Template
If you choose to deploy Cisco Unified MeetingPlace features to an organization, the easiest method is to delete the standard IBM Lotus Notes mail template and replace it with the Cisco Unified MeetingPlace mail template.
Before You Begin
•Ensure that you have the Cisco Unified MeetingPlace-specific mail template installed on the IBM Lotus Domino Server.
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open an IBM Lotus Domino console session.
Procedure
Step 1 Enter exit to shut down the IBM Lotus Domino Server.
Step 2 Delete the mailx.ntf template, where the value of x depends on your server version.
Note Make sure that the mailx.ntf file is deleted; otherwise, IBM Lotus Notes assumes that you have two templates claiming to be the standard IBM Lotus Notes mail template and displays warning messages.
Step 3 Restart the IBM Lotus Domino Server.
Step 4 Change the database properties of the Cisco Unified MeetingPlace-specific mail template after the server restarts:
a. Choose File > Application > Properties.
The system opens the database window.
b. Select Design.
c. Change the name of the Cisco Unified MeetingPlace mail template:
If You Are Using
|
Do This
|
mail60_xxMP.ntf
mail65_xMP.ntf
|
Delete the current template name and enter StdR60Mail, which is the name of the standard IBM Lotus Notes mail template.
|
mail70_xMP.ntf
|
Delete the current template name and enter StdR70Mail, which is the name of the standard IBM Lotus Notes mail template.
|
mail80_xMP.ntf
|
Delete the current template name and enter StdR80Mail, which is the name of the standard IBM Lotus Notes mail template.
|
mail85_xMP.ntf
|
Delete the current template name and enter StdR85Mail, which is the name of the standard IBM Lotus Notes mail template.
|
How to Update the System to Use the New Template
The system automatically starts using the new template the next day. However, you can manually have the system start using the new template at any time if you do not want to wait until the next day.
Caution Completeing this procedure can temporarily affect the performance of the IBM Lotus Domino Server. We recommend that you do this during non-business hours.
•Manually Updating a Single System to Use the New Template
•Updating the System to Use the New Template for All Users
Manually Updating a Single System to Use the New Template
Before You Begin
•Sign in as an administrator to the computer where you plan to perform the manual update.
•Open IBM Lotus Notes.
Procedure
Step 1 Select Mail.
Step 2 Choose File > Application > Refresh Design.
The IBM Lotus Domino Server immediately starts using the new template.
Updating the System to Use the New Template for All Users
Before You Begin
•Sign in to the IBM Lotus Domino Server.
•Open the IBM Lotus Domino console.
Procedure
Step 1 Enter load design.
Step 2 Press Enter.
The IBM Lotus Domino Server immediately starts using the new template for all users in the system.
Tip Depending on the number of users, this process might take several minutes.
10 How to Customize Meeting Notifications
End users can receive meeting notifications in IBM Lotus Notes for meetings scheduled from IBM Lotus Notes or from Cisco Unified MeetingPlace.
•About Using Multiple Notification Programs
•About Meeting Notification Formats
•About Notifications for Rescheduled Meetings
•About Meeting Notification Templates
•Customizing the Meeting Notification Templates
About Using Multiple Notification Programs
If your organization has both Microsoft Outlook and IBM Lotus Notes, you can install Microsoft Outlook for Cisco Unified MeetingPlace and IBM Lotus Notes for Cisco Unified MeetingPlace on separate servers to support each set of users. Both integrations can point to the same Cisco Unified MeetingPlace system, but must point to different mailboxes.
After you install both integrations, users can schedule Cisco Unified MeetingPlace meetings from IBM Lotus Notes, Microsoft Outlook, or Cisco Unified MeetingPlace.
About Meeting Notification Formats
The format of a meeting notification varies depending on the following:
•The program used to schedule the meeting
•The email program in which the end user receives the notification
The following table describes the format of the meeting notifications that users receive.
Meeting Scheduled From
|
IBM Lotus Notes Users Receive
|
Microsoft Outlook Users Receive
|
Cisco Unified MeetingPlace
|
IBM Lotus Notes notification1
|
Microsoft Outlook notification1
|
IBM Lotus Notes
|
IBM Lotus Notes notification1
|
SMTP notification
|
Microsoft Outlook
|
SMTP notification
|
Microsoft Outlook notification1
|
About Notifications for Rescheduled Meetings
Notifications for rescheduled meetings contain a different set of information than the information in the original meeting notification. The information in the notification for the rescheduled meeting depends on the interface that was used to reschedule the meeting.
You can only reschedule a meeting using the interface from which you originally scheduled the meeting. So if you scheduled a meeting from IBM Lotus Notes, you can only reschedule it from IBM Lotus Notes and if you scheduled a meeting from Cisco Unified MeetingPlace, you can only reschedule it from Cisco Unified MeetingPlace.
•Notifications for Meetings Rescheduled From IBM Lotus Notes
•Notifications for Meetings Rescheduled From Cisco Unified MeetingPlace
Notifications for Meetings Rescheduled From IBM Lotus Notes
When you schedule a meeting from IBM Lotus Notes and then reschedule it from IBM Lotus Notes, the system sends a meeting notification for the rescheduled meeting that has the same information as the original notification, including the click-to-attend link. If the user accepts the rescheduled meeting, the system updates their calendar.
Note IBM Lotus Notes does not allow you to change the meeting ID or the Allow Internet Access option when you reschedule a meeting from IBM Lotus Notes.
Notifications for Meetings Rescheduled From Cisco Unified MeetingPlace
When you schedule a meeting from Cisco Unified MeetingPlace and then reschedule it from Cisco Unified MeetingPlace, the system sends a meeting notification with different subject and body fields than those in the original meeting notification, as noted in the following table:
Meeting Notification for Original Meeting
|
Meeting Notification for Rescheduled Meeting
|
Subject: Meeting name, date/time
|
Subject: Meeting name, meeting ID, meeting password (if required)
|
Body: Click-to-attend link, meeting information
|
Body: Click-to-attend link, original meeting information
|
The system updates the click-to-attend link and allows users to attend the rescheduled meeting.
About Meeting Notification Templates
The following table describes the templates used to generate meeting notifications.
Template Name
|
Description
|
mailxx_xxMP.ntf
|
Generates meeting and reminder notifications for meetings scheduled from IBM Lotus Notes.
A template is included for each supported version of IBM Lotus Domino and IBM Lotus Notes (for example, mail65_3.ntf is used for users of IBM Lotus Domino Release 6.5 and IBM Lotus Notes Release 6.5.3).
|
NotifySchedule.tpl
|
Generates meeting notifications for IBM Lotus Notes users for meetings that are scheduled from Cisco Unified MeetingPlace.
|
NotifyReschedule.tpl
|
Generates updated notices for IBM Lotus Notes users for meetings that are rescheduled from Cisco Unified MeetingPlace.
|
NotifyCancel.tpl
|
Generates cancellation notices for IBM Lotus Notes users for meetings that are canceled from Cisco Unified MeetingPlace.
|
Customizing the Meeting Notification Templates
You can customize the meeting notification templates for meetings that are scheduled from Cisco Unified MeetingPlace. Each template contains tags that contain the text that appears in the meeting notifications. When the system generates a meeting notification, IBM Lotus Notes replaces the tags with the appropriate information from the Cisco Unified MeetingPlace database.
Consider adding tags with the following information to your meeting notifications:
•Instructions about how to attend meetings and access attachments.
•Alternate phone numbers for your Cisco Unified MeetingPlace system, such as a toll free number or internal company extension.
•A list of meeting invitees.
•Information about how to record a meeting.
Before You Begin
Sign in to the IBM Lotus Domino Server as an administrator.
Procedure
Step 1 Access the meeting notification templates by navigating to C:\Cisco\Cisco MeetingPlace for Notes.
Step 2 Using Notepad, open the .tpl meeting notification template that you want to customize.
Caution Using a word processing program other than Notepad can change the template file extension and produce an unreadable meeting notification. Notepad can automatically save a template without changing its .tpl extension.
Step 3 As applicable, add the tags that are listed in the following table to your Cisco Unified MeetingPlace meeting notification template.
Note Tags for alternate phone numbers differ depending on whether you are customizing notifications for front-end or back-end scheduling.
Tag
|
Description
|
<!--#LATD AttendMeetingHint -->
|
How to attend a meeting.
|
<!--#LATD MeetingNotesHint -->
|
How to access MeetingNotes.
|
<!--#LATD C_AltPhoneNumName1 -->
<!--#LATD C_AlternatePhoneNum1-->
|
Label for notifications.
First alternate phone number.
Note This tag is for front-end meetings. You can find the template for front-end meetings in C:\Program Files\Cisco Systems\MPWeb\Template\NotesGetMeetingSuccess.tpl
|
<!--#LATD AltPhoneLabel_1 -->
<!--#LATD AltPhone_1 -->
|
Label for Notifications
1st Alternate Ph Number
Note This tag is for back-end meetings. You can find the template for back-end meetings in C:\Program Files\Cisco Systems\MeetingPlace for Notes\NotifySchedule.tpl
|
<!--#LATD C_AltPhoneNumName2 -->
<!--#LATD C_AlternatePhoneNum2 -->
|
Second label for notifications.
Second alternate phone number.
Note This tag is for front-end meetings. You can find the template for front-end meetings in C:\Program Files\Cisco Systems\MPWeb\Template\NotesGetMeetingSuccess.tpl
|
<!--#LATD AltPhoneLabel_2
<!--#LATD AltPhone_2 -->
|
Second Label for Notifications
2nd Alternate Ph Number
Note This tag is for back-end meetings. You can find the template for back-end meetings in C:\Program Files\Cisco Systems\MeetingPlace for Notes\NotifySchedule.tpl
|
<!--#LATD C_AltPhoneNumName3 -->
<!--#LATD C_AlternatePhoneNum3 -->
|
Third label for notifications.
Third alternate phone number.
Note This tag is for front-end meetings. You can find the template for front-end meetings in C:\Program Files\Cisco Systems\MPWeb\Template\NotesGetMeetingSuccess.tpl
|
<!--#LATD AltPhoneLabel_3
<!--#LATD AltPhone_3 -->
|
Third Label for Notifications
3rd Alternate Ph Number
Note This tag is for back-end meetings. You can find the template for back-end meetings in C:\Program Files\Cisco Systems\MeetingPlace for Notes\NotifySchedule.tpl
|
<!--#LATD ListInvitees -->
|
List of meeting invitees.
|
<!--#LATD fRecordConference -->
|
Whether the meeting is scheduled to be recorded.
|
<!--#LATD WhoCanListen -->
|
Who can access the meeting recording (None, anyone, Cisco Unified MeetingPlace users, or invited users).
|
Note When you add a tag to a meeting notification template, the system displays the information in the same location in the meeting notification where you entered it. Place more important information at the top of the meeting notification template.
Step 4 To delete a tag from the meeting notification template, delete the applicable tag and label from the template.
Step 5 Save the template as a text file. Make sure that your word processing program does not change the .tpl extension of the file.
11 Troubleshooting IBM Lotus Notes for Cisco Unified MeetingPlace
•Troubleshooting: What to Do First
•Resolving Error Messages
•Troubleshooting Mail Template Settings
•Resolving Scheduling Errors When the "Allow Internet Access" Option is Checked
•Resolving Problems when LNNotify Does not Start
•Resolving Java.io.fileNotFound Exception
•Resolving Cross Certify Errors
•Problems With Meeting Notifications
•Problem Accessing Online Help From the "About This Database" Page
Troubleshooting: What to Do First
If you have scheduling, attendance, or notification problems, perform the following three procedures in the order presented to make sure that IBM Lotus Notes has not lost any of its connections. If you still experience the same problem after completing these procedures, continue with the remaining troubleshooting topics in this section.
•Verifying That the Windows Services Are Running
•Verifying That MPNotify and MPAgent Can Sign In
•Checking the Windows Event Viewer for Errors
Verifying That the Windows Services Are Running
Restriction
Running some services, such as MPAgent, can use as much as 90 percent of your CPU. Fortunately, these services run at a low priority so the CPU spikes do not impact important system functions.
Before You Begin
Sign in as an administrator to the Cisco Unified MeetingPlace Web Server that has the IBM Lotus Notes for Cisco Unified MeetingPlace integration installed on it.
Procedure
Step 1 Choose Start > Programs > Administrative Tools > Services.
Step 2 Verify that the following services are running:
•Cisco MeetingPlace Gateway SIM
•Cisco MeetingPlace Notification Gateway
•Cisco Unified MeetingPlace Agent Service
•Cisco Unified MeetingPlace Audio Service
•Cisco Unified MeetingPlace Connect Application Service
•Cisco Unified MeetingPlace Connect Gateway
•Cisco Unified MeetingPlace for Notes Gateway
Note If you cannot start the Cisco Unified MeetingPlace for Notes Gateway service, make sure that the Cisco Unified MeetingPlace account has been set up to use the new Cisco Unified MeetingPlace mail template. See the "How to Configure the IBM Lotus Notes Gateway Account to Use the Mail Template" section.
•Cisco Unified MeetingPlace for Single Sign On
•Cisco Unified MeetingPlace Replication Service
•Cisco Unified MeetingPlace Web Server
•(Optional) Cisco Unified MeetingPlace Gateway for Cisco WebEx, if this is installed
Step 3 If the services are not running, restart them.
Verifying That MPNotify and MPAgent Can Sign In
Restriction
Running some services, such as MPAgent, can use as much as 90 percent of your CPU. Fortunately, these services run at a low priority so the CPU spikes do not impact important system functions.
Before You Begin
Sign in as an administrator to the Cisco Unified MeetingPlace Web Server that has the IBM Lotus Notes for Cisco Unified MeetingPlace integration installed on it.
Procedure
Step 1 Open the Gateway Configuration utility.
Step 2 Select Properties.
Step 3 Select the Notes Gateway tab.
Step 4 Check Verbose Logging.
Step 5 Select OK.
Step 6 Right-click the Gateway Configuration utility and select Eventlog.
The system displays the Gateway SIM eventlog.
Step 7 Stop and restart the following services:
•Cisco Unified MeetingPlace
•Cisco Unified MeetingPlace Notification Gateway
Step 8 View the Gateway SIM eventlog.
The eventlog should display entries that show the MPNotify and MPAgent signing in to the IBM Lotus Domino Server and Cisco Unified MeetingPlace, similar to the following:
12/17 12:20:06 MPNotify Information:[2] No new messages to process
12/17 12:20:07 MPNotify Information:[2] Domino server CN=ServerName is available
12/17 12:19:08 mpagent Success:Registered for CS events
12/17 12:19:08 mpagent Success:Successfully logged into MeetingPlace
12/17 12:19:08 MPNotify Information:MeetingPlace login completed
12/17 12:18:55 mpagent Success:The MPAgent has started successfully.
12/17 12:18:51 mpagent Information:Service started
12/17 12:18:43 MPNotify Information:Service started
Step 9 If the IBM Lotus Notes Gateway service is not signing in to the IBM Lotus Domino Server, check to see if the IBM Lotus Notes client on the Cisco Unified MeetingPlace Web Server that has the IBM Lotus Notes for Cisco Unified MeetingPlace integration installed on it can view its mail database.
If the mail database is not accessible, see the IBM Lotus Notes documentation to troubleshoot this problem.
Step 10 If the MPAgent and MPNotify services cannot sign in to the Cisco Unified MeetingPlace system, verify that the Cisco Unified MeetingPlace system is up and running and that you have network connectivity.
Note After you finish troubleshooting, we recommend that you turn off verbose logging. Modifications made to verbose logging will only take effect after you stop and restart the service.
Checking the Windows Event Viewer for Errors
You can use the Windows Event Viewer to diagnose directory, user account, and permission errors.
Before You Begin
Sign in as an administrator to the Cisco Unified MeetingPlace Web Server that has the IBM Lotus Notes for Cisco Unified MeetingPlace integration installed on it.
Step 1 Choose Start > Programs > Administrative Tools > Event Viewer.
Step 2 Select a log name in the left pane of the Event Viewer window to view events for that log.
Step 3 Look for any directory, user account, and permission errors.
Step 4 Troubleshoot the errors.
Resolving Error Messages
•Error Messages Related to Joining Meetings
•Error Messages Related to Scheduling Problems
•Error Messages Related to Incorrect Profile Information
•Error Messages Related to System Setup
•Error Messages Related to Errors Validating a User Agent Execution Access
•Error Messages Related to Java AccessControl
•Error Messages Related to the Connection Between Cisco Unified MeetingPlace and IBM Lotus Domino
•JavaScript Error Messages When Selecting the URL to Attend the Meeting
•Error Messages Related to Installing the Lotus Notes Client
Error Messages Related to Joining Meetings
Error Message Unable to get a MeetingPlace session ID
Explanation You may see this error message when you are trying to join a meeting that was scheduled on an external web
server. This is due to an incomplete installation of the external server.
Recommended Action To permit users to use the Cisco Unified MeetingPlace for Notes Gateway on an external web server,
make sure that you complete one of the following:
–Install the MP Notes Gateway on the external web server.
–Manually copy all 33 Notes-related template files from the internal web server at C:\Program Files\Cisco Systems\MPWeb\Template to the same location on the external web server.
Related Topics
•Installing the Cisco Unified MeetingPlace Gateway for IBM Lotus Notes
Error Messages Related to Scheduling Problems
Error Message You are currently unable to schedule Cisco Unified MeetingPlace meetings because you are either
offline or working on a local copy of your mail database. Please note that you must be online and your mail
database must be located on the IBM Lotus Domino server to allow scheduling of Cisco Unified MeetingPlace
meetings.
Explanation This error occurs when the MPSA.nsf file (the MeetingPlace Server Agent Database) is not visible to IBM Lotus
Notes. The client thinks the MeetingPlace Server Agent Database is offline.
Recommended Action Complete the following procedure.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Administrator.
Procedure
Step 1 Verify that the MPSA.nsf file (the MeetingPlace Server Agent Database) is present on the IBM Lotus Domino Server in the correct location at C:\Lotus\Domino\Data.
If you installed IBM Lotus Notes in a different location, the system might have installed the MPSA.nsf file in the client data directory. If this is the case, copy it to the C:\Lotus\Domino\Data directory.
Step 2 Verify that the MPSA.nsf file (the MeetingPlace Server Agent Database) is signed and that Cisco Unified MeetingPlace has permission to run unrestricted LotusScript/Java agents on your client.
Related Topics
•Signing the MeetingPlace Server Agent (MPSA) Database Template
Error Messages Related to Incorrect Profile Information
Error Message Error Message: Unable to access Cisco Unified MeetingPlace resources because your Cisco Unified
MeetingPlace profile information is incorrectly entered in the Public Name and Address Book.
Explanation This error appears when IBM Lotus Domino authentication is being used and the Cisco Unified MeetingPlace
user ID of the scheduler was not entered correctly in the IBM Lotus Domino address book.
Explanation Update the IBM Lotus Domino address book with the Cisco Unified MeetingPlace user ID of the scheduler.
Error Messages Related to System Setup
Error Message The Administrator has not set up the Cisco Unified MeetingPlace System. Please exit and notify
the Administrator.
Explanation The MeetingPlace Server Agent Database has not yet been created and configured on the IBM Lotus Domino
Server.
Recommended Action Complete the steps in the "Creating the MeetingPlace Server Agent (MPSA) Database" section.
Error Messages Related to Errors Validating a User Agent Execution Access
Error Message Error validating user's agent execution access [4000] (QuerySave)
Explanation This error occurs when you sign the MPSA.nsf file (the MeetingPlace Server Agent Database) or Cisco Unified
MeetingPlace mail templates (for example, mail65_5MP.ntf, mail70_2MP.ntf, or mail85_0MP.ntf) with the wrong user ID.
Recommended Action Verify that the MPSA.nsf file (the MeetingPlace Server Agent Database) is signed with the
Cisco Unified MeetingPlace ID and that the user, Cisco Unified MeetingPlace, has permission to run unrestricted
LotusScript/Java agents on your client. See the "Signing the MeetingPlace Server Agent (MPSA) Database Template"
section.
Error Messages Related to Java AccessControl
Error Message AccessControl Exception java.security.AccessControlException.
Explanation You have not correctly modified the java.policy file.
Recommended Action Check the java.policy file to make sure it has the proper syntax. See the "Editing the java.policy File"
section.
Error Messages Related to the Connection Between Cisco Unified MeetingPlace and IBM Lotus Domino
Error Message A connection cannot be established between Cisco Unified MeetingPlace and IBM Lotus Domino.
Contact your IBM Lotus Notes Administrator.
Recommended Action Complete the following procedure.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Launch IBM Lotus Domino Administrator.
Procedure
Step 1 Verify that the IBM Lotus Domino Server is running.
Step 2 Sign in to the Cisco Unified MeetingPlace Web Server as an administrator.
Step 3 Verify that the Cisco Unified MeetingPlace services are running.
Step 4 Open the MPSA.nsf database from the Domino Administrator.
Step 5 Choose Administration from the left pane.
Step 6 Select Edit/Create Profile Document at the top of the right pane, to open the Cisco Unified MeetingPlace System Profile Document.
Step 7 Verify that the URLs for Server Address and External Server Address are correct in the Cisco Unified MeetingPlace Server Settings section. If they are not correct, update them as follows:
a. Choose Modify Server.
b. Update the MeetingPlace Web CGI URL and External MeetingPlace Web CGI URL fields.
Related Topics
•Verifying That the Windows Services Are Running
•Modifying the Cisco Unified MeetingPlace Server Settings
JavaScript Error Messages When Selecting the URL to Attend the Meeting
Problem The system displays JavaScript errors when selecting the attend URL link.
Explanation You are using an unsupported web browser.
Solution For browser support information, see the System Requirements for Cisco Unified MeetingPlace Release 8.5 at http://www.cisco.com/en/US/products/sw/ps5664/ps5669/prod_installation_guides_list.html.
Error Messages Related to Installing the Lotus Notes Client
Error Message Error 1330: A file that is required cannot be installed because the cabinet file D:\LN\Data1.cab
has an invalid digital signature. This may indicate that the cabinet file is corrupt. Error 270 was returned
by WinVerifyTrust.
Explanation When installing the Lotus Notes client on a MeetingPlace Web Server that has a hardened version of Windows
2003 installed, the installation fails and the user sees an error message. This error occurs because WinVerifyTrust is trying
to download a certificate revocation list to verify if the signed file is valid even though Internet access is restricted on the
hardened operating system.
Recommended Action The workaround for this issue is to temporarily disable checking of the revocation list so that
WinVerifyTrust will not attempt to download the revocation list. This can be done by using the SetReg.exe that is part of
the Microsoft Windows SDK. It is also included in the .NET framework SDK. Follow the steps below to get around this
issue:
Step 1 Copy SetReg.exe to the Windows server.
Step 2 Run the following commands from the windows command line:
a. SetReg.exe 3 FALSE
b. SetReg.exe 9 FALSE
Step 3 Run the Lotus Notes installer.
Step 4 Once the Lotus Notes installation is done. Run the following commands from the windows command line:
a. SetReg.exe 3 TRUE
b. SetReg.exe 9 TRUE
Troubleshooting Mail Template Settings
Problem Users cannot schedule meetings, or they can schedule meetings but the system does not send a notification.
Explanation The mail template is not signed.
Solution Complete the following procedure.
Procedure
Step 1 Verify that the mail template that is being used by the IBM Lotus Notes client is signed. See the "Signing the Cisco Unified MeetingPlace Mail Template" section.
Step 2 Verify that the mail template that is being used by the gateway account is signed.
Step 3 Verify that the user who signed the mail template and the MeetingPlace Server Agent Database (mpsa.nsf) can run unrestricted methods and operations and restricted LotusScript/Java agents.
Step 4 If that user does not have the permissions identified in Step 3, sign the mail template and the MeetingPlace Server Agent (MPSA) database template again. See the "Signing the MeetingPlace Server Agent (MPSA) Database Template" section and the "Signing the Cisco Unified MeetingPlace Mail Template" section.
Step 5 Refresh the design of the end user and gateway account.
Related Topics
Granting Permission to Run Agents on the IBM Lotus Domino Server
Resolving Scheduling Errors When the "Allow Internet Access" Option is Checked
Problem There are errors when scheduling a Cisco Unified MeetingPlace meeting when the "Allow Internet Access" option checked.
Explanation You may have entered a blank value for either the internal or external Web Server URLs when you installed
IBM Lotus Notes.
Solution Open the MPSA.nsf database and add the missing URL. See the "Adding a Cisco Unified MeetingPlace Profile to the MeetingPlace Server Agent (MPSA) Database" section for information.
Resolving Problems when LNNotify Does not Start
Problem LNNotify does not start. On startup, the system displayed an error message that there is either an internal Windows error or an internal service error.
Explanation The Cisco Unified MeetingPlace gateway account does not have a Cisco Unified MeetingPlace mail template
associated with it.
Solution Verify that the mail template is appropriate for the IBM Lotus Notes mail template that you are using (for example, mail65_5MP.ntf, mail70_2MP.ntf, or mail85_0MP.ntf). Follow the procedure in the "Modifying the Cisco Unified MeetingPlace Server Settings" section.
Resolving Java.io.fileNotFound Exception
Problem The Java.io.FileNotFound exception occurs when a meeting is scheduled on the IBM Lotus Domino console.
Explanation This error occurs when you have set up your system to receive, but not to send, HTTPS requests.
Solution Verify that you are using SSL by completing the following procedure.
Before You Begin
•Sign in to the IBM Lotus Domino Server as an administrator.
•Open IBM Lotus Domino Administrator.
Procedure
Step 1 Open the MPSA.nsf database.
Step 2 Choose Administration.
Step 3 From the Administration page, choose Edit/Create Profile Document.
Step 4 Select Modify Server.
Step 5 Verify that the Use SSL check box is checked.
Related Topics
Adding a Cisco Unified MeetingPlace Profile to the MeetingPlace Server Agent (MPSA) Database
Resolving Cross Certify Errors
Problem The system displays the Cross Certify window when trying to open the IBM Lotus Notes calendar.
Explanation The system displays the Cross Certify window if the database template was not signed after installing
IBM Lotus Notes.
Solution Complete the procedure in the "Signing the MeetingPlace Server Agent (MPSA) Database Template" section.
Problems With Meeting Notifications
Problem When scheduling a Cisco Unified MeetingPlace meeting through IBM Lotus Notes, invited users do not receive meeting notifications.
Explanation The User Name field in the IBM Lotus Domino account of the invited user does not match the email address
field in the Cisco Unified MeetingPlace profile for that user.
Solution Update the email address of the Cisco Unified MeetingPlace profile for the invited user to match the User Name field in the IBM Lotus Domino account.
Problem When scheduling a meeting through Cisco Unified MeetingPlace, invited users do not receive meeting notifications.
Explanation This problem occurs when the IBM Lotus Notes gateway account mailbox is full, or there is no more space on
the system hard drive.
Solution Check the mailbox and hard drive space of the IBM Lotus Domino Server where the templates and gateway account mailbox are installed. If the mailbox or hard drive is full, delete or archive unwanted emails or files to create more space.
Problem When scheduling a meeting through Cisco Unified MeetingPlace, invited users do not receive meeting notifications.
Explanation This problem occurs when:
–The profile of the invited user is not set up to receive meeting notifications.
–The profile of the meeting scheduler is not set up to send meeting notifications.
Solution Complete the following procedure to verify whether user profiles are set up to send and receive meeting notifications.
Before You Begin
Sign in to the Cisco Unified MeetingPlace Administration Center as an administrator.
Procedure
Step 1 Select User Configuration > User Profiles.
Step 2 Locate the user profile by doing the following:
a. Select a search rule.
b. Enter the first one or two characters of the user or meeting scheduler name.
c. Select Search.
Step 3 Select the user from the search results list.
Step 4 Select Edit.
Step 5 Ensure that the E-mail type field is set to LotusNotes.
Step 6 Ensure that the Can send notifications field is set to Yes.
Step 7 Ensure that the Can receive notifications field is set to Yes.
Step 8 Select Save.
Problem IBM Lotus Notes users do not receive meeting notifications. This happens after the users have received meeting notifications previously and can occur when scheduling a meeting through Cisco Unified MeetingPlace Conference Manager or Cisco Unified MeetingPlace Web Server.
Explanation Back-end notifications begin to fail if the IBM Lotus Notes account for Cisco Unified MeetingPlace exceeds
5000 documents. This is caused by a default limitation on the IBM Lotus Domino Server where it is unable to handle index
files larger than 5000 documents.
See the following example in the IBM Lotus Domino Server console:
index of [some_number_greater_then_5000] documents exceeds limit (5000), aborting: Maximum allowable documents exceeded for a temporary full text index.
Example:
12/03/2009 12:14:46 PM Opened session for Meeting Place/[your_domain] (Release 8.0.1).
12/03/2009 12:14:53 PM Full text operations on database 'mail\meetingplace.nsf' which is not full text indexed. This is extremely inefficient.
12/03/2009 12:14:53 PM Full Text message: index of 6001 documents exceeds limit (5000), aborting: Maximum allowable documents exceeded for a temporary full text index.
Recommended Action Complete the following procedure to verify that meeting notifications can be received by IBM Lotus
Notes users.
Procedure
Step 1 Navigate to the IBM Lotus Domino Server installation folder.
Step 2 Open the file called notes.ini.
Step 3 At the end of the file, add these two lines:
•Temp_Index_Max_Doc=10000
•FT_Max_Search_Results=10000
Step 4 Restart the IBM Lotus Domino Server.
Problem Accessing Online Help From the "About This Database" Page
Problem The online help for IBM Lotus Notes cannot be accessed by selecting the help link on the About This Database page.
Solution Press the F1 key while the cursor is present in any of the Cisco Unified MeetingPlace-specific fields in the Calendar Entry form to access the online help.
12 About Upgrading to the Cisco Unified MeetingPlace Release 8.5 Integration for IBM Lotus Notes
Cisco Unified MeetingPlace supports upgrading to the Release 8.5 integration from the Release 8.0 integration. To upgrade to the Cisco Unified MeetingPlace Release 8.5 integration for IBM Lotus Notes, simply follow the instructions in this guide keeping the following in mind:
•Cisco Unified MeetingPlace does not support mixed template environments. If you are upgrading from one release of IBM Lotus Domino to another, you must upgrade all users to the same server and template environment.
•Verify that you are currently using supported releases of the IBM Lotus Domino Server and IBM Lotus Notes clients. For system requirements, see the System Requirements for Cisco Unified MeetingPlace Release 8.5, at http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_device_support_tables_list.html.
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. Cisco currently supports RSS Version 2.0.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party trademarks mentioned 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. (1005R)
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.
© 2011 Cisco Systems, Inc. All rights reserved.
