Guest

Cisco Unity

Release Notes for Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1)

  • Viewing Options

  • PDF (302.2 KB)
  • Feedback
Release Notes for Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1)

Table Of Contents

Release Notes for Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1)

Contents

Introduction

Compatibility Information

System Requirements

Hard Disk Space Requirements

Determining the Voice Connector Version

Downloading the Voice Connector

Installing the Voice Connector

Installing the Voice Connector for AMIS Networking

Installing the Voice Connector for Bridge Networking

Installing the Voice Connector for Trusted Internet Locations

Installing the Voice Connector for VPIM Networking

Uninstalling the Voice Connector

Uninstall Procedures

New and Changed Requirements and Support—Release 14.0(1)

New and Changed Functionality—Release 14.0(1)

Voice Message-Duration Tagging

VPIM Delivery Location Configuration Options

Warning Message When Uninstalling the Voice Connector

Installation and Upgrade Notes

Secure Messaging Certificates Are Removed When Uninstalling the Voice Connector

SMTP Pickup Directory

Caveats

Open Caveat—Release 14.0(1)

Resolved Caveats—Release 14.0(1)

Cisco Unity Documentation

Obtaining Documentation and Submitting a Service Request


Release Notes for Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1)


Published May 21, 2008

These release notes contain compatibility information, system requirements, installation instructions, new and changed support, new and changed functionality, and caveats for Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1).

Voice Connector 14.0(1) is available with Cisco Unity version 7.0(2) and later.

Contents

Introduction

Compatibility Information

System Requirements

Determining the Voice Connector Version

Downloading the Voice Connector

Installing the Voice Connector

Uninstalling the Voice Connector

New and Changed Requirements and Support—Release 14.0(1)

New and Changed Functionality—Release 14.0(1)

Installation and Upgrade Notes

Caveats

Cisco Unity Documentation

Obtaining Documentation and Submitting a Service Request

Introduction

The Voice Connector is a Cisco Unity (with Microsoft Exchange) networking component that enables messaging between:

Cisco Unity servers that access separate directories.

Cisco Unity servers and other voice messaging systems by way of AMIS, VPIM, or the Cisco Unity Bridge.

Note that Voice Connector for Exchange 2000 version 14.0(1) can be installed on either an Exchange 2000 or Exchange 2003 server.

Compatibility Information

For detailed information on the networking option combinations and versions of Cisco Unity that can be used with Voice Connector 14.0(1), see Cisco Unity Networking Options Requirements (Cisco Unity Version 5.x and Later), available at http://www.cisco.com/en/US/docs/voice_ip_comm/unity/compatibility/matrix/cunetoptionsreqs.html.

System Requirements

Install the Voice Connector on any Exchange 2000 or Exchange 2003 server that is not part of an Exchange cluster (Microsoft does not support third-party connectors on an Exchange cluster server). Although the Voice Connector can be installed on the Cisco Unity server (when Exchange is also on the server), this is not recommended for performance reasons.


Caution Installing the Voice Connector on an Exchange 2007 server is not supported.

If the Exchange server on which the Voice Connector will be installed is in a different routing group than the Exchange servers on which Cisco Unity subscribers are homed, routing group connectors must be configured between the routing groups.

The Voice Connector service is automatically configured to log on as the account that is associated with the Exchange server on which the Voice Connector is installed (sometimes referred to as the "Local System" account). The account that the service logs on as should not be changed.


Caution Do not change the default permissions for the Local System account. In addition, do not change the permissions granted to Exchange administrative groups during Exchange installation. The Voice Connector logs on using that account, and if you change permissions, the Voice Connector may not function properly.


Caution Installing the Transport Event Sink for VPIM Networking on an Exchange 2007 server is not supported.

In order to view Voice Connector properties in Exchange System Manager, Microsoft Windows Script Host version 5.6 or later must be installed on the Exchange server on which the Voice Connector is installed. Note that if the Exchange server uses an earlier version of Windows Script Host, the Voice Connector functions properly, but you will not be able to view Voice Connector properties in Exchange System Manager.

Hard Disk Space Requirements

The Exchange 2000 or Exchange 2003 private store consumes more hard disk space after the Voice Connector is installed. Administrators should plan to have sufficient space available on the Exchange 2000 or Exchange 2003 server that will host the Voice Connector for Exchange 2000. Lack of disk space introduces a risk of experiencing severe problems on the Exchange server.

The required space is directly related to the amount of traffic processed by the Voice Connector per 24 hours, and the file size of the messages. Table 1 provides storage requirements for the Exchange server to handle the increase in size of the Priv1.edb and Priv1.stm files. These requirements are in addition to the current storage requirements on the server to handle activity unrelated to the Voice Connector.

Table 1 Additional Storage Space Needed for Voice Message Processing 

Messages Processed
Per 24 Hours
Average Message Size
Additional Storage Required

20,000

1 min - G.711 (~640 KB)

18 GB1

10,000

1 min - G.711 (~640 KB)

9 GB

5,000

1 min - G.711 (~640 KB)

5 GB

20,000

1 min - G.729a (~80 KB)

4 GB

10,000

1 min - G.729a (~80 KB)

2 GB

5,000

1 min - G.729a (~80 KB)

1 GB

1 Exchange 2000 Standard Edition does not support database size greater than 16 GB.


Determining the Voice Connector Version

This section contains two procedures. Do the procedure for your version of Cisco Unity.

To Determine the Voice Connector Version in Use (Cisco Unity Version 7.x and 5.x)


Step 1 Log on to the Exchange server on which the Voice Connector is installed.

Step 2 In Windows Explorer or My Computer, browse to the <ExchangeServerPath>\VoiceGateway\Bin directory.

Step 3 Right-click GwIvc.exe, and click Properties.

Step 4 Click the Version tab in the Properties window.

Step 5 In the Item Name box, click Product Version to view the product version in the Value box.


To Determine the Voice Connector Version in Use (Cisco Unity Version 4.x)


Step 1 Log on to the Exchange server on which the Voice Connector is installed.

Step 2 In Windows Explorer or My Computer, browse to the applicable directory:

Exchange 2000
or Exchange 2003

<ExchangeServerPath>\VoiceGateway\Bin

Exchange 5.5

<ExchangeServerPath>\Connect\Voice\Bin


Step 3 Right-click GwIvc.exe, and click Properties.

Step 4 Click the Version tab in the Properties window.

Step 5 In the Item Name box, click Product Version to view the product version in the Value box.


Downloading the Voice Connector

To Download the Voice Connector


Step 1 On a computer with a high-speed Internet connection, go to the Voice and Unified Communications Download page at http://tools.cisco.com/support/downloads/pub/Redirect.x?mdfid=278875240.


Note To access the software download page, you must be logged on to Cisco.com as a registered user.


Step 2 In the tree control on the Downloads page, expand Unified Communications Applications > Voice Mail and Unified Messaging > Cisco Unity. Download the file CiscoUnityVoiceConnector14.0.1-Ex2000.exe to the directory of your choice.


Note Confirm that the computer you are using has sufficient hard disk space for the downloaded file. The download file size appears on the Downloads page.


Step 3 Unzip the downloaded file and extract the files to the directory of your choice. The extracted files must be accessible from the Exchange server on which the Voice Connector will be installed. (The Voice Connector Setup program creates several folders within the folder in which the Exchange server software is installed and copies files to these folders.)

Step 4 Delete the downloaded zip file to free hard disk space.


Installing the Voice Connector

If you have not already done so, uninstall any previous version of the Voice Connector that is on the server on which you will be installing the Voice Connector. See the "Uninstalling the Voice Connector" section.

As a best practice, back up the Exchange server before installing the Voice Connector.

We also recommend that you run the Cisco Unity Permissions wizard version 5.0(1) or later on a Cisco Unity server in the network and select the Report on Current Permissions option before installing the Voice Connector, to confirm that permissions are set properly. Download and run the latest version of the Permissions wizard that is applicable to your version of Cisco Unity. The Permissions wizard is available at http://www.ciscounitytools.com/4_x_tools.htm.

Follow the procedures in the applicable section:

Installing the Voice Connector for AMIS Networking

Installing the Voice Connector for Bridge Networking

Installing the Voice Connector for Trusted Internet Locations

Installing the Voice Connector for VPIM Networking

Installing the Voice Connector for AMIS Networking


Caution Installing the Voice Connector on an Exchange 2007 server is not supported.

Do the following two procedures in the order listed.

To Install the Voice Connector for Exchange 2000


Step 1 Log on to the Exchange server on which you are installing the Voice Connector.

Step 2 Disable any virus-scanning services on the Exchange server.

Step 3 If Cisco Unity is also on the server on which you are installing the Voice Connector, disable the Cisco Security Agent service, if applicable.

Step 4 If you are installing the Voice Connector from a Cisco Unity DVD or CD, insert the disc in the computer, and browse to the VoiceConnector-Ex2000 directory.

If you downloaded the Voice Connector files from the Software Center website, browse to the directory in which the files were extracted.

Step 5 Double-click Install.exe, and click Next.

Step 6 On the Voice Connector Setup Wizard Select Components dialog box, check the Voice Connector for Exchange check box.

Step 7 If you are setting up secure messaging and if Cisco Unity is not on the Exchange server, check the Cisco Secure Messaging Service check box.

Step 8 Click Next.

Step 9 On the Welcome screen, click Next.

Step 10 On the Confirm SMTP Pickup Directory screen, click Next.

Step 11 In the Address Types dialog, check the AMIS check box.

Step 12 If you are setting up the system to use other networking options, check the check boxes of the applicable address types.


Note Note that setting up VPIM Networking also requires the installation of the Transport Event Sink.


Step 13 Click Next.

Step 14 On the Confirm Directory dialog box, click Next to launch the setup.

Step 15 If you did not check the Cisco Secure Messaging Service check box in Step 7, skip to Step 16. Otherwise, do the following steps in the Cisco Unity Secure Messaging Service Setup wizard:

a. On the Welcome screen, click Next.

b. On the Choose Destination Folder dialog, specify the destination, and click Next.

c. On the Message Security Settings screen, optionally check the Enable Message Aging check box, and enter the number of days that encrypted messages should be available. (If the check box is unchecked, Cisco Unity will not limit the number of days for which encrypted messages will be available.)

d. Click Next.

e. On the Ready to Install Software screen, click Install.

Step 16 When the setup is complete, click Finish to exit Setup and restart the server.

Step 17 If you had previously installed and configured the Voice Connector for secure messaging on an Exchange server that did not also host Cisco Unity, and you want to restore the previous secure messaging certificate on the Exchange server, continue with Step 18. Otherwise, skip to Step 24.


Caution If you do not restore the previous secure messaging certificate, subscribers will not be able to access previously recorded secure messages that are forwarded through the Voice Connector.

Step 18 Install the latest version of the Cisco Unity Disaster Recovery Restore tool on the Exchange server.

Step 19 Open the Disaster Recovery Restore tool.

Step 20 Click Browse to browse to the location of a Cisco Unity DiRT backup file that contains the secure messaging certificates, or enter the location in the Backup Source Location field.

Step 21 Check the Restore Certificates Used for Secure Messaging check box.

Step 22 Click Restore From Backup.

Step 23 When the restore is complete, click Exit to close the Disaster Recovery Restore tool.

Step 24 Enable virus-scanning and the Cisco Security Agent services, if applicable.


To view Voice Connector properties in Exchange System Manager, Windows Script Host version 5.6 or later must be installed on the Exchange server. (Note that if the Exchange server uses an earlier version of Windows Script Host, the Voice Connector functions properly, but you will not be able to view Voice Connector properties in Exchange System Manager.)

To Determine Whether to Update Windows 2000 Script Host


Step 1 On the Exchange server on which the Voice Connector has been installed, browse to Winnt\System32.

Step 2 Right-click the file Wshom.ocx, and click Properties.

Step 3 Click the Version tab.

Step 4 In the Item Name list, click Product Version to view the version in the Value box.

Step 5 If the version is earlier than 5.6, update Windows Script Host so the Voice Connector properties can be displayed in Exchange System Manager. (Go to the downloads page of the Microsoft website, and do a keyword search for Windows Script Host. Follow the installation instructions.)


Installing the Voice Connector for Bridge Networking


Caution Installing the Voice Connector on an Exchange 2007 server is not supported.

Do the following two procedures in the order listed.

To Install the Voice Connector for Exchange 2000


Step 1 Log on to the Exchange server on which you are installing the Voice Connector.

Step 2 Disable any virus-scanning services on the Exchange server.

Step 3 If Cisco Unity is also on the server on which you are installing the Voice Connector, disable the Cisco Security Agent service, if applicable.

Step 4 If you are installing the Voice Connector from a Cisco Unity DVD or CD, insert the disc in the computer, and browse to the VoiceConnector-Ex2000 directory.

If you downloaded the Voice Connector files from the Software Center website, browse to the directory in which the files were extracted.

Step 5 Double-click Install.exe, and click Next.

Step 6 On the Voice Connector Setup Wizard Select Components dialog box, check the Voice Connector for Exchange check box.

Step 7 If you are setting up secure messaging and if Cisco Unity is not on the Exchange server, check the Cisco Secure Messaging Service check box.

Step 8 Click Next.

Step 9 On the Welcome screen, click Next.

Step 10 On the Confirm SMTP Pickup Directory screen, click Next.

Step 11 In the Address Types dialog, check the Bridge check box.

Step 12 If you are setting up the system to use other networking options, check the check boxes of the applicable address types.


Note Note that setting up VPIM Networking also requires the installation of the Transport Event Sink.


Step 13 Click Next.

Step 14 On the Confirm Directory dialog box, click Next to launch the setup.

Step 15 If you did not check the Cisco Secure Messaging Service check box in Step 7, skip to Step 16. Otherwise, do the following steps in the Cisco Unity Secure Messaging Service Setup wizard:

a. On the Welcome screen, click Next.

b. On the Choose Destination Folder dialog, specify the destination, and click Next.

c. On the Message Security Settings screen, optionally check the Enable Message Aging check box, and enter the number of days that encrypted messages should be available. (If the check box is unchecked, Cisco Unity will not limit the number of days for which encrypted messages will be available.)

d. Click Next.

e. On the Ready to Install Software screen, click Install.

Step 16 When the setup is complete, click Finish to exit Setup and restart the server.

Step 17 If you had previously installed and configured the Voice Connector for secure messaging on an Exchange server that did not also host Cisco Unity, and you want to restore the previous secure messaging certificate on the Exchange server, continue with Step 18. Otherwise, skip to Step 24.


Caution If you do not restore the previous secure messaging certificate, subscribers will not be able to access previously recorded secure messages that are forwarded through the Voice Connector.

Step 18 Install the latest version of the Cisco Unity Disaster Recovery Restore tool on the Exchange server.

Step 19 Open the Disaster Recovery Restore tool.

Step 20 Click Browse to browse to the location of a Cisco Unity DiRT backup file that contains the secure messaging certificates, or enter the location in the Backup Source Location field.

Step 21 Check the Restore Certificates Used for Secure Messaging check box.

Step 22 Click Restore From Backup.

Step 23 When the restore is complete, click Exit to close the Disaster Recovery Restore tool.

Step 24 Enable virus-scanning and the Cisco Security Agent services, if applicable.


To view Voice Connector properties in Exchange System Manager, Windows Script Host version 5.6 or later must be installed on the Exchange server. (Note that if the Exchange server uses an earlier version of Windows Script Host, the Voice Connector functions properly, but you will not be able to view Voice Connector properties in Exchange System Manager.)

To Determine Whether to Update Windows 2000 Script Host


Step 1 On the Exchange server on which the Voice Connector has been installed, browse to Winnt\System32.

Step 2 Right-click the file Wshom.ocx, and click Properties.

Step 3 Click the Version tab.

Step 4 In the Item Name list, click Product Version to view the version in the Value box.

Step 5 If the version is earlier than 5.6, update Windows Script Host so the Voice Connector properties can be displayed in Exchange System Manager. (Go to the downloads page of the Microsoft website, and do a keyword search for Windows Script Host. Follow the installation instructions.)


Installing the Voice Connector for Trusted Internet Locations


Caution Installing the Voice Connector on an Exchange 2007 server is not supported.

Do the following two procedures in the order listed.

To Install the Voice Connector for Exchange 2000


Step 1 Log on to the Exchange server on which you are installing the Voice Connector.

Step 2 Disable any virus-scanning services on the Exchange server.

Step 3 If Cisco Unity is also on the server on which you are installing the Voice Connector, disable the Cisco Security Agent service, if applicable.

Step 4 If you are installing the Voice Connector from a Cisco Unity DVD or CD, insert the disc in the computer, and browse to the VoiceConnector-Ex2000 directory.

If you downloaded the Voice Connector files from the Software Center website, browse to the directory in which the files were extracted.

Step 5 Double-click Install.exe, and click Next.

Step 6 On the Voice Connector Setup Wizard Select Components dialog box, check the Voice Connector for Exchange check box.

Step 7 If you are setting up secure messaging and if Cisco Unity is not on the Exchange server, check the Cisco Secure Messaging Service check box.

Step 8 Click Next.

Step 9 On the Welcome screen, click Next.

Step 10 On the Confirm SMTP Pickup Directory screen, click Next.

Step 11 In the Address Types dialog, check the Trusted Internet Location check box.

Step 12 If you are setting up the system to use other networking options, check the check boxes of the applicable address types.


Note Note that setting up VPIM Networking also requires the installation of the Transport Event Sink.


Step 13 Click Next.

Step 14 On the Confirm Directory dialog box, click Next to launch the setup.

Step 15 If you did not check the Cisco Secure Messaging Service check box in Step 7, skip to Step 16. Otherwise, do the following steps in the Cisco Unity Secure Messaging Service Setup wizard:

a. On the Welcome screen, click Next.

b. On the Choose Destination Folder dialog, specify the destination, and click Next.

c. On the Message Security Settings screen, optionally check the Enable Message Aging check box, and enter the number of days that encrypted messages should be available. (If the check box is unchecked, Cisco Unity will not limit the number of days for which encrypted messages will be available.)

d. Click Next.

e. On the Ready to Install Software screen, click Install.

Step 16 When the setup is complete, click Finish to exit Setup and restart the server.

Step 17 If you had previously installed and configured the Voice Connector for secure messaging on an Exchange server that did not also host Cisco Unity, and you want to restore the previous secure messaging certificate on the Exchange server, continue with Step 18. Otherwise, skip to Step 24.


Caution If you do not restore the previous secure messaging certificate, subscribers will not be able to access previously recorded secure messages that are forwarded through the Voice Connector.

Step 18 Install the latest version of the Cisco Unity Disaster Recovery Restore tool on the Exchange server.

Step 19 Open the Disaster Recovery Restore tool.

Step 20 Click Browse to browse to the location of a Cisco Unity DiRT backup file that contains the secure messaging certificates, or enter the location in the Backup Source Location field.

Step 21 Check the Restore Certificates Used for Secure Messaging check box.

Step 22 Click Restore From Backup.

Step 23 When the restore is complete, click Exit to close the Disaster Recovery Restore tool.

Step 24 Enable virus-scanning and the Cisco Security Agent services, if applicable.


To view Voice Connector properties in Exchange System Manager, Windows Script Host version 5.6 or later must be installed on the Exchange server. (Note that if the Exchange server uses an earlier version of Windows Script Host, the Voice Connector functions properly, but you will not be able to view Voice Connector properties in Exchange System Manager.)

To Determine Whether to Update Windows 2000 Script Host


Step 1 On the Exchange server on which the Voice Connector has been installed, browse to Winnt\System32.

Step 2 Right-click the file Wshom.ocx, and click Properties.

Step 3 Click the Version tab.

Step 4 In the Item Name list, click Product Version to view the version in the Value box.

Step 5 If the version is earlier than 5.6, update Windows Script Host so the Voice Connector properties can be displayed in Exchange System Manager. (Go to the downloads page of the Microsoft website, and do a keyword search for Windows Script Host. Follow the installation instructions.)


Installing the Voice Connector for VPIM Networking


Caution Installing the Voice Connector on an Exchange 2007 server is not supported.

To set up VPIM Networking, the Voice Connector and the Transport Event Sink must be installed. Although you use the same Voice Connector installation program to install these components, where you install them depends on the network configuration.

If you are installing the Voice Connector on multiple Exchange servers, in most cases you install the Transport Event Sink only once. The Exchange server on which the Transport Event Sink is installed should be the Exchange server that will receive incoming VPIM messages. Only one instance of the Transport Event Sink is necessary when all VPIM messages will be routed through a single Exchange server. When incoming VPIM messages will be routed through multiple Exchange servers, the Voice Connector and Transport Event Sink should be installed on each of the servers.

Do the following three procedures, as applicable.

To Install the Voice Connector for Exchange 2000 and Optionally, the Transport Event Sink, on the Same Server


Step 1 Log on to the Exchange server on which you are installing the Voice Connector.

Step 2 Disable any virus-scanning services on the Exchange server.

Step 3 If Cisco Unity is also on the server on which you are installing the Voice Connector, disable the Cisco Security Agent service, if applicable.

Step 4 If you are installing the Voice Connector from a Cisco Unity DVD or CD, insert the disc in the computer, and browse to the VoiceConnector-Ex2000 directory.

If you downloaded the Voice Connector files from the Software Center website, browse to the directory in which the files were extracted.

Step 5 Double-click Install.exe, and click Next.

Step 6 On the Voice Connector Setup Wizard Select Components dialog box, check the Voice Connector for Exchange check box.

Step 7 If you are setting up secure messaging and if Cisco Unity is not on the Exchange server, check the Cisco Secure Messaging Service check box.

Step 8 If you are installing the Transport Event Sink on the same server, check the Transport Event Sink for VPIM Networking check box.

Step 9 Click Next.

Step 10 If you did not check the Transport Event Sink for VPIM Networking check box in Step 8, skip to Step 11. Otherwise, do the following steps:

a. On Transport Event Sink wizard Welcome screen, click Next.

b. On the Choose Destination Folder dialog box, specify the destination, and click Next.

c. On Enter Domain Name dialog box, follow the instructions to specify the domain. (Typically, the domain entered is the same as the domain that will be entered on the Primary Location page. Note that the domain does not have to be the same domain as that of the server on which the Transport Event Sink is being installed.)

d. Click Next.

e. On the Ready to Install the Program screen, click Install.

f. When the installation is complete, click Finish.

Step 11 On the Voice Connector for Exchange Welcome screen, click Next.

Step 12 On the Confirm SMTP Pickup Directory screen, click Next.

Step 13 In the Address Types dialog, check the VPIM check box.

Step 14 If you are setting up the system to use other networking options, check the check boxes of the applicable address types.

Step 15 Click Next.

Step 16 On the Confirm Directory dialog box, click Next to launch the setup.

Step 17 If you did not check the Secure Messaging Service check box in Step 7, skip to Step 18. Otherwise, do the following steps in the Cisco Unity Secure Messaging Service Setup wizard:

a. On the Welcome screen, click Next.

b. On the Choose Destination Folder dialog, specify the destination, and click Next.

c. On the Message Security Settings screen, optionally check the Enable Message Aging check box, and enter the number of days that encrypted messages should be available. (If the check box is unchecked, Cisco Unity will not limit the number of days for which encrypted messages will be available.)

d. Click Next.

e. On the Ready to Install Software screen, click Install.

Step 18 When the setup is complete, click Finish to exit Setup and restart the server.

Step 19 If you had previously installed and configured the Voice Connector for secure messaging on an Exchange server that did not also host Cisco Unity, and you want to restore the previous secure messaging certificate on the Exchange server, continue with Step 20. Otherwise, skip to Step 26.


Caution If you do not restore the previous secure messaging certificate, subscribers will not be able to access previously recorded secure messages that are forwarded through the Voice Connector.

Step 20 Install the latest version of the Cisco Unity Disaster Recovery Restore tool on the Exchange server.

Step 21 Open the Disaster Recovery Restore tool.

Step 22 Click Browse to browse to the location of a Cisco Unity DiRT backup file that contains the secure messaging certificates, or enter the location in the Backup Source Location field.

Step 23 Check the Restore Certificates Used for Secure Messaging check box.

Step 24 Click Restore From Backup.

Step 25 When the restore is complete, click Exit to close the Disaster Recovery Restore tool.

Step 26 Enable virus-scanning and the Cisco Security Agent services, if applicable.


To view Voice Connector properties in Exchange System Manager, Windows Script Host version 5.6 or later must be installed on the Exchange server. (Note that if the Exchange server uses an earlier version of Windows Script Host, the Voice Connector functions properly, but you will not be able to view Voice Connector properties in Exchange System Manager.)

To Determine Whether to Update Windows 2000 Script Host


Step 1 On the Exchange server on which the Voice Connector has been installed, browse to Winnt\System32.

Step 2 Right-click the file Wshom.ocx, and click Properties.

Step 3 Click the Version tab.

Step 4 In the Item Name list, click Product Version to view the version in the Value box.

Step 5 If the version is earlier than 5.6, update Windows Script Host so the Voice Connector properties can be displayed in Exchange System Manager. (Go to the downloads page of the Microsoft website, and do a keyword search for Windows Script Host. Follow the installation instructions.)


To Install Only the Transport Event Sink on a Separate Exchange Server


Step 1 Log on to the Exchange server on which you are installing the Transport Event Sink.

Step 2 Disable any virus-scanning services on the Exchange server.

Step 3 If Cisco Unity is also on the server on which you are installing the Transport Event Sink, disable the Cisco Security Agent service, if applicable.

Step 4 If you are installing the Transport Event Sink by running the Voice Connector installation program from a Cisco Unity DVD or CD, insert the disc in the computer, and browse to the VoiceConnector-Ex2000 directory.

If you downloaded the Voice Connector files from the Software Center website, browse to the directory in which the files were extracted.

Step 5 Double-click Install.exe, and click Next.

Step 6 On the Voice Connector Setup Wizard Select Components dialog box, check the Transport Event Sink for VPIM Networking check box, and click Next.

Step 7 On Transport Event Sink wizard Welcome screen, click Next.

Step 8 On the Choose Destination Folder dialog box, specify the destination, and click Next.

Step 9 On Enter Domain Name dialog box, follow the instructions to specify the domain. (Typically, the domain entered is the same as the domain that will be entered on the Primary Location page. Note that the domain does not have to be the same domain as that of the server on which the Transport Event Sink is being installed.)

Step 10 Click Next.

Step 11 On the Ready to Install the Program screen, click Install.

Step 12 When the installation is complete, click Finish to exit Setup and restart the server.

Step 13 Enable virus-scanning and the Cisco Security Agent services, if applicable.


Uninstalling the Voice Connector

The uninstall procedure that you use depends on the Cisco Unity Voice Connector version in use. Beginning with Cisco Unity version 4.0(1), the Voice Connector itself was assigned a version separate from the Cisco Unity version. Voice Connector version 14.0(1) is included with Cisco Unity 7.0(2).

To determine the version of an installed Voice Connector, see the "Determining the Voice Connector Version" section.

In the following "Uninstall Procedures" section, do the procedure that is applicable to your installation, depending on the versions of Exchange and the Voice Connector.

Uninstall Procedures

This section contains three procedures. Do the procedure that applies to your installation:

To Uninstall the Voice Connector for Exchange 2000 (Voice Connector Version 14.0 and 12.0)

To Uninstall the Voice Connector for Exchange 2000 (Voice Connector Version 10.0 Through 11.0)

To Uninstall the Voice Connector for Exchange 5.5 (Voice Connector Version 10.0 Through 11.0)

To Uninstall the Voice Connector for Exchange 2000 (Voice Connector Version 14.0 and 12.0)


Step 1 If you are not using secure messaging, if the Voice Connector is installed on the Cisco Unity server, or if you have already backed up the Cisco Unity server (including the secure messaging certificate) by using the Cisco Unity Disaster Recovery tools (DiRT), skip to Step 7. Otherwise, continue with Step 2 to back up the secure messaging certificates.


Caution Uninstalling the Voice Connector on an Exchange server that does not also host Cisco Unity removes the secure messaging certificates from the Exchange server. If you do not have a backup of the certificates, and you later reinstall the Voice Connector, subscribers will not be able to access previously recorded secure messages that are forwarded through the Voice Connector.

Step 2 On the Cisco Unity server (the secondary server, if Cisco Unity failover is configured), install the latest versions of DiRT, if the tools are not already installed. DiRT is available at http://ciscounitytools.com/App_DisasterRecoveryTools.htm.

Step 3 Open the Disaster Recovery Backup tool.

Step 4 Enter a location in the Backup Target Location field, and check the Include Security Certificate Used for Secure Messaging check box.

Step 5 Configure any additional options for other items you want to back up. Refer to DiRT Help for detailed instructions. (The Help file, UnityDisasterRecovery.htm, is in the same directory as UnityDisasterRecoveryBackup.exe.)


Caution Follow Help carefully. DiRT includes a variety of options that you must understand to use the tools successfully. In addition, the account you are logged on as when you back up Cisco Unity data must have sufficient permissions or the backup will fail.

Step 6 Click Back Up Now to start the backup. When the backup completes, click Exit to close the Disaster Recovery Backup tool.

Step 7 Log on to the Exchange server on which the Voice Connector is installed.

Step 8 On the Windows Start menu, click Settings > Control Panel > Add/Remove Programs.

Step 9 Click the Voice Connector component to uninstall the Exchange 2000 Voice Connector.

Step 10 Follow the on-screen prompts to uninstall the component.

Step 11 Repeat Step 9 and Step 10 to also uninstall the following two components:

Cisco Unity Transport Event Sink

Cisco Unity Secure Messaging Service

Step 12 On the Windows Start menu, click Programs > Microsoft Exchange > System Manager.

Step 13 Expand Servers\<Server name>\<Storage group>\Mailbox Store\Mailboxes for the server on which the Voice Connector was installed.

The mailbox for the Voice Connector is named "AvExchangeIVC_<Servername>" or "Exchange 2000 Voice Connector (<Servername>)."

Step 14 Right-click Mailboxes in the left pane, and click Run Cleanup Agent.

Step 15 After the Cleanup Agent has run, right-click each Voice Connector mailbox marked with the red X icon and click Purge. Click Yes in the warning dialog box.

Step 16 Close the Exchange System Manager.

Step 17 Close Add/Remove Programs.


To Uninstall the Voice Connector for Exchange 2000 (Voice Connector Version 10.0 Through 11.0)


Step 1 Log on to the Exchange server on which the Voice Connector is installed.

Step 2 On the Windows Start menu, click Settings > Control Panel > Add/Remove Programs.

Step 3 Click Exchange 2000 Voice Connector.

Step 4 Follow the on-screen prompts to uninstall the Voice Connector.

Step 5 On the Windows Start menu, click Programs > Microsoft Exchange > System Manager.

Step 6 Expand Servers\<Server name>\<Storage group>\Mailbox Store\Mailboxes for the server on which the Voice Connector was installed.

The mailbox for the Voice Connector is named "AvExchangeIVC_<Servername>" or "Exchange 2000 Voice Connector (<Servername>)."

Step 7 Right-click Mailboxes in the left pane, and select Run Cleanup Agent.

Step 8 After the Cleanup Agent has run, right-click each Voice Connector mailbox marked with the red X icon and select Purge. Click Yes in the warning dialog box.

Step 9 Close the Exchange System Manager.


To Uninstall the Voice Connector for Exchange 5.5 (Voice Connector Version 10.0 Through 11.0)


Step 1 Log on to the Exchange server on which the Voice Connector is installed.

Step 2 On the Windows Start menu, click Settings > Control Panel > Add/Remove Programs.

Step 3 Select the Voice Connector.

Step 4 Follow the on-screen prompts to uninstall the Voice Connector.


New and Changed Requirements and Support—Release 14.0(1)

There are no new or changed requirements or support in Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1).

See the release notes of the applicable version for information on new and changed requirements and support in earlier versions of the Voice Connector. Release notes for all versions of the Voice Connector are available at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_release_notes_list.html.

New and Changed Functionality—Release 14.0(1)

This section contains information about new and changed functionality for Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1) only. See the release notes of the applicable version for information on new and changed functionality in earlier versions of the Voice Connector. Release notes for all versions of the Voice Connector are available at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_release_notes_list.html.

Note that the new functionality provided by Voice Connector 14.0(1) is available only with Cisco Unity with Microsoft Exchange, Release 7.0(2) and later.

Voice Message-Duration Tagging

When the Voice Connector processes voice messages for Cisco Unity subscribers, it includes a tag that indicates the duration of the voice recording. This tag can be used by visual clients (such as Phone View) to display the length of the message.

VPIM Delivery Location Configuration Options

When used with Cisco Unity 7.0(2), Voice Connector 14.0(1) supports the following new VPIM delivery location configuration options, which apply when sending messages from Cisco Unity to the delivery location:

Remove Message Subject—If enabled, the Voice Connector does not include the "Subject:" MIME header or value when converting the message to VPIM for sending to this location.

Remove All Text Attachments—If enabled, the Voice Connector removes all text attachments when converting the voice message to VPIM for sending to this location. This includes any previous vCard attachments on the message; however, if the delivery location is configured to include the sender's vCard, this vCard will still be added to the message before sending.

Remove All Fax Attachments—If enabled, the Voice Connector removes all fax attachments when converting the message to VPIM for sending to this location.

Note that when any of these settings are enabled, the sender is not notified that part of the message has been removed.

Warning Message When Uninstalling the Voice Connector

The uninstall program for the Secure Messaging Service component of the Voice Connector 14.0(1) includes a warning message box that alerts you that you should back up the certificates used in message encryption and decryption before uninstalling this component. See also the "Secure Messaging Certificates Are Removed When Uninstalling the Voice Connector" section.

Installation and Upgrade Notes

Secure Messaging Certificates Are Removed When Uninstalling the Voice Connector

Uninstalling the Secure Messaging Service component of the Voice Connector 14.0(1) or 12.0(1) on an Exchange server that does not also host Cisco Unity removes the secure messaging certificate from the Exchange server. If you do not have a backup of the certificate, and you later reinstall the Voice Connector (for example, to install a newer version), subscribers will not be able to access previously recorded secure messages that are forwarded through the Voice Connector. To avoid this situation, back up the certificate on the Cisco Unity server by using the Cisco Unity Disaster Recovery tools (DiRT) before uninstalling the Voice Connector, so that you can restore the certificate to the Exchange server after reinstalling the Voice Connector. See the "Uninstall Procedures" section for instructions.

SMTP Pickup Directory

If the SMTP pickup directory was not changed in IIS by using metaedit, skip this section.

The Voice Connector places outgoing VPIM messages, outgoing messages to the Cisco Unity Bridge, and outgoing messages to Trusted Internet subscribers in the SMTP pickup directory on the Exchange server on which the Voice Connector is installed. In typical installations, the path to the SMTP pickup directory is C:\Program Files\Exchsvr\Mailroot\vs 1\Pickup. The Microsoft Windows SMTP service monitors the pickup directory, and when it detects a message in the directory, the service attempts to send the message to the destination specified in the message header.

During installation, the Voice Connector setup program obtains the path to the SMTP pickup directory from Active Directory. The Voice Connector setup displays the path on the Confirm SMTP Pickup Directory page and writes the path to the registry in the key HKEY_LOCAL_MACHINE\SOFTWARE\Active Voice\AvIvc\SmtpPickupPath. When the Voice Connector service starts, it reads the path stored in the SmtpPickupPath registry key, and subsequently places outgoing VPIM, Bridge, and Trusted Internet subscriber messages in that directory. If you have not changed the location of the SMTP pickup directory, you will not need to take any further action after installing the Voice Connector.

If you changed the SMTP pickup directory in Active Directory, Active Directory automatically updates the IIS metabase. In this case, the Voice Connector will use the path specified in Active Directory, and you will not need to take any further action after installing the Voice Connector. However, if you changed the path to the SMTP pickup directory in the IIS metabase by using metaedit, then Active Directory may not have been updated, and the Voice Connector may place outgoing VPIM, Bridge, and Trusted Internet subscriber messages in a directory that the SMTP service is not monitoring.

You can fix the problem by either changing the path to the SMTP pickup directory in Active Directory or changing the path in the SmtpPickupPath registry key.

To change the path to the SMTP pickup directory in Active Directory, you can use ADSI Edit. The path is stored in the attribute msExchSmtpPickupDirectory. For more information on using ADSI Edit, refer to the Microsoft documentation.

To change the path in the SmtpPickupPath registry key, do the following procedure.

To Change the SmtpPickupPath Registry Key


Step 1 Start Regedit.


Caution Changing the wrong registry key or entering an incorrect value can cause the server to malfunction. Before you edit the registry, confirm that you know how to restore it if a problem occurs. (See the "Restoring" topics in Registry Editor Help.) If you have any questions about changing registry key settings, contact Cisco TAC.

Step 2 If you do not have a current backup of the registry, click Registry > Export Registry File, and save the registry settings to a file.

Step 3 Expand the key:

HKEY_LOCAL_MACHINE\SOFTWARE\Active Voice\AvIvc

Step 4 In the right-pane, double-click the SmtpPickupPath value.

Step 5 In the Edit String dialog box, change the path in the Value Data field, and click OK.

Step 6 Close Regedit.

Step 7 Open the Services MMC.

Step 8 Right-click Exchange 2000 Voice Connector (<Server name>), and click Restart.

Step 9 Close the Services MMC.


Caveats

If you have an account with Cisco.com, you can use Bug Toolkit to find more information on caveats of any severity for any release. Bug Toolkit is available at the website http://www.cisco.com/go/bugs.

Open Caveat—Release 14.0(1)

Table 2 Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1) Open Caveat 

Caveat Number
Severity
Component
Description

CSCsq05129

3

exchvoicegateway

IVC Exceptions cause entire process to hang


Resolved Caveats—Release 14.0(1)

Table 3 Cisco Unity Voice Connector for Microsoft Exchange Release 14.0(1) Resolved Caveats 

Caveat Number
Severity
Component
Description

CSCae05373

2

exchvoicegateway

Internet Voice Connector (IVC) doesn't install on a machine in a Window

CSCae07149

2

exchvoicegateway

Voice Gateway: Cant install on a Windows2000 DC in a native domain

CSCae08014

2

exchvoicegateway

CPR - IVC install does not work with Win2K machines

CSCdv18091

2

exchvoicegateway

Exchange Voice Gateway does not look at OUs in AD

CSCdw18464

2

exchvoicegateway

Extension Address Utility crashes if subscriber lacks an extension

CSCdw37376

2

exchvoicegateway

AMIS: IVC fails to find locations created in another E55 site

CSCdw89000

2

exchvoicegateway

IVC2000-GEN-privbyte leak ~2MB/hr during 20 port Bridge load

CSCdy34974

2

exchvoicegateway

IVC2000-GEN-get AD or loc takes 5-120 sec when 60000 Uty sub in AD

CSCdy36967

2

exchvoicegateway

IVC-GEN-VOICE-Subs can not properly Send/receive msgs to SMTP locs

CSCdz55172

2

exchvoicegateway

IVC5.5-using LDAP 389 vc stops when processing outbound AMIS msg

CSCea48424

2

exchvoicegateway

IVC2000-abend when no valid attachments and multiple recipients

CSCeb48856

2

exchvoicegateway

Voice connector always uses root domain as its own SMTP address

CSCee08196

2

exchvoicegateway

Voice Connector stops processing messages in MTS-OUT queue

CSCdu81162

3

exchvoicegateway

IVC2000: Mscomctrl.ocx not registered on server without Unity

CSCdu81233

3

exchvoicegateway

IVC2000: From address is in the wrong format

CSCdv22383

3

exchvoicegateway

IVC installer reports SMTP Service error

CSCdv67880

3

exchvoicegateway

Voice Gateway install fails - MSVCP60.dll could not be found.

CSCdv71923

3

exchvoicegateway

IVC installation points to wrong directories

CSCdw06018

3

exchvoicegateway

IVC: Error given if Messages to Process checkbox altered

CSCdw16321

3

exchvoicegateway

IVC2000-VOICE-proxy address must exist for sender of VMO msg to IVC

CSCdw20515

3

exchvoicegateway

IVC2000-VOICE-NDR failed to be sent

CSCdw32294

3

exchvoicegateway

IVC5.5-GEN-gwivc.log has no date/time reference

CSCdw34225

3

exchvoicegateway

IVC does not send NDRs for email messages sent to AMIS subscribers

CSCdw71165

3

exchvoicegateway

Bridge-OctelNet subs can reply to outside caller msgs from Unity

CSCdx84958

3

exchvoicegateway

VPIM-No NDR generated when receiving mailbox over size limit

CSCdx85677

3

exchvoicegateway

Voice Gateway (IVC) 5.5 Fails to Install Correctly

CSCdx86386

3

exchvoicegateway

VPIM-NDRs generated after IVC modifies addr not routed to sender

CSCdy41481

3

exchvoicegateway

IVC-GEN-VOICE-messages w/o valid WAV attachment not NDRed

CSCdy49912

3

exchvoicegateway

Voice connector not moved with Exch svr when routing group changed

CSCdz16087

3

exchvoicegateway

IVC2000-Event Sink not removed when Install run from alternate loc

CSCdz20416

3

exchvoicegateway

VPIM-SMTP locations found and used by Voice Connector for VPIM msgs

CSCdz46253

3

exchvoicegateway

IVC-GEN-Delivery Restrictions settings do not work as expected

CSCdz68535

3

exchvoicegateway

VPIM-Voice Connector should accept messages from postmaster@domain

CSCea63124

3

exchvoicegateway

IVC5.5-Does not recognize hidden Exchange users

CSCeb70841

3

exchvoicegateway

Too many registry permissions are required to install IVC

CSCeb71865

3

exchvoicegateway

Hidden Users not resolved properly in From: Address

CSCec12309

3

exchvoicegateway

Voice Connector should request DR from Exchange on inbound messages

CSCec12560

3

exchvoicegateway

Voice connector abends processing inbound msg when log level = 5

CSCec26682

3

exchvoicegateway

IVC2000-No NDR generated when deliv location has no remotenodeid

CSCec26719

3

exchvoicegateway

IVC2000-No NDR for Bridge message from Unity sender w/ no legacymbox

CSCed66880

3

exchvoicegateway

Voice Connector message queues not visible in E2K3 System Manager

CSCef28340

3

exchvoicegateway

VC: commas in display name cause unity to unity vpim msg failure

CSCeg44297

3

exchvoicegateway

Bad audio quality for VPIM message from Unity to 3rd party voicemail

CSCeg79348

3

exchvoicegateway

VC: VPIM: eventsync routes all ndr with leading number alias to vc

CSCsa66650

3

exchvoicegateway

VC delivers inbound msgs even when sender matches multiple contacts

CSCsa69482

3

exchvoicegateway

VC: setup failure in CreateDSObject gives misleading msg box

CSCsa69499

3

exchvoicegateway

VC: install fails due to miscalculated homeMTA

CSCsb50300

3

exchvoicegateway

VC: Bridge/VPIM: Dir msgs not delvrd from voice connector to UOmni/UVpim

CSCsd48585

3

exchvoicegateway

Bridge directory bulk synchronization fails to add all contacts

CSCsd56197

3

exchvoicegateway

IVC: smtp pickup path calculation needs to be more precise

CSCsd59228

3

exchvoicegateway

HrGetServiceSiteDN is unused in Voice Connector install

CSCsf06231

3

exchvoicegateway

Voice Connector (IVC): send NDR if recipient does not have OMNI Address

CSCsj29997

3

exchvoicegateway

Secure Msg: vc inbound encrypt fails due to server name case

CSCsk58626

3

exchvoicegateway

VPIM: voice connector fails to process inbound msg with many recipients


Cisco Unity Documentation

For descriptions and URLs of Cisco Unity documentation on Cisco.com, see the Documentation Guide for Cisco Unity. The document is shipped with Cisco Unity and is available at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/products_documentation_roadmaps_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 and Cisco currently supports RSS version 2.0.