Configuring Service Monitor

Step 1

Select Configuration > Trap Receivers. The Trap Receiver Parameters page appears.


GUI Element	Description/Action
SNMP Community String	Enter the SNMP community string for each trap receiver.
Trap Receiver n and Port fields (where n is a number from 1 to 4)	Enter up to 4 trap receivers: •Trap Receiver n—Enter the IP address or DNS name of a server. If you want to use Operations Manager to act on and display data from Service Monitor—for example to use the Service Quality Alerts dashboard—specify the IP address for the system with Operations Manager. •Port—Enter the port number on which the receiver listens for SNMP traps. The default is 162; however, a different port might be used for this purpose on this server. When Service Monitor generates SNMP traps, it forwards them to these receivers.

Understanding and Setting Unified Communications Manager Credentials

Service Monitor can obtain and analyze voice data from supported versions of Unified Communications Manager. For Service Monitor to do this, you must:

Add Unified Communications Manager credentials to Service Monitor using the following procedure.

Step 1

Select Configuration > Unified Communications Manager Credentials. The Unified Communications Manager Credentials page displays the information in the following table.


Columns or Buttons	Description/Action
Display Name	The user-specified name entered when credentials were added to Service Monitor.
IP Address	Cluster IP address.
Cluster	Version—Unified Communications Manager software version. ID—ID assigned to the cluster by Unified Communications Manager.
Last Contact Status	Status for these credentials: •HTTP/S •CDR/CDRM DB •Device DB Note The CDRM database resides on Unified Communications Manager 5.x and 6.x systems. Service Monitor should have access to the credentials for this database after providing HTTP/S credentials. One of the following statuses will be displayed for each set of credentials: •Success—If you click this link, you can check when the last successful contact occurred. Note Clicking a status link opens a dialog box with more information, including the last time Service Monitor tried to contact Unified Communications Manager and the last time Service Monitor was successful in making contact. This information might show that Service Monitor is discarding data. Service Monitor discards data when receiving old data from Unified Communications 5.x and later. This can happen after the connection between Service Monitor and Unified Communications Manager is reestablished after a break. Unified Communications Manager first sends older files to Service Monitor. •Verifying—Click the link for more information. •Waiting for Data—Click the link for more information. •Failure—Click the link for more information. Note Service Monitor must be able to resolve the IP address for Unified Communications Manager to the correct name. Verify that DNS parameters are specified correctly on the Service Monitor server and the Unified Communications Manager hostname has been added to DNS or supply the Unified Communications Manager hostname in the credentials. See Supplying the Correct Hostname for Unified Communications Manager Credentials. •Blank—This credential is not required for Service Monitor to obtain information from this version of Unified Communications Manager. For more information, see Understanding Last Contact Status and When to Verify Credentials.
Buttons	•Add—Add credentials for a Unified Communications Manager cluster. See Adding Unified Communications Manager Credentials. •Edit—Edit credentials for a Unified Communications Manager cluster. See Adding Unified Communications Manager Credentials. •Delete—See Deleting Unified Communications Manager Credentials. •Verify—Verify credentials for a selected Unified Communications Manager cluster. •Refresh—Refresh the page.

Supported Unified Communications Manager Versions

For the list of Unified Communications Manager versions that Service Monitor supports, see Release Notes for Cisco Unified Service Monitor 2.0.1.

Adding Unified Communications Manager Credentials

Note For Unified Communications Manager 5.x and 6.x, in addition to adding credentials using the following procedure, you must also provide an SFTP password. See Configuring and Viewing Other Settings.

Step 1

Select Configuration > Unified Communications Manager Credentials. The Unified Communications Manager Credentials page appears.


Field	Description
Display Name	Enter a name—up to 20 characters—to describe the cluster.
Host Name	(Optional) Enter the hostname for the server where Unified Communications Manager is installed. Note Service Monitor must be able to resolve the IP address for Unified Communications Manager to the correct name. If DNS parameters are specified correctly on the Service Monitor server and the Unified Communications Manager hostname has been updated in DNS, you do not need to enter the hostname here. To enter the hostname, see Supplying the Correct Hostname for Unified Communications Manager Credentials.
IP Address	Enter the IP address for appropriate node in the cluster; for this software version: •3.3.x—Enter the IP address for the publisher •4.x—Enter the IP address for the publisher •5.x—Enter the IP address for a publisher or a subscriber •6.x—Enter the IP address for a publisher or a subscriber
Version	Select the software version running on the cluster from these: •CM 3.3.x •CM 4.x •CM 5.x, 6.x Note For more information, see Supported Unified Communications Manager Versions. Depending on the selected software version, you will need to enter one or more usernames and passwords, described in Step 4.

Note

When there are multiple Unified Communications Managers in a cluster, you need only supply credentials for one of them. If you must enter credentials for a specific node in the cluster, such as the publisher, it is specified in the bullet points below the version.

The usernames and passwords that are required vary by Unified Communications Manager version:

–

CDR DB User Name and Password/Re-enter password—Enter the username and password for a Microsoft SQLServer account on the server where Unified Communications Manager publisher is installed. This account must have access to the CDR database and, optionally, to the device database. For more information, see Adding Microsoft SQLServer User Accounts, page B-6.

–

Device DB User Name and Password/Re-enter password—Enter the username and password for a Microsoft SQLServer account on the server where Unified Communications Manager publisher is installed; this account must have access to the device database. For more information, see Adding Microsoft SQLServer User Accounts, page B-6.

Note

The username and password for the CDR database and the device database will be the same if you have configured one Microsoft SQLServer account to access both databases.

–

CDR DB User Name and Password/Re-enter password—Enter the username and password for a Microsoft SQLServer account on the server where Unified Communications Manager publisher is installed; this account must have access to the CDR database. For more information, see Adding Microsoft SQLServer User Accounts, page B-6.

–

HTTP/S User Name and Password/Re-enter password—Enter a username and password that can be used to log in to Unified Communications Manager Administration.

Note

You need only supply this username and password for any one Unified Communications Manager in a cluster.

–

HTTP/S User Name and Password/Re-enter password—Enter a username and password that can be used to log in to Unified Communications Manager Administration.

Note

You need only supply this username and password for any one Unified Communications Manager in a cluster.

Supplying the Correct Hostname for Unified Communications Manager Credentials

To supply a hostname while adding or editing Unified Communications Manager credentials, use the following procedure to obtain the correct name. If you do not have access to Unified Communications Manager Administration, contact a user who can do this and provide the correct name to you.

Step 2

Select System > Server and find the page for the Unified Communications Manager. The name displayed on this page is the one you should enter in the Unified Communications Manager credentials in Service Monitor.

Editing Unified Communications Manager Credentials

Step 1

Select Configuration > Unified Communications Manager Credentials. The Unified Communications Manager Credentials page appears.

Step 2

Select a cluster and click Edit. The Edit Unified Communications Manager dialog box appears.


Field	Description
Display Name	Enter a name—up to 20 characters—to describe the cluster.
Host Name	Hostname for the server where Unified Communications Manager is installed. Note If Service Monitor successfully retrieves the hostname from Unified Communications Manager, it is displayed here, replacing any previously supplied hostname. If the hostname is not displayed here, you must enter it; see Supplying the Correct Hostname for Unified Communications Manager Credentials.
IP Address	This field is grayed out because you cannot edit it.
Version	The software version: •3.3.x •4.x •5.x •6.x Note You cannot change the version by editing.

Step 4

Enter usernames and passwords for the selected Unified Communications Manager version:

–

CDR DB User Name and Password/Re-enter password—Enter the username and password for a Microsoft SQLServer account on the server where Unified Communications Manager is installed. This account must have access to the CDR database and, optionally, to the device database. For more information, see Adding Microsoft SQLServer User Accounts, page B-6.

–

Device DB User Name and Password/Re-enter password—Enter the username and password for a Microsoft SQLServer account on the server where Unified Communications Manager is installed; this account must have access to the device database. For more information, see Adding Microsoft SQLServer User Accounts, page B-6.

Note

The username and password for the CDR database and the device database will be the same if you have configured one Microsoft SQLServer account to access both databases.

–

CDR DB User Name and Password/Re-enter password—Enter the username and password for a Microsoft SQLServer account on the server where Unified Communications Manager is installed; this account must have access to the CDR database. For more information, see Adding Microsoft SQLServer User Accounts, page B-6.

–

HTTP/S User Name and Password/Re-enter password—Enter a username and password that can be used to log in to Unified Communications Manager Administration.

–

HTTP/S User Name and Password/Re-enter password—Enter a username and password that can be used to log in to Unified Communications Manager Administration.

Understanding Last Contact Status and When to Verify Credentials

Service Monitor needs one or more credentials to obtain Unified Communications Manager data successfully. The Unified Communications Manager Credentials page displays the status of the last contact between Service Monitor and Unified Communications Managers.

In a few cases, you might need to correct credentials on Unified Communications Manager and then verify the credentials from Service Monitor:

•

When the last contact status is Success, in some cases, Service Monitor might not be receiving data, but simply waiting to receive data. To see when the last successful contact occurred, click the status link. If the last contact was not recent, correct any problem with credentials on Unified Communications Manager and verify the credentials from Service Monitor.

•

Credentials that Service Monitor relies upon might change on Unified Communications Manager platform. If this happens, check with your Unified Communications Manager administrator to obtain the correct credentials. If necessary, update the credentials in Service Monitor. Otherwise, verify the credentials.

Note To determine whether known problems have been identified that could prevent successful data exchange between a cluster and Service Monitor, see Release Notes for Cisco Unified Service Monitor 2.0.1.

Step 1

Select Configuration > Unified Communications Manager Credentials. The Unified Communications Manager Credentials page appears.

Step 2

Select the Unified Communications Manager for which you want to verify credentials.

Deleting Unified Communications Manager Credentials

After you complete this procedure, Service Monitor can no longer obtain voice quality transmission data for the related cluster. Additionally, the cluster will no longer appears on the Monitored Phones page. Call data for the cluster remains in the database until it is purged. For more information, see Maintaining the Service Monitor Database, page 6-1.

Step 1

Select Configuration > Unified Communications Manager Credentials. The Unified Communications Manager Credentials page appears.

•

An error message appears, displaying a list of CVTQ threshold groups to which the cluster belongs. You will need to remove the cluster from these CVTQ threshold groups and repeat this procedure.

Selecting Sensors and Clusters to Monitor

On the Monitored Phones page, you can view the total number of phones that Service Monitor is monitoring. You can also view the names of all sensors and Unified Communications Manager clusters known to Service Monitor, see whether each is monitored, and, if so, see the number of phones that Service Monitor manages in the cluster or for the sensor.

Note Because it is possible for a Unified Communications Manager cluster and a sensor to report MOS for some of the same phones:

•

The total known phone count displayed on the Monitored Phones page might be less than the sum of known phone counts for clusters/sensors.

•

To decrease the total known phone count, you might need to suspend more than one cluster or sensor.

Step 1

Select Configuration > Monitored Phones. The Monitored Phones page appears, displaying the information in the following table.


GUI Element	Description
Total known phone count: (n)	Number of phones that Service Monitor is monitoring. If the number of phones equals the license size, the following message is displayed in red: `Total known phone count (n) has reached or exceeded licensed limit!` For more information, see Determining License Size Exceeded.
License limit: (n)	Number of phones allowed by license.
Cluster/Sensor List
Cluster/Sensor ID column	One of the following: •Cluster ID—The cluster ID is assigned by Unified Communications Manager. •Sensor ID—Sensor MAC address.
Version column	Software version of Unified Communications Manager.
Type	One of the following: •Cluster •Sensor
State column	One of these: •Monitored—Service Monitor is collecting and analyzing data from this cluster or sensor and sending traps when violations occur. •Suspended—Service Monitor is not collecting and analyzing data from this cluster or sensor for one of these reasons: –A user set the state of the cluster or sensor to Suspended. See Suspending and Resuming a Cluster or Sensor from Monitoring. –Service Monitor could not monitor any more newly created clusters or phones when data was received because the phone license count was reached.
State column	One of these: •Monitored—Service Monitor is collecting and analyzing data from this cluster or sensor and sending traps when violations occur. •Suspended—Service Monitor is not collecting and analyzing data from this cluster or sensor for one of these reasons: –A user set the state of the cluster or sensor to Suspended. See Suspending and Resuming a Cluster or Sensor from Monitoring. –Service Monitor could not monitor any more newly created clusters or phones when data was received because the phone license count was reached.

Suspending and Resuming a Cluster or Sensor from Monitoring

Provided that Unified Communications Manager is configured properly and Service Monitor license limits are not exceeded, Service Monitor starts to monitor a cluster when it learns of the cluster. Service Monitor learns of a cluster when you add Unified Communications Manager credentials to Service Monitor. (For more information, see Adding Unified Communications Manager Credentials.)

If you want to suspend a cluster or a sensor from monitoring—for example, to enable you to monitor phones from a different cluster or sensor—you can do so.

Suspending a Cluster or Sensor

•

Data for the suspended cluster or sensor no longer appears in Service Monitor reports.

•

The cluster or sensor appears on the Monitored Phones page as Suspended and the known phone count for that cluster or sensor drops to zero (0). If, as a result, the total known phone count also decreases, you are free to monitor additional phones in other clusters or from other sensors (up to your license limit).

Step 2

Select the check box for the cluster or sensor that you want to suspend.

Resuming a Cluster or Sensor

Step 2

Select the check box for a suspended cluster or sensor that you want to monitor.

Updating the Total Known Phone Count for a Cluster

Service Monitor monitors the first n phones that it finds in the data that it receives or obtains from the clusters. If a phone in a cluster fails and is replaced, Service Monitor is not notified and continues to include the failed phone in the total known phone count. To refresh the total known phone count for a cluster, suspend the cluster and resume it.

Note Suspending a cluster resets the phone count to zero for that cluster. The phone count then increases as and when calls come from a phone.

Configuring Number of Endpoints and Export Settings for Impacted Endpoints Reports

•

The number of endpoints to be included in CVTQ and sensor most-impacted endpoint reports no matter when they run—daily, weekly, or on demand.

•

The most-impacted endpoints reports to export—CVTQ or sensor or both. Most-impacted endpoint reports can run daily and weekly, exporting the results to a comma-separated values file (CSV) or a portable document format (PDF) file. You can save the reports on the server and, optionally, automatically send them through e-mail.

Note The maximum number of records that can be exported to a PDF file is 2,000. The maximum number of records that you can export to CSV is configurable; the default is 30,000 with an upper limit of 64,000 records. For more information, see Configuring Diagnostic Report Search and CSV Export Limit Settings.

Step 1

Select Configuration > Export Settings. The Export Settings (for Most Impacted Endpoint) page appears, displaying the information described in the following table.


GUI Element	Description/Action
Number of Endpoints field	Enter the number of endpoints that you want to see on all—exported or directly launched—most-impacted endpoints reports.
Daily at 1:00 AM check boxes	To generate the report every day, select at least one of the following: •CSV check box—Save the report in CSV format. •PDF check box—Save the report in PDF format. If neither is selected, Service Monitor does not generate the reports.
Weekly at 1:00 AM Monday check boxes	To generate the report every week, select at least one of the following: •CSV check box—Save the report in CSV format. •PDF check box—Save the report in PDF format. If neither is selected, Service Monitor does not generate the reports.
Report Type	Select at least one of the following: •Sensor •CVTQ Note Separate reports are generated for sensor and CVTQ data. For report filenames, see Table 3-1.
Save at	Enter a location for storing the reports on the server where Service Monitor is installed; a default location is displayed.
E-mail to	(Optional) Enter one or more complete e-mail addresses separated by commas.
SMTP Server	(Optional) Enter an SMTP server.

Depending on the reports and formats that you have selected, the following reports will be generated.

Table 3-1 Most-Impacted Endpoints Exported Reports
Report Type	When Generated	Report Filenames
CVTQ	Daily	CVTQ_Daily_ddmmyyyy.csv
	Daily	CVTQ_Daily_ddmmyyyy.pdf
	Weekly Note Generated on Monday.	CVTQ_Weekly_ddmmyyyy.csv
	Weekly Note Generated on Monday.	CVTQ_Weekly_ddmmyyyy.pdf
Sensors	Daily	Sensor_Daily_ddmmyyyy.csv
	Daily	Sensor_Daily_ddmmyyyy.pdf
	Weekly Note Generated on Monday.	Sensor_Weekly_ddmmyyyy.csv
	Weekly Note Generated on Monday.	Sensor_Weekly_ddmmyyyy.pdf

Configuring and Viewing Other Settings

•

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:


Fields	Description/Action
Low-Volume Schedule Hours
<day> <timerange>; <timerange> For example: Mon 0-6; 22-24	For each day of the week, timerange indicates the hours during which Service Monitor processes fewer records, handling a number that is roughly 20% of records processed during a peak period. During the low-volume schedule, Service Monitor performs database maintenance. Note A windows user with access to the Service Monitor server can configure this schedule. See Configuring Low-Volume Schedule and Database Purging, page 6-1.
Miscellaneous
Data Retention Period	Number of days that data is retained in the Service Monitor database before being purged. The default value depends on the configuration: •Service Monitor alone on a server—7 days. •Service Monitor and Operations Manager on a server—3 days. On the Service Monitor server, a user can change the value of the data-retention-days property in the NMSROOT\qovr\qovrconfig.properties file. (NMSROOT is the location where Service Monitor is installed. If you used the default location, it is C:\Program Files\CSCOpx.) To put changes into effect after you edit qovrconfig.properties, you must stop and start the QOVR process. While logged on to the the server where Service Monitor is installed, from the command line, enter these commands: `pdterm QOVR` `pdexec QOVR` Note Before changing the value of the data-retention-days property, be sure to read the recommendations for the appropriate settings for your configuration in Deployment Guide for Cisco Unified Service Monitor on Cisco.com.
Wait for Diagnostic Report	Number of minutes that Service Monitor continues to search—when there is a large volumn of data—before displaying the matching records found so far for a diagnostic report (a Cisco 1040 Sensor report or a CVTQ report). To configure this setting, see Configuring Diagnostic Report Search and CSV Export Limit Settings.
SFTP
Username	You cannot change the username from smuser. This same username, smuser, must be configured in Unified Communications Manager. See Adding Service Monitor to Unified Communications Manager 5.x (or 6.x) as a Billing Server, page B-4.
Change password check box	Select to change password. Caution The default password is smuser. If you change the password here, you must also change the password for smuser in Unified Communications Manager. See Adding Service Monitor to Unified Communications Manager 5.x (or 6.x) as a Billing Server, page B-4.
Password	Enter password.
Re-enter password	Re-enter password.

Configuring Diagnostic Report Search and CSV Export Limit Settings

Table 3-2 lists properties that affect diagnostic reports. A windows user with access to the Service Monitor server can change the values of these properties in the NMSROOT\qovr\qovrconfig.properties file.

Table 3-2 Diagnostic Report and Export Settings
Property	Description and Limit
WaitForDiagReport	Number of minutes that Service Monitor continues to search—when there is a large volumn of data—before displaying the matching records found so far for a diagnostic report (a Cisco 1040 Sensor report or a CVTQ report). Default: 2. Maximum: 4. Note Service Monitor reports can display up to 2,000 records. To see additional records, you can export a diagnostic report to a CSV file.
ExportCSVLimit	Number of records that Service Monitor exports to a CSV file. Default: 30000. Maximum: 64000—This is approximately the maximum number of records that can be included in a CSV file that Excel can open.

Note There are additional configurable properties in the qovrconfig.properties file. Before setting the data-retentions-days property, see recommendations for your configuration in Deployment Guide for Cisco Unified Service Monitor on Cisco.com. For information on other settings, see Configuring Low-Volume Schedule and Database Purging, page 6-1.

After you edit qovrconfig.properties, to put changes into effect, you must stop and start the QOVR process. While logged on to the the server where Service Monitor is installed, from the command line, enter these commands:

Table Of Contents