Installation Guide for Cisco Unity Release 5.x with IBM Lotus Domino (With Failover Configured)
Setting Up Domino and Installing Lotus Notes
Downloads: This chapterpdf (PDF - 123.0KB) The complete bookPDF (PDF - 3.8MB) | Feedback

Setting Up Domino and Installing Lotus Notes

Table Of Contents

Setting Up Domino and Installing Lotus Notes

Preparing the Domino Server(s) for Cisco Unity

Installing and Configuring Lotus Notes on the Cisco Unity Server


Setting Up Domino and Installing Lotus Notes


In this chapter, you do the following tasks in the order listed:


Note Do Task 1. only for the first server that you install in the failover pair.


1. Prepare the Domino server(s) for Cisco Unity. See the "Preparing the Domino Server(s) for Cisco Unity" section.

2. Install and configure IBM Lotus Notes on the Cisco Unity server. See the "Installing and Configuring Lotus Notes on the Cisco Unity Server" section.

When you are finished with this chapter, return to Chapter 1, "Overview of Mandatory Tasks for Installing Cisco Unity" to continue installing the Cisco Unity system.


Note The tasks in the list reference detailed instructions in the Cisco Unity installation guide and in other Cisco Unity documentation. Follow the documentation for a successful installation.


Preparing the Domino Server(s) for Cisco Unity


Note Cisco assumes that the Domino environment is already set up and working before the Cisco Unity system is installed.


In the procedure in this section, you:

Create a Domino group called UnityServers.

Register a Person with Lotus Notes as the mail system for the Cisco Unity server.

In the Access Control List (ACL) for Admin4.nsf, grant the UnityServers group Editor permissions.

Admin4.nsf is used by the Administrative Process task running on each Domino server. When a Domino user is imported into Cisco Unity, Cisco Unity submits a signed request to the Adminp task, which adds the request to Admin4.nsf. IBM Lotus Domino Unified Communications (DUC) for Cisco then modifies the user's mail file with Cisco Unity Unified Messaging functionality. The changes are made to the database on the server that contains the user's mail file. The UnityServers group requires editor-level permissions in the Admin4.nsf database on each server containing the mail file for a Cisco Unity subscriber.

Domino security policy requires Cisco Unity to digitally sign requests. Requests are documents, and signing documents requires modifying them, so the UnityServers group needs privileges to sign requests submitted to the Administrative Process database. This corresponds to editor-level permissions in an ACL.

In the Access Control List for Names.nsf, grant the UnityServers group Editor with Delete Documents permissions.

By default, Names.nsf is the main directory database for a Domino domain. Cisco Unity needs sufficient permissions in the ACL of the database to read, edit, create, and delete documents (or "notes") in the database.

On the Security tab of the Server document of the Domino address book server, grant the UnityServers group the permission to Create Databases and Templates.

You will specify the Domino server to use as the address book server during Cisco Unity installation in the Cisco Unity Message Store Configuration wizard. The wizard must be able to create mail files for the default accounts, such as the Unity Messaging System account, on the specified Domino server.

Install DUC for Cisco components on Domino servers.

Confirm that the network is configured so that Cisco Unity can resolve the unqualified Domino server name to an IP address.

The Cisco Unity server also has Manager-level access to the mail files of its subscribers because when a Domino user is imported into Cisco Unity, DUC for Cisco adds Cisco Unity to the ACL of the mail file for the user. Cisco Unity requires the access to modify the read/unread list. Ensure there are no explicit deny lists or security settings that hinder the ability of Cisco Unity to access a mail file after the Domino user has been imported into Cisco Unity.

To Prepare the Domino Server(s) for Cisco Unity


Step 1 Create a group of type MultiPurpose for the Cisco Unity server, and name it UnityServers. Refer to the applicable IBM Lotus documentation.


Note Multipurpose is the recommended type, but Access Control List Only is acceptable.


Step 2 Register a Person for the Cisco Unity server. Most settings will not affect Cisco Unity functionality, however, you must do the following:

Create a Lotus Notes mail file for the Person.


Note All Cisco Unity voice messages are submitted to mail.box on the Domino server on which you create the Lotus Notes mail file. Messages are then routed to the Domino servers on which Cisco Unity subscribers are homed. Create the Lotus Notes mail file on a Domino server that is well connected to the network.


Save the user ID file for the Person in a location other than the Domino directory (the default option). In the Register Person—New Entry dialog box:

a. Check the Advanced check box, so tabs on the left side of the dialog box appear.

b. Click the ID Info tab.

c. Uncheck the In Domino Directory check box.


Caution If you save the ID file in the Domino directory, regardless of whether you also save it in a file, Cisco Unity will not function properly.

d. Check the In File check box.

e. Choose a location for the ID file, and make note of where you saved it. You will use it when you configure Lotus Notes on the Cisco Unity server, later in the installation.

Step 3 Add the Cisco Unity Person to the UnityServers group that you created in Step 1. Refer to the applicable IBM Lotus documentation.

Step 4 In the Access Control List for Admin4.nsf, grant the UnityServers group Editor permissions.

Step 5 In the Access Control List for Names.nsf, grant the UnityServers group Editor with Delete Documents permissions.

Step 6 On the Security tab of the Server document of the Domino address book server, grant the UnityServers group the permission to Create Databases and Templates. (You will specify the Domino server to use as the address book server during Cisco Unity installation in the Cisco Unity Message Store Configuration wizard.)

Step 7 Install csServer, the server component of DUC for Cisco, on the following servers:

On each Domino server that will home Cisco Unity subscribers.

On the Domino server on which you created the Lotus Notes mail file in Step 2.


Caution Do not install csServer on the Cisco Unity server.

Step 8 If you selected the mail template MailX.ntf (where X is the version of Domino in use—for example, Mail6.ntf for Domino 6.0) during csServer installation in Step 7, skip to Step 9.

If you selected a mail template other than MailX.ntf (where X is the version of Domino in use—for example, Mail6.ntf for Domino 6.0) during csServer installation in Step 7, rerun csServer installation on the Domino server that you intend to use as the address book server for Cisco Unity. (The address book server is the Domino server that Cisco Unity monitors for changes to the primary address book, and the server on which it creates default objects.) Select the option to DUC-enable multiple mail templates, then select the applicable MailX.ntf file.


Caution If you do not DUC-enable the MailX.ntf template, default objects created by Cisco Unity, such as the Unity Messaging account, may not function correctly.

Step 9 In the Domino Administrator or Lotus Notes client on the server you would typically use to administer the Domino Directory, switch to a Notes ID that has Designer or higher access to the administration server for the Domino Directory, then close all windows applications including the Domino Administrator and Lotus Notes client.


Note The switch is required for the next step. After you begin the step, you cannot switch to another Notes ID.


Step 10 Install csAdmin, the administration component of DUC for Cisco, to update the Domino domain directory database. The database is usually called Names.nsf, but it may have a different name on your system. You install csAdmin only once for the domain. For more detailed installation instructions, refer to the applicable IBM Lotus documentation.


Caution Do not install csAdmin on the Cisco Unity server.

Step 11 Confirm that the network is configured so that Cisco Unity can resolve the unqualified Domino server name to an IP address. (For example, if the Domino server name is MailServer and you enter ping mailserver on the command line on the Cisco Unity server, the response is the IP address of the Domino server.)


Installing and Configuring Lotus Notes on the Cisco Unity Server

You install Notes on the Cisco Unity server because Cisco Unity communicates with Domino by using the Notes software.

You can also use Notes for troubleshooting (for example, to determine whether messages are getting from the Cisco Unity server to Domino users), but you must stop Cisco Unity before you start Notes. When you are finished troubleshooting, exit the Notes software, and shut down and restart the Cisco Unity server.


Caution Do not run Notes on the Cisco Unity server while Cisco Unity is running, or Cisco Unity may stop functioning.


Caution Do not install an unsupported version of Notes on the Cisco Unity server. For a list of Notes versions supported on the Cisco Unity server, refer to the applicable System Requirements for Cisco Unity at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_installation_guides_list.html.


Caution Do not install csClient or csiNotes, the client component of DUC for Cisco, on the Cisco Unity server.

Do the following three procedures in the order listed.

To Install Lotus Notes on the Cisco Unity Server


Step 1 On the Cisco Unity server, insert the IBM Lotus Notes disc in the DVD drive.

Step 2 Browse to the Lotus Notes directory, and double-click Setup.exe.

Step 3 Follow the on-screen prompts, and accept the default settings until you are prompted to enter a user name and organization.

Step 4 Enter a user name and organization, and click Only for Me.

Step 5 Click Next.

Step 6 When you are prompted to specify destination folders, for both the program and the data folders, use the drive location for binary files that you made note of in the "Determining the Locations for Files on the Cisco Unity Server" section on page 2-4.

Make note of the drive and directory for the program folder because you will need this information for the next procedure.

Step 7 Click Next.

Step 8 Follow the on-screen prompts, and accept the default settings.

Step 9 If a dialog window appears warning about a read-only file that is about to be replaced, check the Don't Display Again check box, and click No.

Step 10 Click Finish.


To Add the Location of the Lotus Notes Program Folder to the System Path Environment Variable


Step 1 Right-click the My Computer icon on the Windows desktop, and click Properties.

Step 2 Click the Advanced tab.

Step 3 Click Environment Variables.

Step 4 In the System Variables list, click Path, and click Edit.

Step 5 In the Edit System Variable dialog box, at the end of the Variable Value field, enter a semicolon (;) and the drive and directory of the Lotus Notes program folder.

Step 6 Click OK to close the Edit System Variable dialog box.

Step 7 Click OK to close the Environment Variables dialog box.

Step 8 Click OK to close the System Properties dialog box.


To Configure Lotus Notes to Use the Cisco Unity Account


Step 1 On the Cisco Unity server, on the Windows Start menu, click Programs > Lotus Applications > Lotus Notes.

Step 2 On the Welcome screen, click Next.

Step 3 On the User Information screen, enter a user name and the name of the Domino server on which the Cisco Unity mail file was created.

Step 4 Check the I Want to Connect to a Domino Server check box.

Step 5 Click Next.

Step 6 Browse to the location where you saved the user ID file in the "To Prepare the Domino Server(s) for Cisco Unity" procedure, and double-click the file.

Step 7 Click Yes to copy the user ID file for the Cisco Unity user locally, and click Next.


Caution If you do not copy the user ID file to the Cisco Unity server, Cisco Unity will not function correctly.

Step 8 If the Enter Password dialog box appears, enter the password for the Cisco Unity account.

Step 9 To complete the configuration, follow the on-screen prompts and accept the default values.

Step 10 Exit Lotus Notes.