Domino Unified Communications 1.2.4 for Cisco Readme File

About DUC 1.2.4

IBM(R) Lotus(R) Domino(TM) Unified Communications (DUC) is a set of software that integrates with Domino and IBM(R) Lotus(R) Notes and Cisco Unity to provide users with access to their voice mail and e-mail through either their Lotus Notes or Domino Web Access client or their telephone. DUC 1.2.4 is supported with Cisco Unity 7.0(2) and Cisco Unity 5.0(1).

 

For details on operating systems, Domino, and Notes versions supported with DUC 1.2.4, refer to the section “Domino Requirements—Message Store” in:

·       System Requirements for Cisco Unity Release 7.x  http://www.cisco.com/en/US/docs/voice_ip_comm/unity/7x/requirements/7xcusysreq.html

·       System Requirements for Cisco Unity Release 5.0  http://www.cisco.com/en/US/docs/voice_ip_comm/unity/5x/requirements/50cusysreq.html

 

NOTE: For Cisco Unity 5.0(1), to use telephone record and playback (TRaP) in Domino Web Access or in the Notes client to listen to or record voice messages, you must install Cisco Unity ES 48 (or a later ES).

 

For details on operating systems and Notes versions supported with DUC 1.2.4 on client workstations, see the section “Cisco Unity with Domino: Supported Software on Subscriber Workstations Compatibility Matrix:” in Cisco Unity and the Software on Subscriber Workstations http://www.cisco.com/en/US/docs/voice_ip_comm/unity/compatibility/matrix/cuclientmtx.html.

 

For information about DUC, including information about what’s new in DUC 1.2.4, see the Domino Unified Communications 1.2.4 Administration Help for Cisco - Installing and Configuring - IBM Lotus Notes, which is available on the DUC 1.2.4 DVD in the file DOC\csUCAdminGuide.nsf.

 

NOTE:  Although the operating systems Windows NT 4.0, AIX 5.1, AIX 5.2 are listed in the “Notes and Domino release support” section in the Domino Unified Communications 1.2.4 Administration Help for Cisco, they are not supported with DUC 1.2.4.

New Installations

For new installations, in addition to installing DUC 1.2.4, there are several other steps to preparing your Domino servers for use with Cisco Unity. For details, refer to the chapter "Setting Up Domino and Installing Lotus Notes” in the Installation Guide for Cisco Unity Release 5.x with IBM Lotus Domino, available at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_installation_guides_list.html. (For Cisco Unity 7.x, use the Release 5.x versions of guides—all content in the guides applies to Release 7.x)

Upgrading to DUC 1.2.4 from an Earlier DUC Version

To upgrade to DUC 1.2.4, you must first uninstall the existing DUC components. This section provides a task list and procedures on upgrading to DUC 1.2.4 from an earlier version of DUC.

Task List

  1. Stop Cisco Unity.
  2. Uninstall the existing DUC administration component.
  3. Uninstall the existing DUC server component on every Domino server on which it is installed.
  4. Install the DUC 1.2.4 server component on every Domino server on which Cisco Unity subscribers have or will have mail files.
  5. Install the DUC 1.2.4 administration component.
  6. Start Cisco Unity.
  7. Uninstall the existing DUC client component on every client computer.
  8. Install DUC 1.2.4 client component on every client computer.
  9. Update each user’s mail file.
  10. Uninstall Domino Web Access on every client computer. The DUC 1.2.4 components for Domino Web Access will be pushed out to the client computer the first time that the user launches Domino Web Access to listen to a voice message.

 

The following procedures provide basic steps for uninstalling and then reinstalling the DUC components. For more information, refer to Domino Unified Communications 1.2.4 Administration Help for Cisco - Installing and Configuring - IBM Lotus Notes, which is available on the DUC 1.2.4 DVD in the file DOC\csUCAdminGuide.nsf. See also the file INSTALL-AIX.doc on the DUC 1.2.4 DVD.

Stop Cisco Unity

1. Log on to the Cisco Unity server.

2. Right-click the Cisco Unity icon in the status area of the taskbar.

3. Click Stop Cisco Unity.

 

For more details, refer to the System Administration Guide for Cisco Unity Release 5.x (With IBM Lotus Domino), the "Exiting and Starting the Cisco Unity Software" section of the "Accessing and Using the Cisco Unity Administrator" chapter. Available at: http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_maintenance_guides_list.html

Uninstall the DUC Administration Component

1.    In the Domino Administrator or Lotus Notes client on the computer where the existing DUC csAdmin component is installed, 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.

2.    Make sure that the Domino administration server is running.

3.    On the Windows Start menu, click Settings > Control Panel.

4.    Open Add/Remove Programs.

5.    Remove Domino Unified Communications Administration 1.2.x for Cisco.

6.    Close Add/Remove Programs.

Uninstall the Windows Version of the DUC Server Component

1.       Exit all Windows applications and stop the Domino server. (Enter quit in the Domino console.)

2.       On the Windows Start menu, click Settings > Control Panel.

3.       Open Add/Remove Programs.

4.       Remove Domino Unified Communications Administration 1.2.x for Cisco.

5.       Close Add/Remove Programs.

6.       Repeat steps 1 through 5 on every Domino server that the old version of DUC is installed on.

Uninstall the AIX Version of the DUC Server Component

1.       Log in or switch user to root.

2.       Stop the Domino server. (Enter quit in the Domino console.)

3.       Change to the _uninstDUCServer directory in your Lotus Notes data directory. For example:
cd /local/notesdata/_uninstDUCServer

4.       Run uninstaller.bin by entering the following:
./uninstaller.bin

5.       Repeat steps 1 through 4 on every Domino server that the old version of DUC is installed on.

Install the DUC Server Component on Windows

Make sure that the server is running a supported version of Domino. Refer to the section “Domino Requirements—Message Store” in:

·       System Requirements for Cisco Unity Release 7.x  http://www.cisco.com/en/US/docs/voice_ip_comm/unity/7x/requirements/7xcusysreq.html

·       System Requirements for Cisco Unity Release 5.0  http://www.cisco.com/en/US/docs/voice_ip_comm/unity/5x/requirements/50cusysreq.html

 

1.       Exit all Windows applications and stop the Domino server.

2.       From the DUC 1.2.4 DVD, within the applicable language folder, open the Win32\csServer folder and double-click Setup.exe

3.       Follow the on-screen instructions in the setup program to install the server component.

4.       If you want to enable multiple mail templates for DUC, rerun the setup program. Select "DUC-enable multiple mail templates" and then follow the on-screen instructions.

5.       Start the Domino server.

6.       If you are installing the DUC server component on a Domino partitioned server, perform Steps 1 to 5 for each Domino server partition, each time specifying the partition's individual data directory.

 

Refer to the Domino Unified Communications 1.2.4 Administration Help for Cisco for information on enabling DUC mail templates for single copy template. 

Install the DUC Server Component on AIX 

You should be able to run the DUC server install directly from the DVD/CD.

 

1.       Log in or switch user to root.

2.       Make sure the Domino server is not running.

3.       If you have not already done so, create a directory for the CD. For example:
mkdir –p /cdrom

4.       Mount the cdrom. For example:
mount -v cdrfs -r /dev/cd0 /cdrom

5.       Go to the cdrom directory. For example:
cd /cdrom

6.       Go to the CSServerAIX subdirectory.

7.       Run setupaix.bin by entering the following:
./setupaix.bin

8.       Respond to all installation prompts.

9.       Start the Domino server. For example, enter:
/opt/ibm/lotus/bin/server

 

Refer to Domino Unified Communications 1.2.4 Administration Help for Cisco for troubleshooting information.

Install the DUC Administration Component for Cisco 

 

1.       Make sure that the workstation is running a supported version of the IBM Lotus Domino Administrator or IBM Lotus Notes client.

2.       In the Domino Administrator or Lotus Notes client, switch to a Notes ID that has Designer or higher access to the administration server for the Domino Directory. Note that after you start the install program, you cannot switch to another ID.

3.       Make sure that you have access to the Domino administration server and that it is running.

4.       Exit all Windows programs, including the Notes client and the Domino Administrator.

5.       From the DUC 1.2.4 DVD, within the applicable language folder, open the Win32\csAdmin folder and double-click Setup.exe. Follow the on-screen prompts.

 

Refer to Domino Unified Communications 1.2.4 Administration Help for Cisco for information on how to manually update the Domino Directory.

Start Cisco Unity

1. Log on to the Cisco Unity server.

2. Right-click the Cisco Unity icon in the status area of the taskbar.

3. Click Start Cisco Unity.

Uninstall the DUC Client Component

1.    On the user’s computer, from the Windows Start menu, click Settings > Control Panel.

2.    Open Add/Remove Programs.

3.    Remove Domino Unified Communications Client 1.2.x for Cisco.

4.    Close Add/Remove Programs.

5.    Reboot the client computer.

Install the DUC Client Component

Note  Be sure your TEMP environment variable is set properly prior to running install. You must include the drive letter, for example, c:\temp as opposed to \temp. Not including the drive letter may result in an incomplete install or in unpredictable behavior during install.

Manual install

This procedure copies the DUC program files to the workstation and installs a DUC mail template, for example UCMAIL8.NTF. In earlier releases, the installation program could replace the current Notes mail design. Replacing the mail design is now a separate step (File - Application - Replace Design). For Domino Web Access subscribers, the mail file design is updated automatically when the subscriber is enabled.

 

1.       Verify that the DUC-enabled server is running and that you can connect to it.

2.       Exit all Windows programs, including the Notes client.

3.       From the DUC 1.2.4 DVD, within the applicable language folder, open the Win32\csClient folder and double-click Setup.exe.

4.       Follow the on-screen instructions in the setup program to install the client component.

5.       Replace your current Notes mail file design (see the next section for details).

 

Refer to Domino Unified Communications 1.2.4 Administration Help for Cisco for information on:

·       How to do a silent install of the DUC client component.

·       Troubleshooting silent install.

·       Supporting roaming DUC users on a multi-user Notes client.

Update the Mail File Design with the DUC Mail Template File 

After installing DUC client component, you must update the design of the active mail file (for example, MAIL8.NSF) with that of the DUC mail template installed during DUC client installation (for example, UCMAIL.NTF) before subscribers can use DUC.

 

·       From Domino Designer, copy the design elements from the DUC mail template (for example, ucmail.ntf) to the Notes mail file or mail template (for example, MAIL8.NTF).

OR

·       While active in Notes mail, click File - Application - Replace Design, navigate to the installed DUC mail template, for example UCMAIL8.NTF, select it, and respond as prompted.

If you do not see the menu option File - Application - Replace Design (From “Several advanced menu choices in Notes 8 are not displayed by default” http://www-1.ibm.com/support/docview.wss?uid=swg21268395):

“Note: The Advanced menus default to ON if all Notes 8 clients are installed: Notes client, Lotus Domino Designer® client, and Domino Administrator client.

If a Notes-Only install is performed, by default the Advanced Menus are not available. However, the following notes.ini parameter can be supplied through a custom desktop policy or via an MST, and this will enable access to Replace and Refresh Design advanced menu actions: "MenusAdvanced=1"

Uninstall and Reinstall the Domino Web Access DUC Components

Domino Web Access users who have a previous release of DUC are not automatically prompted to upgrade to a new version of the player/recorder. To obtain the updated

player/recorder, Domino Web Access users must complete this procedure to uninstall the earlier version:

 

1.       Click Start -- Control Panel -- Add or Remove Programs and remove the DUC DWA application.

2.       Manually clear the UC Player from Microsoft(R)Internet Explorer, using the Internet Options menu selection. Instructions for IE6 and IE7 browser version are as below:

IE6 browser

1.    Log out of DWA mail file.

2.    Click Tools - Internet Options.

3.    On General tab, click Settings.

4.    Click View Objects...

5.    Right-click Lotus UC Player.

6.    Remove instead of Add-ons.

 

IE7 browser

1.    Log out of DWA mail file.

2.    Click Tools - Internet Options.

3.    On Programs tab, click Manage add-ons.

4.    With Add-ons that have been used by Internet Explorer selected, look for Lotus UC Player.

5.    Select Lotus UC Player and click Delete (or Disable). If Lotus UC Player is not visible in the list, click Downloaded Active X controls.

 

The next time the user opens a voice message, a prompt to install the updated player/recorder appears.