Table Of Contents
AMIS Networking
Overview: AMIS
Task List: Setting Up Cisco Unity to Use AMIS
Procedures for Setting Up Cisco Unity to Use AMIS
Setting Up the Voice Connector for AMIS Networking
Setting Up the Voice Connector for Exchange 5.5
Setting Up the Voice Connector for Exchange 2000
Creating the UAmis Mailbox
Designating Voice Ports for Outbound AMIS Calls
Customizing the Primary Location
Setting the Addressing, Directory Handler, and Automated Attendant Search Scopes
Setting the Addressing Search Scope
Setting the Directory Handler Search Scope
Setting the Automated Attendant Search Scope
Setting AMIS Delivery Options
Customizing the AMIS Restriction Table
Setting Up the AMIS Schedule
Creating AMIS Delivery Locations
Creating AMIS 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 AMIS Subscriber Accounts
After Creating Subscriber Accounts
AMIS Concepts and Definitions
Introduction to AMIS
Port Usage and Schedules
UAmis Mailbox
Voice Connector and AMIS Networking
Locations and AMIS Networking
Message Addressing Options
Message Addressing Limitations
Blind Addressing and AMIS Networking
AMIS Subscribers
Subscriber Experience with AMIS Subscribers
Call Transfer Settings and AMIS Subscribers
Deleting AMIS Subscribers
Extension Addresses
Determining How AMIS Subscribers Appear in the Outlook Address Book
Preventing Contacts From Appearing in the Outlook Address Book
Modifying How Contacts Appear in the Outlook Address Book
Migrating Subscribers from Another Voice Messaging System to Cisco Unity
Migrating Subscribers in Bulk
Migrating Subscribers One at a Time
Considerations for Networked Cisco Unity Servers
Design Considerations
Maintenance
AMIS Reference
AMIS Delivery Location Profile Settings
AMIS Delivery Options Settings
AMIS Schedule Settings
Troubleshooting
Notable Behavior
Inbound Search Scope
Leaving a Message Versus Sending a Message
Restriction Table Selection Is Not Automatically Replicated Between Servers Set Up for Failover
AMIS Networking
Overview: AMIS
Cisco Unity supports the Audio Messaging Interchange Specification analog (AMIS-a) protocol, which provides a mechanism for transferring voice messages between different voice messaging systems.
AMIS 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 AMIS Networking. The Cisco Unity server configured for AMIS Networking is referred to as the bridgehead server. For more information about obtaining licenses for Cisco Unity features, refer to the White Paper: Licensing for Cisco Unity, which is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/whitpapr/licenses.htm.
No special permissions are required for AMIS Networking beyond those required for Cisco Unity itself. For detailed information about the permissions required by Cisco Unity, see the help file for the Permissions Wizard, which is available in Tools Depot on the Cisco Unity server.
In this chapter, you will find procedures for setting up AMIS Networking, followed by detailed discussions of the concepts and terminology you need to understand. See the following sections:
•Task List: Setting Up Cisco Unity to Use AMIS—This task list provides a high-level view of all of the tasks that you need to complete, and the order in which they should be completed.
•Procedures for Setting Up Cisco Unity to Use AMIS—This section contains all of the procedures necessary to set up Cisco Unity to use AMIS.
•AMIS Concepts and Definitions—This section explains AMIS concepts in detail. You may want to read this section prior to completing the setup procedures.
•AMIS Reference—This section contains tables that define the fields on the Cisco Unity Administrator web pages related to AMIS setup, and briefly explain the options for correctly entering information in the fields.
•Maintenance—This section provides information about monitoring system activity.
•Troubleshooting—This section provides links to troubleshooting information.
•Notable Behavior—This section provides information about notable behavior related to AMIS Networking.
Task List: Setting Up Cisco Unity to Use AMIS
Use this task list to set up Cisco Unity to use AMIS. The cross-references take you to detailed procedures for the setup.
1. Verify that the voice messaging system that Cisco Unity will be networked with is listed in the "Supported AMIS-Compliant Voice Messaging Systems" section of the Cisco Unity System Requirements, and Supported Hardware and Software, available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/sysreq/40_sysrq.htm.
2. If Cisco Unity is integrated with Cisco CallManager verify that the Cisco gateway version that you plan to use is supported for use with AMIS as described in the "Supported Cisco Gateways for Use with AMIS" section of the Cisco Unity System Requirements, and Supported Hardware and Software document.
3. Review the "AMIS Networking Requirements" section in Cisco Unity Networking Options Requirements (With Microsoft Exchange), available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/sysreq/netrq.htm.
4. Install the Voice Connector on an Exchange server. See the "Setting Up the Voice Connector for AMIS Networking" section.
Then, for each Cisco Unity server that will handle AMIS calls:
5. Confirm that the Cisco Unity server is licensed for AMIS.
6. Verify that the Cisco Unity call routing rules route calls to a call handler, such as the Opening Greeting. (This is the default when Cisco Unity is initially installed.)
7. Create the UAmis mailbox. See the "Creating the UAmis Mailbox" section.
8. Designate voice ports for outbound AMIS calls. See the "Designating Voice Ports for Outbound AMIS Calls" section.
9. Customize the primary location profile settings. See the "Customizing the Primary Location" section.
10. Set the subscriber addressing, directory handler, and automated attendant search options. See the "Setting the Addressing, Directory Handler, and Automated Attendant Search Scopes" section.
11. Set the AMIS delivery options. See the "Setting AMIS Delivery Options" section.
12. Customize the AMIS Restriction Table as needed. See the "Customizing the AMIS Restriction Table" section.
13. Set up the AMIS schedule. See the "Setting Up the AMIS Schedule" section.
14. Create a delivery location for each remote voice messaging system. See the "Creating AMIS Delivery Locations" section.
15. If you are not using blind addressing, create AMIS subscribers. See the "Creating AMIS Subscribers" section.
16. Set up the other voice messaging system for AMIS. The other voice messaging system will require the number to dial into Cisco Unity, and the Node ID that was entered for the primary location.
17. Test the setup to verify that Cisco Unity can exchange messages with the other voice messaging system. If desired, you can configure the macro trace "Basic Incoming and Outgoing AMIS Message" in the Unity Diagnostic Tool (on the Windows Start menu, click Programs > Cisco Unity > Unity Diagnostic Tool) to verify that Cisco Unity can send and receive AMIS messages.
18. If you discover a problem with the setup, see the "Troubleshooting" section for links to information that can help you find and fix the problem.
Procedures for Setting Up Cisco Unity to Use AMIS
This section contains all of the procedures necessary to set up Cisco Unity to use AMIS.
Setting Up the Voice Connector for AMIS Networking
There are two Voice Connector installation programs included on Cisco Unity DVD 1 and CD 1, and separate setup procedures:
•When the Cisco Unity partner server is Exchange 5.5 (when your network consists only of Exchange 5.5 servers), set up the Voice Connector for Exchange 5.5.
•When the Cisco Unity partner server is Exchange 2000 or Exchange 2003 (when your network consists only of Exchange 2000 or Exchange 2003 servers or a mixture of Exchange 5.5 servers and Exchange 2000 or Exchange 2003 servers), set up the Voice Connector for Exchange 2000. Voice Connector for Exchange 2000 version 11.0(1) or later can be installed on either an Exchange 2000 or an Exchange 2003 server.
As applicable, see the "Setting Up the Voice Connector for Exchange 5.5" section or the "Setting Up the Voice Connector for Exchange 2000" section.
Setting Up the Voice Connector for Exchange 5.5
Install the Voice Connector on an Exchange 5.5 server that is in the same Exchange site as the Exchange partner server. Although the Voice Connector can be installed on the Cisco Unity server (if Exchange 5.5 is also on the server), this is not recommended for performance reasons. Following are additional requirements:
•Install only one instance of the Voice Connector in the Exchange site.
•If the Exchange server on which the Voice Connector will be installed is running Windows NT 4.0, the Microsoft Active Directory Services Client Extension (DSClient) for Windows NT 4.0 must be installed on the server prior to installing the Voice Connector. The DSClient requires Windows NT 4.0 Service Pack 6a. For information on downloading and installing the DSClient from the Microsoft website, refer to the following Microsoft Knowledge Base articles:
–288358—HOW TO: Install the Active Directory Client Extension
–295166—INFO: Advanced Installation of Directory Services Client for Windows NT 4.0
–295168—INFO: Files Installed by Directory Services Client Extension for Windows NT 4.0
–289105—INFO: Support for ADSI on Windows NT 4.0
–216290—INFO: Determining Which Version of ADSI Is Installed
The Internet Mail Service is not required by the Voice Connector when it is used for AMIS Networking.
To Install the Voice Connector for Exchange 5.5
As a best practice, back up the Exchange server before installing the Voice Connector.
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 Uninstall any previous versions of the Voice Connector. See the "Uninstalling the Cisco Unity Voice Connector" section.
Step 4 If you are installing the Voice Connector from Cisco Unity DVD 1 or CD 1, insert the disc in the computer, and browse to the VoiceConnector-Ex55 directory.
Step 5 If you downloaded the Voice Connector files from the Software Center website, browse to the directory in which the files were extracted.
Step 6 Double-click Install.exe and then click Next.
Step 7 In the Address Types dialog box, check AMIS (and also select any other features that are being used in your network).
Step 8 Click Next twice.
Step 9 When setup is complete, click Finish to exit Setup and restart the server.
Step 10 Enable virus-scanning services on the server.
Setting Up the Voice Connector for Exchange 2000
Install Voice Connector version 11.0(1) or later 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 (if Exchange 2000 or Exchange 2003 is also on the server), this is not recommended for performance reasons.
If the Cisco Unity subscriber accounts are homed on Exchange servers in routing groups other than that in which the Voice Connector is installed, routing group connectors must be configured to allow routing among these routing groups.
To Install the Voice Connector for Exchange 2000
As a best practice, back up the Exchange server before installing the Voice Connector.
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 Uninstall any previous versions of the Voice Connector. See the "Uninstalling the Cisco Unity Voice Connector" section.
Step 4 If you are installing the Voice Connector from Cisco Unity DVD 1 or CD 1, 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 then click Next.
Step 6 In the Address Types dialog box, check AMIS (and also select any other features that are being used in your network).
Step 7 Click Next twice.
Step 8 In the User Information dialog box, enter your Windows password and then click Next.
Step 9 When setup is complete, click Finish to exit Setup and restart the server.
Step 10 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 will function properly, but you will not be able to view Voice Connector properties in the 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 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, the Windows Script Host needs to be updated in order for the Voice Connector properties to be displayed in 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.
Creating the UAmis Mailbox
In installations with multiple Cisco Unity servers networked together, the UAmis mailbox needs to be created only on the Cisco Unity server(s) that will place and receive AMIS calls. Note that the mailbox is actually homed on the Exchange server that Cisco Unity is connected to (the Exchange server that was selected in the Cisco Unity Server Configuration Wizard during setup).
The UAmis mailbox can be removed just like any other Exchange mailbox, by using standard Microsoft tools.
Note For installations upgrading from AMIS on a Cisco Unity version 3.0(x) through 3.1(1) system, if the UAmis mailbox already exists, skip this procedure.
To Create the UAmis Mailbox
Step 1 On the Cisco Unity server, browse to the directory in which Cisco Unity is installed (the default location is C:\CommServer).
Step 2 Double-click ConfigMgr.exe. The ConfigMgr dialog box appears.
Step 3 Click Create SQL AMIS Account.
Step 4 Uncheck Enable Diagnostics.
Step 5 Click Run.
Step 6 Click OK on the dialog box that displays when the UAmis mailbox is successfully configured.
Step 7 Close the ConfigMgr dialog box.
Step 8 On the Cisco Unity server, start the Services tool. (Click Start > Programs > Administrative Tools > Services.)
Step 9 Right-click AvNotifierMgr, and select Restart. The CPU usage on the Cisco Unity server will spike for a few minutes while the AvNotifierMgr reinitializes connections with subscriber mailboxes.
Step 10 Close the Services tool.
Designating Voice Ports for Outbound AMIS Calls
In installations with multiple Cisco Unity servers networked together, designate voice ports for AMIS calls only on those Cisco Unity server(s) that will place and receive AMIS calls.
To Designate Voice Ports for Outbound AMIS Calls
Step 1 In the Cisco Unity Administrator, go to the Systems > Ports page.
Step 2 Designate which ports to use for outgoing AMIS calls.
Step 3 Click the Save icon.
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.
In installations with multiple Cisco Unity servers networked together, specify the AMIS primary location information only on those Cisco Unity server(s) that will place and receive AMIS calls.
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 For the dialing domain, do one of the following:
•If this server is not intended to belong to a dialing domain, click None.
•If this server is intended to belong to a dialing domain, enter the dialing domain name, or select it from the available list. The list contains names of dialing domain names already configured on at least one other Cisco Unity server in the network.
Note that the dialing domain name is case sensitive and must be entered exactly the same on all of the servers. To ensure that all servers are correctly added to the same dialing domain, enter the dialing domain name on one Cisco Unity server and wait for the name to replicate to the other Cisco Unity servers. By doing so, you also confirm that replication is working correctly among the servers. 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 numbers for the Node ID, which is transmitted by Cisco Unity to identify itself to other voice messaging systems during outgoing AMIS calls. If desired, the Country Code and Area Code fields may be left blank; however, the Phone Number field is mandatory.
Step 7 Click the Save icon.
Setting the Addressing, Directory Handler, and Automated Attendant Search Scopes
In installations with multiple Cisco Unity servers networked together, set the search scopes on all Cisco Unity servers, not just those that are set up for AMIS.
Before changing the directory handler or automated attendant search scopes, see the "Call Transfer Settings Unavailable" section.
Note The Subscriber Search Option on the Primary Location > Addressing Options page controls the search scope for both outbound and inbound AMIS messages.
Do the following procedures to set up the addressing, directory handler, and automated attendant search scopes.
•Setting the Addressing Search Scope
•Setting the Directory Handler Search Scope
•Setting the Automated Attendant Search Scope
The automated attendant search scope must be set to search the dialing domain in order for identified subscriber messaging between networked Cisco Unity servers to work.
Setting the Addressing Search Scope
For detailed information about the addressing search options, see the "Primary Location Addressing Option Settings" section on page 7-5.
To Set the Addressing Search Scope
Step 1 In the Cisco Unity Administrator, go to the Network > Primary Location > Addressing Options page and set the addressing options as necessary.
•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 applicable.
•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 applicable.
Step 2 If you want locations included in address searches, check the Include Locations in Searches check box. In addition to matching subscribers, location matches will also be returned. Confirming the match of a location allows a secondary search of the subscribers that are associated with that location.
Step 3 Click the Save icon.
Setting the Directory Handler Search Scope
For detailed information refer to the "Directory Handler Search Options Settings" section in the "Directory Handler Settings" chapter of the Cisco Unity System Administration Guide. (The Cisco Unity System Administration Guide is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/sag/sag403/ex/index.htm.)
To Set the Directory Handler Search Scope
Step 1 In the Cisco Unity Administrator, 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.
Step 2 To allow subscribers on other Cisco Unity servers in the dialing domain to be located in directory assistance, click Dialing Domain.
Step 3 Click the Save icon.
Setting the Automated Attendant Search Scope
By default, callers who reach the opening greeting for your organization can be transferred only to subscribers associated with the local Cisco Unity server. If you want to set up the automated attendant so that callers can be transferred to subscribers associated with other Cisco Unity servers in the same dialing domain, change a registry setting as described in the following procedure.
The automated attendant search scope must be set to search the dialing domain in order for identified subscriber messaging between networked Cisco Unity servers to work.
Note For Cisco Unity failover, registry changes on one Cisco Unity server must be made manually on the other Cisco Unity server, because registry changes are not replicated.
To Set the Automated Attendant Search Scope
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 Advanced Settings Tool.
Step 3 In the Unity Settings pane, click Set Auto Attendant Search Scope.
Step 4 In the New Value list, click 1, and then click Set so that Cisco Unity searches for subscribers within the dialing domain.
Step 5 When prompted, click OK.
You do not need to restart Cisco Unity to enable the change.
Step 6 Click Exit.
Setting AMIS Delivery Options
The AMIS delivery option settings control attributes of outgoing AMIS calls on the Cisco Unity server.
In installations with multiple Cisco Unity servers networked together, set the AMIS delivery options only on those Cisco Unity server(s) that will place and receive AMIS calls.
To Set AMIS Delivery Options
Step 1 In the Cisco Unity Administrator, go to the Network > AMIS Options > Delivery Options page.
Step 2 Select either the Default AMIS restriction table or another restriction table to use as the Local Dial Restriction Table.
The Local Dial Restriction Table and the AMIS schedule together determine when outgoing AMIS calls are made.
Step 3 Set the other AMIS delivery options as needed.
Step 4 Click the Save icon.
Customizing the AMIS Restriction Table
By default, the AMIS restriction table allows all delivery numbers; you can customize the restriction table as needed. The AMIS restriction table and the AMIS schedule together determine when outgoing AMIS calls are made. If a delivery number for an outgoing AMIS message is allowed by the AMIS restriction table, the message is sent immediately—the schedule settings do not apply. If the delivery number is not allowed by the AMIS restriction table, the schedule determines when the message is sent.
In installations with multiple Cisco Unity servers networked together, customize the AMIS restriction table only on those Cisco Unity server(s) that will place and receive AMIS calls.
To Customize the AMIS Restriction Table
Step 1 In the Cisco Unity Administrator, go to any Call Management > Restriction Tables page.
Step 2 Click the Find icon.
Step 3 Double-click the AMIS restriction, which by default is named {Default AMIS}.
The AMIS restriction table is specified in the Local Dial Restriction Table field on the Network > AMIS Options > Delivery Options page.
Step 4 As applicable for your installation, do one or more of the following:
•To add a dial string, click Add Dial String and enter settings for the new dial string as applicable.
•To delete a dial string, click the dial string number in the table at the bottom portion of the Restriction Tables page, and then click Remove Dial String.
•To modify a dial string, click the dial string number in the table at the bottom portion of the Restriction Tables page, and change settings as applicable.
Step 5 Click the Save icon.
Setting Up the AMIS Schedule
Set up the AMIS schedule for messages that are not allowed by the AMIS restriction table.
In installations with multiple Cisco Unity servers networked together, set up the AMIS schedule only on those Cisco Unity server(s) that will place and receive AMIS calls.
To Set Up the AMIS Schedule
Step 1 In the Cisco Unity Administrator, go to the Network > AMIS Options > Schedule page.
Step 2 Click boxes on the schedule grid to set the active and inactive half hours. To avoid clicking the same blocks for more than one day, use the Copy Day's Schedule box to copy the settings from one day to other days.
Step 3 Click the Save icon.
Creating AMIS Delivery Locations
Create an AMIS 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 networked together, create the AMIS delivery locations only on those Cisco Unity server(s) that will place and receive AMIS calls.
To Create AMIS 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. See the "Guidelines for Assigning Dial IDs and Extensions" section on page 7-2 for detailed information about choosing a Dial ID.
Step 5 Select AMIS as the Destination Type for the location.
Step 6 Click Add.
Step 7 Record a voice name for the location.
Step 8 Enter the Delivery Phone Number. This is the number that Cisco Unity dials to connect to the remote voice messaging system for outgoing AMIS messages.
Step 9 Enter the numbers for the Node ID, which is used to identify the remote voice messaging system that corresponds to this delivery location. This Node ID must match the Node ID that the corresponding remote voice messaging system transmits during incoming calls. If desired, the Country Code and Area Code fields may be left blank; however, the Phone Number field is mandatory.
Step 10 Click the Save icon.
Creating AMIS Subscribers
You can create AMIS 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 AMIS 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 check 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 AMIS 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 AMIS subscribers because they cannot log on to Cisco Unity or use the Cisco Personal Communications Assistant (PCA), administrators can enter call transfer numbers for AMIS subscribers. For security purposes, you should modify the restriction table used for transfers in the COS to which AMIS 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.
Public distribution lists correspond to distribution groups in Active Directory and to distribution lists in Exchange 5.5. The distribution lists are listed in the address book for Microsoft Outlook (or other e-mail client), unless they are explicitly hidden. To help prevent others from sending e-mail to AMIS subscribers, you may want to create lists that contain only AMIS subscribers, and then hide these distribution lists from the Outlook address book. The option to hide distribution lists is available on the Subscribers > Public Distribution Lists > Profile page in the Cisco Unity Administrator. Additionally, you may also want to exclude AMIS 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 applicable 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.
AMIS subscribers correspond to contacts in Active Directory and to custom recipients in Exchange 5.5. The contacts/custom recipients are listed in the address book for Microsoft Outlook (or other e-mail client), unless they are explicitly hidden. You may prefer that the associated contacts/custom recipients do not appear in the Outlook address book at all, or you may want to alter how contacts appear in the Outlook address book. See the "Determining How AMIS Subscribers Appear in the Outlook Address Book" section for details.
Note The Cisco Unity System Administration Guide is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/sag/sag403/ex/index.htm.
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.
As long as the user data contained in the CSV file is formatted correctly, you can use it to create new contacts or custom recipients at the same time that you create subscriber accounts. (If Cisco Unity uses an Exchange 2000 or Exchange 2003 server as its partner server, a contact is created in Active Directory. If Cisco Unity uses an Exchange 5.5 server as its partner server, a custom recipient is created in the Exchange 5.5 directory.) Alternatively, the Cisco Unity Bulk Import wizard allows you to use a CSV file to create subscriber accounts with existing contact or custom recipient data.
If you choose to create subscriber accounts with existing contact or custom recipient data, note that the e-mail addresses for the imported contacts or custom recipients are overwritten with extension addresses used for addressing voice messages to the remote voice messaging systems. Thus, the imported objects can no longer be used for outbound message addressing to remote e-mail addresses.
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 AMIS 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 directory 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 that 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
Note The examples in this procedure illustrate how to set up a CSV file so that the Cisco Unity Bulk Import wizard creates subscriber accounts and new contacts or custom recipients at the same time. If you choose to create new subscriber accounts with existing contact or custom recipient data, you must also include the ALIAS column header and data in your CSV file.
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
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 To associate the subscribers in the CSV file with a delivery location, you can either choose from the list of defined delivery locations presented by the Cisco Unity Bulk Import wizard during the import, or you can add the DELIVERY_LOCATION_ID column to the CSV file.
The DELIVERY_LOCATION_ID column contains the dial ID of a delivery location that the external subscriber will be associated with. This value corresponds to the Dial ID field on the Network > Delivery Locations > Profile Page in the Cisco Unity Administrator. If this column header is omitted, or if a row does not contain a value, the delivery location that the Cisco Unity Import wizard prompts for is used as a default. You can import external subscribers for multiple delivery locations by using one CSV file.
Step 8 To help prevent others from sending e-mail to AMIS subscribers, you may want to include the HIDE_IN_ADDRESS_BOOK column header, and enter a 1 (one) in each row of subscriber data. (A 1 indicates to hide subscribers from the e-mail address book, and 0 indicates to display.)
Step 9 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 10 Confirm that each row contains the applicable data corresponding to each column header.
Step 11 Save the file as a CSV file.
Step 12 Continue with the following procedure "To Create AMIS Subscriber Accounts by Using the Cisco Unity Bulk Import Wizard."
Note Before you run the Cisco Unity Bulk Import wizard, disable virus-scanning services and intrusion-detection software on the Cisco Unity server, if applicable. Otherwise, the Cisco Unity Bulk Import wizard may run slowly. See the Cisco Unity Bulk Import wizard online Help for procedures.
To Create AMIS 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 AMIS.
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 wizard, the error and output log files are overwritten (unless you specify new names for the files).
To correct import errors, use the following procedure.
To Correct Errors That Occurred When Importing Data from a CSV File
Step 1 Browse 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 Browse 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 AMIS Subscriber Accounts
By using the Cisco Unity Administrator, you can create AMIS subscriber accounts one at a time. When you add a new AMIS subscriber account, Cisco Unity creates a contact or a custom recipient. (If Cisco Unity uses an Exchange 2000 or Exchange 2003 server as its partner server, a contact is created in Active Directory. If Cisco Unity uses an Exchange 5.5 server as its partner server, a custom recipient is created in the Exchange 5.5 directory.)
To create an AMIS subscriber account, do the following procedure.
To Add a New AMIS 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 AMIS from the list.
Step 4 Enter the First Name and Last Name.
Step 5 Enter the Extension of the AMIS subscriber on Cisco Unity. This is the number that Cisco Unity subscribers use when addressing a message to this AMIS 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 AMIS subscriber.
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 applicable, and then click the Save icon.
After Creating Subscriber Accounts
After creating AMIS subscriber accounts, consider the following:
•It takes a few minutes for a newly-created subscriber to be available to receive messages.
•You can make changes to subscriber settings for individual accounts in the Cisco Unity Administrator. For details, refer to the "Subscriber Settings" chapter in the Cisco Unity System Administration Guide. The Cisco Unity System Administration Guide is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/sag/sag403/ex/index.htm.
•When you want to modify unique subscriber settings—such as primary or alternate extensions—for multiple subscribers at once, you can (re)run the Cisco Unity Bulk Import wizard. To learn more, refer to the Cisco Unity Bulk Import wizard online Help.
•When a subscriber leaves the organization or otherwise no longer needs a Cisco Unity account, you can delete the subscriber account. See the "Deleting AMIS Subscribers" section for details.
AMIS Concepts and Definitions
The following sections explain AMIS concepts in detail:
•Introduction to AMIS
•Port Usage and Schedules
•UAmis Mailbox
•Voice Connector and AMIS Networking
•Locations and AMIS Networking
•Message Addressing Options
•Blind Addressing and AMIS Networking
•AMIS Subscribers
•Extension Addresses
•Determining How AMIS Subscribers Appear in the Outlook Address Book
•Migrating Subscribers from Another Voice Messaging System to Cisco Unity
•Considerations for Networked Cisco Unity Servers
Introduction to AMIS
In AMIS terminology, Cisco Unity and the other voice messaging systems that it communicates with are called nodes. Each node is assigned a unique ID, referred to as a Node ID. The node that places an AMIS call and delivers messages is called the originating node. The node that answers the AMIS call and receives messages is called the destination node. If a particular system acts as both an originating node and a destination node, its Node ID is the same for both functions. AMIS nodes correspond to locations in Cisco Unity.
The Cisco Unity subscribers and the users on the other voice messaging systems are identified by mailbox numbers. On Cisco Unity, the mailbox number for a subscriber is the same as the subscriber extension.
Voice messages are transmitted between nodes by using ordinary phone connections. When one node calls another by dialing a specified delivery phone number, the originating node transmits its Node ID by using a sequence of touchtones. If the destination node accepts the call, the originating node transmits each voice message by using analog playback, and the destination node records each message and delivers it to the applicable mailbox. For detailed information about the touchtones that are transmitted during an AMIS call, refer to the White Paper: AMIS Analog Networking Definitions, which is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/whitpapr/amis.htm.
In compliance with the AMIS protocol, Cisco Unity batches outgoing messages by node, with a maximum of 9 messages per batch. If there are more than 9 messages for a particular node, Cisco Unity ends the AMIS session after sending the ninth message, hangs up for a brief period of time, and then redials the node to send the next batch of messages.
The AMIS protocol specifies that a message be a maximum of eight minutes long. During an AMIS transmission, before playing a message, the originating node sends the destination node the length of the message. If the message is too long, the destination node may refuse the message and skip to the next message. However, some voice messaging systems will accept longer messages. If the voice messaging system refuses the message, a non-delivery receipt (NDR) is returned to the sender. If a subscriber sends a message that is longer than eight minutes, Cisco Unity will attempt to transmit it. In addition, Cisco Unity may accept messages longer than eight minutes. For each incoming message, Cisco Unity checks the space available in the subscriber mailbox and the Maximum Message Length setting on the Subscriber > Messages page to determine whether to accept the message.
Incoming AMIS messages are delivered to subscriber mailboxes only, and cannot be delivered to public distribution lists.
Note that for incoming AMIS calls, the initial "handshake" between the originating system and Cisco Unity must take place in a call handler, such as the Opening Greeting call handler. For AMIS Networking to be properly configured, you need to ensure that all incoming AMIS calls are routed to a call handler. When Cisco Unity is initially installed, the default setting is for the call routing table to route calls to the Opening Greeting call handler; thus it is properly configured for AMIS Networking. If the call routing table has been modified after installation, you need to make sure that a rule is in place in your call routing table to route any incoming AMIS calls to a call handler.
Port Usage and Schedules
In the Cisco Unity Telephony Integration Manager (UTIM) and in the Cisco Unity Administrator on the System > Ports page, you can designate which ports on your system are used for outgoing AMIS calls. All ports are used for incoming AMIS calls.
AMIS transmissions can be lengthy and thus tie up ports on your Cisco Unity server. For example, 10 hours of AMIS messages take at least 10 hours of port time to transmit. A 2-minute message sent to a public distribution list that contains 200 AMIS recipients results in 200 messages in the outbound queue, and would require at least 6.5 hours of port time to transmit.
When multiple ports have been designated for outgoing AMIS messages, Cisco Unity uses all designated ports as message traffic warrants. The total number of ports used is limited by the availability of ports that have been designated for outgoing AMIS calls. For example, if there are 10 ports available for outgoing AMIS messages, and 10 hours of messages to deliver, then all 10 ports are used for message delivery, and the time to transmit all the messages will be about one hour plus the time it takes to place the calls and establish the AMIS sessions.
Outbound messages are sorted according to their destination, and then batched into groups of 9. If there are multiple destinations, multiple ports are used to transmit the messages. If there are numerous messages to one destination, each batch of messages (with a maximum of 9 per batch) is transmitted on a different port, if one is available. In other words, if you have multiple ports designated for AMIS message delivery, then multiple ports will be used to handle the messages to a single node, as needed. As the number of messages for a particular node increases, an additional port is added when the number of outgoing messages reaches a multiple of 9. For example, one port will be used for message delivery if there are 9 or fewer messages to a node. For 10-18 messages, two ports will be used. For 19-27 messages, three ports will be used, and so on.
After a port starts an AMIS session, it continues sending messages as long as there are messages to be sent. The only time a port disconnects is when there are no more outgoing messages, or after it sends the ninth message to the same node. In this case, the port disconnects briefly, and then continues sending messages if there are more messages that need to be sent.
Because the transmission of outgoing AMIS messages can tie up voice ports for long periods of time, you may want to adjust the schedule so that outgoing AMIS calls are placed during closed hours or at times when Cisco Unity is not processing many calls. Additionally, if most or all of your AMIS delivery numbers are long distance, you may want to schedule the outgoing AMIS calls when the long distance phone rates are lower. Keep in mind, however, that outgoing messages are queued up in the UAmis mailbox, so there must be sufficient storage available if you restrict the delivery window.
You can override the AMIS schedule so that messages marked urgent are sent immediately. Additionally, by setting up a restriction table, you can specify which delivery numbers are sent immediately and which numbers must wait for the AMIS schedule to become active.
If you adjust the AMIS schedule so that outgoing AMIS calls are made only after normal business hours, be sure to inform subscribers. They may choose to contact users on the other voice messaging system directly, or send e-mail, rather than send a voice message that will not be delivered immediately.
In organizations with multiple Cisco Unity servers networked together, you can set up a "bridgehead" Cisco Unity server to handle all AMIS calls—both inbound and outbound—for all of the Cisco Unity servers in the network. This way, the ports on just one Cisco Unity server are used for AMIS messages.
For additional information, see the following:
•UAmis Mailbox
•Considerations for Networked Cisco Unity Servers
•AMIS Delivery Options Settings
•AMIS Schedule Settings
•Also refer to the "Voice Messaging Port Settings" section in the "System Settings" chapter of the Cisco Unity System Administration Guide. The Cisco Unity System Administration Guide is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/sag/sag403/ex/index.htm.
UAmis Mailbox
Outgoing AMIS messages are placed in a special Exchange mailbox, which has the display name UAmis_<Server name>. Before AMIS messages can be transmitted, you must create the UAmis mailbox (see the "Creating the UAmis Mailbox" section).
When Cisco Unity and its partner Exchange server are on the same computer, the UAmis Exchange mailbox is created on the Cisco Unity server. When the partner Exchange server is not on the same computer as Cisco Unity, the UAmis mailbox is created on the partner Exchange server.
The storage limits for the UAmis mailbox are set to the limits defined for the mailbox store in which the UAmis mailbox is created. You can change the storage limit for the UAmis mailbox by using the Exchange 2000 or Exchange 2003 System Manager or Exchange 5.5 Administrator, as applicable. If the UAmis mailbox is full, subsequent outgoing messages cannot be delivered, and the sender receives a NDR.
Consider the following when determining whether limits should be set on the UAmis mailbox:
•If the AMIS dialing restrictions and schedule are configured such that AMIS messages are delivered only during specified periods of the day, messages are queued up in the UAmis mailbox. The storage limit must be high enough to store all AMIS messages during the non-delivery periods.
•There could be times during the day when the number of AMIS messages spikes, particularly if the UAmis mailbox handles AMIS traffic for multiple Cisco Unity servers. The storage limit must be high enough to handle this.
•If hard disk space on the Exchange server is limited, you may want to set a limit to ensure that available space is not exceeded.
You may want to monitor the outgoing AMIS message traffic by running the AMIS Out Traffic Report before setting limits on the UAmis mailbox. For more information, refer to the "AMIS Out Traffic Report" section in the "Reports" chapter of the Cisco Unity System Administration Guide. (The Cisco Unity System Administration Guide is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/sag/sag403/ex/index.htm.)
The UAmis mailbox can be moved and deleted just like any other Exchange mailbox, by using standard Microsoft tools. To avoid inadvertently moving or deleting the UAmis mailbox, consider changing the Exchange display name so that the mailbox is more clearly identified to you or the Exchange administrator as requiring "special" treatment.
Caution After installing the UAmis mailbox, if you later move it to another Exchange server, you will have to stop and restart Cisco Unity after the move. Otherwise, messages get stuck in the mailbox.
Messages are sent from the UAmis mailbox at one or more of the following times:
•When a message is marked urgent, and the AMIS delivery option settings allow urgent messages to be sent immediately.
•When the AMIS restriction table allows the delivery number of a message.
•When the AMIS schedule becomes active.
When AMIS messages are sent, Cisco Unity follows the AMIS protocol. It batches the outgoing messages by destination, with a maximum of nine messages per batch. If there are more than nine messages for a particular destination, Cisco Unity ends the AMIS session after sending the ninth message, hangs up for a brief period of time, and then redials the delivery number to send the next batch of messages. Messages that have not been sent when the schedule becomes inactive remain in the UAmis mailbox until the schedule becomes active again. An error is logged in the Windows Application Event log when messages remain in the UAmis mailbox for more than 24 hours. See the "Maintenance" section for information about monitoring the UAmis mailbox.
In organizations with multiple Cisco Unity servers networked together, the UAmis mailbox needs to be created only on those Cisco Unity servers that will place and receive AMIS calls. See the "Considerations for Networked Cisco Unity Servers" section for more information.
Voice Connector and AMIS Networking
The Voice Connector allows Cisco Unity to send and receive AMIS messages. When subscribers use the phone to address a message to an AMIS recipient, Cisco Unity constructs an address with the form AMIS:<Location Dial ID>_<Remote Mailbox> for the message. The Voice Connector is registered with Exchange to handle messages with the AMIS address type. For an outbound message to an AMIS recipient, the Voice Connector transforms the message properties and delivers the message to the UAmis mailbox. For installations with multiple Cisco Unity servers, the Voice Connector delivers the message to the UAmis mailbox associated with the Cisco Unity server on which the AMIS location or AMIS subscriber was created.
There are two versions of the Voice Connector. The version that you use depends on your Exchange network:
•When your network consists only of Exchange 5.5 servers, you install the Voice Connector for Exchange 5.5.
•When your network consists only of Exchange 2000 or Exchange 2003 servers, or a mixture of Exchange 2000 or Exchange 2003 and Exchange 5.5 servers, you install the Voice Connector for Exchange 2000.
Note The Voice Connector for Exchange 2000 version 11.0(1) or later can be installed on either an Exchange 2000 or Exchange 2003 server.
Caution If your network consists of both Exchange 5.5 and Exchange 2000 or Exchange 2003 servers, do not use the Exchange 5.5 Administrator to manage the Voice Connector for Exchange 2000. Use the Exchange 2000 or Exchange 2003 System Administrator to manage the Voice Connector. To avoid system errors, use the Exchange 5.5 Administrator to configure Exchange 5.5 objects, and use the applicable MMC snap-in to configure Exchange 2000 or Exchange 2003 objects.
See the "Setting Up the Voice Connector for AMIS Networking" section for information about setting up the Voice Connector.
Locations and AMIS Networking
Central to how you set up AMIS 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 AMIS, you give the primary location a new name and a Dial ID (which is an identifier for the location within Cisco Unity), enter the AMIS Node ID, and customize other properties as applicable. The AMIS Node ID on the primary location is transmitted on all outgoing AMIS calls and identifies your Cisco Unity system to the destination nodes. See the "Primary Location Profile Settings" section on page 7-1 for more information.
You create a delivery location in Cisco Unity 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 nodes—the Delivery Phone Number and the AMIS Node ID. See the "AMIS Delivery Location Profile Settings" section for more information.
In organizations with multiple Cisco Unity servers networked together, the delivery locations should be created only on those Cisco Unity servers that will place and receive AMIS calls. See the "Considerations for Networked Cisco Unity Servers" section for more information.
Message Addressing Options
Cisco Unity provides the following message addressing options:
•Blind addressing—Allows Cisco Unity subscribers to send messages to subscribers on the remote voice messaging system even though the recipient mailbox number, name, and recorded name are not in the directory. Even though Cisco Unity cannot provide voice name confirmation (hence the term "blind addressing"), the message is addressed and sent. See the "Blind Addressing and AMIS Networking" section for more information.
•AMIS subscribers—Allows Cisco Unity subscribers to get voice name confirmation when addressing messages to subscribers on the remote voice messaging system. AMIS subscribers are a representation in Cisco Unity of the subscribers on the remote messaging system. AMIS subscribers are created in Cisco Unity to enable Cisco Unity subscribers to find them in the directory and send them messages as they would with any other subscriber. See the "AMIS Subscribers" section for more information.
Message Addressing Limitations
Subscribers can use the Cisco Unity phone conversation (also known as the telephone user interface, or TUI), ViewMail for Microsoft Outlook, or the Cisco Unity Inbox to reply to and forward AMIS messages just as they do with regular voice messages. However, when sending or retrieving AMIS messages, subscribers will encounter the following limitations:
•AMIS messages marked urgent when they are sent are not marked urgent when they are retrieved by the recipient.
•AMIS messages marked private when they are sent are not marked private when they are retrieved by the recipient.
•Requests for return receipts on AMIS messages are not honored.
•E-mail messages cannot be sent to AMIS recipients even though ViewMail allows subscribers to address them. Instead of being delivered, e-mail messages sent to AMIS recipients are returned to the sender as NDRs.
(Note that in version 3.1 and earlier, the Cisco Unity Inbox was known as the Visual Messaging Interface or VMI.)
Blind Addressing and AMIS Networking
AMIS blind addressing is one of the methods that Cisco Unity provides for addressing AMIS messages to users of another voice messaging system. Blind addressing allows Cisco Unity subscribers to send messages to subscribers on the remote voice messaging system even though the recipient mailbox number, name, and recorded name are not in the directory. Even though Cisco Unity cannot provide voice name confirmation (hence the term "blind addressing"), the message is addressed and sent.
One of the steps to setting up blind addressing is adjusting the Blind Addressing setting on the Primary Location > Addressing Options page. You also create a delivery location that corresponds to each voice messaging system with which Cisco Unity communicates.
You provide the following information for each delivery location:
•Delivery Phone Number—The number that Cisco Unity dials to reach the other voice messaging system.
•AMIS Node ID—The number used by Cisco Unity to identify the remote voice messaging system during an AMIS transmission. For incoming calls, Cisco Unity searches the AMIS delivery locations for an AMIS Node ID that matches the value transmitted by the originating node. If a corresponding location is not found, Cisco Unity follows the AMIS protocol and rejects the call without recording messages.
•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.
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 a voice name was recorded for the delivery location).
Because your Cisco Unity server does not have access to the names and extensions of the users on the other voice messaging system, subscribers cannot use spelling mode when blind addressing a message to someone on the other system.
Subscribers can also address voice messages in ViewMail for Microsoft Outlook and in the Cisco Unity Inbox to someone on the remote voice messaging system by using the following format: [AMIS:<Location Dial ID>_<Remote Mailbox>]. For example, to send a message to Dial ID 206, mailbox 555, the address is: [AMIS:206_555]; the brackets must be included in the address. (Note that in version 3.1 and earlier, the Cisco Unity Inbox was known as the Visual Messaging Interface or VMI.)
For administrators of Cisco Unity, blind addressing is the option which requires the least amount of work to set up. However, subscribers will encounter some limitations when blind addressing messages to users on the other voice messaging system. 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. Additionally, Cisco Unity cannot verify that the number entered is correct, so subscribers may inadvertently address a message to the wrong person or to a non-existent mailbox.
In organizations with multiple Cisco Unity servers networked together, when subscribers use blind addressing to address messages to someone at an AMIS location, the AMIS transmission originates from the Cisco Unity server on which the AMIS delivery location was created. See the "Considerations for Networked Cisco Unity Servers" section for more information.
AMIS Subscribers
AMIS subscribers are a representation in Cisco Unity of the subscribers on the remote messaging system. AMIS subscribers are created in Cisco Unity to enable Cisco Unity subscribers to find them in the directory and send them messages as they would with any other subscriber. Voice messages addressed to AMIS subscribers are sent to the voice messaging system that they use. To set up AMIS subscribers, you first create an AMIS delivery location that corresponds to each remote voice messaging system with which Cisco Unity communicates.
After creating the delivery location(s), you create an AMIS subscriber account for each remote user. When creating each AMIS subscriber account, you specify the user mailbox number on the other voice messaging system and select the AMIS delivery location with which the AMIS subscriber is associated. Cisco Unity uses the Delivery Phone Number and AMIS Node ID from the associated delivery location when delivering messages to the AMIS subscriber.
In organizations with multiple Cisco Unity servers networked together, AMIS subscribers can be associated only with AMIS delivery locations created on your Cisco Unity server. When subscribers address messages to an AMIS subscriber, the AMIS transmission originates from the Cisco Unity server on which the AMIS subscriber was created. See the "Considerations for Networked Cisco Unity Servers" section for more information.
AMIS subscribers in Cisco Unity are represented as custom recipients in Exchange 5.5 and as contacts in Active Directory. When you delete AMIS subscribers in the Cisco Unity Administrator either by deleting individual accounts or by deleting a delivery location that the AMIS subscribers are associated with, the underlying contacts/custom recipients are removed automatically.
You create and manage AMIS subscriber accounts in much the same way that you do regular subscriber accounts. You can use the Cisco Unity Administrator to create, modify, and delete AMIS subscriber accounts one at a time, and you can use the Cisco Unity Bulk Import wizard to create and modify multiple AMIS subscriber accounts.
Extensions are mandatory for AMIS subscriber accounts. The extension, which must be unique across the dialing domain, is the number that subscribers dial when addressing a message to an AMIS subscriber. This number may or may not be the same as the mailbox number of the AMIS subscriber on the remote voice messaging system. Callers who reach the opening greeting of your organization can dial the extension of an AMIS subscriber or look up an AMIS subscriber in directory assistance and leave a message.
Other than receiving messages, AMIS subscribers do not have access to other Cisco Unity features, and some sections of the Cisco Unity Administrator are disabled for AMIS subscribers. AMIS 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 AMIS subscribers requires more overhead for administrators of Cisco Unity than AMIS blind addressing does. However, the AMIS subscriber option allows other subscribers to address messages to AMIS subscribers the same way that they address messages to regular subscribers.
Subscriber Experience with AMIS Subscribers
Provided that AMIS subscribers are listed in the phone directory and have had voice names and greetings recorded for them:
•Subscribers can address messages to AMIS subscribers by using the phone, ViewMail for Microsoft Outlook, or the Cisco Unity Inbox.
•Contacts (or custom recipients) that correspond to AMIS subscribers are included in Exchange address lists which means that they are listed in the Outlook address book (unless the contact has been explicitly prevented from appearing there) and the Cisco Unity Inbox address book. Therefore, message addressing to AMIS subscribers—either by using Outlook or the Cisco Unity Inbox—is the same as for regular subscribers.
•When using the phone, subscribers can address messages to AMIS subscribers in spelled-name mode (if enabled on the system) or by extension.
•Subscribers get voice name confirmation when addressing a message to a AMIS subscriber.
•When subscribers use the phone to listen to messages, the conversation announces who the message is from.
•AMIS subscribers can be added to distribution lists.
Note Be sure to explain to subscribers the difference between a message sent via AMIS (which can be replied to) and a message that is left when a call is forwarded to voice mail (which cannot be replied to). See the "Leaving a Message Versus Sending a Message" section for more information.
Note that when Cisco Unity records a message from an unidentified caller for an AMIS subscriber, the Dial ID of the primary location is used as the sending mailbox. Although AMIS subscribers can reply to these messages, the messages are returned to the Unity Messaging System mailbox as NDRs.
Call Transfer Settings and AMIS Subscribers
AMIS subscribers have call transfers settings, can be listed in the phone directory, and have recorded voice names and greetings just like regular Cisco Unity subscribers. Callers who call into the Cisco Unity server on which the AMIS subscribers were created can enter an extension of an AMIS subscriber or look up the extension in the phone directory. When AMIS subscribers do not have phones on the phone system that Cisco Unity is integrated with, you should configure the call transfer settings to sends calls directly to the subscriber's greeting. In this case, Cisco Unity plays the greeting of the AMIS subscriber, records the message, and sends it via AMIS to the remote messaging system.
If you have configured call transfer settings for AMIS subscribers so that calls are transferred to an extension on the phone system that Cisco Unity is integrated with or to another number, depending on how you configure the other call transfer settings, messages left by callers for AMIS subscribers may be recorded directly by the remote voice messaging system, or they may be recorded by Cisco Unity and sent via AMIS to the remote voice messaging system. If the transfer type is:
•Release to switch, Cisco Unity dials the number specified in the call transfer settings for the AMIS subscriber and hangs up. Presumably, this rings the AMIS subscriber phone, which is set to forward calls on ring no answer or busy to the voice messaging system on which the AMIS subscriber has a mailbox.
•Supervise transfer, Cisco Unity dials the number specified in the call transfer settings for the AMIS subscriber and stays on the line to monitor progress. On ring no answer or busy, Cisco Unity pulls the call back, plays the greeting of the AMIS subscriber, records the message, and sends it via AMIS to the remote messaging system. Note, however, if the rings to wait is set for more rings than the phone is set for on forward to voice mail, the call will forward to the other voice mail system, because Cisco Unity will detect the other voice mail system prompt as a connect and let go of the call, in which case the message is recorded by the remote voice mail system.
Note that in installations with multiple Cisco Unity servers, call transfer settings are not replicated among the Cisco Unity servers. See the "Call Transfer Settings Unavailable" section for more information.
Deleting AMIS Subscribers
Each AMIS Subscriber is associated with a directory object, which is either an Active Directory contact or an Exchange 5.5 custom recipient. When you delete AMIS subscribers in the Cisco Unity Administrator by deleting the subscriber accounts individually, the underlying directory objects are automatically deleted. To delete all the AMIS subscribers associated with a delivery location, the underlying contacts for those subscribers, and the delivery location itself, use the Global Subscriber Manager available in Tools Depot.
Extension Addresses
When you create an AMIS subscriber, Cisco Unity automatically generates an e-mail address in the following format:
AMIS:<Location Dial ID>_<Remote Mailbox>
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 AMIS subscriber is associated, and the Remote Mailbox Number of the AMIS subscriber. Each contact in Active Directory that corresponds to an AMIS subscriber contains an extension address. Similarly, each custom recipient in Exchange 5.5 that corresponds to an AMIS subscriber contains an extension address.
When subscribers use the phone to address messages to an AMIS subscriber, they dial an extension. Cisco Unity recognizes the recipient as an AMIS subscriber and retrieves the extension address from the SQL database on the Cisco Unity server.
Extension addresses are generated automatically when you create AMIS subscribers, and as of Cisco Unity 4.0(3), extension addresses are automatically updated if you change the Dial ID of a delivery location. (Because the extension addresses are now updated automatically, the Extension Address utility is no longer included with the tools that ship with Cisco Unity.)
Determining How AMIS Subscribers Appear in the Outlook Address Book
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 AMIS subscriber accounts are created for them, the Exchange address lists will contain duplicate listings—the existing user account and a new contact (or custom recipeint). Both listings are included in the Outlook address book. This means that people may inadvertently send e-mail messages to the contact, which should be used only for addressing voice messages.
To discourage people from inadvertently sending e-mail messages to AMIS subscribers, you can prevent the associated contact (or custom recipeint) from appearing in the Outlook address book. Alternatively, you can change how the display name for the contact appears in the Outlook address book so that subscribers can distinguish the contact from a user account. In this way, you can reduce the number of e-mail messages inadvertently sent to contacts and simplify addressing for those sending voice messages to AMIS subscribers at the same time.
If you prefer that the associated contacts for subscribes do not appear in the Outlook address book at all, see the "Preventing Contacts From Appearing in the Outlook Address Book" section.
Alternatively, if you want to alter how contacts appear in the Outlook address book, see the "Modifying How Contacts Appear in the Outlook Address Book" section.
Preventing Contacts From Appearing in the Outlook Address Book
Either before or after you create AMIS subscriber accounts, you can prevent the associated contact (or custom recipeint) from appearing in the Outlook address book by hiding them from Exchange address lists. When you do so, Exchange will still deliver e-mail messages addressed to an existing user account (if one exists) and to the contact. However, the number of e-mail messages sent to the contact may be reduced because subscribers cannot inadvertently pick the contact from the Outlook address book when addressing messages to them.
The method by which you prevent subscribers from appearing in Outlook address books varies depending on your version of Exchange:
Cisco Unity with Exchange 5.5
To prevent subscribers from appearing in Outlook address books, you can use either the Cisco Unity Administrator, Bulk Edit, or Microsoft Exchange 5.5 Administrator:
•To do so in the Cisco Unity Administrator, uncheck the Show Subscriber In E-Mail Server Address Book check box on the Profile page for the subscriber template that you plan to use when creating AMIS subscribers, or on individual subscriber Profile pages after you have created the subscribers.
•To do so by using the Bulk Edit utility, refer to the online Help.
•To do so in the Microsoft Exchange 5.5 Administrator, double-click a recipient, and then check the Hide From Address Book check box on the Advanced tab.
Cisco Unity with Exchange 2000 and Exchange 2003
To prevent subscribers from appearing in Outlook address books, you can use the Cisco Unity Administrator, the Cisco Unity Bulk Import wizard, Bulk Edit, or Windows Active Directory for Users and Computers:
•To do so in the Cisco Unity Administrator, uncheck the Show Subscriber In E-Mail Server Address Book check box on the Profile page for the subscriber template that you plan to use when creating AMIS subscribers, or on individual subscriber Profile pages after you have created the subscribers.
•To do so by using the Cisco Unity Bulk Import wizard or the Bulk Edit utility, refer to the online Help for each tool.
•To do so in Windows Active Directory for Users and Computers, select View > Advanced Features to see the Exchange Advanced property page for a user, and then check the Hide From Exchange Address Lists check box on the Exchange Advanced tab.
Modifying How Contacts Appear in the Outlook Address Book
As an alternative to preventing a contact (or custom recipeint) from appearing in the Outlook address book altogether, you may want to alter the display name for the contact so that subscribers can distinguish the contact from the user account. For example, you could append " - Voice mail" to the display name of each AMIS subscriber, and the names would appear in the Outlook address book as follows:
Abade, Alex
Abade, Alex - Voice mail
Bader, Kelly
Bader, Kelly - Voice mail
Campbell, Terry
Campbell, Terry - Voice mail
Cho, Li
Cho, Li - Voice mail
In this way, subscribers can easily determine which address is appropriate to use when they send voice messages to AMIS subscribers. Additionally, when subscribers use the Outlook address book to address a message to a contact, they can be confident that the address is formatted correctly.
Migrating Subscribers from Another Voice Messaging System to Cisco Unity
If you are using AMIS to migrate from another voice messaging system to Cisco Unity, there are several tools that you can use to create Cisco Unity subscribers from AMIS subscriber information. See the following sections for more information:
•Migrating Subscribers in Bulk
•Migrating Subscribers One at a Time
Migrating Subscribers in Bulk
Following are the general steps for migrating AMIS subscribers to Cisco Unity subscribers in bulk. Refer to the help files of each of the tools for more information. (Click the Tools Depot icon on the Cisco Unity server, and click the applicable tool in the left pane to view the help file.)
1. As a best practice, back up the Cisco Unity server (just as a precaution because you will be deleting data).
2. Run Subscriber Information Dump from Tools Depot, and output the AMIS subscriber information to a CSV file.
3. Modify the output CSV file as needed so that you can use it as the input file when you create Cisco Unity subscribers by using the Cisco Unity Bulk Import wizard.
4. Run Global Subscriber Manager from Tools Depot to delete the AMIS delivery locations and associated AMIS subscribers and underlying contacts.
5. Optionally, create Windows domain accounts if they have not already been created. Alternatively, you can let the Cisco Unity Bulk Import wizard create the accounts.
6. Optionally, create Exchange mailboxes if they have not already been created. Alternatively, you can let the Cisco Unity Bulk Import wizard create the mailboxes.
7. Run the Cisco Unity Bulk Import wizard using the input file that you prepared in step 3.
Migrating Subscribers One at a Time
If you have set up AMIS 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 AMIS subscriber account (such as the voice name) with an existing mail user. The utility then deletes the AMIS subscriber account and the associated Active Directory contact (or Exchange 5.5 custom recipient).
The Migrate Subscriber Data utility is available in Tools Depot on the Cisco Unity server. Refer to the Help file that comes with the utility for more information.
Considerations for Networked Cisco Unity Servers
In organizations with multiple Cisco Unity servers networked together, when subscribers address messages to an AMIS delivery location (by using blind addressing) or to an AMIS subscriber, the AMIS transmission originates from the Cisco Unity server on which the AMIS delivery location was created. (Note that AMIS subscribers are always created on the same Cisco Unity server as their associated AMIS delivery locations.)
When subscribers address a message to someone on the remote voice messaging system, the Voice Connector delivers the message to the UAmis mailbox associated with the Cisco Unity server on which the addressed AMIS delivery location was created. The AMIS schedule and the AMIS delivery options on the pertinent Cisco Unity server are applied.
Only one Cisco Unity server in the network needs to be set up for AMIS. If allowed by the primary location addressing options, all subscribers, no matter which Cisco Unity server they are associated with, can send messages to an AMIS delivery location or to an AMIS subscriber. The Cisco Unity server configured for AMIS acts as the AMIS "bridgehead" server for the other Cisco Unity servers in the network. For example, in Figure 4-1, there are three Cisco Unity servers in the network, but Unity 2 is the only server configured for AMIS. Unity 2 places and receives all the AMIS calls. Thus, no matter which Cisco Unity server a subscriber is associated with, when the subscriber sends a message to someone on another voice messaging system, the message is routed to the UAmis mailbox associated with Unity 2. This mailbox is homed on the Exchange server that was selected during the setup of Unity 2.
Figure 4-1 AMIS Bridgehead Configuration
Design Considerations
Because AMIS calls are placed and answered on the Cisco Unity server on which the AMIS delivery locations were created, you can configure your Cisco Unity servers as needed to handle AMIS traffic.
•You can set up a bridgehead topology by designating one Cisco Unity server in the network to handle sending and receiving AMIS calls. See Figure 4-1.
•Recall that the dialout for an outbound AMIS message originates from the Cisco Unity server on which an AMIS delivery location was created. If the AMIS traffic is too heavy for one Cisco Unity server to handle, you can balance the load by setting up multiple AMIS bridgehead servers. In this case, you need to determine which AMIS delivery locations and AMIS subscribers to create on each of the Cisco Unity servers, and keep a record of the mapping.
For example, assume that there are two AMIS bridgehead servers, Bridgehead A and Bridgehead B, and there are four AMIS delivery locations called London, Paris, Goose Creek, and Monks Corner. You anticipate that message delivery to the London and Paris delivery locations will be heavy, and that message delivery to the Goose Creek and Monks Corner delivery locations will not be as heavy. You can balance the load by creating the London and Goose Creek delivery locations on Bridgehead A, and create the Paris and Monks Corner delivery locations on Bridgehead B. This ensures that the AMIS traffic for the two heavy AMIS locations is split up between the two bridgehead servers, rather than one trying to deliver all of the messages by itself.
•For organizations with Cisco Unity servers deployed in different areas around the country or the world, it may be possible to set up a least-cost-routing topology to minimize or eliminate long distance phone charges related to AMIS transmissions.
For example, assume there are Cisco Unity servers in Chicago and in New York, and that there is also another voice messaging system in New York to which subscribers in Chicago want to send messages. To avoid long distance phone charges when subscribers in Chicago send messages to individuals who use the remote voice messaging system in New York, you create an AMIS delivery location, and optionally, AMIS subscribers, on the New York Cisco Unity server. When subscribers associated with the Chicago Cisco Unity server address messages to the AMIS subscribers in New York, the messages are first delivered by Exchange and the Voice Connector to the UAmis mailbox associated with the New York Cisco Unity server. Then the New York Cisco Unity server dials a local number to deliver the message to the remote voice messaging system, thus avoiding long distance phone charges.
Maintenance
Cisco Unity monitors AMIS transmissions and the UAmis mailbox, and logs error events to the Windows Application Event log. Outgoing messages that cannot be delivered are returned to the sender, or to the Unaddressed Messages public distribution list if Cisco Unity cannot determine who the sender is.
For detailed information about the touchtones that are transmitted during an AMIS call, refer to the White Paper: AMIS Analog Networking Definitions, which is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/whitpapr/amis.htm. You can use the StatusMonitor.exe utility in the \CommServer\TechTools directory on the Cisco Unity server to monitor AMIS transmissions.
Cisco Unity also provides reports on AMIS message traffic. For more information, refer to the "AMIS Out Traffic Report" and the "AMIS In Traffic Report" sections in the "Reports" chapter of the Cisco Unity System Administration Guide. (The Cisco Unity System Administration Guide is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/sag/sag403/ex/index.htm.)
Although Cisco Unity monitors the UAmis mailbox, you may want to check the UAmis mailbox periodically to confirm that messages are being sent in a timely manner. For example, if there are still messages to be sent when the AMIS schedule becomes inactive, they remain in the UAmis mailbox until the AMIS schedule becomes active again. If messages are often left in the UAmis mailbox, you may need to adjust the AMIS schedule or designate more voice ports for outgoing AMIS calls. Access to the UAmis mailbox is also needed when troubleshooting outbound message delivery problems.
In order to use Microsoft Outlook to access the UAmis mailbox, use the following procedure to add the UAmis mailbox to the user profile of someone with administrative rights to Exchange. Refer to the Outlook documentation for more information.
To Add the UAmis Mailbox to a User Profile
Step 1 Start Microsoft Outlook.
Step 2 On the Tools menu, click Services.
Step 3 On the Services tab, in The Following Information Services Are Set Up in This Profile box, click Microsoft Exchange Server.
Step 4 Click Properties.
Step 5 On the Advanced tab, click Add.
Step 6 In the Add Mailbox box, enter UAmis.
Step 7 Click OK three times to dismiss the dialog boxes.
AMIS Reference
This section contains tables that define the fields on the Cisco Unity Administrator web pages related to AMIS setup, and briefly explain the options for correctly entering information in the fields. See the following sections for details:
•AMIS Delivery Location Profile Settings
•AMIS Delivery Options Settings
•AMIS Schedule Settings
AMIS Delivery Location Profile Settings
AMIS 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 AMIS 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 an AMIS location.
Table 4-1 Profile 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 sending messages to a remote location, subscribers can 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 Dial IDs that have at least three-digits.
•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.
|
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 4-2 Profile Settings Specific to AMIS Delivery Locations
Field
|
Considerations
|
Delivery Phone Number
|
Enter the phone number, including trunk access code, that Cisco Unity dials for outgoing AMIS calls to the remote voice messaging system that corresponds to this delivery location.
|
Node ID:
Country Code, Area Code, Phone Number
|
Enter the numbers used to identify the remote voice messaging system that corresponds to this delivery location. This Node ID must match the Node ID that the corresponding remote voice messaging system transmits during incoming calls. Cisco Unity accepts messages only from known AMIS nodes, so the Node ID entered here must exactly match the Node ID that the remote voice messaging system transmits.
Although the Node ID numbers should contain all the information necessary for Cisco Unity to send a reply message to the originating system, this is not enforced because of the different ways in which voice messaging systems implement the AMIS protocol. Therefore, the only requirement is that the numbers entered here match the Node ID that the corresponding remote voice messaging system transmits.
The maximum number of digits for each field is:
•Country Code—4 digits
•Area Code—3 digits
•Phone Number—8 digits
|
Disable Outbound Message Delivery to This AMIS Location
|
By default, this check box is unchecked. When an outbound AMIS call to this delivery location is answered by a person or a voice messaging system that is not AMIS-compliant (such as an answering machine), this check box is checked automatically. Checking the check box automatically prevents Cisco Unity from repeatedly attempting to deliver messages to an incorrect Delivery Phone Number.
If the call is answered by a person, Cisco Unity plays a prompt that instructs the person to prevent further calls by pressing a touchtone. If the person presses the touchtone, Cisco Unity checks this check box and disables outbound calls to this location. If the person simply hangs up, or if a voice messaging system that is not AMIS-compliant answers (such as an answering machine), Cisco Unity retries the delivery phone number according to the settings on the Network > AMIS Options > Delivery Options page. When the maximum number of retries has been reached, Cisco Unity checks this check box to disable further calls to this number.
Any messages that could not be delivered to this location remain in the UAmis mailbox until you confirm the delivery phone number and then uncheck this check box. An error is logged in the Windows Application Event log when messages remain in the UAmis mailbox for more than 24 hours.
Note that when multiple Cisco Unity servers are networked together, you can view the contents of delivery locations created on other Cisco Unity servers, and edit this field from your local server.
|
AMIS Delivery Options Settings
The AMIS delivery options settings control attributes of outgoing AMIS calls. These settings apply to messages sent to all AMIS delivery locations and AMIS subscribers created on your Cisco Unity server.
One of the settings that you specify here is the Local Dial Restriction Table. This restriction table and the AMIS schedule together determine when outgoing AMIS calls are made. Refer to the "Restriction Tables" chapter of the Cisco Unity System Administration Guide for general information about restriction tables. (The Cisco Unity System Administration Guide is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/sag/sag403/ex/index.htm.)
Use the following table to learn more about AMIS delivery options settings.
Table 4-3 Network > AMIS Options > Delivery Options Page
Field
|
Considerations
|
Deliver Urgent Messages Immediately
|
Check this check box to allow messages marked urgent to be delivered immediately. Checking this check box overrides both the Local Dial Restriction Table and the AMIS schedule. When the check box is unchecked, Cisco Unity handles urgent messages the same as non-urgent messages.
|
Local Dial Restriction Table
|
Select a restriction table that determines which AMIS delivery numbers can be processed immediately. If an AMIS delivery number is allowed by the restriction table, messages to this number are delivered immediately. If the delivery number is not allowed by the restriction table, messages are queued in the UAmis mailbox until the AMIS schedule becomes active.
By default, the Local Dial Restriction Table field is set to the predefined Default AMIS restriction table. You can modify the Default AMIS restriction table or select another restriction table. For example, you may want to modify this restriction table to disallow long distance delivery numbers, and adjust the AMIS schedule to become active when the long distance phone rates are lower.
|
If the Remote System Does Not Answer: Hang Up After This Many Rings
|
Specify the number of rings that Cisco Unity waits for the remote node to answer when making an AMIS call. After the specified number of rings, Cisco Unity hangs up. The default value is 4.
|
If the Remote System Does Not Answer: Try Calling This Many Times
|
Specify the number of times that Cisco Unity makes AMIS redelivery attempts when the remote system did not answer the initial call. The default value is 4.
When the schedule that allows AMIS deliveries becomes inactive, the count that Cisco Unity maintains for this setting is reset to 0.
|
If the Remote System Does Not Answer: Retry After This Many Minutes
|
Specify the number of minutes that Cisco Unity waits after an AMIS call is not answered before attempting the call again. The default value is 5 minutes.
|
If the Remote System Is Busy: Try Calling This Many Times
|
Specify the number of times that Cisco Unity makes AMIS redelivery attempts when the initial attempt resulted in a busy signal. The default value is 4.
When the schedule that allows AMIS deliveries becomes inactive, the count that Cisco Unity maintains for this setting is reset to 0.
|
If the Remote System Is Busy: Retry After This Many Minutes
|
Specify the number of minutes that Cisco Unity waits after receiving a busy signal before attempting the AMIS call again. The default value is 5 minutes.
|
AMIS Schedule Settings
The AMIS schedule and the AMIS restriction table together determine when outgoing AMIS calls are made. If a delivery number for an outgoing AMIS message is allowed by the AMIS restriction table, the message is sent immediately—the schedule settings do not apply. If the delivery number is not allowed by the AMIS restriction table, the schedule determines when the message is sent. Therefore, the schedule determines when messages are sent for delivery numbers that are disallowed by the AMIS restriction table.
Cisco Unity batches messages to a delivery location, with a maximum of nine messages per batch. If an AMIS transmission is in progress when the schedule becomes inactive, the transmission of the entire batch of messages is completed. However, any other messages remaining in the queue, but not in the batch that was in the process of being transmitted, are queued until the next active time in the schedule. Queued messages are placed in the Inbox for the UAmis account.
Because the transmission of AMIS messages may tie up voice ports for long periods of time, you may want to schedule outgoing AMIS calls during closed hours or at times when Cisco Unity is not processing many calls. Additionally, if most or all of your AMIS delivery numbers are long distance, you may want to schedule the AMIS calls when the long distance phone rates are lower.
Use the following table to learn more about AMIS schedule settings.
Table 4-4 Network > AMIS > Schedule Page
Field
|
Considerations
|
Click Individual Blocks to Set Hours
|
Click the blocks in the grid to change from inactive to active hours. Click the block again to undo your change. Messages queued in the UAmis mailbox are sent only during the active hours on the schedule. Note that you can set active and inactive hours for one day, then use the Copy Day's Schedule box to copy the settings to other days.
|
Copy Day's Schedule
|
To avoid clicking the same blocks for more than one day, use the Copy Day's Schedule and >> functions. Select a day to copy, then select which days to copy the schedule setting to.
|
Troubleshooting
For information on troubleshooting problems with AMIS messages, refer to the following sections in the Cisco Unity Troubleshooting Guide, which is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/unity40/tsg/tsg403/ex/index.htm.
•In the "Logs and Traces" chapter:
–"AMIS Diagnostic Traces"
–"Cisco Unity Voice Connector Logs"
•In the "Messages" chapter:
–"Troubleshooting Problems with Outbound AMIS Messages"
–"Troubleshooting Problems with Inbound AMIS Messages"
For detailed information about the touchtones that are transmitted during an AMIS call, refer to the White Paper: AMIS Analog Networking Definitions, which is available at http://www.cisco.com/univercd/cc/td/doc/product/voice/c_unity/whitpapr/amis.htm.
Finally, you can use the StatusMonitor utility (located in \CommServer\TechTools on the Cisco Unity server) to observe call progress.
Notable Behavior
This section describes notable behavior of AMIS Networking. See the following sections for more information:
•Inbound Search Scope
•Leaving a Message Versus Sending a Message
•Restriction Table Selection Is Not Automatically Replicated Between Servers Set Up for Failover
Inbound Search Scope
In installations with multiple Cisco Unity servers networked together, the search scope for a matching subscriber extension for inbound messages sent from another AMIS-compliant voice messaging system is controlled by the primary location addressing options in the Cisco Unity Administrator. The search scope for inbound AMIS messages can be set to the local Cisco Unity server, to the dialing domain that the local Cisco Unity server is a member of, or to the entire global directory. Note that only subscriber extensions are searched. Incoming AMIS messages cannot be delivered to distribution lists.
Leaving a Message Versus Sending a Message
When a person on the remote voice messaging system who has a corresponding AMIS subscriber account calls a Cisco Unity subscriber and leaves a message, Cisco Unity does not identify the message as being from the AMIS subscriber. In this case, when the phone system forwards the call to Cisco Unity, the message is handled as though it came from an unidentified caller. This means that:
•Cisco Unity does not play the internal greeting of the subscriber when the caller leaves a message.
•Cisco Unity does not play the recorded voice name of the AMIS subscriber when the recipient listens to the message.
•Cisco Unity does not allow the recipient to record a reply.
However, when a person on the remote voice messaging system records and sends a message to a Cisco Unity subscriber, Cisco Unity can identify the message as being from the corresponding AMIS subscriber. In this case, the phone system is not involved and the recipient phone does not ring. Instead, the message is sent directly from the remote voice messaging server via AMIS to Cisco Unity, and then to Exchange, which delivers the message to the recipient. Thus, when the recipient listens to the message, Cisco Unity plays the recorded name of the AMIS subscriber, and allows the recipient to record a reply.
Restriction Table Selection Is Not Automatically Replicated Between Servers Set Up for Failover
On a system set up for Cisco Unity failover, when you change the restriction table to be used for outgoing AMIS calls, the table selection on the primary server does not replicate to the secondary server. You must manually select the same AMIS restriction table on the secondary server. Note, however, that the settings on the restriction table itself replicate. You specify the AMIS restriction table in the Cisco Unity Administrator on the Network > AMIS Options page.