Table Of Contents
Release Notes for Cisco Unified
Service Statistics Manager 1.1
Revised: May 21, 2009
Cisco Unified Service Statistics Manager is a product from the Cisco Unified Communications Management Suite. These release notes provide:
The following changes and enhancements are included in Service Statistics Manager 1.1:
•Call categories—You can edit and add call categories.
•New reports for the following devices and data:
–Cisco 1040 sensor-based call quality
–Cisco IOS routers system utilization
–Cisco Unified Contact Center Express (Unified CCE) performance
–Cisco Unity Express (CUE) performance
–H.323 gateway call volume
•Upgrade from Service Statistics Manager 1.0—Data collected using Service Statistics Manager 1.0 is preserved.Table 1 lists some changes to the monitor types.
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 product documentation that is available.
Note The originally published printed and electronic documentation was 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 3 describes the additional documentation that is available.
Table 4 lists problems known to exist in Service Statistics Manager. 1.1. Some known problems occur due to changes made in Operations Manager and Service Monitor system after integration with Service Statistics Manager; these are summarized in Useful Information About Integration with Operations Manager and Service Monitor.
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 4 Known Problems in Service Statistics Manager 1.1
Bug ID Summary Explanation
SSM database server cannot start
If the database process does not start, you can troubleshoot the problem as follows:
1. Restart the SSM server process. If Service Statistics Manager does not function properly after restart, continue to step 2.
2. Check whether the dbsrv process is running by entering the following command:pw process list
The command lists each process and the process status in this format: <process name> <status>. If the dbsrv process is not running, it is displayed as follows:dbsrv !Not Running!
If dbsrv is not running, continue to step 3.
3. Start the dbsrv process by entering this command:pw p r dbsrv
If the database starts successfully, you are done. If the database does not start and you see an error "Assertion failed", the database is probably corrupt and you need to replace it with a backup as directed in step 4.
Note The instructions in the next step explain how to replace the corrupted database with the most recent weekly archive that Service Statistics Manager automatically created.
4. Copy the storm_<hostname>.db and pronto.log files from the <Installation Directory>\pw\dbarchive directory to the <Installation Directory>\pw\sybase directory.
5. Start the SSM server.
Error when starting discovery
When trying to start discovery, the following error is sometimes displayed:
"There was a problem with the request.."
The discovery process, however, completes successfully.
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:
If you find that the invalid session exception occurred, resolve it by doing the following:
1. Log in to the Operations Manager server.
2. Edit the <NMSROOT>\lib\classpath\ss.properties file and set the SS_CHECKIP property to false:
3. Restart the daemon manager as follows:
From the command prompt, enter this text:
net stop crmdmgtd
Wait 15 minutes.
From the command prompt, enter this text:
net start crmdmgtd
System error when generating custom graphs for longer term
When generating a custom graph for more than 25 instances for 1 month, the following error is displayed:
System error !!
Please contact Administrator or try again later.
To work around this problem:
•We recommend that you do either of the following:
–Use custom graphs to generate data for fewer instances or a shorter period of time.
–To generate data for more than 25 instances or for a longer period of time, instead of using custom graphs, use the reports tab.
•You can use custom graphs to generate data for more than 25 instances or for a longer period of time by doing this:
1. Log on to the Service Statistics Manager server.
2. Edit the <Installation Directory>/pw/pronto/conf/pnjserver.conf file and change the value of MaxHeap from 512 to 1024.
3. From the Start menu, stop and start the SSM Server.
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. Operations Manager is located in C:\Program Files\CSCOpx.
2. Service Statistics Manager performs discovery.
3. Operations Manager is reinstalled and, in place of C:\Program Files\CSCOpx, the following destination location is selected: C:\CSCOpx,
4. When polling for new data, the SSM agent continues to use the original path—C:\Program Files\CSCOpx—to look for the Operations Manager files and database.
Edit configuration files and update the path to Operations Manager, Service Monitor, or both on each system as follows:
•On a system where Service Statistics Manager is installed with Operations Manager:
1. Change the paths as needed in both of these files:
<Service Statistics Manager Installation Directory>\pw\custom\conf\ciscodetails.conf
<Service Statistics Manager Installation Directory>\pw\custom\conf\pnagent.conf
2. Restart the server:
Select Start > Cisco Unified Service Statistics Manager > Stop Server
Select Start > Cisco Unified Service Statistics Manager > Stop Server
•On a remote system where SSM Agent is installed:
1. Change the paths as needed in both of these files
<SSM Agent Installation Directory>\Agent\custom\conf\ciscodetails.conf
<SSSM Agent Installation Directory>\Agent\custom\conf\pnagent.conf
2. On a system where SSM Administration Console is installed:
a. Log in to the SSM Administration Console.
b. Expand the Advanced Options and SSM Agent folders.
c. Right-click the IP address for the remote SSM agent and select Restart Agent.
SSM advertises in reserve ports 1099, 1100 for JBoss
When you install or upgrade Service Statistics Manager 1.1 on a server where Operations Manager is running, the installation stops if port 1099 or 1100 are in use.
To prevent this problem, follow the instructions in Installation Guide for Cisco Unified Operations Manager 2.1 and reserve ports 1099 and 1100 before you install or upgrade to Operations Manager 2.1. (Operations Manager 2.1 must be installed before you install or upgrade to Service Statistics Manager 1.1.)
If you completed the installation or upgrade to Operations Manager 2.1 without first reserving ports 1099 and 1100 and now cannot complete the installation or upgrade to Service Statistics Manager 1.1 on the same server, perform the following steps from the command line:
1. Stop Operations Manager by typing this command:net stop crmdmgmt
2. Wait several minutes for Operations Manager processes to stop.
3. Verify that ports 1099 and1100 are free. To check whether a port is free, enter this command:netstat -anb | findstr <portnumber>
If there is no output from the command, the port is free.
4. Depending on the status of the ports, use one of these procedures to complete the installation or upgrade:
If ports are free, install or upgrade to Service Statistics Manager 1.1 and then restart Operations Manager by typing this command:net start crmdmgmt
If port 1099 or port 1100 is in use, perform these steps:
a. Set the Windows service CW2000 Daemon Manager startup type to Manual.
b. Restart the server.
c. Reserve ports 1099 and 1100. (For instructions, see Installation Guide for Cisco Unified Operations Manager 2.1.)
d. Perform the installation or upgrade to Service Statistics Manager 1.1. Let the installation script complete, but do not restart the server until you set the Windows service CW2000 Daemon Manager startup type to Automatic.
Initial polling after midnight can result in No Response from Operations Manager
A gap appears in the data that is displayed for some devices in graphs and reports for the period just after midnight.
This can happen if Service Statistics Manager polls Operations Manager for data between 00:00:00 and 00:04:00, which is while Operations Manager creates one performance polling data file for each device (for the next 24 hours). Normally, Service Statistics Manager polls at 20 minutes before the hour and 10 minutes after the hour and, therefore, the problem does not occur.
The problem can occur when you do something that changes the time at which Service Statistics Manager performs polling, such as the following:
•Retrigger discovery—Polling is suspended during discovery and restarts whenever discovery completes.
•Restart the server manually—Polling restarts after the server starts.
You can do either of the following:
•Wait until Service Statistics Manager performs the weekly restart on Sunday at 8:40am. Polling resumes the desired schedule thereafter.
•Restart the server at 23:40:00 on a regular or as-needed basis.
Note These workarounds are effective when Operations Manager default polling intervals are used. However, you can configure polling intervals separately for each device group in Operations Manager. If a polling interval is configured such that Operations Manager polling for a device group doesn't start or complete by the time Service Statistics Manager starts polling after midnight, performance polling data files for the devices in the group do not yet exist and the error occurs.
Service Statistics Manager no longer accessible if Operations Manager admin user password changes
The problem happens in this scenario:
1. From Service Statistics Manager:
a. Enter a username and password for Operations Manager.
b. Perform discovery.
2. After Service Statistics Manager discovers Operations Manager, change the password for the admin user in Operations Manager.
3. Restart the Service Statistics Manager server.
4. Try to log in to Service Statistics Manager.
5. An error occurs: "Unable to validate CUSSM license information. Please check the OM licensing info..."
1. From the command line on the Service Statistics Manager server, enter this command:runjava scripts.ssm.UpdateOMPassword
You 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. From the Start menu, start and stop SSM Server.
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. Open Control Panel.
2. Click System.
3. Click the Advanced tab.
4. Click the Error Reporting button.
5. Select both the "Disable Error Reporting" radio button and the "But notify me when critical errors occur" check box.
6. Click OK. The window closes.
7. Click OK on the remaining window.
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:
•The username and password for a user with System Administrator and Network Administrator privilege on Operations Manager—The default user admin has these privileges and can be used.
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.
•The installation directory for Operations Manager and for Service Monitor—When you run discovery, Service Statistics Manager stores the directory path for Operations Manager and for Service Monitor. You might change the directory in which Operations Manager or Service Monitor is installed when you reinstall or upgrade Operations Manager or Service Monitor. If you do so, Service Statistics Manager stops collecting data. For a workaround to this problem, see bug ID CSCsr21803.
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:
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, CCSI, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; 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, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, 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. (0903R)
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.
© 2008-2009 Cisco Systems, Inc. All rights reserved.