Cisco Unified Analysis Manager Tools
This chapter provides information about the Unified Analysis Manager, which provides a set of tools that allows you to perform management tasks for specific devices and groups of devices.
Analyze Call Path Tool
The Analyze Call Path tool allows you to trace a call between multiple Cisco Unified Communications products. In order to trace a call using the Analyze Call Path tool, a node must be defined in Unified Analysis Manager and the node must belong to a group.
![]() Note | All nodes that you define are assigned to the AllNodes group by default. Use the Node Groups function if you want to assign the node to a different group. See the topics related to the Analyze Call Path setup for more information on configuring a Call Record Repository before using the Analyze Call Path function. |
Analyze Call Path Setup Considerations
![]() Caution | The Analyze Call Path Tool might not work correctly if your computer is set to a language other than English. |
When using the Analyze Call Path tool, there are configuration considerations for each product that the Unified Analysis Manager manages.
The Analyze Call Path tool does not include information for Cisco Unity Connection and IM and Presence servers.
- Cisco Unified Communications Manager/Cisco Business Edition 5000
- Cisco Unified Contact Center Express
- Cisco Unified Intelligent Contact Management Enterprise/Cisco Unified Contact Center Enterprise
- Cisco Unified Customer Voice Portal
- Cisco Access Control Server and Cisco IOS Gateway
Cisco Unified Communications Manager/Cisco Business Edition 5000
The following information applies when configuring the Analyze Call Path for Cisco Unified Communications Manager and Cisco Business Edition 5000:
Version Support—Unified Analysis Manager supports Release 8.0(1) and above for Cisco Unified Communications Manager and Release 8.0(1) and above for Cisco Business Edition 5000.
Call Record Repository—For Cisco Unified Communications Manager, use the first node (publisher) as the Call Record Repository with the HTTPS protocol and the default port 8443.
User Group and Access Permissions— Users should belong to a user group whose role contains read and update permissions required to access Call Records for the following resources:
SOAP Call Record APIs
SOAP Control Center APIs
SOAP Diagnostic Portal Database Service
SOAP Log Collection API
SOAP Performance Informations APIs
SOAP Realtime Informations and Control Center APIs

NoteNew resources "SOAP Diagnostic Portal Database Service" and "SOAP Call Record APIs" added on an upgrade should not have the read and update permissions by default due to security reasons for existing users. Users need to create or copy the role to custom resources and update the required permissions for above mentioned resources as needed. Refer to Cisco Unified Communications Manager Administration Guide for additional details.
Configuring NTP—Each product installed in the solution should be configured to point to same set of external NTP clock sources. NTP is required to be configured on all nodes that involve calls for SCT features. For Cisco Unified Communications Manager, use the utils ntp config CLI command to configure NTP.
Enable Call Record Logging—In Cisco Unified Communications Manager Administration, go to the Service Parameter Configuration window, and choose the Cisco CallManager Service. Enable the CDR Enabled Flag and the CDR Log Calls with Zero Duration Flag parameters. Restart the Cisco CallManager service for change-notification to take effect immediately. Repeat this procedure for all nodes in the Cisco Unified Communications Manager cluster.

NoteYou can verify that flags are set as desired at https://<HOSTNAME:PORT>/ccmadmin/vendorConfigHelp.do
CDR CAR Loader—Ensure your CDR Analysis and Reporting (CAR) Loader is set to Continuous Loading 24/7. To verify this:
Go to the Cisco Unified Serviceability and select page. The CAR page opens in a new browser.
Go to .
Verify if Loader is not disabled and that Continuous Loading 24/7 is enabled. This allows CDR records that are generated from Cisco Unified Communications Manager nodes to be loaded into the CAR database as soon as they arrive to Cisco Unified Communications Manager first node (publisher).
If call records are not found on the Cisco Unified Communications Manager, it is possible that the CAR Loader failed or is having a delay loading the latest CDR records. If this occurs, go to the CAR page and click the Table Information button. Check for the oldest and latest CDR records that are available in the CAR database. If records are not set to the latest date, go to and select CDR Load to check its recent run status to see if there were any Unsuccessful runs. If CDR Load failure is found, collect CAR Scheduler traces to provide to Cisco Support for troubleshooting.
Raw Call Record Details—For information on Raw Call Record details help for the Cisco Unified Communications Manager, refer to Cisco Unified Communications Manager Call Detail Records Administration Guide.
Cisco Unified Contact Center Express
The following information applies when configuring the Analyze Call Path for Unified CCX:
Version Support—Unified Analysis Manager supports Unified CCX version 8.0(1) and later.
Call Record Repository—The Call Record Repository used for Unified CCX is either (or both in the case of a High Availability system) of the Unified CCX nodes. The database is active on both nodes and the data is replicated. The JDBC user is uccxsct and the password is the encrypted version of the TFTP password. The password is typically set by the Unified CCX administrator.
Default user for adding Unified CCX Call Record Repository—The Informix user for adding (and connecting to) Unified CCX Call Record Repository is: uccxsct. You can reset the default install time password for above user in the Unified CCX Application page. Typically, the Unified CCX administrator will reset to the desired password and pass it on to the Unified Analysis Manager administrator.
User Group and Access Permissions—Unified CCX does not require any additional user group and access permission to access Call Records. The access permissions of the uccxsct user is set by Unified CCX install for read access to specific tables. No external settings are required.
Configuring NTP—To configure NTP for Unified CCX, go to .
Enable Call Record Logging—Unified CCX always generates Call Records by default, so no configuration is required to enable logging of Call Records.
Cisco Unified Intelligent Contact Management Enterprise/Cisco Unified Contact Center Enterprise
The following information applies when configuring the Analyze Call Path for Cisco Unified Intelligent Contact Management Enterprise (Unified ICME) and Unified CCE:
Version Support—Unified Analysis Manager supports Release 8.0(1) and above for Unified ICME and Unified CCE.
Call Record Repository—The Call Record Repository used for Unified ICME is either AW-HDS-DDS or HDS-DDS. The server used for Unified CCE is HDS/AW Database (port 1433).
User Group and Access Permissions—For Release 8.0(1), the recommended user group and access permissions that are required to access Call records are the Windows only Authentication for SQL Server. This is done by using the User List tool from the Configuration Manager and creating a user with the right access privileges.
Configuring NTP—Configuration for Time Synchronization of Unified CCE servers is based on Microsoft Windows Time Services. When setting up the Unified CCE router component, retain the default settings of the "Disable ICM Time Synchronization" box as checked. With the recommended default setting, the time synchronization for Unified CCE servers is provided by the Windows Time Service, which automatically synchronizes the computer's internal clock across the network. The time source for this synchronization varies, depending on whether the computer is in an Active Directory domain or a workgroup. For additional information on setting up Windows Time Service, refer to the Microsoft Windows Time Service Technical Reference documentation at: http://technet.microsoft.com/en-us/library/cc773061(WS.10).aspx.
Enable Call Record Logging—To check that Call Record logging is enabled, first be sure that the Unified Analysis Manager service on Unified CCE is enabled. Using the web setup, you need to install the AW-HDS-DDS or HDS-DDS servers with Administration and Data Server roles. Once you install these roles using the web setup, the call records are available by default.
Raw Call Record Details—To find help for the Raw Call Record details, refer to the Schema Help which you can access from the Unified CCE Administration Tool group on either the AW-HDS-DDS or HDS-DDS server. You can also refer to the United CCE Database Schema Handbook for a specific release at http://www.cisco.com/en/US/products/sw/custcosw/ps1844/tsd_products_support_series_home.html.
![]() Note | If you are using RTMT to monitor Cisco Unified Contact Center Enterprise, you must open the following file and change the value for ReadTimeout to 360: <RTMT_INSTALLATION_FOLDER_PATH>/conf/rtmt.xml. If you don't change the value, RTMT will not be able to collect OPC logs because RTMT's default timeout value is greater than the time it takes to collect OPC logs. |
Cisco Unified Customer Voice Portal
The following information applies when configuring the Analyze Call Path for Unified CVP:
Version Support—United Analysis Manager supports Unified CVP Release 8.0(1) and above.
Call Record Repository—Unified CVP uses the Unified CVP Reporting Server for the Call Record Repository.
User Group and Access Permissions—Unified CVP uses Unified CVP OAMP to set user group and access permissions required to access Call Records:
All users trying to access Unified CVP records from the Unified CVP database need to be created through Unified CVP OAMP.
Unified CVP Reporting users need to be granted the Unified CVP Reporting role in Unified CVP OAMP.
User passwords may expire if security hardening is installed on the Unified CVP Reporting Server. SNMP monitor displays alerts when this happens.
Configuring NTP—Configuration for Time Synchronization of the Unified CVP servers is based on Microsoft Windows Time Services. For additional information on setting up Windows Time Service, refer to the Microsoft Windows Time Service Technical Reference documentation at http://technet.microsoft.com/en-us/library/cc773061(WS.10).aspx.
Enable Call Record Logging—To ensure that Call Record logging is enabled, do the following:
Unified CVP Reporting Server is not installed nor configured by default. Customers and Partners will have to install a Unified CVP Reporting Server to use the Analyze Call Path tool with Unified CVP.
Unified CVP Database schema needs to be laid down by the Unified CVP_database_config.bat file. This file needs to be run by the user after Unified CVP Reporting Server installation is completed.
Once a Unified CVP Reporting Server is installed, it needs to be configured through Unified CVP OAMP and a Unified CVP Call Server needs to be associated with the Unified CVP Reporting Server.
Follow the Unified CVP CAG and RPT guidelines for configuring the Unified CVP Reporting Server, Unified CVP VXML Server, and Unified CVP Call Servers.
Unified CVP data retention is 30 days, by default. You can customize this value through Unified CVP OAMP. Unless you back up the database, data will be purged at the end of data retention day. Backed up Unified CVP data is not accessible unless it is imported back into the database.
Unified CVP VXML Server filters need to be configured on Unified CVP OAMP. Refer to the Unified CVP OAMP guide for configuring these filters.
Raw Call Record Details—For information relating to Raw Call Record details, refer to the Unified CVP Reporting Guide for version7.0(2).
Cisco Access Control Server and Cisco IOS Gateway
The following information applies when configuring the Analyze Call Path for Cisco Access Control (ACS) Servers and Cisco IOS Gateways:
Version Support—Unified Analysis Manager supports ACS Release 5.1.
Call Record Repository—To assign a Call Record Repository, one of the acs servers can be configured as a "collector" node.
User Group and Access Permissions—To set user group and access permissions, after the ACS server is installed, in ssh/telnet access, enter acsadmin as the username and default as the password, You will be prompted to change the password.
Configuring NTP—To configure an NTP server on an ACS server, use cli: ntp server <NTP server IP/host>.
Enable Web View—Execute the CLI command acs config-web-interface view enable to enable web view. It is disabled by default.
Cisco IOS gateways as ACS network devices or AAA clients—You need to configure ACS network device to have the correct Radius secret, which is the same secret as the one on the IOS gateway.
For IOS configurations:
Use the CLI to configure NTP server: ntp server <NTP server IP/host>
Configure Cisco IOS gateway as a Radius client of the ACS server. Sample CLIs are below:
aaa new-model! ! aaa group server radius acs server 172.27.25.110 auth-port 1812 acct-port 1813 ! aaa authentication login h323 group acs aaa authorization exec h323 group acs aaa accounting connection h323 start-stop group acs aaa session-id common gw-accounting aaa radius-server host 172.27.25.110 auth-port 1812 acct-port 1813 radius-server key cisco radius-server vsa send accounting radius-server vsa send authentication
Be sure you have local login access to your Cisco IOS gateways.
Enable Call Record Logging—To check that Call Records logging is enabled:
Call Definitions
|
The call is not connected for any reason other than user hang-up before the connection is completed. |
|
|
The call is not connected because the user hangs up after initiating the call. |
|
|
The call is disconnected after connection for any reason other than user hanging up. |
|
Unified Communications Manager |
||||
|---|---|---|---|---|
Trace Collection
Unified Analysis Manager allows you to collect log and trace files from services of supported devices. There are three ways you can collect logs and trace files:
Collect Traces Now— Collect Traces Now option allows you to collect trace files based on a selection of services on a device or group of devices for any period of time that has occurred in the past.
Schedule Trace Collection— Schedule Trace Collection option allows you to collect trace files based on a selection of services on a device or group of devices for any period of time in the future.
Schedule Trace Settings and Collections—Schedule Trace Settings and Collection option allows you to collect trace files from the present into the future and also specify the trace levels to be used during the scheduled time.
Collect Traces Now
The Collect Traces Now option allows you to collect trace files based on a selection of services on a device or group of devices for any period of time that has occurred in the past.
| Step 1 | From the Unified Analysis Manager menu, select . The Collect Traces Now window displays. |
| Step 2 | Select either the Group to display a list of supported groups or the Node for a list of supported devices. Select the groups or devices that you want to collect traces for. |
| Step 3 | Use the Select the template to dropdown list to select the template containing the trace levels you want to use. Alternately, you can click the Customize button if you want to customize new trace levels for the group or device. |
| Step 4 | Use the Start Time and End Time fields to select the collection time period. |
| Step 5 | Use the Referenced Time Zone field to select the time zone for the collection time period. |
| Step 6 | You can optionally click the View Summary button to view the Collection Summary window. This window contain a list of the components associated with the node. |
| Step 7 | Click the OK button to start the trace. When the trace is completed, the window displays a Status Summary and Status Details for the trace. The Status Details provide the path to the directory to which the log was sent. |
Schedule Trace Collection
Use the Schedule Trace Collection option if you want to collect trace files for any period of time from the present into the future.
| Step 1 | From the Unified Analysis Manager menu, select . The Schedule Trace Collection window appears. |
| Step 2 | Select either the Group to display a list of supported groups or the Node for a list of supported devices. Select the groups or devices that you want to collect traces for. |
| Step 3 | Use the Select the template to dropdown list to select the template containing the trace levels you want to use. Alternately, you can click the Customize button if you want to collect traces for specific components. |
| Step 4 | Use the Start Time and End Time fields to select the collection time period. |
| Step 5 | Use the Referenced Time Zone field to select the time zone for the collection time period. |
| Step 6 | Use the Collect Traces Every dropdown field to indicate the frequency of the collection. |
| Step 7 | Optionally, you can choose to have an email notification sent regarding the trace collection. To do that, click the Send Email Notification to check box and enter the email address in the text box. |
| Step 8 | You can optionally click the View Summary button to view the Collection Summary window. This window contains a list of the components associated with the node. |
| Step 9 | Click the OK button to start the trace. When the trace is scheduled, the window displays a Status Summary and Status Details for the trace. When the trace is completed, a report is written to your log file and, if email information was provided, a system-generated email is sent. |
Schedule Trace Settings and Collection
Use the Schedule Trace Settings and Collection option if you want to collect trace files for any period of time from the present into the future and, in addition, also specify the trace levels to be used during the scheduled time. If you change trace settings with this option, trace levels are restored to their default settings after the collection period is over.
| Step 1 | From the Unified Analysis Manager menu, select . The Schedule Trace Collection window appears. |
| Step 2 | Select either the Group to display a list of supported groups or Node, for a list of supported devices. Select the groups or devices that you want to collect traces for. |
| Step 3 | Use the Select the template to drop-down list to select the template containing the trace levels you want to use. Alternately, you can click the Customize button if you want to customize new trace levels for the group or device. This option also allows you to collect traces for specific components. |
| Step 4 | Use the Start Time and End Time fields to select the collection time period. |
| Step 5 | Use the Referenced Time Zone field to select the time zone for the collection time period. |
| Step 6 | Use the Collect Traces Every drop-down field to indicate the frequency of the collection. |
| Step 7 | Optionally, you can choose to have an email notification sent regarding the trace collection. To do that, click the Send Email Notification to check box and enter the email address in the text box. |
| Step 8 | You can optionally click the View Summary button to view the Collection Summary window. This window contains a list of the components associated with the node. |
| Step 9 | Click the OK button to start the trace. When the trace is scheduled, the window displays a Status Summary and Status Details for the trace. When the trace is completed, a report is written to your log file and, if email information was provided, a system-generated email is sent. |
Set Trace Levels
Use the Set Trace Level option to assign trace levels for a group of devices or individual devices. You can assign trace levels using a template or you can customize trace levels. Trace levels can be set for the following Cisco Unified Communications components:
- Cisco Unified Communications Manager: Allows setting trace levels for Cisco Unified Communications Manager and Common Trace Components.
- IM and Presence: Allows setting trace levels for Unified Presence and Common Trace Components.
- Cisco Unity Connection: Allows setting trace level for Cisco Unity Connection and Common Trace Components.
- Cisco Unified Contact Center Express: Allows setting trace level only for Common Trace Components.
The following table describes the general trace level settings for the Cisco Unified Communications components that are managed by Unified Analysis Manager.
This level should include all traces generated in abnormal paths. This level is intended for coding error traces and error s traces that normally should not occur. |
||
This level should include traces for system-level operations. This should include all traces generated by "State Transitions" within components. |
||
This should include traces that can be used in the lab for debugging difficult problems of the component. |
||
This level should include detailed debug information or high volume of messages which are primarily used for debugging. |
| Step 1 | From the Unified Analysis Manager menu, select . The Set Trace Level window appears. |
| Step 2 | Select either the Group to display a list of supported groups or the Node for a list of supported devices. Select the groups or devices that you want to collect traces for. |
| Step 3 | From the Select the template drop-down list box, select the template containing the trace levels that you you want to use. Alternately, you can click the Customize button if you want to customize trace levels for the group or device. If you choose the Customize option, the Design Preview dialog displays with a list of supported devices. Choose the device you want and use the Selected Components fields to set the trace levels. |
| Step 4 | Click View Changes to see any changes made to traces levels for the node. Click OK to set the level and exit the screen. |
View Configuration
Use the View Configuration option to view configuration information related to a node. You can collect the version and configuration information and view it in a browser or save the results.
| Step 1 | From the Unified Analysis Manager menu, select . The View Configuration window appears and displays a list of nodes. |
| Step 2 | Select a node and click the Next button to display the Selected Components screen. This screen lists the Version, Platform, License and other category configuration information for the product. |
| Step 3 | Click Finish to collect the configuration information. The summary window appears. Users can view the collected information in a browser or save the collected configuration information using the Save As button. |

Feedback