Guest

Cisco Unity

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

  • Viewing Options

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

Table Of Contents

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

Contents

Introduction

Requirements

Voice Connector Requirements

Hard Disk Space Requirements

Compatibility Information

Determining the Voice Connector Version

Related Documentation

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

New and Changed Functionality—Release 15.0(1)

Installation and Upgrade Information

Downloading the Voice Connector

Installing the Voice Connector

Installing the Voice Connector for Trusted Internet Locations

Upgrading to Voice Connector 15.0(1)

Uninstalling the Voice Connector

Installation and Upgrade Notes

Secure Messaging Certificates Are Removed When Uninstalling the Voice Connector

SMTP Pickup Directory

Caveat Information

Obtaining Documentation and Submitting a Service Request


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


Published February 23, 2010

These release notes contain information on downloading and installing software, and caveats for Cisco Unity Voice Connector for Microsoft Exchange Release 15.0(1).

Voice Connector 15.0(1) is shipped with Cisco Unity version 8.x (on DVD 1).

Contents

Introduction

Requirements

Related Documentation

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

New and Changed Functionality—Release 15.0(1)

Installation and Upgrade Information

Caveat Information

Obtaining Documentation and Submitting a Service Request

Introduction

The Cisco Unity Voice Connector for Microsoft Exchange is a networking component that enables messaging between Cisco Unity servers and other voice messaging systems.

The Voice Connector can be used when your network consists of only Exchange 2003 servers, or of a mixture of Exchange 2000, Exchange 2003, and Exchange 2007 servers.

Voice Connector version 15.0(1) can be installed on either an Exchange 2000 or an Exchange 2003 server.

For more information, see the following documentation:

The "Voice Connector in Cisco Unity 8.x" section in the "Networking in Cisco Unity 8.x" chapter of the Networking Guide for Cisco Unity at http://www.cisco.com/en/US/docs/voice_ip_comm/unity/8x/networking/guide/8xcunetx.html.

The "Cisco Unity Voice Connector for Microsoft Exchange Versions" section of Networking Options Requirements for Cisco Unity at http://www.cisco.com/en/US/docs/voice_ip_comm/unity/compatibility/matrix/cunetoptionsreqs.html.

Requirements

Voice Connector Requirements

Hard Disk Space Requirements

Compatibility Information

Determining the Voice Connector Version

Voice Connector 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.

Instead, you can use the Interoperability Gateway for Microsoft Exchange on an Exchange 2007 server to provide support for Cisco Unity Connection Networking, VPIM Networking, and trusted Internet subscribers. (See the "Interoperability Gateway for Microsoft Exchange in Cisco Unity 8.x" section in the "Networking in Cisco Unity 8.x" chapter of the Networking Guide for Cisco Unity.)

Caution Installing the Transport Event Sink for VPIM Networking 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.

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. 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.


Compatibility Information

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

Determining the Voice Connector Version

To Determine the Voice Connector Version in Use


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.


Related Documentation

For descriptions and URLs of Cisco Unity documentation on Cisco.com, see the Documentation Guide for Cisco Unity Release 8.x. The guide is shipped with Cisco Unity and is available at http://www.cisco.com/en/US/docs/voice_ip_comm/unity/8x/roadmap/8xcudg.html.

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

There are no new or changed requirements or support in this release.

(For information on new and changed requirements and support in earlier versions of the Cisco Unity Voice Connector for Microsoft Exchange Connection, see the applicable release notes at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_release_notes_list.html.)

New and Changed Functionality—Release 15.0(1)

There is no new or changed functionality in this release.

(For information on new and changed functionality in earlier versions of the Cisco Unity Voice Connector for Microsoft Exchange Connection, see the applicable release notes at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_release_notes_list.html.)

Installation and Upgrade Information

Downloading the Voice Connector

Installing the Voice Connector

Upgrading to Voice Connector 15.0(1)

Uninstalling the Voice Connector

Installation and Upgrade Notes

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 Downloads 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, and click Cisco Unity Voice Connector for Microsoft Exchange 15.0.

Step 3 On the Select a Release page, click 15.0(1), and the file information and Download Now button appear on the right side of the page.

Step 4 Confirm that the computer you are using has sufficient hard disk space for the downloaded file. (The file information includes the download size.)

Step 5 Click Download Now and follow the on-screen prompts to complete the download to the directory of your choice.

Step 6 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 7 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 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/Applications/Unity/PermissionsWizard/Unity50/PW50.html.)

For instructions on installing the Voice Connector, see the applicable documentation:

AMIS Networking—The "Setting Up the Voice Connector for AMIS Networking" subsection in the "Procedures for Setting Up Cisco Unity 8.x to Use AMIS" section in the "AMIS Networking in Cisco Unity 8.x" chapter of the Networking Guide for Cisco Unity Release 8.x at http://www.cisco.com/en/US/docs/voice_ip_comm/unity/8x/networking/guide/8xcunetx.html.

Bridge Networking—The "Setting Up the Voice Connector for Bridge Networking" section in the "Setting Up Cisco Unity and the Bridge for Networking" chapter of the Networking Guide for Cisco Unity Bridge Release 3.1 at http://www.cisco.com/en/US/docs/voice_ip_comm/bridge/31/networking/guide/31ex_5x/31cubnetex.html.

Trusted Internet Locations—The "Installing the Voice Connector for Trusted Internet Locations" section of these release notes.

VPIM Networking—The "Setting Up the Voice Connector for VPIM Networking" subsection in the "Procedures for Setting Up Cisco Unity 8.x to Use VPIM Networking" section in the "VPIM Networking in Cisco Unity 8.x" chapter of the Networking Guide for Cisco Unity Release 8.x at http://www.cisco.com/en/US/docs/voice_ip_comm/unity/8x/networking/guide/8xcunetx.html.

Installing the Voice Connector for Trusted Internet Locations


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

Instead, you can use the Interoperability Gateway for Microsoft Exchange on an Exchange 2007 server to provide support for Cisco Unity Connection Networking, VPIM Networking, and trusted Internet locations. (See the "Interoperability Gateway for Microsoft Exchange in Cisco Unity 8.x" section in the "Networking in Cisco Unity 8.x" chapter of the Networking Guide for Cisco Unity.)

Do the following two procedures in the order listed.

To Install the Voice Connector for Trusted Internet Locations


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.)


Upgrading to Voice Connector 15.0(1)

You must uninstall any previous version of the Voice Connector that is on the server on which you will be upgrading the Voice Connector. See the "Uninstalling the Voice Connector" section.

To install Voice Connector version 15.0(1), see the "Installing the Voice Connector" section.

Uninstalling the Voice Connector

Voice Connector version 15.0(1) is shipped with Cisco Unity 8.x (on DVD 1).

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

You can use the procedure in this section to uninstall Voice Connector version 15.0(1), 14.0(1), or 12.0(1). To uninstall an older version of the Voice Connector, see the Release Notes for Cisco Unity Voice Connector for Microsoft Exchange for the version you are uninstalling at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_release_notes_list.html.

To Uninstall the Voice Connector (Versions 15.0, 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.


Installation and Upgrade Notes

Secure Messaging Certificates Are Removed When Uninstalling the Voice Connector

SMTP Pickup Directory

Secure Messaging Certificates Are Removed When Uninstalling the Voice Connector

Uninstalling the Secure Messaging Service component of the Voice Connector 15.0(1), 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 "Uninstalling the Voice Connector" 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.


Caveat Information

You can find the latest caveat information for Cisco Unity Voice Connector for Microsoft Exchange version 15.0(1) by using Bug Toolkit, an online tool available for customers to query defects according to their own needs.

Bug Toolkit is available at www.cisco.com/go/bugs. Fill in your query parameters by using the custom settings in the Advanced Settings option.


Note To access Bug Toolkit, you must be logged on to Cisco.com as a registered user.


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.)

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.