 Feedback
|
Table Of Contents
Release Notes for Cisco Unified
Service Statistics Manager 1.2Ensuring That You Have the Correct Service Statistics Manager Build ID Installed
Obtaining and Installing the Correct Service Statistics Manager 1.2 Build
Useful Information About Integration with Operations Manager and Service Monitor
What to Do when You Receive a Database Table Size Exceeded E-mail
User Guide—Chapter 7, Using Administration
Obtaining Documentation and Submitting a Service Request
Release Notes for Cisco Unified
Service Statistics Manager 1.2
Revised: November 17, 2009Cisco Unified Service Statistics Manager is a product from the Cisco Unified Communications Management Suite. These release notes provide:
•
Obtaining Documentation and Submitting a Service Request
New Features
The following changes and enhancements are included in Service Statistics Manager 1.2:
•
–
–
•
–
–
–
•
•
–
–
–
http://<servername>:11101
Product Documentation
Note
Table 1 describes the product documentation that is available.
Related Documentation
Note
Table 2 describes the additional documentation that is available.
Table 2 Related Documentation
Release Notes for Cisco Unified Service Monitor 2.2
Cisco Unified Service Monitor 2.2 Compatibility Matrix
Installation Guide for Cisco Unified Service Monitor 2.2
User Guide for Cisco Unified Service Monitor
Release Notes for Cisco Unified Operations Manager 2.2
http://cisco.com/en/US/products/ps6535/prod_release_notes_list.html
Installation Guide for Cisco Unified Operations Manager (Includes Service Monitor)
http://cisco.com/en/US/products/ps6535/prod_installation_guides_list.html
User Guide for Cisco Unified Operations Manager
http://cisco.com/en/US/products/ps6535/products_user_guide_list.html
Release Notes for CiscoWorks Common Services 3.2
User Guide for CiscoWorks Common Services 3.2
Known Problems
Table 3 lists problems known to exist in Service Statistics Manager. 1.2. Some known problems occur due to changes made in Operations Manager and Service Monitor systems after integration with Service Statistics Manager; these are summarized in Useful Information About Integration with Operations Manager and Service Monitor.
Note
http://www.cisco.com/pcgi-bin/Support/Bugtool/home.pl. (You will be prompted to log into Cisco.com.)
Table 3 Known Problems in Service Statistics Manager 1.2
CSCtc59091
CUSSM 1.2 remains in evaluation mode with purchased license
After a purchased license is applied, Service Statistics Manager 1.2 license remains in evaluation mode.
Conditions:
This has been observed on VMware and non-VMware installations.
Workaround:
1.
<Installation directory>pw/licenses/cisco/etc/licenses/
2.
CSCta34541
Lag in storing records (CDR or CMR) retrieved from Service Monitor
A delay can occur between the retrieval of the CDR and CMR information from Service Monitor and the insertion of this information into Service Statistics Manager. The delay might happen when the Service Statistics Manager CDR and CMR table sizes are too large (a few million rows) and if the pruning of the data in those tables is occurring or has occurred. The delay can result in the Service Statistics Manager tables and the Service Monitor tables becoming out of sync.
To address this issue, a Service Statistics Manager script runs every day at 7:15 p.m. The script sends an e-mail notification when the table sizes exceed 2.5 million records for the CDR table and 5 million records for the CMR table; the e-mail notification tells you to contact the Cisco Technical Assistance Center (TAC).
The e-mail notification contains the following information:
•
•
•
•
•
•
•
When you receive an e-mail notification, you can decrease the data retention days to 20 or 15 days (default is 30 days), and run the pruner with the help of Cisco TAC to bring database table sizes within limits. Determine the new period to use for data retention based on the call volume observed in the deployment. Typically, the higher call volumes that cause the database table sizes to grow beyond the default limit happen in deployments of 30,000 or more phones. To change the data retention days and to reduce database table sizing, see What to Do when You Receive a Database Table Size Exceeded E-mail.
To ensure that you receive e-mail notifications, you must set the administrator e-mail ID and the SMTP hostname and port number. They are usually set during installation; however, you can still update them.
CSCta34541 (continued)
Lag in storing records (CDR or CMR) retrieved from Service Monitor (continued)
If the administrator e-mail ID was not set, set it as follows:
1.
<Installation Directory>pw\etc\hosts\admin_user
2.
jbgrayse@cisco.com
If the SMTP hostname and port number were not set, see "Updating the SMTP Server and Port Number" section in User Guide for Cisco Unified Service Statistics Manager.
Service Statistics Manager has been tested with a rate of 200 calls/minute and a data retention period of 30 days. This scenario does not cause the Service Statistics Manager database tables to become out of sync with the Service Monitor database tables. With this call rate, the out-of-sync condition appears when the Service Statistics Manager CDR table size exceeds 2.5 million records and the Service Statistics Manager CMR table size exceeds 5 million records.
However, if the call rate is greater than 200 calls/minute, the out-of-sync condition can occur with fewer records in the CDR and CMR tables. In such situations, Cisco TAC can configure Service Statistics Manager to send e-mail notification when there are fewer records than the default in the CDR and CMR tables.
Note
CSCta03506
How to clean up after failed installation or uninstallation
If Service Statistics Manager installation fails part-way through, or if uninstallation fails, your system can be left in a state where retrying the installation or uninstallation fails.
Workaround:
To workaround this problem, you must clean up your system as follows:
1.
2.
3.
–
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{A57EBAA8-A035-483D-A0BA-3CB667CE5214}
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{B69A9D81-31FD-4B39-A4C7-9F0F0F774E0A}
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{DCD3461A-7AA6-44D3-9DC2-FE7B28DC7189}
–
HKEY_LOCAL_MACHINE\SOFTWARE\CUSSM
–
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
Services\ASANYe_CussmDBHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
Services\ProNetAgentHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\
Services\ProNetServerHKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\
CUSSMApache4.
<StartupMenuDirectory>\Programs\Cisco Unified Service Statistics Manager
5.
6.
CSCsq70177
Not all Operations Manager devices included in reports
The following was observed. More than 10 instances of Unified Communications Manager were added to Operations Manager. There were instances of Unified Communications Manager in each of these device states:
•
•
•
Data for fewer than 10 instances of Unified Communications Manager was included in Service Statistics Manager reports.
Circumstances:
Operations Manager does not produce performance data for devices unless they are in the Monitored device state. During discovery, Service Statistics Manager determines the devices for which data will be collected. Service Statistics Manager does not monitor each device in Operations Manager inventory. Of the devices that Service Statistics Manager supports, it monitors only those for which Operations Manager has collected data. (Much of the data that Service Statistics Manager uses is produced only when Voice Utilization polling is enabled for device groups in Operations Manager. By default, Voice Utilization polling is not enabled in Operations Manager.)
Workaround:
For Operations Manager (and Service Monitor) to provide the data that Service Statistics Manager relies upon, Operations Manager and Service Monitor must be configured correctly and devices must be reachable in the network. If you do not see particular Operations Manager devices in Service Statistics Manager reports:
•
•
•
–
–
•
CSCsz20537
No Data Available shown on Voicemail views with Unity Connection
If you have Cisco Unity Connection (and not Cisco Unity), you see No Data Available for voicemail on the initial pages of these views:
•
This report includes Cisco Unity data only.
•
This report includes data for Cisco Unity and Cisco Unity Connection. However, you must drill down to see that No Data Available is displayed for Cisco Unity and that data is available for Cisco Unity Connection.
Workaround:
•
•
CSCsx60244
Apostrophe in global comment distorted in graph or report
You can enter global comments to be displayed on graphs and reports. If you include an apostrophe (') in a global comment, it appears garbled in the graph or report.
Workaround:
Do not include an apostrophe in a global comment.
CSCsz26825
dbsrv and java_cntl process conflict
The database server was observed to shut down during a stress test due to a port conflict with another Service Statistics Manager process, pronet_cntl (java_cntl.exe).
Workaround:
Restart the SSM server:
1.
2.
3.
CSCsz57462
Instance aggregation report limited to 25 trunks
When defining an Instance Aggregation report, you can include up to 25 trunks only. This is so even when the data will be displayed in a table (that is, Show Only Table is selected in the report definition).
Workaround:
Do either of the following to produce a report with more than 25 trunks in it:
•
1.
2.
•
1.
2.
# Entries for configurations in reports graph displaypronet.report.display.noOfxValues=253.
4.
pw j rCSCsz44590
Call Quality Summary shows incorrect average
The average value for good calls and fair calls is incorrect. If you add the data points shown on the graph and average them, the result does not match the average value displayed on the graph.
Workaround:
There is no workaround.
CSCsy58383
Headings not aligned with data in e-mailed reports
Reports that are received and read using e-mail look misaligned. Column headings do not line up with data. This problem occurs when using Outlook 2003.
Workaround:
1.
2.
3.
4.
CSCta07283
No abandoned calls reported
Zero (0) abandoned calls are shown in these default reports:
•
•
and in any report based on the Call Volume monitor type when you select the abandoned calls attribute.
There is no recommended workaround for this problem.
CSCsr62218
Discovery fails with invalid session exception
You trigger discovery and it fails. Service Statistics Manager does not discover Operations Manager because the IP address used in the login registration and the subsequent calls are different. An invalid session exception occurs.
To determine whether this is the case, look in the <Installation Directory>\pw\pronto\logs\ProactiveNet.log file for the following exception:
com.cisco.nm.nbi.cwcs.nbifw.InvalidSessionException
Workaround:
If you find that the invalid session exception occurred, resolve it by doing the following:
1.
2.
SS_CHECKIP=false
3.
From the command prompt, enter this text:
net stop crmdmgtd
Wait 15 minutes.
From the command prompt, enter this text:
net start crmdmgtd
CSCsr21803
Service Statistics Manager stops collecting data
Service Statistics Manager stops collecting data from Operations Manager, Service Monitor, or both. This happens after Operations Manager, Service Monitor, or both are reinstalled to folders that are different from the those in which they were located when Service Statistics Manager performed discovery.
For example, the problem happens as follows:
1.
2.
3.
4.
Workaround:
Edit configuration files and update the path to Operations Manager, Service Monitor, or both on each system as follows:
•
1.
<Service Statistics Manager Installation Directory>\pw\custom\conf\ciscodetails.conf
<Service Statistics Manager Installation Directory>\pw\custom\conf\pnagent.conf
2.
Select Start > Cisco Unified Service Statistics Manager > Stop Server
Select Start > Cisco Unified Service Statistics Manager > Stop Server
•
1.
<SSM Agent Installation Directory>\Agent\custom\conf\ciscodetails.conf
<SSSM Agent Installation Directory>\Agent\custom\conf\pnagent.conf
2.
a.
b.
c.
CSCso85594
Service Statistics Manager no longer accessible if Operations Manager admin user password changes
The problem happens in this scenario:
1.
a.
b.
2.
3.
4.
5.
Workaround:
1.
runjava scripts.ssm.UpdateOMPasswordYou will be prompted to enter and verify a password for the Operations Manager admin user. The admin user password of Operations Manager is updated in the Service Statistics Manager database.
2.
CSCso33613
ApacheCore_dll service errors
After restarting SSM Server, a window pops up repeatedly with this message: "Apache.exe encountered a problem and needs to close."
No functional impacts occur due to this pop-up.
To work around this problem, you can turn off the Windows error reporting feature by doing the following while logged into the Service Statistics Manager server:
1.
2.
3.
4.
5.
6.
7.
Resolved Problems
Table 4 lists problems that are resolved in Service Statistics Manager 1.2.
Table 5 describes additional problems that existed in Service Statistics Manager 1.2 Build ID 207 (available July 2009) and were resolved in Service Statistics Manager 1.2 Build ID 227 (available October 2009).
Note
Ensuring That You Have the Correct Service Statistics Manager Build ID Installed
Table 6 lists Service Statistics Manager 1.2 build IDs.
Table 6 Service Statistics Manager 1.2 Build IDs
207
The problems in Table 5 exist in this build.
227
This build resolves the problems listed inTable 5.
If Service Statistics Manager 1.2 Build ID 207 is installed on your system, you must reinstall Service Statistics Manager 1.2 using build 227.
To determine which build is installed on your system, click the About link in the upper-right corner of the Service Statistics Manager window. The product version and build ID are included in the display.
If Service Statistics Manager 1.2 Build ID 207 is installed on your system, follow the instructions in Obtaining and Installing the Correct Service Statistics Manager 1.2 Build.
Obtaining and Installing the Correct Service Statistics Manager 1.2 Build
If Service Statistics Manager 1.2 Build ID 207 is installed on your server, you must perform the following steps:
1.
2.
3.
Useful Information About Integration with Operations Manager and Service Monitor
Service Statistics Manager relies on information that it stores about Operations Manager and Service Monitor. Changes that you make in Operations Manager and Service Monitor can disrupt Service Statistics Manager functioning. Service Statistics Manager relies on this information:
•
You might change the password for the admin user when you reinstall or upgrade Operations Manager. If you do, no one can log in to Service Statistics Manager. For a workaround to this problem, see bug ID CSCso85594.
•
What to Do when You Receive a Database Table Size Exceeded E-mail
Before performing any tasks in this section, you should contact Cisco TAC for assistance.
After receiving an e-mail alert regarding table sizing (see the explanation for CSCta34541 in Table 3), you should perform the following procedure (with the help of Cisco TAC):
Step 1
Step 2
a.
For example, runjava scripts.PruneEntry -update SSM_CDR_TABLE 360.
changes the prune period (data retention) for SSM_CDR_Table to 360 hours (15 days).
b.
This changes the prune period (data retention) for SSM_CMR_Table to 360 hours (15 days).
Step 3
Pruning might take a few hours to complete, depending on the amount of data to be purged.
Step 4
a.
For example, runjava scripts.PruneEntry -list ssm_cdr_table.
b.
In the tables, look in the MinTimeStamp field. This field lists the time stamp of the oldest data present in the table. If a time exists that is older than the current time, the pruning is not complete.
Step 5
To modify the frequency and reporting period of the report, perform the following commands:
a.
For example, runjava scripts.UpdateReportDetails "Traffic Summary - Day of Month" PERIODID NUM 5.
This sets the reporting period to the last 15 days.
b.
This sets the frequency of the report generation to weekly.
Step 6
Step 7
Following are the settings you might want to change:
•
•
•
•
•
If you change any of these settings, you must run the following command in a command prompt to reload these jserver properties:
pw j r
Documentation Updates
The following information is missing from the online help and the user guide that is available from online help. However, it is present in the documentation on Cisco.com.
User Guide—Chapter 7, Using Administration
The following section was added to the topic Understanding the Default Dial Plan.
How Service Statistics Manager Handles Special Characters in Directory Numbers
The data that Service Statistics Manager receives might include directory numbers that contain special characters. This is how Service Statistics Manager handles directory numbers that contain these special characters:
•
–
–
•
Configuring Service Statistics Manager to Connect with Operations Manager (Updated)
These are the updated instructions for running ConfigureSSMtoSSLOM:
1.
2.
–
–
–
3.
4.
–
–
5.
6.
pw sys start7.
8.
Quick Start Guide
The following updated information is provided wherever instructions for running ConfigureSSMtoSSLOM are provided:
1.
2.
–
–
–
3.
4.
–
–
5.
6.
pw sys start7.
8.
Notices
The following notices pertain to this software license.
OpenSSL/Open SSL Project
This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/).
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).
This product includes software written by Tim Hudson (tjh@cryptsoft.com).
License Issues
The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are BSD-style Open Source licenses. In case of any license issues related to OpenSSL please contact openssl-core@openssl.org.
OpenSSL License:
Copyright © 1998-2007 The OpenSSL Project. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1.
2.
3.
4.
5.
6.
"This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)".
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT "AS IS"' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).
Original SSLeay License:
Copyright © 1995-1998 Eric Young (eay@cryptsoft.com). All rights reserved.
This package is an SSL implementation written by Eric Young (eay@cryptsoft.com).
The implementation was written so as to conform with Netscapes SSL.
This library is free for commercial and non-commercial use as long as the following conditions are adhered to. The following conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com).
Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If this package is used in a product, Eric Young should be given attribution as the author of the parts of the library used. This can be in the form of a textual message at program startup or in documentation (online or textual) provided with the package.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1.
2.
3.
"This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)".
The word `cryptographic' can be left out if the routines from the library being used are not cryptography-related.
4.
THIS SOFTWARE IS PROVIDED BY ERIC YOUNG "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The license and distribution terms for any publicly available version or derivative of this code cannot be changed. i.e. this code cannot simply be copied and put under another distribution license [including the GNU Public License].
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, CCSI, Cisco Eos, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Pulse, Cisco StackPower, Cisco StadiumVision, Cisco TelePresence, Cisco Unified Computing System, Cisco WebEx, DCE, Flip Channels, Flip for Good, Flip Mino, Flipshare (Design), Flip Ultra, Flip Video, Flip Video (Design), Instant Broadband, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn, Cisco Capital, Cisco Capital (Design), Cisco:Financed (Stylized), Cisco Store, and Flip Gift Card are service marks; and Access Registrar, Aironet, AllTouch, 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, Continuum, EtherFast, EtherSwitch, Event Center, Explorer, Fast Step, Follow Me Browsing, FormShare, GainMaker, GigaDrive, HomeLink, iLYNX, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, Laser Link, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerKEY, PowerPanels, PowerTV, PowerTV (Design), PowerVu, Prisma, ProConnect, ROSA, 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. (0908R)
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.
© 2009 Cisco Systems, Inc. All rights reserved.
