System Administration Guide for Cisco Unity Connection Release 10.x
Administrative Tools in Cisco Unity Connection 10.x
Downloads: This chapterpdf (PDF - 240.0KB) The complete bookPDF (PDF - 10.3MB) | Feedback

Table of Contents

Administrative Tools in Cisco Unity Connection 10.x

Application Plug-ins in Unity Connection 10.x

Cisco Unified Backup and Restore Application Suite (COBRAS) in Unity Connection 10.x

Cisco Unity Connection Administration 10.x

Unity Connection 10.x Bulk Administration Tool

Unity Connection 10.x Custom Keypad Mapping Tool

Unity Connection 10.x Grammar Statistics Tool

Unity Connection 10.x Import and Synch Users Tools

Unity Connection 10.x Migrate Messages Utility

Unity Connection 10.x Migrate Users Utility

Cisco Unity Connection Serviceability 10.x

Unity Connection 10.x Show Dependency Results

Unity Connection 10.x Task Management Tool

Disaster Recovery System in Unity Connection 10.x

Cisco Voice Technology Group Subscription Tool in Unity Connection 10.x

Cisco Unified Serviceability in Unity Connection 10.x

Remote Database Administration Tools in Unity Connection 10.x

Enabling Database Access for Remote Administration Tools

Cisco Utilities Database Link for Informix (CUDLI) in Unity Connection 10.x

Unity Connection User Data Dump (CUDD) in Unity Connection 10.x

Wallet Card Wizard in Unity Connection 10.x

Administrative Tools in Cisco Unity Connection 10.x

This chapter provides brief descriptions of and procedures for accessing a selection of tools and utilities for administering Cisco Unity Connection.

See the following sections:

Application Plug-ins in Unity Connection 10.x

Application plug-ins extend the functionality of Cisco Unity Connection. For example, the Real-Time Monitoring Tool (RTMT) plug-in allows an administrator to monitor system performance.

For Unity Connection configurations, see the “Installing Plugins in Cisco Unity Connection 10.x” chapter for detailed information.

Cisco Unified Backup and Restore Application Suite (COBRAS) in Unity Connection 10.x

Cisco Unified Backup and Restore Application Suite (COBRAS) is the application you use to migrate data and messages from Cisco Unity 4.0(5) or later or from Cisco Unity Connection 1.2 to Unity Connection 10.x. Download the latest version, and view training videos and Help at http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html .

Alternatively, you can use the Unity Connection Migrate Messages and Migrate Users utilities to migrate messages and user data when you are migrating from Cisco Unity 4.0(4) and earlier and you cannot upgrade to Cisco Unity 4.0(5) or later for some reason. COBRAS migrates significantly more data than the Migrate Users utility, and it does not require that you configure a secure shell (SSH) server application. For more information, see the “Unity Connection 10.x Migrate Messages Utility” section and the “Unity Connection 10.x Migrate Users Utility” section.


Note Migration in a Tenant Partitioned environment using COBRAS tool allows the administrator to export the data from a non-partitioned Unity Connection system or a Tenant-Partitioned Unity Connection system. For more information on each scenario and on migration process using COBRAS tools, refer to http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html link.


For a task list that enumerates the steps for migrating from Cisco Unity or from Unity Connection 7.x to Unity Connection 10.x either by using COBRAS or by using the Migrate Messages and Migrate Users utilities, see the applicable chapter of the Upgrade Guide for Cisco Unity Connection Release 10.x , available at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/upgrade/guide/10xcucrugx.html .

Cisco Unity Connection Administration 10.x

Cisco Unity Connection Administration is a web application that you use to do most administrative tasks, including specifying settings for users and implementing a call management plan. Many of the tools listed in this section are available from Unity Connection Administration.

For information on accessing and using Cisco Unity Connection Administration, see the “Accessing and Using Cisco Unity Connection Administration 10.x” chapter.

Unity Connection 10.x Bulk Administration Tool

The Unity Connection Bulk Administration Tool (BAT) allows you to create, update, and delete multiple user accounts, administrator-defined contacts, system distribution lists, or system distribution list members at the same time by importing information contained in a comma separated value (CSV) file. In addition, it allows you to export information about users, administrator-defined contacts, system distribution lists, system distribution list members, or LDAP users from Cisco Unity Connection to a CSV file.

For small numbers of users—up to a few hundred—it may be faster and easier to use the Import Users tool to create Unity Connection users from users in an LDAP directory. See the “Unity Connection 10.x Import and Synch Users Tools” section.

To Access the Cisco Unity Connection Bulk Administration Tool


Step 1 In Cisco Unity Connection Administration, expand Tools .

Step 2 Select Bulk Administration Tool .


 

For information on using the BAT tool on Unity Connection or Cisco Unified CMBE, see the “ Using the Cisco Unity Connection 10.x Bulk Administration Tool ” chapter of the User Moves, Adds, and Changes Guide for Cisco Unity Connection Release 10.x , at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/user_mac/guide/10xcucmacx.html .

Unity Connection 10.x Custom Keypad Mapping Tool

The Custom Keypad Mapping tool allows you to edit the key mappings that are associated with the Custom Keypad Mapping conversation, which can be assigned to users or user templates on the Phone Menu page in Cisco Unity Connection Administration. You are allowed to assign any one-, two-, or three-key sequence to any defined option for the main menu, the message playback menu (the message

header, body, and footer can be mapped separately), the after message menu, and the settings menu. You can customize which options are voiced in each menu and the order in which they are offered. The Custom Keypad Mapping tool is accessed in the Tools section of Unity Connection Administration.

To Access the Custom Keypad Mapping Tool


Step 1 In Cisco Unity Connection Administration, expand Tools .

Step 2 Select Custom Keypad Mapping.


 

For information on using the tool, see the “Custom Keypad Mapping Tool in Cisco Unity Connection 10.x” chapter.

Unity Connection 10.x Grammar Statistics Tool

The Grammar Statistics tool shows information about all of the dynamic name grammars that are used by the Cisco Unity Connection voice-recognition conversation to match caller utterances to the names of objects on the system (for example, usernames and alternate names, distribution list names, and so on). When administrators add or change names on the Unity Connection system, the names are not recognized by the voice-recognition conversation until they are compiled in the grammars.

For each name grammar, the tool displays information such as the finish time of the last grammar recompilation, the total number of unique items in the grammar, whether there are updates pending to the grammar, and whether the grammar is currently in the process of being recompiled.

By default, Unity Connection recompiles grammars when administrators add named objects or change object names on the system (unless a bulk operation is in progress, in which case Unity Connection waits ten minutes for the operation to complete before recompiling the grammars), or when there are more than five changes requested in the space of a minute. If the grammars have grown to the point where the name grammar recompilation process is affecting the performance of your Unity Connection server during busy periods, you can modify the default Voice Recognition Update Schedule (under System Settings > Schedules in Cisco Unity Connection Administration) to limit the times and days when the Unity Connection voice-recognition transport utility can automatically rebuild the voice-recognition name grammars. By default, all days and times are active for this schedule; if you modify the schedule but want to override the schedule while it is inactive and force an immediate recompilation of all grammars, or if you want to force recompilation during the ten minute wait period after a bulk operation has been initiated, you can select the Rebuild Grammars button on the Grammar Statistics tool.

Unity Connection 10.x Import and Synch Users Tools

When the Unity Connection server is integrated with a Cisco Unified Communications Manager phone system, you can use the Import Users tool to automatically create multiple users with voicemail accounts from existing Cisco Unified Communications Manager users.

You can also use the Import Users tool to create small numbers of users—up to a few hundred—from users in an LDAP directory. (This is not a question of technical limitations; you can create many thousands of users by using the Import Users tool, but the process is less efficient than other methods.)

In Unity Connection configurations, the Synchronize Users tool allows you to manually refresh the information you imported from Cisco Unified Communications Manager when you created voicemail users.

In Cisco Business Edition configurations, synchronization happens automatically. There should be no need to manually synchronize users.

To Access the Import and Synch Users Tools


Step 1 In Cisco Unity Connection Administration, expand Users .

Step 2 Select Import Users or Synch Users , as applicable.


 

For information on using both tools, see the “ Creating Multiple Cisco Unity Connection 10.x User Accounts from Cisco Unified Communications Manager Users ” chapter of the User Moves, Adds, and Changes Guide for Cisco Unity Connection Release 10.x , at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/user_mac/guide/10xcucmacx.html .

Unity Connection 10.x Migrate Messages Utility

To migrate messages and data from Cisco Unity 4.0(5) or later to Unity Connection 10.x, we recommend that you use the Cisco Unified Backup and Restore Application Suite (COBRAS) tool instead of the Migrate Messages and Migrate Users utilities. COBRAS migrates significantly more data than the Migrate Users utility, and it does not require that you configure a secure shell (SSH) server application.

For a task list that enumerates the steps for migrating from Cisco Unity to Unity Connection 10.x either by using COBRAS or by using the Migrate Messages and Migrate Users utilities, see the “ Migrating from Cisco Unity 4.x or Later to Cisco Unity Connection 10.x ” chapter of the Upgrade Guide for Cisco Unity Connection Release 10.x , at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/upgrade/guide/10xcucrugx.html .

The Unity Connection Migrate Messages utility allows you to migrate messages from Cisco Unity to Unity Connection 10.x. You can only migrate messages if you have first migrated user data by using the Migrate Users utility.

To Access the Migrate Messages Utility (Cisco Unity Connection Configurations Only)


Step 1 In Cisco Unity Connection Administration, expand Tools .

Step 2 Expand Migration Utilities , then select Migrate Users .


 

Unity Connection 10.x Migrate Users Utility

To migrate messages and data from Cisco Unity 4.0(5) or later to Unity Connection 10.x, we recommend that you use the Cisco Unified Backup and Restore Application Suite (COBRAS) instead of the Migrate Messages and Migrate Users utilities. COBRAS migrates significantly more data than the Migrate Users utility, and it does not require that you configure a secure shell (SSH) server application.

For a task list that enumerates the steps for migrating from Cisco Unity to Unity Connection 10.x either by using COBRAS or by using the Migrate Messages and Migrate Users utilities, see the “ Migrating from Cisco Unity 4.x or Later to Cisco Unity Connection 10.x ” chapter of the Upgrade Guide for Cisco Unity Connection Release 10.x , at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/upgrade/guide/10xcucrugx.html .

To Access the Migrate Users Utility (Cisco Unity Connection Configurations Only)


Step 1 In Cisco Unity Connection Administration, expand Tools .

Step 2 Expand Migration Utilities , then select Migrate Users .


 

Cisco Unity Connection Serviceability 10.x

Cisco Unity Connection Serviceability, a web-based troubleshooting tool for Unity Connection, provides the following functionality:

  • Displaying Unity Connection alarm definitions, which you can use for troubleshooting.
  • Enabling Unity Connection traces. You can collect and view trace information in the Real-Time Monitoring Tool (RTMT) or in the command line interface (CLI).
  • Configuring the logs to which Unity Connection trace information is saved.
  • Viewing and changing the server status of the Unity Connection servers when a Unity Connection cluster is configured.
  • Viewing the status of the Unity Connection feature services.
  • Activating, deactivating, starting, and stopping the Unity Connection services.
  • Generating reports that can be viewed in different file formats.

Depending on the service and component involved, you may perform serviceability-related tasks in both Cisco Unity Connection Serviceability and Cisco Unified Serviceability. For example, you may need to start and stop services, view alarms, and configure traces in both applications to troubleshoot a problem.

For more information, see the Administration Guide for Cisco Unity Connection Serviceability Release 10.x , at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/serv_administration/guide/10xcucservagx.html .

Unity Connection 10.x Show Dependency Results

The Show Dependency Results page provides a way to view the results of the most recent dependency search.

When database objects such as user accounts are referenced by other objects in Unity Connection (for example, if a user is set to be a recipient of messages left in an interview handler, or if a call handler is set to transfer incoming calls to a user phone), you cannot delete the referenced objects until you have changed settings on the dependent objects.

To determine the dependencies of an object that you want to delete, select the Show Dependencies option on the search page for the object type. The option initiates a search for database objects that are dependent on the object you want to delete. From the dependency search results, follow links to the dependent objects and reassign the dependencies. When all dependencies have been reassigned, you can delete the object.

Some dependency searches can take several minutes, depending on the object being searched. While a search is in progress, if you browse to another page, or your browser session times out, navigate to Tools > Show Dependency Results to view the dependency search results.

Unity Connection 10.x Task Management Tool

The Task Management pages list a variety of system maintenance and troubleshooting tasks that Unity Connection automatically runs on a regular schedule. Tasks can be run at the same time as backups and anti-virus scans.

The default settings and schedules for each task are optimized for functionality and performance. We recommend that you not change the default settings and schedules.


Caution Some tasks are critical to Unity Connection functionality. Disabling or changing the frequency of critical tasks may adversely affect performance or cause Unity Connection to stop functioning.

To Access the Task Management Tool


Step 1 In Cisco Unity Connection Administration, expand Tools .

Step 2 Select Task Management .


 

Disaster Recovery System in Unity Connection 10.x

Disaster Recovery System lets you back up and, if necessary, restore data and voice messages on a Cisco Unity Connection or Cisco Business Edition system. For more information, see the Disaster Recovery System Administration Guide for Cisco Unity Connection Release 10.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/10x/drs_administration/guide/10xcucdrsag.html .

Cisco Voice Technology Group Subscription Tool in Unity Connection 10.x

You can use the Cisco Voice Technology Group Subscription tool to be notified by email of any Cisco Unity Connection software updates. To subscribe, go to the Cisco Voice Technology Group Subscription Tool page at http://www.cisco.com/cgi-bin/Software/Newsbuilder/Builder/VOICE.cgi .

Cisco Unified Serviceability in Unity Connection 10.x

Cisco Unified Serviceability, a web-based troubleshooting tool for Unity Connection, provides the following functionality:

  • Saving alarms and events for troubleshooting and providing alarm message definitions.
  • Saving trace information to various log files for troubleshooting.
  • Providing feature services that you can turn on, turn off, and view through the Service Activation window.
  • Providing an interface for starting and stopping feature and network services.
  • Generating and archiving daily reports; for example, alert summary or server statistic reports.
  • Monitoring the number of threads and processes in the system; uses cache to enhance the performance.

Depending on the service and component involved, you may perform serviceability-related tasks in both Cisco Unified Serviceability and Cisco Unity Connection Serviceability. For example, you may need to start and stop services, view alarms, and configure traces in both applications to troubleshoot a problem.

For more information, see the Cisco Unified Serviceability Administration Guide at http://www.cisco.com/en/US/products/ps6509/prod_maintenance_guides_list.html .

Remote Database Administration Tools in Unity Connection 10.x

A database proxy can be enabled to allow the use of some Windows-based remote database administration tools that are available on the Cisco Unity Tools website ( http://ciscounitytools.com ), where updates to utilities are frequently posted between Cisco Unity Connection releases.

See the following sections for detailed information:


Note You can sign up to be notified when the utilities posted on the Cisco Unity Tools website are updated. Go to http://ciscounitytools.com and select Sign Up Here.


Enabling Database Access for Remote Administration Tools

In order to use the remote tools, you must first enable remote database access. Because opening up database access for remote administration tools can introduce a security risk to your system, several layers of security are involved with enabling access:

  • The username and password of a user with the Remote Administrator role is required to run remote tools.
  • The Unity Connection Database Proxy service is disabled by default.

To enable remote database access, do the following three procedures in the order presented:

To Assign the Remote Administrator Role to One or More Users


Step 1 In Cisco Unity Connection Administration, select Users.

Step 2 On the Search Users page, find the applicable user account.


Note As a best practice, do not use the default system administrator user account for remote access. Instead, use a different administrative user account to avoid having the default system administrator account become locked due to too many failed authentication attempts.


Step 3 On the Edit User Basics page, on the Edit menu, select Roles.

Step 4 On the Edit Roles page, in the Available Roles field, select Remote Administrator , then select the Up arrow to move it into the Assigned Roles field.

Step 5 Select Save .

Step 6 Repeat Step 2 through Step 5 for each user who needs access to remote administration tools.


 

To Start the Database Proxy Service


Step 1 In Cisco Unity Connection Serviceability, select Tools > Service Management.

Step 2 In the Optional Services section, find the Unity Connection Database Proxy row and select Activate.


 

Cisco Utilities Database Link for Informix (CUDLI) in Unity Connection 10.x

The Cisco Utilities Database Link for Informix (CUDLI) tool allows you to navigate the Cisco Unity Connection database, learn about the purpose of data in a particular table or column, and jump between referenced objects in the database. It also shows stored procedures and includes a custom query builder.

Download the tool and view training videos and Help at http://www.ciscounitytools.com/Applications/CxN/CUDLI/CUDLI.html .

Unity Connection User Data Dump (CUDD) in Unity Connection 10.x

The Unity Connection User Data Dump (CUDD) allows you to export specific information about users to a file that can then be viewed or imported into another application such as a database utility or Excel. When the data is exported, the tool automatically creates a header row that lists the data type found in each column of the output, for ease of import into other programs.

Download the tool and view training videos and Help at http://www.ciscounitytools.com/Applications/CxN/UserDataDump/UserDataDump.html .

Wallet Card Wizard in Unity Connection 10.x

The Wallet Card wizard is available for producing a PDF file of a wallet card based on any of the Unity Connection conversations, including custom keypad mappings. The templates in the wizard list frequently used menu options and shortcuts for managing Unity Connection messages and user preferences by phone; the wizard fills in the applicable keys based on the conversation that you specify. The resulting PDF is formatted as a wallet card that can be printed, then cut out and folded by users.

The wizard also allows you to customize technical support information and instructions for signing in to Unity Connection. The Wallet Card wizard is a Windows-based remote database administration tool. Download the tool and view Help at http://www.ciscounitytools.com/Applications/CxN/WalletCardWizard/WalletCardWizard.html .