Table Of Contents
VPIM Networking
Overview: VPIM Networking
Task List: Setting Up Cisco Unity To Use VPIM Networking
Procedures for Setting Up Cisco Unity To Use VPIM Networking
Making Design Decisions and Gathering Needed Information
Verifying Connectivity Between Exchange and the Remote Voice Messaging System
Resolving Names with IP Addresses
Extending the Active Directory Schema
Setting Up the Voice Connector for VPIM Networking (Exchange 2000)
Customizing the Primary Location
Setting Search Options
Creating VPIM Delivery Locations
Creating VPIM Subscribers
Before Creating Subscriber Accounts
Using the Cisco Unity Bulk Import Wizard To Create Multiple Subscriber Accounts
Correcting CSV Import Errors
Using the Cisco Unity Administrator To Create VPIM Subscriber Accounts
After Creating Subscriber Accounts
Gathering Information About Cisco Unity To Configure Another Voice Messaging System for VPIM
VPIM Concepts and Definitions
Introduction to VPIM
VPIM Messages
VPIM Addresses
Locations and VPIM Networking
Voice Connector and VPIM Networking
How the Voice Connector Processes Outgoing VPIM Messages
How the Voice Connector Processes Incoming VPIM Messages
Message Addressing Options
Messaging Similarities and Limitations
Blind Addressing and VPIM Networking
Subscriber Experience with Blind Addressing
VPIM Subscribers
Subscriber Experience with VPIM Subscribers
Extension Address Utility
Hiding VPIM Subscribers
Migrating Subscribers from Another Voice Messaging System to Cisco Unity
Considerations for Networked Cisco Unity Servers
Phone Prefixes
Audio Formats Supported
VPIM Reference
VPIM Delivery Location Profile Settings
VPIM Networking
Overview: VPIM Networking
Cisco Unity supports the Voice Profile for Internet Messaging (VPIM) protocol, which allows different voice messaging systems to exchange voice, fax, and text messages over the Internet or any TCP/IP network. VPIM is based on the Simple Mail Transfer Protocol (SMTP) and Multi-Purpose Internet Mail Extension (MIME) protocols.
VPIM Networking is a licensed feature. If your organization has multiple Cisco Unity servers networked together, only one server needs to be licensed and configured for VPIM Networking. The Cisco Unity server configured for VPIM Networking is referred to as the bridgehead server.
In this chapter, you will find procedures for setting up VPIM Networking. See the following sections:
•Task List: Setting Up Cisco Unity To Use VPIM Networking—This task list provides a high-level view of all of the tasks you need to complete, and the order in which they should be completed.
•Procedures for Setting Up Cisco Unity To Use VPIM Networking—This section contains all of the procedures necessary to set up Cisco Unity for VPIM Networking.
•VPIM Concepts and Definitions—This section explains VPIM concepts in detail. You may want to read this section prior to completing the setup procedures.
•VPIM Reference—This section contains tables that define the fields on the Cisco Unity Administrator web pages related to VPIM setup, and briefly explain the options for correctly entering information in the fields.
For a list of VPIM-compliant voice messaging systems that Cisco Unity supports, refer to Cisco Unity System Requirements, and Supported Hardware and Software on Cisco.com, at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_pre_installation_guides_list.html.
Task List: Setting Up Cisco Unity To Use VPIM Networking
Use this task list to set up VPIM Networking in Cisco Unity. The cross-references take you to detailed procedures for the setup.
1. Make decisions about your dial plan and gather information needed to configure VPIM Networking. See the "Making Design Decisions and Gathering Needed Information" section.
2. Verify network and SMTP connectivity between Exchange and the remote voice messaging system. See the "Verifying Connectivity Between Exchange and the Remote Voice Messaging System" section.
3. Extend the Active Directory schema to enable VPIM Networking. See the "Extending the Active Directory Schema" section.
4. Install the Cisco Unity Voice Connector on an Exchange 2000 server. See the "Setting Up the Voice Connector for VPIM Networking (Exchange 2000)" section.
On the Cisco Unity server that will be set up for VPIM Networking:
5. Customize the primary location profile settings. See the "Customizing the Primary Location" section.
6. Set the addressing and directory handler search options. See the "Setting Search Options" section.
7. Create delivery locations for each remote voice messaging system. See the "Creating VPIM Delivery Locations" section.
8. Optionally, create VPIM subscribers. See the "Creating VPIM Subscribers" section.
9. Set up the remote voice messaging system for VPIM. Precisely how this is done depends on the voice messaging system; you may need to provide the remote system with information about Cisco Unity. See the "Gathering Information About Cisco Unity To Configure Another Voice Messaging System for VPIM" section.
10. Test the setup to verify that Cisco Unity can exchange messages with the other voice messaging system.
Procedures for Setting Up Cisco Unity To Use VPIM Networking
This section contains all of the procedures necessary to set up Cisco Unity for VPIM Networking.
Making Design Decisions and Gathering Needed Information
Before you begin setting up Cisco Unity for VPIM Networking, be sure to plan for the following, and gather the appropriate information:
•Review your dial plan strategy to determine if you will need to enter prefixes on the VPIM delivery location and to determine which numbers to assign as Dial IDs for the primary location and the VPIM delivery location.
•Determine whether you want Cisco Unity subscribers to use blind addressing or to address messages to VPIM subscribers.
•Make note of the following information about the remote voice messaging system: the mailbox range, the server name, the domain name, and the IP address.
•Determine which Exchange server(s) on which to install the Voice Connector and the event sink. Make note of the server name, domain name, and the IP address of the Exchange server.
•You may want to record information on the Cisco Unity Customization Worksheets before entering the information in the Cisco Unity Administrator. The Cisco Unity Customization Worksheets are available on Cisco.com, at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_pre_installation_guides_list.html. Enter information on the following worksheets:
–Primary Locations > Profile
–Primary Location > Addressing Options
–Call Management > Directory Handler > Search Options
–VPIM Delivery Location
–Subscriber Template settings, Subscriber COS settings, and Subscriber settings (only if you are creating VPIM subscribers)
Verifying Connectivity Between Exchange and the Remote Voice Messaging System
Verify that the Exchange server on which the Voice Connector and the event sink will be installed has network and SMTP connectivity with the remote voice messaging server, and vice-versa.
VPIM messages are sent over the Internet (or any TCP/IP network) via SMTP. With Cisco Unity, the processing of VPIM messages occurs on the Exchange server on which the Voice Connector and the event sink are installed. An SMTP service will be running on the Exchange server. This may not be the case on the remote voice messaging server. Before proceeding, verify that the SMTP service or gateway has been installed on the remote voice messaging server. Refer to the remote voice messaging system documentation for information on installing the SMTP service or gateway.
To verify network connectivity between Exchange and the remote voice messaging server
Step 1 On the Exchange server on which the Voice Connector and event sink will be installed, open a command prompt window.
Step 2 Enter ping <IP address> where <IP address> is the IP address of the remote voice messaging server.
If you receive no reply, troubleshoot the network connectivity problem until the problem is resolved. Then continue with Step 3.
Step 3 Enter ping <domain name> where <domain name> is the domain name of the remote voice messaging server.
Note This is the domain name that will be entered on the VPIM delivery location page in the Cisco Unity Administrator when setting up VPIM Networking.
Then enter ping <server name> where <server name> is the name of the remote voice messaging server.
If you receive a reply when pinging the IP address, but no replies when pinging the domain name and server name, see the "Resolving Names with IP Addresses" section. When the problem(s) are resolved, continue with Step 4.
Step 4 Repeat Step 2 and Step 3 on the remote voice messaging server, entering the IP address, domain name, and server name of the Exchange server on which the Voice Connector and event sink will be installed.
Note The domain name entered in this step is the domain name that is entered on the primary location page in the Cisco Unity Administrator, and during the Voice Connector setup program on the dialog box about the event sink.
If any of the above ping tests fail, there is a basic network connectivity problem that needs to be resolved before proceeding with the VPIM Networking setup.
When you verify that you have basic network connectivity, continue with the next procedure, To verify SMTP Connectivity between Exchange and the remote voice messaging server.
To verify SMTP Connectivity between Exchange and the remote voice messaging server
Step 1 In a command prompt window on the Exchange server on which the Voice Connector will be installed (Server 1), enter telnet <server name> 25, where <server name> is the name of the server on the remote voice messaging system (Server 2).
Step 2 If there is a response from Server 2, enter ehlo. Server 2 should respond with a list of SMTP commands.
Step 3 If the telnet test was successful, enter quit to end the telnet session.
Step 4 Repeat Step 1 through Step 3 to verify that SMTP connectivity works in the opposite direction: do the steps in a command prompt window on Server 2, entering the server name of the Exchange server on which the Voice Connector will be installed (Server 1).
If any of the telnet tests fails, there is a basic SMTP connectivity problem that must be resolved before proceeding with the VPIM Networking setup.
Resolving Names with IP Addresses
Both the Exchange and remote voice messaging servers require some mechanism for name resolution. While any method or combination of methods may be used, two common ways to accomplish name resolution are through Domain Name System (DNS), and by using HOSTS files.
If the Exchange server and/or the remote voice messaging server are in a network that uses DNS, the servers should have a host address resource (A) record and mail exchange (MX) record in DNS. If the A and MX records for the servers have not already been added, do so now before continuing. Refer to your operating system documentation for more information about adding A and MX records in DNS.
A HOSTS file is a text file that contains the mappings of IP addresses to host and domain names. If the Exchange server is in a network that does not use DNS, you will need to edit the HOSTS file to add host and domain entries for the remote voice messaging server. The HOSTS file on the Exchange server is located in the C:\WINNT\system32\drivers\etc folder. If the remote voice messaging server is in a network that does not use DNS, you will need to edit the HOSTS file on the remote voice messaging server to add host and domain entries for the Exchange server. The location of the HOSTS file on the remote voice messaging server depends on the operating system that is used. Some systems may have a user interface for editing the HOSTS file. Refer to the remote voice messaging system documentation for more information.
Extending the Active Directory Schema
Before Cisco Unity is installed, the Active Directory schema is extended to store Cisco Unity-specific information. To support VPIM Networking, the schema must be further extended to add attributes to the Cisco Unity location object class. To see the schema changes that need to be made to support VPIM Networking, browse to the directory Schema\LdifScripts on Cisco Unity Disc 1, and view the file vpimgateway.ldf.
To extend the Active Directory schema for VPIM Networking
Do this procedure only if you have not already modified the Active Directory schema to support VPIM Networking during the Cisco Unity installation. A log file is generated each time the schema is updated. A shortcut to the directory where the log file is located is placed on the Windows desktop.
Step 1 Verify that all domain controllers are online before making the schema updates. Schema replication will occur only if all domain controllers are online.
Step 2 On the domain controller that is the schema master, log on by using an account that is a member of the Schema Administrators group.
Step 3 Insert Cisco Unity Disc 1, and browse to the ADSchemaSetup directory.
Step 4 Double-click ADSchemaSetup.exe, and then double-click the dialog box that is displayed to proceed with the installation.
Step 5 Check Exchange 2000 VPIM Connector, uncheck the other check boxes, and then click OK.
Step 6 When the LDAP Data Interchange Format (LDIF) scripts have finished running, click OK.
Step 7 Wait for the changes to the schema to replicate throughout the forest before adding information to the primary location and to delivery locations. Changes to the schema may take 15 minutes or more to replicate.
Note To determine whether changes have replicated and to force replication if necessary, use the Replication Monitor, which is available when you install Support Tools from the Windows 2000 compact disc.
Setting Up the Voice Connector for VPIM Networking (Exchange 2000)
Although there are two Voice Connector installation programs included on Cisco Unity Disc 1, the Voice Connector for Exchange 2000 is the only one supported for VPIM Networking.
Install the Voice Connector on an Exchange 2000 server. If the Exchange 2000 and Cisco Unity servers are in different routing groups, a routing group connector must be installed. Although the Voice Connector can be installed on the Cisco Unity server (if Exchange 2000 is also on the server), this is not recommended for performance reasons.
Do not install the Voice Connector on a server in an Exchange cluster. Microsoft does not support third-party connectors on an Exchange cluster server.
If a prior version of the Voice Connector is installed, it may need to be uninstalled before continuing. How you uninstall the Voice Connector depends on the version that is installed. See "Upgrade and Uninstall Information" for more information. After uninstalling the existing Voice Connector, continue with the next procedure, To install the Voice Connector for Exchange 2000.
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 As a best practice, backup the Exchange server before installing the Voice Connector.
Step 3 Disable any virus-scanning services on the Exchange server.
Step 4 Insert Cisco Unity Disc 1, and browse to the VoiceConnector-Ex2000 folder.
Step 5 Double-click Install.exe and then click Next.
Step 6 In the Address Types dialog box, check VPIM.
Step 7 Click Next, the VPIM Transport Sink dialog box is displayed.
Step 8 Optionally check Install SMTP Transport Event Sink. If you are installing the Voice Connector on multiple Exchange servers, in most cases you need to 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 if all VPIM messages will be routed through a single Exchange server. If incoming VPIM messages will be routed through multiple Exchange servers, then the Voice Connector and Transport Event Sink should be installed on each of these servers.
Step 9 If you checked Install SMTP Transport Event Sink, then enter the SMTP Domain.This is the domain name used in your e-mail addresses/recipient policy, which does not have to be the same domain as that of the server on which the SMTP Transport Event Sink is being installed. Typically, the domain entered here is the same as the one that will be entered on the Primary Location page.
Step 10 Click Next twice.
Step 11 When setup is complete, click Finish to exit Setup and restart the server.
Step 12 Enable virus-scanning services on the server.
Note 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. Continue with the next procedure, To determine if the Microsoft Windows 2000 Script Host should be updated. (Also 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 if the Microsoft Windows 2000 Script Host should be updated
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 select Properties.
Step 3 Click the Version tab.
Step 4 Click Product Version in the Item Name list to view the version in the Value box.
Step 5 If the version is earlier than 5.6, the Windows Script Host needs to be updated in order for the Voice Connector properties to be displayed in the Exchange System Manager.
To update the Windows Script Host, go to the downloads page on the Microsoft website, and do a keyword search for Windows Script Host. Follow the installation instructions.
Customizing the Primary Location
Carefully consider the Dial ID that you will assign to the primary location, particularly if your organization has multiple Cisco Unity servers networked together. See the "Guidelines for Assigning Dial IDs and Extensions" section on page 7-2 for detailed information about choosing a Dial ID.
To customize the primary location
Step 1 In the Cisco Unity Administrator, go to the Network > Primary Location > Profile page.
Step 2 Enter a meaningful name for the location.
Step 3 Enter a Dial ID. The Dial ID identifies this location to Cisco Unity.
Step 4 Record a voice name for the location.
Step 5 Do one of the following:
•If the location does not belong to a dialing domain, click None.
•If the location does belong to a dialing domain, enter the Dialing Domain name only on one Cisco Unity server that is in the dialing domain, and wait for the name to replicate to the other Cisco Unity servers.
Note When setting up the primary location of the other Cisco Unity servers that are members of the dialing domain, select the Dialing Domain name from the list instead of entering a name.
The time that it takes for the primary location data from other Cisco Unity servers to be reflected on the local server depends on your network configuration and replication schedule.
Step 6 Enter the SMTP Domain Name. This is the right half of an e-mail address after the @ symbol (for example, london.cisco.com). Do not enter the @ symbol; Cisco Unity automatically inserts it.
Step 7 Click the Save icon.
Note If your organization has multiple Cisco Unity servers networked together via Digital Networking, the primary location must be configured on those servers as well. In particular, the SMTP Domain Name must be entered on the primary locations of the other Cisco Unity servers. Otherwise, VPIM Networking will not work for the subscribers on the other Cisco Unity servers.
Setting Search Options
In installations with multiple Cisco Unity servers networked together, set the addressing and directory handler search options on all Cisco Unity servers, not just those that you are setting up for VPIM Networking.
See the "Primary Location Addressing Option Settings" section on page 7-5. Also refer to the "Directory Handler Search Options Settings" chapter in the Cisco Unity System Administration Guide, which is available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/products_administration_guide_books_list.html.
To set search options
Step 1 In the Cisco Unity Administrator, go to the Network > Primary Location > Addressing Options page and set the addressing options as needed.
•To allow subscribers created on the local Cisco Unity server to address messages to subscribers on other Cisco Unity servers (that access the same directory), select Dialing Domain or Global Directory, as appropriate.
•If you are using blind addressing to a Cisco Unity server in a separate directory, or to another voice messaging system, set the Blind Addressing Allowed Locations setting to something other than None, as appropriate.
Step 2 If you want locations included in address searches, check Include Locations in Searches. The location name is played only when a subscriber enters the location dial ID when addressing a message.
Step 3 Go to the Call Management > Directory Handlers > Search Options page, and modify the search options for an existing directory handler, or create a new directory handler for unidentified callers who use directory assistance.
To allow subscribers on other Cisco Unity servers to be located in directory assistance, select Dialing Domain. (The Cisco Unity servers must be in the same dialing domain as the local Cisco Unity server.)
Creating VPIM Delivery Locations
Create a VPIM delivery location on your local Cisco Unity server for each remote voice messaging system to which subscribers will send messages. In installations with multiple Cisco Unity servers, you need to create the VPIM delivery location only on the designated VPIM bridgehead server.
Carefully consider the Dial ID that you will assign to the delivery location. See the "Guidelines for Assigning Dial IDs and Extensions" section on page 7-2 for detailed information about choosing a Dial ID.
To create VPIM delivery locations
Step 1 In the Cisco Unity Administrator, go to the Network > Delivery Locations > Profile page.
Step 2 Click the Add icon.
Step 3 Enter a meaningful name for the location.
Step 4 Enter the Dial ID, which identifies the location in Cisco Unity, and which subscribers use to blind address messages to recipients at this location.
Step 5 Select VPIM as the Destination Type for the location.
Step 6 Click Add.
Step 7 Record a voice name for the location.
Step 8 Enter the Internet-addressable SMTP domain name of the system on the TCP/IP network that handles messages for the remote voice messaging system.
Step 9 If needed to accommodate your dial plan, enter a number in the Phone Prefix field in the VPIM Location section. This number is used to construct the VPIM addresses of subscribers on the remote voice messaging system.
Step 10 If needed to accommodate your dial plan, enter a number in the Phone Prefix field in the Cisco Unity Location section. This number is used to construct the VPIM addresses of Cisco Unity subscribers.
Step 11 Indicate whether incoming messages from this VPIM location should be converted to another audio format.
Step 12 Optionally, check the Sender's Recorded Name and/or Sender's vCard check box(es).
Step 13 Click the Save icon.
Creating VPIM Subscribers
You can create VPIM subscriber accounts by using the Cisco Unity Bulk Import wizard or the Cisco Unity Administrator. See the following sections:
•Before Creating Subscriber Accounts
•Using the Cisco Unity Bulk Import Wizard To Create Multiple Subscriber Accounts
•Using the Cisco Unity Administrator To Create VPIM Subscriber Accounts
•After Creating Subscriber Accounts
Before Creating Subscriber Accounts
This section lists—in order—the issues that you must consider before creating subscriber accounts.
1. Cisco Unity Configuration and Permissions
If you are unsure whether the account that you are using has sufficient rights and permissions to create subscribers, or whether Cisco Unity is properly configured to work with your message store, use the following procedure to run the SysCheck diagnostic tool.
To check Cisco Unity setup and permissions by using the Cisco Unity SysCheck tool
Step 1 On the Cisco Unity server desktop, double-click the Cisco Unity Tools Depot icon.
Step 2 In the left pane of the Tools Depot window, in the Diagnostic Tools directory, double-click SysCheck.
Step 3 On the Welcome to the Cisco Unity Configuration Wizard page, click Select Configuration Tests, and click Next.
Step 4 Uncheck the boxes for the message stores that are not connected to Cisco Unity.
Step 5 Click Test.
Step 6 In the Test Results box, click the link provided to view the test results.
Step 7 If no errors are reported, proceed to Step 8. Otherwise, do the following sub-steps:
a. Follow the advice offered in the Resolution column to correct each configuration or permissions error.
b. Return to the Completing the Check Unity Configuration Wizard page, and click Finish.
c. Repeat Step 2 through Step 7 until no errors are reported.
Step 8 Click Finish.
2. Classes of service
A class of service (COS) defines limits and permissions for subscribers who use Cisco Unity. For example, a COS dictates the maximum length of subscriber messages and greetings. Although most COS settings are not applicable to VPIM subscribers, they still must be members of a COS. In the Cisco Unity Administrator, a COS is specified in each subscriber template; thus, a subscriber is assigned to the COS that is specified in the template upon which the subscriber account is based. Cisco Unity includes predefined classes of service, which you can modify. You can also create new classes of service. For details, refer to the "Class of Service Settings" chapter in the Cisco Unity System Administration Guide.
3. Restriction tables
Each COS specifies a restriction table for call transfers, one for message notification, and one for fax deliveries. Cisco Unity applies the restriction table associated with the COS of a subscriber, and displays an error message if the phone number is not allowed. Cisco Unity comes with predefined restriction tables, which you can modify.
Although most restriction table settings do not apply to VPIM subscribers because they cannot log on to Cisco Unity or use the Cisco Personal Communications Assistant (PCA), administrators can enter call transfer numbers for VPIM subscribers. For security purposes, you should modify the restriction table used for transfers in the COS to which VPIM subscribers belong, as necessary. For details, refer to the "Restriction Tables" chapter in the Cisco Unity System Administration Guide.
4. Public distribution lists
Public distribution lists are used to send voice messages to multiple subscribers at the same time. Cisco Unity assigns new subscribers to the public distribution lists that are specified in the template on which the subscriber account is based. For details, refer to the "Public Distribution List Settings" chapter in the Cisco Unity System Administration Guide.
In Active Directory, VPIM subscribers correspond to contacts, and public distribution lists correspond to distribution groups. This means that the contacts and distribution lists are listed in the address book for Outlook (or other e-mail client). To prevent e-mails from being sent to VPIM subscribers, you may want to create lists that contain only VPIM subscribers, and then hide these distribution lists and contacts from Exchange address lists. Additionally, you may also want to exclude VPIM subscribers from the All Subscribers distribution list or any other distribution list that contains regular subscribers.
5. Subscriber templates
In the Cisco Unity Administrator, you can specify settings for a group of subscribers by using a subscriber template. Subscriber templates contain settings that are appropriate for subscribers of a particular type, such as a department. The settings from the template you choose are applied to subscriber accounts as the accounts are created. Cisco Unity comes with a default subscriber template, which you can modify, and you can create an unlimited number of additional templates.
For more details, refer to the "Subscriber Template Settings" chapter in the Cisco Unity System Administration Guide.
The Cisco Unity System Administration Guide is available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/products_administration_guide_books_list.html.
Using the Cisco Unity Bulk Import Wizard To Create Multiple Subscriber Accounts
The Cisco Unity Bulk Import wizard allows you to create multiple subscriber accounts at once by importing user data from a comma-separated value (CSV) file. CSV is a common text file format for moving data from one data store to another. For each new VPIM subscriber account that is created, Cisco Unity creates a corresponding contact in Active Directory.
Use the following procedure to prepare your CSV file. To learn more about preparing a CSV file for use with the Cisco Unity Bulk Import wizard—including information on the required and optional column headers for your CSV file—refer to the Cisco Unity Bulk Import wizard online Help.
To prepare a CSV file for creating VPIM subscriber accounts
Step 1 Save the data which you will use to create Cisco Unity accounts as a CSV file.
As a best practice, do not include more than 7,500 records in a single CSV file, as you may encounter unexpected results when the Cisco Unity Bulk Import wizard imports the data.
Step 2 Copy the CSV file to the Cisco Unity server or to a folder that you can browse to from the server.
Step 3 Open the CSV file in a spreadsheet application or another application with which you can edit and reorganize the data. Do the following:
•Confirm that the data is separated by commas, and no tabs, spaces, or semicolons separate the data in the file.
•If any data includes a space, quotes, or commas, contain it within quotes.
Step 4 Rearrange the data, so that the columns are in the same order as the column headers that you will add in Step 5. The order of the column headers does not matter, though it is good practice to set up your CSV file as indicated here. For example, the columns of data in this sample are sorted so that the last name of the user is followed by the first name, the extension, and then by the remote mailbox number:
Abade,Alex,2001,3000
Bader,Kelly,2002,3100
Campbell,Terry,2003,3200
Cho,Li,2004,3300
Step 5 Enter the required column headers above the first row of data. Column headers must be in uppercase, separated by commas, and spelled as indicated below:
LAST_NAME,FIRST_NAME,DTMF_ACCESS_ID,REMOTE_USER_ID
For example, using the sample data from Step 4, the CSV file would look like this:
LAST_NAME,FIRST_NAME,DTMF_ACCESS_ID,REMOTE_USER_ID
Abade,Alex,2001,3000
Bader,Kelly,2002,3100
Campbell,Terry,2003,3200
Cho,Li,2004,3300
Step 6 If desired, add optional column headers to the first row, and the corresponding data that you want to import in the subsequent rows below. As you do so, confirm that:
•Column headers and data are separated by commas. Note that each row does not have to contain data for each optional column header.
•Any data that includes a space, quotes, or commas is contained within quotes.
Step 7 If your CSV file contains columns of data that you do not want to import, delete the columns. Alternatively, you can title one column NOTES. The Cisco Unity Bulk Import wizard ignores data beneath any NOTES column header, but the wizard does not support more than one NOTES column in a CSV file.
Step 8 Confirm that each row contains the appropriate data corresponding to each column header.
Step 9 Save the file as a CSV file.
Step 10 Continue with the next procedure, To create VPIM subscriber accounts by using the Cisco Unity Bulk Import wizard.
To create VPIM subscriber accounts by using the Cisco Unity Bulk Import wizard
Step 1 On the Cisco Unity server, on the Windows Start menu, click Programs > Cisco Unity > Cisco Unity Bulk Import.
Step 2 Follow the on-screen instructions. (To learn more about the options presented in the dialog boxes that appear as the wizard proceeds, click Help.)
Step 3 When prompted to choose the type of subscriber that you want to create, click VPIM.
Step 4 Click Next, and proceed through the wizard. If the wizard reports any errors, you can:
•Click OK to continue with the import, and fix the errors later.
•Fix the errors. See the "Correcting CSV Import Errors" section for details.
Step 5 Once the subscriber accounts are created, click Finish.
Step 6 If you had import errors, but in Step 4 you chose to correct them later, see the "Correcting CSV Import Errors" section.
If you had no import errors, or if all errors have now been corrected, see the "After Creating Subscriber Accounts" section.
Correcting CSV Import Errors
The error log file contains data that the Cisco Unity Bulk Import wizard could not import. The wizard reports the first error it detects in a row in a CSV file. Once you correct that error, the wizard may detect additional errors in the same row when the data is imported again. Thus, you may need to repeat the correction process—running the Cisco Unity Bulk Import wizard and correcting an error—several times to find and correct all errors.
The output log file contains all the records that were not imported. You can save it as a CSV file, and use it when you run the Cisco Unity Bulk Import wizard again. Note that each time you run the Cisco Unity Bulk Import wizard, the error and output log files are overwritten (unless you specify new names for the files).
To correct import errors, do the procedure, To correct errors that occurred when importing data from a CSV file.
To correct errors that occurred when importing data from a CSV file
Step 1 Go to the directory location of the error log file you specified during the import. (The default location and file name is C:\Error.log.)
Step 2 Use a text editor to open the error log file. You will use the error codes in the file to make corrections.
Step 3 Go to the directory location of the output log file you specified during the import. (The default location and file name is C:\Output.log.)
Step 4 Use a text editor to open the output log file.
Step 5 Correct any records in the output file that are listed as errors in the error log file.
Step 6 When you have finished editing the output log file, save it as a CSV file with a new name.
Step 7 Run the Cisco Unity Bulk Import wizard again with the CSV file that you saved in Step 6.
Step 8 Repeat this procedure until all subscriber accounts are created without error, and then proceed to the "After Creating Subscriber Accounts" section.
Using the Cisco Unity Administrator To Create VPIM Subscriber Accounts
Using the Cisco Unity Administrator, you can create VPIM subscriber accounts one at a time. When you add a new VPIM subscriber account, Cisco Unity creates a contact in Active Directory.
To create an VPIM subscriber account, do the procedure, To add a new VPIM subscriber by using the Cisco Unity Administrator.
To add a new VPIM subscriber by using the Cisco Unity Administrator
Step 1 In the Cisco Unity Administrator, go to the Subscribers > Subscribers > Profile page.
Step 2 Click the Add icon.
Step 3 Click New and select VPIM from the list.
Step 4 Enter the First Name and Last Name.
Step 5 Enter the Extension of the VPIM subscriber on Cisco Unity. This is the number that Cisco Unity subscribers use when addressing a message to this VPIM subscriber.
Step 6 Select the Subscriber Template to use.
Step 7 Enter the Remote Mailbox Number, which is the number that the remote voice messaging system uses to route messages to this VPIM subscriber. This number is used by the Voice Connector to construct a VPIM address for messages to the VPIM subscriber. When constructing a VPIM address, the Voice Connector modifies this number when a prefix is defined on the associated VPIM delivery location page.
Step 8 Select the Delivery Location with which the subscriber is associated.
Step 9 Click Add.
Step 10 On the subscriber record, customize settings as appropriate, and then click the Save icon.
After Creating Subscriber Accounts
After creating VPIM subscriber accounts, consider the following:
•It takes a few minutes for the newly-created subscriber to be available to receive messages.
•To reduce the possibility that e-mails will be sent to VPIM subscribers, you may want to hide the corresponding contacts from the Exchange address list. See the "Hiding VPIM Subscribers" section for more information.
•If you change the Dial ID of the delivery location with which the VPIM subscribers are associated, you will need to run the Extension Address utility to generate new extension addresses. See the "Extension Address Utility" section for more information.
•You can make changes to subscriber settings for individual accounts in the Cisco Unity Administrator. (Note that the Bulk Edit utility cannot be used to modify VPIM subscriber settings.) For details, refer to the "Subscriber Settings" chapter in the Cisco Unity System Administration Guide.
The Cisco Unity System Administration Guide is available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/products_administration_guide_books_list.html.
Gathering Information About Cisco Unity To Configure Another Voice Messaging System for VPIM
Configuring another voice messaging system to exchange VPIM messages with Cisco Unity may require the following information:
•The server name and domain name of the Exchange server on which the Voice Connector and Transport Event Sink are installed.
•The Unity phone prefix (if any) and Remote phone prefix (if any) entered on the corresponding delivery location page.
•Mailbox number range for Cisco Unity subscribers.
VPIM messages destined for Cisco Unity should be sent to the Exchange 2000 server on which the Voice Connector and Transport Event Sink are installed. When defining a location for Cisco Unity on the other voice messaging system, this Exchange server should be specified.
Cisco Unity is expecting incoming VPIM messages to be formatted as <UnityPhonePrefix+UnitySubscriberExtension@PrimaryLocationSMTPDomainName>. These specific properties are configured on Cisco Unity, but to ensure successful message flow, similar information should be provided when configuring the other voice messaging system.
VPIM Concepts and Definitions
The following sections explain VPIM concepts in detail:
•Introduction to VPIM
•Locations and VPIM Networking
•Voice Connector and VPIM Networking
•Message Addressing Options
•Blind Addressing and VPIM Networking
•VPIM Subscribers
•Extension Address Utility
•Hiding VPIM Subscribers
•Migrating Subscribers from Another Voice Messaging System to Cisco Unity
•Considerations for Networked Cisco Unity Servers
•Phone Prefixes
•Audio Formats Supported
Introduction to VPIM
VPIM Networking allows the exchange of voice, fax, and text messages between different voice messaging systems over the Internet or any TCP/IP network. VPIM is an industry-standard protocol based on the Simple Mail Transfer Protocol (SMTP) and Multi-Purpose Internet Mail Extension (MIME) protocols.
VPIM enables organizations to link different voice messaging systems and to provide seamless voice message sending, receiving, forwarding, and replying between these systems. With VPIM Networking, organizations may be able to save long-distance toll charges for network messages. An organization can exchange messages over a TCP/IP-based intranet, or over the Internet, or a combination of the two.
The VPIM specification defines the format of messages and message addresses, and how messages are exchanged between mail servers. VPIM does not specify how the mail servers interact with client applications, or how they interface with end users. This allows many different kinds of existing systems to support VPIM. For more information about VPIM, refer to the Open Group VPIM website at http://www.ema.org/vpim.
VPIM Messages
VPIM messages are made up of one or more MIME-encoded parts. The VPIM specification allows for optional MIME parts for spoken name and for forwarded, fax, and text messages. VPIM messages may also include a vCard (an electronic business card) attachment, which includes phone number, text name and e-mail address. Cisco Unity allows you to select whether the voice name and vCard of the sender will be sent with outgoing messages. If incoming messages include a voice name, it is played as part of the message. If a vCard is attached to an incoming message, the recipient can look at the vCard data in ViewMail. Cisco Unity does not update the directory with the voice name or the vCard data from incoming messages.
VPIM voice message parts are encoded by using the ITU G.726 32-kbps ADPCM standard. VPIM fax encoding is based on the TIFF-F specification, and the vCard format is based on the Internet adaptation of the Versit vCard specification.
VPIM Addresses
A VPIM address is in the same format as a typical SMTP e-mail address—localpart@hostpart. The right-hand side of the address is the domain name of the system on the TCP/IP network that handles messages. The left-hand side of the address is a unique identifier for the user. Typically, the left-hand side is the subscriber mailbox number or the mailbox number with a prefix.
For example, an outgoing VPIM message to Terry Campbell with the remote mailbox 2233 could be:
To: 2233@remotevoicemailsystem.com
If needed to accommodate the dial plan for your organization, the address can also contain a prefix:
To: 8882233@remotevoicemailsystem.com
VPIM addresses are created by the Voice Connector when sending VPIM messages; they are not entered by subscribers when addressing messages.
Locations and VPIM Networking
Central to how you set up VPIM Networking is a Cisco Unity object called a location. Each Cisco Unity server is associated with one location referred to as the default or primary location, which is created during installation and which cannot be deleted. When setting up VPIM Networking, you use the Cisco Unity Administrator to give the primary location a new name and a Dial ID (which is an identifier for the location within Cisco Unity), enter the SMTP domain name, and customize other properties as appropriate. See the "Primary Location Profile Settings" section on page 7-1 for more information.
You create a delivery location in the Cisco Unity Administrator to correspond to each remote voice messaging system with which Cisco Unity communicates. Delivery locations contain the information that Cisco Unity needs to exchange messages with other VPIM-compliant voice messaging systems. A VPIM delivery location contains the SMTP domain name of the system on the TCP/IP network that handles messages for the remote voice messaging system. See the "VPIM Delivery Location Profile Settings" section for more information.
Location data is stored both in the SQL database on the Cisco Unity server and in Active Directory. In organizations with multiple Cisco Unity servers networked together, the location data replicates to all the Cisco Unity servers in the network. This means that delivery locations need to be created only on one Cisco Unity server in the network. The Cisco Unity server on which delivery locations are created is referred to as the bridgehead server. See the "Considerations for Networked Cisco Unity Servers" section for more information.
Voice Connector and VPIM Networking
Cisco Unity makes use of Exchange 2000 to provide messaging between Cisco Unity and other VPIM-compliant voice messaging systems. Exchange 2000 is VPIM-transport compliant and provides the ability to send and receive messages across the Internet or any TCP/IP network to computers that support SMTP.
Before an outgoing message to a VPIM-compliant voice messaging system can be sent, it must be encoded as a MIME message. The Cisco Unity Voice Connector for Exchange 2000 handles the conversion to and from the MIME format.
The Voice Connector must be installed on an Exchange 2000 server. If the Exchange 2000 and Cisco Unity servers are in different routing groups, a routing group connector must be installed. Although the Voice Connector can be installed on the Cisco Unity server (if Exchange 2000 is also on the server), this is not recommended for performance reasons.
The Voice Connector must not be installed on a server in an Exchange cluster. Microsoft does not support third-party connectors on an Exchange cluster server.
See the "Setting Up the Voice Connector for VPIM Networking (Exchange 2000)" section for information about installing the Voice Connector.
How the Voice Connector Processes Outgoing VPIM Messages
When subscribers use the phone to address a message to a VPIM recipient, Cisco Unity constructs a To address for the message in the form VPIM:<Location Dial ID>_<Remote Mailbox>. As with any other message, Cisco Unity hands it off to Exchange for delivery. Since the message has a VPIM address type, it is first passed to the Voice Connector for processing.
The Voice Connector performs the following tasks:
•Converts the message from MAPI to MIME format.
•Formats the To address by using the domain name and prefix specified on the corresponding VPIM delivery location page.
•Formats the From address by using the prefix from the corresponding VPIM delivery location page and the domain name from the primary location page. (If your organization has more than one Cisco Unity server networked together, the domain name is from the primary location of the Cisco Unity server with which the sending subscriber is associated.)
•Converts any voice attachments to G.726 audio format.
•Attaches the recorded voice name and/or vCard, if specified on the corresponding VPIM delivery location page.
The newly formatted message is put in the SMTP pickup folder of the Windows 2000 server for delivery to the VPIM-compliant voice messaging system.
How the Voice Connector Processes Incoming VPIM Messages
When the Voice Connector is installed, it registers a transport event sink with the Windows 2000 SMTP server. An event sink is code that is activated through a defined trigger, such as the receipt of a new message.
The event sink is registered by the Voice Connector and monitors all incoming messages. Messages that have the content type Multipart/Voice-Message and are addressed to the SMTP domain defined during the Voice Connector installation are readdressed to the Voice Connector by the event sink.
When the Voice Connector receives the message, it first verifies that the message is from a domain specified in a VPIM delivery location. If a VPIM delivery location with a matching domain name is not found, the Voice Connector rejects the message and sends a non-delivery receipt (NDR) to the sender.
If a VPIM delivery location with a matching location is found, the Voice Connector does the following:
•Removes the phone prefixes from the To and From addresses, if prefixes are specified on the corresponding VPIM delivery location page.
•Validates the recipients of the message by looking up the extensions in Active Directory, and formats the addresses.
•Converts the message from MIME to MAPI format.
•Converts voice attachments to the audio format specified on the corresponding VPIM delivery location page.
•Hands the message back to Exchange for delivery to the Cisco Unity subscriber mailbox.
Message Addressing Options
Cisco Unity provides these ways to address messages to individuals by using a VPIM-compliant voice messaging system:
•Blind addressing—Blind addressing allows Cisco Unity to send messages without having specific information about the recipients on the remote voice messaging system (such as their names and mailbox numbers). To address a message to someone on another voice messaging system, subscribers enter the delivery location Dial ID and the remote mailbox number of the recipient. See the "Blind Addressing and VPIM Networking" section for more information.
•VPIM subscribers—With VPIM subscribers, Cisco Unity has information about the remote users, such as their names and extensions. Subscribers address messages to VPIM subscribers the same way that they address messages to regular Cisco Unity subscribers—by extension or by spelling the name of the recipient. Note that spoken name confirmation is available when a recorded name exists for the VPIM subscriber. See the "VPIM Subscribers" section for more information.
Messaging Similarities and Limitations
For the most part, messaging between Cisco Unity subscribers and individuals on a VPIM-compliant voice messaging system is the same as messaging between Cisco Unity subscribers. For example:
•Messages marked urgent when they are sent are marked urgent when they are retrieved by the recipient.
•Messages marked private when they are sent are marked private when they are retrieved by the recipient. Note, however, that in ViewMail and in the Cisco Unity Inbox, private messages from both Cisco Unity subscribers and individuals on a VPIM-compliant voice messaging system can be forwarded, but not modified. (Note that in version 3.1 and earlier, the Cisco Unity Inbox was known as the Visual Messaging Interface or VMI.)
•Subscribers can send messages to Cisco Unity distribution lists that include VPIM subscribers.
•Subscribers can send fax messages, if this is supported by the remote voice messaging system.
Note the following exceptions:
•Requests for read receipts and delivery receipts are both returned as delivery receipts.
•E-mail messages without a voice attachment cannot be sent to VPIM recipients even though ViewMail allows subscribers to address to them. Instead of being delivered, e-mail messages sent to VPIM recipients are returned to the sender as NDRs.
•When replying to VPIM messages in ViewMail, if subscribers want to send text in the reply, they must enclose the text in a text file attachment. Whether the recipient receives the text attachment depends on the capabilities of the remote voice messaging system.
•Messages marked as low importance in ViewMail are treated the same as regular messages.
•Messages sent to Cisco Unity distribution lists from subscribers on the remote voice messaging system are not delivered, and an NDR is returned to the sender.
Blind Addressing and VPIM Networking
Blind addressing is one of the methods that Cisco Unity provides for addressing VPIM messages to users of another voice messaging system. Blind addressing allows Cisco Unity to address messages without having specific information about the recipients on the remote voice messaging system (such as their names and mailbox numbers). One of the steps to setting up blind addressing is to change the Blind Addressing setting on the Primary Location > Addressing Options page to something other than None. You also create a VPIM delivery location that corresponds to each voice messaging system with which Cisco Unity communicates.
You provide the following key information for each delivery location:
•Dial ID—A unique number that identifies the location to Cisco Unity. This is the number that subscribers dial when blind addressing messages to individuals who use the remote voice messaging system.
•SMTP Domain Name—The Internet-addressable SMTP domain name that is used to construct addresses for individuals who use the voice messaging system that corresponds to the delivery location.
When blind addressing a message, subscribers dial a number that is made up of the delivery location Dial ID and the mailbox number of the recipient. Before addressing the message, Cisco Unity parses the number that the subscriber entered and searches for a matching delivery location. If Cisco Unity does not find a matching location, it reports the error to the sender and does not address the message. If a matching delivery location is found, Cisco Unity addresses the message without verifying that the remote mailbox number exists. Cisco Unity does provide voice name confirmation that the delivery location exists before addressing the message (assuming that a voice name was recorded for the delivery location).
Subscriber Experience with Blind Addressing
Subscribers can address messages by using the phone, Cisco Unity ViewMail, or the Cisco Unity Inbox. To address a message by using ViewMail or the Cisco Unity Inbox, subscribers enter the address in the following format:
[VPIM:<Delivery Location Dial ID>_<Remote Mailbox Number>]
Note ViewMail requires the brackets in the address.
Because your Cisco Unity server does not have access to the names, extensions, and recorded voice names of the people who use the other voice messaging system, subscribers will encounter some limitations with blind addressing:
•When addressing a message, the sender does not get voice name confirmation. Cisco Unity cannot verify that the entered number is correct, so subscribers may inadvertently address a message to the wrong person or to a non-existent extension. However, subscribers will receive an NDR if the number turns out to be an invalid extension.
•When addressing a message, subscribers cannot use spelled-name mode; subscribers can address the message only by using number mode, so they must know the delivery location Dial ID and the mailbox number for the recipient.
•Blind addresses cannot be added to distribution lists.
•When subscribers use the phone to listen to messages from someone at the VPIM location, the conversation (also known as the telephone user interface, or TUI) cannot identify the sender. When listening to the messages in ViewMail or in the Cisco Unity Inbox, the From address is in the format [VPIM:<Delivery Location Dial ID>_<Remote Mailbox Number>]. Note that the sender can be identified if the remote system included the recorded voice name of the sender in the message.
VPIM Subscribers
VPIM subscribers are a representation in Cisco Unity of individuals who use another voice messaging system. Voice messages addressed to VPIM subscribers are sent to the voice messaging system that they use. Unlike regular subscribers, VPIM subscribers do not require user licenses.
You create and manage VPIM subscribers in much the same way that you do regular subscribers. You can use the Cisco Unity Administrator or the Cisco Unity Bulk Import wizard to create VPIM subscribers, and you use the Cisco Unity Administrator to modify or delete VPIM subscribers. (Note that the Bulk Edit utility cannot be used to modify settings for VPIM subscribers.)
To set up VPIM subscribers, you first create a VPIM delivery location that corresponds to each remote voice messaging system with which Cisco Unity communicates. After creating the delivery locations, you create a VPIM subscriber for each remote user. When creating each VPIM subscriber, you specify the user mailbox number on the other voice messaging system, and select a VPIM delivery location with which to associate the subscriber. The Voice Connector uses the information on the associated delivery location when delivering a message to the VPIM subscriber. Note that VPIM subscribers can be created only on the VPIM bridgehead server on which the associated VPIM delivery location has been created.
Extensions are mandatory for VPIM subscribers. The extension is the number that subscribers dial when addressing a message to a VPIM subscriber. This number may or may not be the same as the mailbox number of the VPIM subscriber on the remote voice messaging system. Callers who reach the opening greeting of your organization can dial the extension of a VPIM subscriber or look up a VPIM subscriber in directory assistance and leave a message.
VPIM subscribers in Cisco Unity are represented as contacts in Active Directory. When you delete VPIM subscribers in the Cisco Unity Administrator either by deleting individual accounts or by deleting a delivery location with which the VPIM subscribers are associated, the underlying contacts are not removed; you must delete them manually by using Active Directory Users and Computers.
Other than receiving messages, VPIM subscribers do not have access to other Cisco Unity features, and some sections of the Cisco Unity Administrator are disabled for VPIM subscribers. VPIM subscribers:
•Cannot log on to Cisco Unity by phone to check or send messages.
•Cannot log on to Cisco Unity by phone—or use the Cisco Unity Assistant—to adjust personal settings, so their recorded names and greetings can only be recorded or changed in the Cisco Unity Administrator. (Note that in version 3.1 and earlier, the Cisco Unity Assistant was known as the ActiveAssistant, or AA).
•Cannot use the Cisco Unity Inbox to check messages. (Note that in version 3.1 and earlier, the Cisco Unity Inbox was known as the Visual Messaging Interface or VMI).
•Cannot own private lists.
•Cannot set up or receive message notifications.
•Cannot receive message waiting indications.
Setting up VPIM subscribers requires more overhead for administrators of Cisco Unity than blind addressing does. However, the VPIM subscriber option allows other subscribers to address messages to VPIM subscribers the same way that they address messages to regular subscribers. In general, setting up VPIM subscriber accounts is a good solution in the following circumstances:
•When there are only a few subscribers at the other voice messaging system who need to receive messages from the subscribers at your location. (Note however that there are no technical constraints associated with creating large numbers of VPIM subscribers.)
•When unidentified callers need to be able to call the local Cisco Unity server to leave a message for someone on the other voice messaging system. This may provide a way for local callers to avoid long distance charges when leaving a message for a remote VPIM subscriber.
•When the functionality listed in the next section, "Subscriber Experience with VPIM Subscribers" is required.
Because of the administrative overhead of setting up and maintaining many VPIM subscriber accounts, you may prefer a combination of blind addressing and VPIM subscribers. For example, you might want to set up VPIM subscriber accounts for senior sales staff, but not for other employees.
Subscriber Experience with VPIM Subscribers
Provided that VPIM subscribers are listed in the phone directory and have had voice names and greetings recorded for them:
•Subscribers can address messages to VPIM subscribers by using the phone, ViewMail, or the Cisco Unity Inbox.
•Unless they have been explicitly hidden, the contacts that correspond to VPIM subscribers are listed in the Exchange address book. Therefore, message addressing by using ViewMail or the Cisco Unity Inbox to VPIM subscribers is the same as for regular subscribers.
•When using the phone, subscribers can address messages to VPIM subscribers in spelled-name mode (if enabled on the system) or by extension.
•Subscribers get voice name confirmation when addressing a message to a VPIM subscriber.
•When subscribers use the phone to listen to messages, the conversation announces who the message is from.
•VPIM subscribers can be added to distribution lists.
•Both unidentified callers and subscribers can place a call to a VPIM subscriber and leave a message. If Cisco Unity is integrated with a networked phone system, calls from both unidentified callers and subscribers can be transferred to the VPIM subscriber extension. (With a networked phone system, subscribers dial an extension without having to dial a trunk access code or prefix when calling someone who is at another location on the phone network.)
Extension Address Utility
When you create an VPIM subscriber, Cisco Unity automatically generates an e-mail address in the following format:
VPIM:<Delivery Location Dial ID>_<Remote Mailbox Number>
This special e-mail address is called an extension address. The extension address is a combination of the delivery location Dial ID with which the VPIM subscriber is associated, and the Remote Mailbox Number of the VPIM subscriber. Each contact in Active Directory that corresponds to a VPIM subscriber contains an extension address.
When subscribers use the phone to address messages to a VPIM subscriber, they dial an extension. Cisco Unity recognizes the recipient as a VPIM subscriber and retrieves the extension address from the SQL database on the Cisco Unity server.
The extension address retrieved by Cisco Unity is identical to the format the subscriber would use in addressing the message from ViewMail or the Cisco Unity Inbox: the delivery location Dial ID and the Remote Mailbox Number. When using ViewMail or the Cisco Unity Inbox to address a message to a VPIM subscriber, subscribers can either select the contact from the Outlook address book or address the voice message by using the full format: [VPIM:<Delivery Location Dial ID>_<Remote Mailbox Number>]. For example, to send a message to Dial ID 206, mailbox 444, the address is: [VPIM:206_444].
Although extension addresses are generated automatically when you create VPIM subscribers, if you later change the Dial ID of a delivery location, you will need to run the Extension Address utility to update the extension addresses for the VPIM subscribers associated with the location. Otherwise, VPIM subscribers will have incorrect extension addresses, and they will not receive messages.
To run the Extension Address utility
Step 1 On the Cisco Unity server desktop, double-click the Cisco Unity Tools Depot icon.
Step 2 In the left pane, under Administrative Tools, double-click Extension Address Utility.
Step 3 Click Update.
Step 4 When the utility has finished updating extension addresses, click OK, and then Close.
It may take a few minutes for the extension addresses to be updated in Exchange.
Hiding VPIM Subscribers
Depending on your installation, the users of the remote voice messaging system may already have Windows accounts and Exchange mailboxes on your local network. Therefore, when VPIM subscriber accounts are created for them, the Exchange address list will contain duplicate listings—the existing user account and a contact. Both listings are viewable in Outlook.
To prevent the VPIM subscribers from being listed in the Exchange address list, you will need to hide them by using Active Directory for Users and Computers. (To access the tool, click View > Advanced Features, and make changes on the Exchange Advanced property page). Note that even when recipients are hidden, Cisco Unity is able to deliver messages to them. However, if you hide the contact created for the VPIM subscriber, subscribers who use ViewMail or Cisco Unity Inbox must manually enter the extension address for the VPIM subscriber in the following format:
[VPIM:<Delivery Location Dial ID>_<Remote Mailbox Number>]
Because e-mails should not be sent to VPIM subscribers, you may want to exclude them from distribution lists in addition to hiding them in the Exchange address list, because distribution lists are also viewable in Outlook. Before creating VPIM subscriber accounts, you may want to create a subscriber template just for VPIM subscribers, and modify the subscriber template distribution lists settings so that the VPIM subscribers are not added to any distribution lists. For more information, refer to the "Subscriber Template Distribution Lists Settings" section in the "Subscriber Template Settings" chapter of the Cisco Unity System Administration Guide. (The Cisco Unity System Administration Guide is available on Cisco.com at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/products_administration_guide_books_list.html.)
Migrating Subscribers from Another Voice Messaging System to Cisco Unity
If you have set up VPIM subscriber accounts for the subscribers on another voice messaging system, and if they have existing Exchange mailboxes, you may want to use the Migrate Subscriber Data utility when the time comes to migrate them to Cisco Unity. The Migrate Subscriber Data utility creates a Cisco Unity subscriber account by combining the Cisco Unity-specific data from an existing VPIM subscriber account (such as the voice name) with an existing mail user. The utility then deletes the VPIM subscriber account and optionally, deletes the associated Active Directory contact.
The Migrate Subscriber Data utility is available in Tools Depot (the Tools Depot icon is installed on the Cisco Unity server desktop). Refer to the Help file that comes with the utility for more information.
Considerations for Networked Cisco Unity Servers
A small subset of subscriber and distribution list data is stored in Active Directory, as is all location data. In organizations with multiple Cisco Unity servers networked together such that they access a common directory, the Cisco Unity-specific data replicates to all Cisco Unity servers in the network. Therefore, all Cisco Unity servers on the network have the information that subscribers need to address messages to users at a VPIM location.
Because of directory replication, VPIM delivery locations and VPIM subscribers need to be created only on one Cisco Unity server in the network. If allowed by the primary location addressing options on each server, all subscribers, no matter which Cisco Unity server they are associated with, can send messages to a VPIM delivery location or to a VPIM subscriber created on another server.
Phone Prefixes
Each VPIM delivery location provides the following prefixes, which are used to accommodate various dial plans:
•Remote Phone Prefix—This number is used to construct addresses for users at a VPIM location. On outgoing messages to the VPIM location, the Voice Connector adds the prefix to the beginning of the recipient mailbox number to form the To address. On incoming messages from the VPIM location, the Voice Connector removes the prefix from the beginning of the sender mailbox number to form the From address.
•Cisco Unity Phone Prefix—This number is used to construct addresses for Cisco Unity subscribers. On outgoing messages to the VPIM location, the Voice Connector adds the prefix to the beginning of the sender mailbox number to form the From address. On incoming messages from the VPIM location, the Voice Connector removes the prefix from the beginning of the recipient mailbox number to form the To address.
If all VPIM delivery locations have a unique domain name, prefixes are optional. If you have multiple delivery locations with the same domain name, the Remote Phone Prefix is required. Within the set of the delivery locations with the same domain name, the Remote Phone Prefix must be a unique number.
For example, assume that an organization has implemented a 10-digit dial plan, in which the mailbox numbers for Cisco Unity subscribers begin with 206, and the mailbox numbers of subscribers on a VPIM voice messaging system begin with 425.
Assume the following has been set on the VPIM delivery location:
•Dial ID = 425
•Remote Phone Prefix = 425
By setting both the Remote Phone Prefix and the Dial ID to 425, the number that a subscriber enters when blind addressing a message to someone at the VPIM location is the same number that the subscriber enters when calling.
Because of the prefix, VPIM subscribers are assigned a 7-digit Remote Mailbox Number. For outgoing messages, the Voice Connector adds the prefix 425 to the beginning of the remote mailbox number, creating a 10-digit recipient mailbox number.
Audio Formats Supported
The Voice Connector always sends outbound VPIM messages in the G.726 format. The Voice Connector can receive VPIM messages with voice attachments in the G.711, GSM 6.10, and G.726 audio formats. The Audio Format Conversion setting on the VPIM Delivery Locations page allows you to control whether incoming messages are converted to another format, or are stored in the same format in which they were sent. See the "VPIM Delivery Location Profile Settings" section for details about the Audio Format Conversion setting.
VPIM Reference
This section contains tables that define the fields on the Cisco Unity Administrator web pages related to VPIM setup, and briefly explain the options for correctly entering information in the fields.
VPIM Delivery Location Profile Settings
VPIM delivery locations are Cisco Unity objects that contain the addressing information that Cisco Unity needs to send messages to and receive messages from another voice messaging system. You create an VPIM delivery location that corresponds to each remote voice messaging system with which Cisco Unity communicates.
Use the following tables to learn more about the delivery location profile settings for a VPIM location.
Table 6-1 Settings Applicable to All Types of Delivery Locations
Field
|
Considerations
|
Name
|
This displays the name of the delivery location. To change the name, enter a new name here, and then click the Save icon.
|
Dial ID
|
Enter the ID that identifies the location to Cisco Unity. Enter numbers only, up to a maximum of ten digits. The default minimum length is three digits.
Although the minimum length for Dial IDs can be reduced by using the Advanced Settings Tool, one- and two-digit Dial IDs may conflict with private distribution list IDs during an address search. When a subscriber addresses a message by entering a one- or two-digit number, Cisco Unity first searches for a matching private distribution list. If a match is found, the search stops. Therefore, when a subscriber addresses a message by entering a location Dial ID (to narrow down the search scope to a particular location), if the number entered matches a private distribution list ID, the conversation offers only the private distribution list as a destination. If subscribers do not address messages to other locations by first entering a Dial ID, there is no conflict, and the minimum length for Dial IDs can be reduced to accommodate complex dial plans.
When addressing a message to another location by using blind addressing, subscribers dial a number that is made up of the Dial ID and the extension (or the remote mailbox number) of the recipient.
When setting up SMTP networking with a Cisco Unity server in a different directory, the ID that you enter here must match the Dial ID of the primary location at the corresponding remote Cisco Unity server.
The following policies are recommended:
•Establish a fixed length for Dial IDs and if possible, a fixed length for extensions.
•Assign unique Dial IDs. Dial IDs should not be the same as other Dial IDs or extensions.
•Assign three-digit Dial IDs.
•Use a different numbering range for Dial IDs than for extensions.
•If you use variable-length Dial IDs, the first digits of each ID should be unique with respect to other Dial IDs.
If you change the Dial ID after creating subscriber accounts associated with this location, run the Extension Address utility to generate new extension addresses. To run the utility, on the Windows Start menu, click Programs > Unity > Extension Address Utility, and then click Update. It may take three to five minutes for the addresses to be updated in Exchange.
|
Recorded Name
|
Record a name for the delivery location. The subscriber conversation plays this recorded name when the setting Include Locations in Searches on the Network > Primary Location > Addressing Options page is enabled. When subscribers address a message, the recorded name for this delivery location is played in the message addressing search results along with subscriber names. (For example: "There are two matches. For Chris Newton, press 1. For New York, press 2.") Additionally, the subscriber conversation plays this recorded name when subscribers address messages by using blind addressing to this delivery location.
To record the name here, use the Media Master control bar. (Note that the Media Master is not available across a firewall.) Use the Options menu in the Media Master control bar to set recording and playback devices, if applicable, and to use other sound files.
|
Destination Type
|
Display only. Indicates the type of delivery location. The Destination Type is specified when the delivery location is created, and it cannot be changed. The Destination Type is one of the following:
•SMTP—Indicates that the delivery location corresponds to a remote Cisco Unity server that accesses a directory different than the local Cisco Unity server. Messages between the local and remote Cisco Unity servers are encoded in a proprietary format and delivered over the Internet or a private TCP/IP network by using the standard Simple Mail Transfer Protocol (SMTP).
•AMIS—Indicates that the delivery location corresponds to an AMIS-compliant voice messaging system. Messages are sent by using the industry-standard Audio Messaging Interchange Specification analog (AMIS-a) protocol.
•Bridge—Indicates that the delivery location corresponds to an Octel node in an Octel analog network. Messages are exchanged between Cisco Unity and the Octel system by using the Cisco Unity Bridge. Cisco Unity sends messages to the Bridge in Voice Profile for Internet Mail (VPIM) format with proprietary extensions. The Bridge converts the message format and sends it to the appropriate Octel server by using the Octel Analog Networking protocol.
•VPIM—Indicates that the delivery location corresponds to a VPIM-compliant voice messaging system. Messages are sent by using the industry-standard VPIM protocol over the Internet or a private TCP/IP network.
|
Table 6-2 VPIM Delivery Location Profile Settings
Field
|
Considerations
|
VPIM Location SMTP Domain Name
|
Enter the Internet-addressable SMTP domain name that is used to construct addresses for individuals who use the voice messaging system that corresponds to this delivery location. This is the right half of an e-mail address after the @ symbol (for example, london.cisco.com). Do not enter the @ symbol; Cisco Unity automatically inserts it.
The Voice Connector accepts VPIM messages only from addresses with a domain name that corresponds to a SMTP Domain Name in a VPIM Delivery Location. Therefore, the domain name entered here must exactly match the domain name that the remote voice messaging system uses when sending messages to Cisco Unity.
|
VPIM Location Remote Phone Prefix
|
Enter the number that is used to construct addresses for individual who use the voice messaging system that corresponds to this delivery location. The maximum allowable digits in the prefix is 64.
On outgoing messages from Cisco Unity to this VPIM location, the Voice Connector adds the prefix to the beginning of the recipient mailbox number to form the To address.
On incoming messages to Cisco Unity from this VPIM location, the Voice Connector removes the prefix from the beginning of the sender mailbox number to form the From address.
If all delivery locations have a unique domain name, this field is optional. This field is required to be a unique number if you have multiple delivery locations with the same domain name.
|
Cisco Unity Location: Unity Phone Prefix
|
Enter the number that is used to construct addresses for Cisco Unity subscribers who send messages to individuals who use the voice messaging system that corresponds to this delivery location. The maximum allowable digits in the prefix is 64.
On outgoing messages from Cisco Unity subscribes to subscribers at this VPIM location, the Voice Connector adds the prefix to the beginning of the sender mailbox number to form the From address.
On incoming messages to Cisco Unity subscribers from subscribers at this VPIM location, the Voice Connector removes the prefix from the beginning of the recipient mailbox number to form the To address.
If all delivery locations have a unique domain name, this field is optional. This field is required to be a unique number if you have multiple delivery locations with the same domain name.
|
Audio Format Conversion
|
Indicate whether incoming messages from this VPIM location should be converted to another audio format.
The Voice Connector can receive VPIM messages with voice attachments in the G.711, GSM 6.10, and G.726 audio formats. If you want the messages to be stored in the same format in which they were sent, select Do Not Convert Incoming Messages. (Note that the Voice Connector will add a RIFF header to a message in the G.726 format if the header is missing. Without the RIFF header, Windows-based audio players will be unable to play messages.)
If incoming messages are in a format not fully supported by Cisco Unity, they should be converted to one of the following:
•G.711 (mu-law)
•G.729a
•GSM 6.10
Cisco Unity will store messages from this VPIM location in the selected audio format. Note that the G.711 and GSM 6.10 codecs are installed automatically by Windows, and the G.729a codec is installed by Cisco Unity.
Verify that the appropriate codec is installed on all Cisco Unity servers and other computers that access these messages. In particular:
•If your organization has multiple Cisco Unity servers networked together, all of the Cisco Unity servers must have the codec installed.
•If subscribers use ViewMail or the Cisco Unity Inbox to listen to messages, the codec must be installed on each subscriber workstation.
|
When Sending Messages from Cisco Unity Include the Sender's Recorded Name
|
Check this box to have the voice name of the sending Cisco Unity subscriber added to the beginning of each message sent to this VPIM location.
|
When Sending Messages from Cisco Unity Include the Sender's vCard
|
Check this box to have the Voice Connector attach a vCard that contains information about the sending Cisco Unity subscriber to each outgoing message to this VPIM location. The vCard will contain the following information about the sender:
•Name
•Phone Number
•E-mail Address
|