Table Of Contents
Release Notes for Cisco Unified
Service Monitor 2.0.1Supported Versions of Cisco Unified Communications Manager
Required Unified Communications Manager Patches and Workarounds
Supported Cisco Unified IP Phone Models and Phone Protocols
Enabling CVTQ Data on Supported Cisco MGCP Voice Gateways
Supported Cisco 1040 Binary Image Files
Scheduling Low-Volume Time and Database Purging
Applying Changes to the qovrconfig.properties File
Configuring AXL Web Services on Unified Communications Manager 5.x and Up
Copies of the Material that Has Been Added to Documentation
Configuring and Viewing Other Settings (Chapter 3)
Configuring Low-Volume Schedule and Database Purging (Chapter 6)
Activating the AXL Web Service on Unified Communications Manager (Appendix B)
Obtaining Documentation and Submitting a Service Request
Release Notes for Cisco Unified
Service Monitor 2.0.1
Revised: June 25, 2008Cisco Unified Service Monitor is a product from the Cisco Unified Communications Management Suite. These release notes provide:
•
Supported Versions of Cisco Unified Communications Manager
•
Supported Cisco 1040 Binary Image Files
•
Obtaining Documentation and Submitting a Service Request
New Features
The following changes and enhancements are included in Service Monitor 2.0.1:
•
Support for:
–
Cisco Unified Communications Manager (Unified Communications Manager) 6.0 and 6.1.
Note
Starting with versions 4.3, 5.1, and 6.0, the product we formerly referred to as Cisco Unified CallManager will be called Unified Communications Manager. Versions earlier than 4.3 and 5.0 retain the Cisco Unified CallManager name. Throughout this document, any reference to Unified Communications Manager can also be understood to refer to Cisco Unified CallManager, unless explicitly noted.
–
Internet Explorer 7.0.
–
Secure Socket Layer (SSL).
•
Thresholds—Configurable by device type.
•
Sensors—Editable in bulk.
•
Scheduling for:
–
Low-volume processing (during system maintenance).
–
Data purging.
•
New configuration options:
–
Number of records (30,000-64,000) to export to CSV files.
–
Number of minutes (1-4) to search for data for diagnostic reports.
•
Updated binary image for Cisco 1040 Sensors—SvcMonAA2_40.img. To load the image onto sensors, see Quick Start Guide for Cisco Unified Service Monitor 2.0.1.
Note
A new image, SvcMonAA2_42.img, is available at http://www.cisco.com/pcgi-bin/tablebuild.pl/servmon. For more information, see Bug IDs CSCsk61142, CSCsk98595, and CSCsl21586 in Known and Resolved Problems.
•
See Known and Resolved Problems for problems that were resolved in this release.
Product Documentation
Note
The originally published printed and electronic documentation is included with your product. Any changes after original publication are reflected on Cisco.com, where you will find the most up-to-date documentation.
Table 1 describes the product documentation that is available.
Table 1 Product Documentation
Document Title Available FormatsRelease Notes for Cisco Unified Service Monitor 2.0.1
•
PDF on the product CD-ROM.
•
On Cisco.com at the following URL:
http://cisco.com/en/US/products/ps6536/
prod_release_notes_list.htmlQuick Start Guide for Cisco Unified Service Monitor 2.0.1
Note
This quick start guide explains how to install and upgrade Service Monitor.
•
PDF on the product CD-ROM.
•
On Cisco.com at the following URL:
http://cisco.com/en/US/products/ps6536/
prod_installation_guides_list.htmlUser Guide for Cisco Unified Service Monitor
•
PDF on the product CD-ROM.
•
PDF accessible from online help.
•
On Cisco.com at the following URL:
http://cisco.com/en/US/products/ps6536/
products_user_guide_list.htmlContext-sensitive online help
Available by clicking one of the following:
•
Help link in the upper right-hand corner of the window.
•
Help button in the dialog box.
Related Documentation
Note
The originally published printed and electronic documentation is included with your product. Any changes after original publication are reflected on Cisco.com, where you will find the most up-to-date documentation.
Table 2 describes the additional documentation that is available.
Table 2 Related Documentation
Document Title Description and Available FormatsRelease Notes for Cisco Unified Operations Manager 2.0.1
On Cisco.com at the following URL:
http://cisco.com/en/US/products/ps6535/
prod_release_notes_list.htmlQuick Start Guide for Cisco 1040 Sensor
Describes how to install a Cisco 1040 and provides regulatory compliance and safety information. This document is available on Cisco.com at the following URL:
http://cisco.com/en/US/products/ps6536/prod_installation_guides_list.html
Installation Guide for Cisco Unified Operations Manager (Includes Service Monitor)
On Cisco.com at the following URL:
http://cisco.com/en/US/products/ps6535/prod_installation_guides_list.html
User Guide for Cisco Unified Operations Manager
On Cisco.com at the following URL:
http://cisco.com/en/US/products/ps6535/products_user_guide_list.html
Release Notes for CiscoWorks Common Services 3.0.5 (Includes CiscoView 6.1.5) on Windows
On Cisco.com at the following URL:
http://cisco.com/en/US/products/sw/cscowork/ps3996/prod_release_note09186a00806f45bf.html
Installation and Setup Guide for Common Services 3.0.5 (Includes CiscoView) on Windows
On Cisco.com at the following URL:
User Guide for CiscoWorks Common Services 3.0.5
On Cisco.com at the following URL:
http://cisco.com/en/US/products/sw/cscowork/ps3996/products_user_guide_book09186a00806feda7.html
Supported Versions of Cisco Unified Communications Manager
When properly configured, Service Monitor can report on voice activity from the versions of Unified Communications Manager listed in Table 3.
Table 3 Unified Communications Manager Support
Unified Communications Manager Version Information Available from this Version3.3
4.0
4.1
The following information is available for Service Monitor to include in reports:
•
Cluster ID
•
Call endpoints
•
Time stamp (Reflects call disconnect time)
•
Call duration
•
Call termination cause
•
Codec
•
Milliseconds of jitter
•
Number of lost packets
4.2
4.3
5.0
5.1
6.0
6.1
In addition to the information provided by earlier versions, MOS is available for Service Monitor to use in determining whether a threshold has been violated and, if so, send a trap. Other data, such as concealment ratio and severely concealed seconds, is also available for inclusion on reports and in traps.
MOS is calculated using the Cisco Voice Transmission Quality (CVTQ) algorithm on specific phones. To make CVTQ data available, you need to:
•
Ensure that you have applied any required patches to Unified Communications Manager.
•
Use the specified models of Cisco Unified IP phones with the specified protocol and firmware; these phones must be registered with Unified Communications Manager 4.2, 4.3, 5.0, 5.1, 6.0, or 6.1.
For more information, see the following topics:
•
Required Unified Communications Manager Patches and Workarounds
•
Supported Cisco Unified IP Phone Models and Phone Protocols
Required Unified Communications Manager Patches and Workarounds
Problems with CVTQ data can occur due to known problems with certain versions of Unified Communications Manager. Table 4 documents these problems.
Supported Cisco Unified IP Phone Models and Phone Protocols
The following Cisco Unified IP phone models support the CVTQ algorithm in SCCP mode—and in most cases SIP mode—if they have the 8.0(3) firmware which can be downloaded from Unified Communications Manager versions 4.2, 4.3, 5.x, 6.0, and 6.1.
Note
For Cisco Unified IP phone models to support the CVTQ algorithm in SIP mode, you must enable Call Stats in the SIP profile. For more information, select the appropriate version of Cisco Unified Communications Manager Administration Guide at this URL: http://cisco.com/en/US/products/sw/voicesw/ps556/prod_maintenance_guides_list.html.
No other Cisco Unified IP Phone models support CVTQ.
Note
The 8.0(3) phone firmwareis also accessible from this URL: http://www.cisco.com/pcgi-bin/tablebuild.pl/ip-7900ser.
Enabling CVTQ Data on Supported Cisco MGCP Voice Gateways
To enable CVTQ data on Cisco MGCP voice gateways, you need the correct Cisco IOS software and DSP hardware and you must enable voice quality statistics on the voice gateway. Ensure that you have:
•
Cisco IOS 12.4(4)T or later.
•
TIC5510 DSP hardware—TIC5510 DSP supports the DSP/KF voice quality metric that Service Monitor needs. To confirm that a voice gateway has TIC5510 DSP, look for 5510 in the output of this command:
show voice dsp detailed
For more information, see Cisco IOS Voice Command Reference at this URL:
http://www.cisco.com/en/US/docs/ios/voice/command/reference/vr_book.html
The platforms on which TICDSP5510 is supported are:
–
Cisco 2800 series and Cisco 3800 series integrated services routers with PVDM2 modules
–
Cisco VG224 voice gateway
–
Cisco IAD2430 series integrated access devices
–
Cisco 2600XM, Cisco 2691, Cisco 3700 series access routers, Cisco 2811, Cisco 2821, Cisco 2851, and Cisco 3800 series integrated services routers with the following network modules:
NM-HDV2
NM-HDV2-1T1/E1
NM-HD-1V
NM-HD-2V
NM-HD-2VE
–
Cisco 2821, Cisco 2851, Cisco 3825, and Cisco 3845 with the EVM-HD-8FXS/DID module
For updates on voice gateways that support TICDSP5510 and updates on DSP technology, see Cisco.com. For more information, see DSP Voice Quality Metrics Guide at this URL: http://www.cisco.com/en/US/docs/ios/12_4t/12_4t15/vqmetric.html
To enable voice quality statistics on the voice gateway, use this command:
mgcp voice-quality-stat all
Note
A warning message might be displayed advising that "enable voice stats might impact performance".
For more information, see Cisco IOS Voice Command Reference at this URL:
http://www.cisco.com/en/US/docs/ios/voice/command/reference/vr_book.html
Supported Cisco 1040 Binary Image Files
Only the following binary image files are supported for use on Cisco 1040 Sensors while using Service Monitor 2.0.1:
•
SvcMonAA2_40.img—Installed in the NMSROOT\ImageDir folder when you install Service Monitor 2.0.1.
•
SvcMonAA2_42.img—Available on Cisco.com from the Software Download site at http://www.cisco.com/pcgi-bin/tablebuild.pl/servmon. For more information, see Bug IDs CSCsk61142, CSCsk98595, and CSCsl21586 in Known and Resolved Problems.
CautionInstalling binary image files other than SvcMonAA2_40.img and SvcMonAA2_42.img can cause severe problems.
Known and Resolved Problems
Note
To obtain more information about known problems, access the Cisco Software Bug Toolkit at
http://www.cisco.com/pcgi-bin/Support/Bugtool/home.pl. (You will be prompted to log into Cisco.com.)Table 6 describes problems known to exist in this release; Table 7 describes problems resolved since the last release of Service Monitor.
Table 6 Known Problems in Service Monitor 2.0.1
Bug ID Summary ExplanationCSCso65632
Installation sometimes corrupts because DEP is not suppressed
Installation sometimes fails. This happens when Windows Data Execution Prevention (DEP) is enabled.
To work around this problem:
1.
Disable DEP:
a.
Log in to the machine on which you will install Service Monitor as an administrator or a member of the Administrators group.
Note
If your computer is connected to a network, network policy settings might prevent you from completing this procedure.
b.
Open System Properties by right-clicking the My Computer icon on your desktop and selecting Properties.
c.
Click the Advanced tab; then, under Performance, click Settings.
d.
Click the Data Execution Prevention tab. If Turn on DEP for all programs and services except those I select is selected, DEP is enabled.
e.
Select Turn on DEP for essential Windows programs and services only.
f.
Click OK.
2.
Install Service Monitor.
3.
Apply the US Daylight Saving Time (DST) Patch for Cisco Unified Service Monitor 1.1 and 2.0:
a.
Enter this URL into your browser: http://www.cisco.com/pcgi-bin/tablebuild.pl/servmon
and follow instructions to log in.
b.
Download and read "Readme for US Daylight Saving Time (DST) Patch for Cisco Unified Service Monitor 1.1 and 2.0" (cusmdst_win.readme.pdf). This document includes the amount of time required to install, installation instructions, and steps to complete after installing the patch.
c.
Download and install "Daylight Saving Patch for Cisco Unified Service Monitor 1.1 and 2.0 " (cusmdst_win_k9.zip).
CSCso65632
(continued)
Installation sometimes corrupts because DEP is not suppressed
4.
Sun Alert 102836 describes a bug in the latest JDK releases when using EST, MST, and HST abbreviations. To work around this problem for Service Monitor, complete either one of these workarounds:
Workaround Alternative 1
a.
From the command line on the Service Monitor system, stop the daemon manager using this command:
net stop crmdmgtdb.
Delete three time zone data files: EST, MST, and HST from the NMSROOT\lib\jre\lib\zi directory (or <JRE_HOME>/lib/zi).
Note
NMSROOT is the directory where you installed Service Monitor; it is C:\Program Files\CSCOpx if you used the default location.
c.
From the command line on the Service Monitor system, stop the daemon manager using this command:
net stop crmdmgtdd.
Start the daemon manager using this command:
net start crmdmgtdWorkaround Alternative 2
a.
From the command line on the Service Monitor system, stop the daemon manager using this command:
net stop crmdmgtdb.
Download and extract the tzupdater tool from this URL:
http://java.sun.com/javase/downloads/index.jspNote
This website is Copyright © 1994-2007, Sun Microsystems, Inc.
5.
If desired, re-enable DEP:
a.
Perform steps 1a-1d.
Select Turn on DEP for all programs and services except those I select.
CSCsc19066
Cisco 1040 does not generate syslog messages for Audio Codec G722
There is no workaround for this problem.
CSCsi66458
Cluster deleted in verifying state doesn't get deleted
If you delete credentials for a Unified Communications Manager while the Last Contact Status is Verifying and the verification fails, the credential reappears as Failed.
To work around this problem, do not delete a credential that is in Verifying state; wait until the Last Contact Status displays one of the final states: Failure, Success, or Waiting For Data.
CSCsi71681
CVTQ, Sensor Reports don't show latest data when > 2000 records match
Diagnostic reports display up to 2,000 rows. When you select report filters that match more than 2,000 records, the resulting report might not include all calls sequentially.
To work around this problem, export the report to a CSV file; up to 30,000 rows can be exported to a CSV file by default. (An administrator can configure Service Monitor to export up to 64,000 rows; see online help for more information.)
If a CSV file contains exactly 30,000 or exactly 64,000 rows, it is very likely that there are additional records that match the report filters. If this is the case:
•
The CSV file still might not include all calls sequentially.
•
It is strongly recommended that you make the report filter more specific to match fewer records. Diagnostic reports are not designed to display all calls made in the system.
CSCsi85940
Handle leak with deleted sensors
After you delete a sensor from Service Monitor, system resource usage on the Service Monitor server increases continuously while the sensor is on the network and attempting to communicate with a Service Monitor.
Workaround:
To prevent this problem, do one of the following before you delete a sensor:
•
If you plan to add the sensor to another licensed instance of Service Monitor, do so and ensure that the sensor is communicating with that Service Monitor.
•
Shut these ports on the switch:
–
The port that physically connects to the 10/100-1 Fast Ethernet port on the sensor.
–
The SPAN or RSPAN destination port. (Alternatively, you can reconfigure this port so that it is no longer a SPAN or RSPAN destination port.)
CSCsi86375
Diagnostic report data incorrect for some nondirect calls
For some nondirect calls, diagnostic (sensor and CVTQ) reports might include information that is incomplete. The circumstances and the problems that have been observed include:
•
Using Music On Hold:
1.
Two Cisco Unified IP Phones are registered with a Unified Communications Manager.
2.
A call is placed between the phones.
3.
One of the phones is placed on hold.
In this case, the sensor and CVTQ reports include records for:
–
Phone 1 to Phone 2—Includes correct data.
–
Phone 2 to Phone 1—Includes correct data.
–
Unified Communications Manager (Music on Hold) to Phone 1—Speaker device type is Unavailable and speaker directory number is blank; speaker device type should be the IP address of the Unified Communications Manager. (In CVTQ reports only, there is no matching record for Unified Communications Manager to Phone 1 while on hold.)
•
Converting from a conference call to a direct call (after all but two phones drop out of a conference call). In CVTQ reports:
–
Records for the calls that dropped out of the conference call are correct.
–
Records for the last two phones can be written in combinations such as these:
Phone 1 to conference bridge; Phone 2 to Phone 1
Phone 1 to Phone 2; Phone 2 to conference bridge
Phone 1 to Phone 2; Phone 2 to Phone 1
In the first two cases, the records for both sides of the call do not match. In the third case, there is no way to tell that these phones were ever in a conference call.
There is no workaround for this problem.
CSCsj45638
Editing Cisco 1040 Sensor configuration files causes problems
If you edit a sensor configuration file, some editing applications might append a carriage-return character to each line. The sensor interprets the Windows carriage return character as part of the binary image filename. As a result, after every reset, the sensor tries to download and install the image from the TFTP server and fails. Hence, the sensor is not able to install a new image.
Workaround:
To open a sensor configuration file with an editing application, use Notepad. Notepad does not add carriage-return characters to each line.
CSCsk61142
Ensure PLC (packet loss concealment) is emulated when grading G.711 MOS
PLC is not emulated while grading G.711 MOS.
Workaround:
Install the SvcMonAA2_42.img file on Cisco 1040 Sensors.
1.
Go to this URL:
http://www.cisco.com/pcgi-bin/tablebuild.pl/servmon
2.
Download these files:
–
ReadmeForSvcMonAA242.pdf
–
SvcMonAA2_42.img
3.
Follow the instructions in the ReadmeForSvcMonAA242.pdf file to install SvcMonAA2_42.img on Cisco 1040 Sensors.
CSCsk98595
Ability to handle recurring streams
Some RTP transmitters might reuse ip:port:RTP ssrc for streams within a short period of time, which might look like incurred packet loss. The 1040 might not be able to distinguish whether this is a case of a packet loss burst or of a stream ending and restarting.
Workaround:
Install the SvcMonAA2_42.img file on Cisco 1040 Sensors. For instructions, see the explanation for CSCsk61442 in this table.
CSCsk77070
No CVTQ data from MGCP gateway
If CVTQ/K-factor is enabled on an MGCP gateway, Service Monitor does not report CVTQ data for the MGCP gateway.
Workaround:
Install an updated qovr1_0.jar file on the Service Monitor server.
1.
Go to this URL:
http://www.cisco.com/pcgi-bin/tablebuild.pl/servmon
2.
Download these files:
–
ReadmeForMGCPGatewayCVTQReportPatch.pdf
–
qovr1_0.jar
3.
Follow the instructions in the ReadmeForMGCPGatewayCVTQReportPatch.pdf file for installing qovr1_0.jar.
CSCsl21586
MOS does NOT drop below 2.7 with 41.img even with high packet loss
Software images prior to SvcMonAA_41 have assumed a maximum packet loss value of 20% in the calculation of MOS. In software image SvcMonAA_41, the 1040 would score RTP streams with packet loss greater than 20% with a MOS using the 20% value; (the G711 codec would yield a MOS of 2.7.)
This problem occurs as follows:
1.
Allow a sensor with the SvcMonAA2_41.img file installed on it to register with Service Monitor.
2.
Create a situation in which packet loss exceeds 20%.
3.
The minimum MOS for G711 streams is 2.7. MOS does not drop below 2.7 as the packet loss increases beyond 20%.
Workaround:
Install the SvcMonAA2_42.img file on Cisco 1040 Sensors. For instructions, see the explanation for CSCsk61442 in this table.
—
Monitored phone count can lag device discovery
There might be a lag of up to one minute between the time that Service Monitor discovers devices and the time when the monitored phone count is updated.
Workaround:
There is no workaround for this problem.
Documentation Errata
The following information is missing from the online help and from the PDF user guide included in the online help and on the product CD:
•
Scheduling Low-Volume Time and Database Purging
•
Applying Changes to the qovrconfig.properties File
•
Configuring AXL Web Services on Unified Communications Manager 5.x and Up
Scheduling Low-Volume Time and Database Purging
Midnight through 1am must be scheduled as low-volume time. Database purging must not run from midnight through 1am. This information has been incorporated into Configuring Low-Volume Schedule and Database Purging (Chapter 6) in the user guide on Cisco.com.
Applying Changes to the qovrconfig.properties File
To put changes into effect after you edit qovrconfig.properties, you must stop and start the QOVR process.
1.
Log on to the server where Service Monitor is installed.
2.
From the command line, enter these commands:
pdterm QOVRpdexec QOVRThis information has been incorporated into Configuring and Viewing Other Settings (Chapter 3) in the user guide on Cisco.com.
Configuring AXL Web Services on Unified Communications Manager 5.x and Up
For Service Monitor to work properly with Unified Communications Manager 5.x and up, you must activate the AXL Web Service. This information has been incorporated into Activating the AXL Web Service on Unified Communications Manager (Appendix B) in the user guide on Cisco.com.
Copies of the Material that Has Been Added to Documentation
This section includes the following:
•
Configuring and Viewing Other Settings (Chapter 3)
•
Configuring Low-Volume Schedule and Database Purging (Chapter 6)
•
Activating the AXL Web Service on Unified Communications Manager (Appendix B)
Configuring and Viewing Other Settings (Chapter 3)
Use this procedure to:
•
View some settings that are configured outside of the user interface. (See Configuring Diagnostic Report Search and CSV Export Limit Settings, page 3-15 and Configuring Low-Volume Schedule and Database Purging, page 6-1.)
•
Configure SFTP settings if you are monitoring calls from Unified Communications Manager version 5.x or 6.x.
Step 1
Select Configuration > Other Settings. The Other Settings page appears.
Step 2
View settings and update SFTP settings as described in the following table:
Step 3
Click Apply.
Configuring Low-Volume Schedule and Database Purging (Chapter 6)
During a low-volume schedule, Service Monitor handles roughly 20% of the number records that are processed during a peak period and performs database maintenance. Table 6-1 lists default schedules for low-volume processing and database purging and provides the information you need to update them.
Activating the AXL Web Service on Unified Communications Manager (Appendix B)
Perform this procedure for Unified Communications Manager versions 5.x and later.
Step 1
Launch Unified Communications Manager Serviceability.
Step 2
Select Tools > Service Activation.
Step 3
Select a server.
Note
Activate the AXL Web Service on the Publisher node only.
Step 4
Scroll down to Database and Admin Services and select Cisco AXL Web Service.
Step 5
Click Save.
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.
This document is to be used in conjunction with the documents listed in the "Related Documentation" section.
CCDE, CCENT, Cisco Eos, Cisco Lumin, Cisco Nexus, Cisco StadiumVision, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn is a service mark; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQ Expertise, the iQ logo, iQ Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0805R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2007-2008 Cisco Systems, Inc. All rights reserved.


