Cisco Unity Connection User Moves, Adds, and Changes Guide, Release 1.x
Creating Multiple User Accounts from Cisco CallManager Users

Table Of Contents

Creating Multiple User Accounts from Cisco Unified CallManager Users

Importing Cisco Unified CallManager Users by Using Cisco Unity Connection Administration (Cisco Unified CallManager Version 5.x Only)

Using the Integrated Mailbox Configuration Tool (Cisco Unified CallManager Version 4.1(x) Only)

Creating Individual User Accounts by Using Integrated Mailbox Configuration

Setting Up the Cisco Unity Connection Logon Account and Environment

Creating a Cisco Unity Connection Voice Mailbox

Troubleshooting

Diagnostics

Error Messages


Creating Multiple User Accounts from Cisco Unified CallManager Users


An alternate way to add Connection voice mail users to the system is to create them from Cisco Unified CallManager users.

See the applicable section in this chapter, depending on the version of Cisco Unified CallManager:

Importing Cisco Unified CallManager Users by Using Cisco Unity Connection Administration (Cisco Unified CallManager Version 5.x Only)

Using the Integrated Mailbox Configuration Tool (Cisco Unified CallManager Version 4.1(x) Only)

Importing Cisco Unified CallManager Users by Using Cisco Unity Connection Administration (Cisco Unified CallManager Version 5.x Only)

If the Connection server is integrated with a Cisco Unified CallManager 5.x phone system, you can use the Tools > Import CallManager Users page to automatically create multiple user with voice mail accounts from Cisco Unified CallManager users.

When user accounts are created this way, Connection takes the user Alias, Extension, First Name, and Last Name from Cisco Unified CallManager, and fills in the remaining information from the user template that you specify. It is important to note that the fields that are taken from Cisco Unified CallManager cannot be modified by using Connection Administration. Instead, the information must be changed in Cisco Unified CallManager, and then the Synchronize CallManager Users page of Connection Administration can be used to update the information in Connection.

Because Connection requires an AXL server to access to the Cisco Unified CallManager database, an AXL server must first be configured for the Cisco Unified CallManager server from which you are importing users. AXL servers are configured on the Edit > Cisco Unified CallManager AXL Servers page for the Cisco Unified CallManager 5.x phone system integration. Note that the Cisco Unified CallManager AXL service, which is not enabled by default, must be enabled so that it appears as an option on the Cisco Unified CallManager AXL Servers page.

The Synchronize CallManager Users page allows you to manually refresh information from Cisco Unified CallManager for voice mail users who were created by using the Import CallManager Users page.

Alternatively, you can use the Task Management pages to create a task to synchronize the Cisco Unified CallManager user data automatically on a regular schedule.

Using the Integrated Mailbox Configuration Tool (Cisco Unified CallManager Version 4.1(x) Only)

See the following sections:

Creating Individual User Accounts by Using Integrated Mailbox Configuration

Setting Up the Cisco Unity Connection Logon Account and Environment

Creating a Cisco Unity Connection Voice Mailbox

Troubleshooting

Creating Individual User Accounts by Using Integrated Mailbox Configuration

When Cisco Unity Connection is integrated with Cisco Unified CallManager version 4.1(x), Cisco Unified CallManager administrators can create regular individual Connection user accounts (referred to as voice mailboxes in Cisco Unified CallManager) from either the Directory Number Configuration page or the User Configuration page of the Cisco Unified CallManager Administration console. Connection user accounts are then created directly in SQL by using browser-encrypted secure transmission of credentials across the network.

When user accounts are created by using the Integrated Mailbox Configuration application, the accounts contain the minimum setup data that is provided by the Connection user template that is chosen. If any customization of the user account is necessary beyond what this template provides, you complete the customization by using Cisco Unity Connection Administration. Note that after the accounts are created, there is no automatic synchronization of user data between Connection and Cisco Unified CallManager. Any changes to user accounts that exist in both systems, and that must be kept synchronized, will need to be made manually in both systems.

Setting Up the Cisco Unity Connection Logon Account and Environment

Do the following procedure to set up the voice mailbox creation environment on Connection and on Cisco Unified CallManager.

To Set Up the Cisco Unity Connection Logon Account and Environment


Step 1 Complete the setup and integration of Connection and Cisco Unified CallManager version 4.1(x) according to instructions in the Cisco Unity Connection Installation Guide, the Cisco Unity Connection integration guide, and other applicable Cisco documentation.

Step 2 Confirm that the Connection voice mail ports have been configured in Cisco Unified CallManager. In Cisco Unified CallManager Administration, click Feature > Voice Mail > Cisco Voice Mail Port. Enter search criteria and click Find. The Connection voice mail ports should list the Cisco Unified CallManager to which they are registered and the IP address of the Connection server.

Step 3 Confirm that the Connection user templates for creating a user with a voice mailbox have been set up and are ready for use.

Step 4 Confirm that Cisco Unified CallManager and Connection have been physically deployed on the same side of the firewall.

Step 5 Confirm that Cisco Unity Connection Administration can be accessed by IP address. From the Cisco Unified CallManager server, open a web browser and browse to https://<Connection IP Address>/cuadmin.

Step 6 In the Cisco Unified CallManager Administration application, browse to Cisco Unified CallManager Serviceability > Tools > Control Center, click the Cisco Unified CallManager server name, and confirm that the RIS data collector is activated and running.

Step 7 On the Connection server, browse to the Cisco Unity Connection\Java\jakarta-tomcat-5.0\webapps\concerto\ccmpages\4.x directory.

Step 8 Copy the Voicemailbox.asp file from the Connection server to the C:\CiscoWebs\Admin directory on the Cisco Unified CallManager server.

Step 9 In Cisco Unity Connection Administration, create a new user with the User Administrator role. When you use the Integrated Mailbox Configuration application from the Cisco Unified CallManager Administration interface, you will enter the logon credentials for this user in order to authenticate the request to Connection. See the "Adding an Individual User Account by Using Cisco Unity Connection Administration" chapter for instructions on creating user accounts.


Note After creating the user account, we recommend that you set a unique password for this user.



Creating a Cisco Unity Connection Voice Mailbox

Note that Integrated Mailbox Configuration prompts you to authenticate with a user name and password once per session. If authentication succeeds, you will not be prompted to reauthenticate as long as you remain logged in to Cisco Unified CallManager Administration.

To Create a Cisco Unity Connection Voice Mailbox by Using Cisco Unity Cisco Unified CallManager Integrated Mailbox Configuration


Step 1 Log on to the Cisco Unified CallManager Administration application.

Step 2 Do one of the following sets of sub-steps:

To create a voice mailbox from the User Configuration page:

a. Click User > Global Directory. The User Information page opens.

b. Search for a user. To see a list of all users, leave the User Search dialog box empty, and click Search.

c. From the list of users, click the name of the applicable user. The User Configuration page opens.

d. Click the Create Voice Mailbox link that appears next to the Primary Extension.


Note The Create Voice Mailbox link will not appear unless the Voice Mail Profile for the user is associated with the Primary Extension Directory Number.


e. Continue with Step 3.

To create a voice mailbox from the Directory Number Configuration page:

a. Click Device > Phone. The Find and List Phones page opens.

b. Search for a phone device. To see a list of all phone devices, leave the search dialog box empty, and click Find.

c. From the list of devices, click the name of the applicable device. The Phone Configuration page opens.

d. From the list of Directory Numbers on the left side of the page, click the applicable Base Phone. The Directory Number Configuration page opens.

e. Click the Create Voice Mailbox link that appears in the top right corner of the page.


Note The Create Voice Mailbox link will not appear unless you have previously configured a Voice Mail Profile setting to either include a pilot number or to specify None as the pilot number. If the Voice Mail Profile is set to No Voice Mail, the Create Voice Mailbox link will not appear.


f. Continue with Step 3.

Step 3 If the Enter Network Password screen appears, enter your Cisco Unity Cisco Unified CallManager Integrated Mailbox Configuration administrator name and password.

Step 4 Confirm that the Extension, Alias, First Name, Last Name, and Display Name for the voice mailbox are as you want them to appear in Connection. Make changes if necessary.

If no Display Name is entered, one will be created based on the Connection user template settings.

Step 5 From the drop-down menu, select the Voice Mailbox Template to be applied to the voice mailbox. Integrated Mailbox Configuration allows you to select from a list of templates for creating a user with a voice mailbox; you cannot select a template for creating a user without a voice mailbox.

Step 6 Confirm the List in Directory status. By default, this check box is checked, which overrides the setting on the user template.

Step 7 Click Insert. The voice mailbox is added to Connection.

Step 8 Confirm that the voice mailbox data is correct. If you made a mistake, click Delete and repeat this procedure, beginning with Step 2.

Step 9 Click Close.


Troubleshooting

Diagnostics

If you are experiencing a problem with the Integrated Mailbox Configuration application, TAC may instruct you to enable debug diagnostics to assist in determining the source of the problem.

Diagnostic logs are written to the Cisco Unity Connection\Logs\cimc.log file. Note that the diagnostic files do not record the transmission of credentials across the network.

To Enable Debug Diagnostics and Collect Logs


Step 1 On the Connection server, browse to the Cisco Unity Connection\Java\jakarta-tomcat-5.0\
webapps\concerto\WEB-INF\classes
directory.

Step 2 Open the log4j.properties file using a text editor, such as Wordpad.

Step 3 Locate the line that contains the text log4j.logger.com.cisco=ERROR.

Step 4 Replace ERROR with DEBUG.

Step 5 Save and close the file.

Step 6 From the Services window, stop and restart the Apache Tomcat service:

a. On the Windows Start menu, click All Programs > Administrative Tools > Services.

b. In the right pane, right-click Apache Tomcat.

c. Click Restart.

Step 7 Collect diagnostic logs by browsing to the Cisco Unity Connection\Logs directory. Diagnostics are written to the cimc.log file.


Error Messages

The following errors may be displayed in the Integrated Mailbox Configuration application.

Error Message    The page cannot be displayed.

Explanation    There are several possible reasons for a page not being displayed:

The Tomcat service is not running on the Connection server.

The RIS Data Collector service is not running on the Cisco Unified CallManager server.

Network access is not available.

Recommended Action    Determine the state of network access and the status of applicable services (for example, status may indicate a shut down, a critical component that has been programatically stopped, or severe network latency). Restart the services and/or correct the cause of the network access problems.

Error Message    Invalid parameter Alias

Recommended Action    An alias may contain only the following alphanumeric characters and symbols: 0-9, A-Z, a-z, ~`!@$%^&-_{}.'. The alias field is required and may not be left blank.

Error Message    Invalid parameter First Name [Last Name, Display Name]

Recommended Action    A first name, last name, or display name may contain only the following alphanumeric characters and symbols: 0-9, A-Z, a-z, ~`!@#$%^&-_{},.' space.

Error Message    Object not found @TemplateObjectId

Explanation    A problem was found with the voice mailbox template that was chosen.

Recommended Action    Confirm that the template exists in Cisco Unity Connection Administration—expand Templates, then click User Templates. If the template does not appear in the search results table, set the applicable parameters in the search fields at the top of the page, and click Find. If the template no longer exists, reset or close and reopen the Integrated Mailbox Configuration window, and select a different template.

Error Message    Invalid parameter Dtmf Access Id

Recommended Action    An extension may contain only the following alphanumeric characters and symbols: 0-9, A-Z, a-z, -_.~!@$%&*()=+:,;'?\.

Error Message    Extension is already in use.

Explanation    A voice mailbox with this extension already exists in Connection.

Recommended Action    Choose another extension, or remove the user from Connection and create the voice mailbox again.

Error Message    Duplicate Alias. An Alias must be unique within a location.

Explanation    A voice mailbox with this alias already exists in Connection.

Recommended Action    Change the alias or remove the user from Connection and create the voice mailbox again.

Error Message    License violation: Subscribers

Explanation    No licenses are available for creating additional users.

Recommended Action    Review your license counts in Cisco Unity Connection Administration. (Expand System Settings > Licenses. On the Search Licenses page, from the Related Links drop-down list, choose View License Usage and click Go.)

Error Message    There are not enough Unity Inbox [IMAP, Advanced User] licenses to 
proceed with this operation. Please see the licensing page for more information.

Recommended Action    Review your license counts in Cisco Unity Connection Administration. (Expand System Settings > Licenses. On the Search Licenses page, from the Related Links drop-down list, choose View License Usage and click Go.) Confirm that the voice mailbox template you are using is associated with a class of service that has the features you want enabled.

Error Message    The voice mailbox was not created.

Recommended Action    To troubleshoot the failure, turn on diagnostics and check the cimc.log file for errors. See the "To Enable Debug Diagnostics and Collect Logs" procedure.

Error Message    Object not found @ObjectID

Explanation    The voice mailbox associated with the ID that is being deleted could not be found.

Recommended Action    Confirm that you have a connection to Microsoft SQL Server and that the voice mailbox exists.

Error Message    Could not obtain Cisco Unity datastore connection.

Recommended Action    Confirm that Microsoft SQL Server is running on the Connection server.

Error Message    Error retrieving Cisco Unity server directory information.

Recommended Action    Confirm that Microsoft SQL Server is running on the Connection server.

Error Message    Could not locate Unity server; make sure the Unity Server is configured 
in Cisco Unified CallManager and that the correct IP address for the Unity server 
appears in the results on the Cisco Voice Mail Port Find/List page.

Recommended Action    Confirm that:

Cisco Unified CallManager is configured correctly for use with the Cisco Unity Cisco Unified CallManager Integrated Mailbox Configuration application.

The Cisco Unified CallManager service is running.

The Cisco RIS Data Collector service is running.

The Voice Mail Profile in Cisco Unified CallManager is configured correctly.