Cisco Unity Installation Guide (With IBM Lotus Domino), Release 4.0(4)
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:

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 "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 this section, you:

Create a Domino group for Cisco Unity servers.

Register a Cisco Unity person and create a mail file for it.

For the Cisco Unity servers group, grant Editor permissions for Admin4.nsf.

Admin4.nsf is used by the Administrative Process task running on each Domino server. When a Domino person is imported into Cisco Unity, Cisco Unity submits a signed request to Admin4.nsf. DUCS then modifies the user's mail file with Unified Messaging functionality. The changes are made to the database on the server that contains the user's mail file. The Cisco Unity 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 Cisco Unity server group needs privileges to sign requests submitted to the Administrative Process database. This corresponds to editor-level permissions in an ACL.

For the Cisco Unity servers group, grant Editor permissions for Names.nsf.

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

In rare cases, you may need to delete a Cisco Unity location object from Names.nsf. For that, you would need delete-documents permissions, too, but they can be granted later if necessary.

For the Cisco Unity servers group, change the user type to Mixed Group (optional).

Install IBM Lotus Domino Unified Communications (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.

Each 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, DUCS 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(s), 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 Cisco Unity person and, when prompted, create a Lotus Notes mail file for it. Save the .id file for the Cisco Unity user on a disk or in a directory other than the Domino directory (the default option). 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. Add the account to the UnityServers group that you created in Step 1. Refer to the applicable IBM Lotus documentation.


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 from the server 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.


Step 3 Grant permissions for the Cisco Unity servers group:

Grant Editor permissions for Admin4.nsf.

Grant Editor permissions for Names.nsf.

Change the user type to Mixed Group (optional).

Refer to the applicable IBM Lotus documentation.

Step 4 On each Domino server that will home Cisco Unity subscribers, install csServer, the server component of DUC for Cisco.


Caution Do not install the server component on the Cisco Unity server.

Step 5 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. For installation instructions, refer to the applicable IBM Lotus documentation.


Caution Do not install the administration component on the Cisco Unity server.

Step 6 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 of 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 Cisco Unity 4.0 System Requirements and Supported Hardware and Software at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/sysreq/40_sysrq.htm.


Caution If you want to use the Domino Administrator option Upgrade to More Secure Internet Password Format, you must install Notes 5.0.11 or later on the Cisco Unity server. Otherwise Cisco Unity subscribers will not be able to log on to the Cisco Personal Communications Assistant.


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

Do the following two 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 CD-ROM 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 choose the applicable option, depending on the version of Notes you are installing:

Notes R6

Click Only for Me, and click Next.

Notes R5

Uncheck Shared Installation, and click Next.


Step 5 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 Drive Locations for Files on the Cisco Unity System" section.

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

Step 6 Click Next.

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

Step 8 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 9 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 Click I Want to Connect to a Domino Server, and click Next.

Step 4 Enter the applicable information, depending on the version of Notes you are configuring:

Notes 6

a. Enter a user name and the name of the Domino server on which the Cisco Unity mail file was created.

b. Click Next.

Notes 5

a. Click Set Up Connection to a Local Area Network (LAN), and click Next.

b. Enter the name of the Domino server on which the Cisco Unity mail file was created, and click Next.

c. Click My Notes User ID Has Been Supplied to Me in a File.


Step 5 Browse to the directory where the .id file for the Cisco Unity user is saved (on a network drive or on a disk), and double-click the file.

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


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

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

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

Step 9 Exit Lotus Notes.