Networking in Cisco Unity Guide (With IBM Lotus Domino), Release 4.0(3)
Internet Subscribers

Table Of Contents

Internet Subscribers

Overview: Internet Subscribers

Task List: Setting Up Internet Subscribers

Procedures for Setting Up Internet Subscribers

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

Creating Internet Subscriber Accounts

Before Creating Internet Subscriber Accounts

Using the Cisco Unity Bulk Import Wizard to Create Multiple Internet Subscriber Accounts

Correcting Import Errors

Using the Cisco Unity Administrator to Create Internet Subscriber Accounts

After Creating Internet Subscriber Accounts

Internet Subscriber Concepts and Definitions

Subscriber Experience with Internet Subscribers

Deleting Internet Subscribers


Internet Subscribers


Overview: Internet Subscribers

By creating Internet subscriber accounts, you enable Cisco Unity subscribers to send voice messages to recipients whose computers are connected to the Internet. Messages are sent over the Internet or any TCP/IP network via the Simple Mail Transfer Protocol (SMTP). The recipient receives a voice message as an e-mail with a WAV attachment.

If Cisco Unity is connected to a networked phone system, calls can be transferred from the auto attendant or the Cisco Unity directory assistance to the phone of the Internet subscriber. (With a networked phone system, subscribers dial an extension without having to dial a trunk access code or prefix when calling someone who is at another location on the phone network.)

In this chapter, you will find procedures for creating Internet subscribers, followed by detailed discussions of the concepts and terminology you need to understand. See the following sections:

Task List: Setting Up Internet Subscribers—This task list provides a high-level view of all of the tasks you need to complete, and the order in which they should be completed.

Procedures for Setting Up Internet Subscribers—This section contains all of the procedures necessary to set up Cisco Unity for Internet subscribers.

Internet Subscriber Concepts and Definitions—This section explains Internet subscriber concepts in detail. You may want to read this section prior to completing the setup procedures.

Task List: Setting Up Internet Subscribers

Use this task list to set up Cisco Unity for using Internet subscribers. The cross-references take you to detailed procedures for the setup.

1. Customize the primary location profile settings. See the "Customizing the Primary Location" section.

2. Set the subscriber addressing, directory handler, and automated attendant search options. See the "Setting the Addressing, Directory Handler, and Automated Attendant Search Scopes" section.

3. Create Internet subscriber accounts on the local Cisco Unity server for each remote message recipient, as needed. See the "Creating Internet Subscriber Accounts" section.

Procedures for Setting Up Internet Subscribers

This section contains all of the procedures necessary to set up Cisco Unity for use with Internet subscribers.

Customizing the Primary Location

Even if you have only one Cisco Unity server, it is good practice to customize 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 4-2 for detailed information about choosing a Dial ID.

To Customize the Primary Location


Step 1 In the Cisco Unity Administrator, go to the Network > Primary Location > Profile page.

Step 2 Enter a meaningful name for the location.

Step 3 Enter a Dial ID. The Dial ID identifies this location to Cisco Unity.

Step 4 Record a voice name for the location.

Step 5 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 Click the Save icon.


Setting the Addressing, Directory Handler, and Automated Attendant Search Scopes

In installations with multiple Cisco Unity servers networked together such that they monitor the same address book, set the addressing search options on all Cisco Unity servers.

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

In Cisco Unity 4.0(3) and later, the automated attendant search scope must be set to search the dialing domain in order for identified subscriber messaging 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 4-4.

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.

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/dom/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, outside 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.

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.


Creating Internet Subscriber Accounts

You can create Internet subscriber accounts by using the Cisco Unity Bulk Import wizard or the Cisco Unity Administrator. See the following sections:

Before Creating Internet Subscriber Accounts

Using the Cisco Unity Bulk Import Wizard to Create Multiple Internet Subscriber Accounts

Using the Cisco Unity Administrator to Create Internet Subscriber Accounts

After Creating Internet Subscriber Accounts

Before Creating Internet Subscriber Accounts

This section lists—in order—the issues that you must consider before creating Internet 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 Internet 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 Internet 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 Internet 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 Internet subscribers because they cannot log on to Cisco Unity or use the Cisco Personal Communications Assistant (PCA), administrators can enter call transfer numbers for Internet subscribers. For security purposes, you should modify the restriction table used for transfers in the COS to which Internet 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 Internet subscriber account is based. For details, refer to the "Public Distribution List Settings" chapter in the Cisco Unity System Administration Guide.

5. Subscriber Templates

In the Cisco Unity Administrator, you can specify settings for a group of Internet 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 Internet subscriber accounts as they 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.

6. Domino Address Books

If you use the Cisco Unity Administrator to create a Internet subscriber account, confirm that the address book(s) listed on the System > Configuration > Subscriber Address Books page in the Cisco Unity Administrator contain the user data that you want to import when you create the Internet subscriber account. If necessary, you can add another address book to the System > Configuration > Subscriber Address Books page. For details, refer to the "System Settings" chapter in the Cisco Unity System Administration Guide.


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/dom/index.htm.


Using the Cisco Unity Bulk Import Wizard to Create Multiple Internet Subscriber Accounts

The Cisco Unity Bulk Import wizard allows you to create multiple Internet subscriber accounts at once by importing user data contained in 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 Internet subscribers with existing Domino Person Documents.

In Cisco Unity 4.0(3) and later, the Cisco Unity Bulk Import wizard also allows you to create multiple Internet subscriber accounts at once by importing user data directly from the Domino directory. To do so, see the procedure "To Create Internet Subscriber Accounts by Using the Cisco Unity Bulk Import Wizard." Otherwise, use the following procedure to prepare your CSV file. Refer to the Cisco Unity Bulk Import wizard online Help to find additional information about using the wizard to create Internet subscriber accounts, or about the required and optional column headers for your CSV file.

To Prepare a CSV File for Creating Internet 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 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 a 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, and then by the remote address and the short name:

Abade,Alex,SMTP:aabade@cisco.com,aabade
Bader,Kelly,SMTP:kbader@cisco.com,kbader
Campbell,Terry,SMTP:tcampbell@cisco.com,tcampbell
Cho,Li,SMTP:lcho@cisco.com,lcho

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,REMOTE_ADDRESS,SHORT_NAME

Step 6 If desired, add optional column headers to the first row, and the corresponding data that you want to import in the subsequent rows below. As you do so, confirm that:

Column headers and data are separated by commas. Note that each row does not have to contain data for each optional column header.

Any data that includes a space, quotes, or commas is contained within quotes.

Step 7 If your CSV file contains columns of data that you do not want to import, delete the columns. Alternatively, you can title one column NOTES. The Cisco Unity Bulk Import wizard ignores data beneath any NOTES column header, but the wizard does not support more than one NOTES column in a CSV file.

Step 8 Confirm that each row contains the applicable data corresponding to each column header.

Step 9 Save the file as a CSV file.

Step 10 Continue with the following procedure "To Create Internet 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 Internet 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 Internet.

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 Import Errors" section for details.

Step 5 Once the Internet 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 Import Errors" section.

If you had no import errors, or if all errors have now been corrected, see the "After Creating Internet Subscriber Accounts" section.


Correcting Import Errors

The error log file contains data that the Cisco Unity Bulk Import wizard could not import. The Cisco Unity Bulk Import wizard reports the first error it detects in any user mailbox or row in a CSV file. Once you correct that error, the wizard may detect additional errors in the same mailbox or row when the data is imported again. Thus, you may need to repeat the correction process—running the Cisco Unity Bulk Import wizard and correcting an error—several times to find and correct all errors.

The output log file contains all the records that were not imported. You can save it as a CSV file, and use it when you run the Cisco Unity Bulk Import wizard again. Note that each time you run the Cisco Unity Bulk Import wizard, the error and output log files are overwritten (unless you specify new names for the files).

To correct import errors, use one of the following procedures: "To Correct Errors That Occurred When Importing Data from a CSV File," or "To Correct Errors That Occurred When Importing Data from the Message Store."

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 Internet subscriber accounts are created without error, and then proceed to the "After Creating Internet Subscriber Accounts" section.


To Correct Errors That Occurred When Importing Data from the Message Store


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 Double-click a mailbox that contains an error to see the properties.

Step 4 Enter corrections in the applicable boxes in the mailbox.

Step 5 Click OK.

Step 6 Repeat Step 3 through Step 5 for each mailbox listed in the error log file.

Step 7 Run the Cisco Unity Bulk Import wizard again.

Step 8 Repeat this procedure until all Internet subscriber accounts are created without error, and then proceed to the "After Creating Internet Subscriber Accounts" section.


Using the Cisco Unity Administrator to Create Internet Subscriber Accounts

By using the Cisco Unity Administrator, you can create an Internet subscriber account by importing existing user data from Domino. Use the following procedure to create an Internet subscriber account.

To Create an Internet Subscriber Account by Importing Existing User Data


Step 1 In the Cisco Unity Administrator, go to the Subscribers > Subscribers > Profile page.

Step 2 Click the Add icon.

Step 3 Select Internet.

Step 4 In the Address Book list, confirm that the address book listed is the one that contains the user data that you want to import.

If the address book that you want to use is not listed, go to the System > Configuration > Subscriber Address Books page and add a different address book.

Step 5 In the Find Domino Person By list, indicate whether to search by short name, first name, or last name.

Step 6 Enter the applicable short name or name. You also can enter * to display a list of all users, or enter one or more characters followed by * to narrow your search.

Step 7 Click Find.

Step 8 On the list of matches, click the name of the user to import.

Step 9 Enter the applicable information on the Add Subscriber page.

Step 10 Click Add.

Step 11 On the subscriber record, customize settings as applicable, and then click the Save icon.


After Creating Internet Subscriber Accounts

After creating Internet subscriber accounts, consider the following:

It takes a few minutes for a newly-created Internet subscriber to be available to receive messages.

You can make changes to the settings for individual Internet subscriber 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/dom/index.htm.

When you want to modify settings 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 Internet subscriber account. See the "Deleting Internet Subscribers" section for details.

Internet Subscriber Concepts and Definitions

Internet subscribers are Cisco Unity subscribers who do not have mailboxes on the Domino network. Instead, messages for Internet subscribers are sent to an e-mail address that you specify when you create the Internet subscriber account. The recipient receives voice messages as e-mails with attached WAV files.

In Domino, Internet subscribers are represented as person documents without a mailbox. You create and manage Internet subscriber accounts in much the same way that you do regular subscriber accounts. For example, a subscriber template is used when the Internet subscriber accounts are created, and you can adjust the call transfer settings for Internet subscriber accounts as needed.

Extensions are optional for Internet subscribers whereas they are mandatory for regular subscribers. If an Internet subscriber has not been assigned an extension, subscribers can address messages to that Internet subscriber only in spelled-name mode.

If you have specified extensions for the Internet subscribers, both unidentified callers and subscribers can dial the extension for the Internet subscriber, listen to the greeting of the Internet subscriber, and leave a message. If Cisco Unity is integrated with a networked phone system, outside callers can be transferred to the extension of the Internet subscriber.

Other than receiving messages (and possibly calls), Internet subscribers do not have access to other Cisco Unity features, and some sections of the Cisco Unity Administrator are disabled for Internet subscribers. Internet 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.

Subscriber Experience with Internet Subscribers

Provided that Internet subscribers have extensions, are listed in the phone directory, and have had voice names and greetings recorded for them:

Subscribers can address messages to Internet subscribers by using the phone or the Lotus Notes with IBM Lotus Domino Unified Communications Services (DUCS) for Cisco Unity.

When using the phone, subscribers can address messages to Internet subscribers by spelled-name mode (if enabled on the system) or by extension.

Subscribers get voice name confirmation when addressing a message to an Internet subscriber.

Internet subscribers can be added to distribution lists.

Both unidentified callers and subscribers can place a call to an Internet subscriber and leave a message. If Cisco Unity is integrated with a networked phone system, calls from both unidentified callers and subscribers can be transferred to the extension of the Internet subscriber. (With a networked phone system, subscribers dial an extension without having to dial a trunk access code or prefix when calling someone who is at another location on the phone network.)

Extensions are optional for Internet subscribers whereas they are mandatory for regular subscribers. If an Internet subscriber has not been assigned an extension:

The Internet subscriber cannot be listed in the phone directory.

Unidentified callers will be unable to leave messages for the Internet subscriber.

When addressing messages to the Internet subscriber, subscribers are limited to spelled-name mode, provided that the Internet subscriber has a recorded voice name. If neither an extension nor a voice name has been set, messages cannot be addressed to the Internet subscriber.

Deleting Internet Subscribers

Each Internet subscriber is associated with a Domino person document without a mailbox. After deleting the Internet subscribers in the Cisco Unity Administrator, you will need to delete the associated person document in the Domino Administrator.