User Guide for Cisco Unified Operations Manager 2.1
Using Synthetic Tests
Downloads: This chapterpdf (PDF - 286.0KB) The complete bookPDF (PDF - 11.8MB) | Feedback

Using Synthetic Tests

Table Of Contents

Using Synthetic Tests

Getting Started with Synthetic Tests

Configuring Synthetic Tests

Configuring Applications for Synthetic Tests

Determining How Many Phones You Need

Configuring Phones

Meeting the Requirements for Target Phones

Recording Phone Extension Numbers on a Worksheet

Maintaining Synthetic Tests

Creating Synthetic Tests

Creating a Phone Registration Test

Creating Dial-Tone Synthetic Tests

Creating an End-to-End Call Synthetic Test

Creating a TFTP Download Synthetic Test

Creating a Cisco Conference Connection Synthetic Test

Creating an Emergency Call Synthetic Test

Creating a Message-Waiting Indicator Synthetic Test

Importing Synthetic Tests

Formatting Synthetic Test Import Files

Exporting Synthetic Tests

Editing Synthetic Tests

Viewing Synthetic Test Details

Starting and Stopping Synthetic Tests

Deleting Synthetic Tests

Viewing Synthetic Test Results

Scheduling Synthetic Tests

Synthetic Test Notes

Synthetic Test Worksheets


Using Synthetic Tests



Note If you do not have the required software license, you will not be able to use synthetic tests.


Synthetic tests are tests that you configure to run periodically. They use voice applications as other devices (phones) normally would, and analyze the behavior of the system. Cisco Unified Operations Manager (Operations Manager) can monitor the information returned from the synthetic tests and generate events based on the results.

The following topics are covered:

Getting Started with Synthetic Tests

Configuring Synthetic Tests

Configuring Applications for Synthetic Tests

Maintaining Synthetic Tests

Scheduling Synthetic Tests

Synthetic Test Notes

Synthetic Test Worksheets

Getting Started with Synthetic Tests

Synthetic tests are used to measure the availability of voice applications. Synthetic tests verify whether the voice application can service requests from a user. For example, you can use synthetic tests to verify that phones can register with a Cisco Unified Communications Manager.

Synthetic tests use synthetic phones to measure the availability of voice applications by emulating your actions. For example, a synthetic test places a call between clusters and then checks to see if the call is successful.

If a synthetic test fails, Operations Manager generates a critical event. Such events are displayed in the Alerts and Events display (see Monitoring Alerts and Events, page 3-1).

Operations Manager supports synthetic testing for the following applications:

Cisco Unified Communications Manager and Cisco Unified Communications Manager Express

Cisco TFTP Server

Cisco Emergency Responder

Cisco Conference Connection

Cisco Unity, Cisco Unity Express, and Cisco Unity Connection

Table 9-1 lists the synthetic tests and the results that each test must produce to pass.


Note The phones in all scheduled synthetic tests, except for Phone Registration, remain registered unless there is a failure.


Table 9-1 Synthetic Test Descriptions and Expected Results 

Synthetic Test
Description
Expected Results

Phone Registration Test

Opens a connection with the Cisco Unified Communications Manager and registers a simulated IP phone.

Successful registration of the phone.

Dial-Tone Test

Simulates an off-hook state to the Cisco Unified Communications Manager and checks for receipt of a dial tone.

Receives a dial tone signal from the Cisco Unified Communications Manager.

End-to-End Call Test

Initiates a call to a second simulated or real IP phone.

Registers, goes off-hook, and places the call

Ring indication

Destination phone goes off-hook to accept the call

Note If call progress tones and announcements are configured on the gateway for your end-to-end call, the test may succeed even before the phone rings or after a couple of rings. This indicates that your gateway is working correctly.

TFTP Download Test

Performs a TFTP get-file operation on the TFTP server.

Successful download of a configuration file from the TFTP server.

Emergency Call Test

Initiates a call to the emergency number to test the dynamic routing of emergency calls.

All calls initiated

Ring indication on Public Safety Answering Point (PSAP) and On Site Alert Number (OSAN), if configured.

Cisco Conference Connection Test

Creates a conference (meeting) in the Conference Center and connects to the meeting.

Conference created with the specified meeting ID

Call initiated

First person and second person (if configured) successfully connect to the conference

Message-Waiting Indicator Test

Calls the target phone and leaves a voice message in the voice mailbox.


Tip The destination phone for the Message-Waiting Indicator Test should be configured as Call Forward after X number of rings before moving to voicemail. If it is configured for Call Forward Always, the test will fail.


Activation of the phone's message-waiting indicator. The message is then deleted and the message-waiting indicator is deactivated.


Configuring Synthetic Tests


Step 1 Configure the phones that you will use to run synthetic tests, following the recommendations in Configuring Applications for Synthetic Tests.

Step 2 Configure the synthetic tests, following the instructions in Creating Synthetic Tests.


Configuring Applications for Synthetic Tests

You can configure synthetic tests for each Cisco Unified Communications Manager and Cisco voice application in your network. For each synthetic test, you must configure one or more phones in the related Cisco Unified Communications Manager or Cisco voice application.


Caution Only Cisco 7960 IP Phones are supported for synthetic tests.

When configuring phones:

Create one phone extension number and one MAC address for each test and use it for that test only.

Make sure that the combination of the phone extension number and the MAC address used in a test is unique across the voice cluster.


Caution Failure to follow these recommendations may result in synthetic test failures.

Before you configure phones, work through Determining How Many Phones You Need to estimate how many phones you will need based on the tests you want to run.

As you configure phones on each Cisco Unified Communications Manager, use the worksheet in Synthetic Test Worksheets to simplify data entry into Operations Manager.

Determining How Many Phones You Need

The number of phones you must create in a Cisco Unified Communications Manager for use in synthetic tests depends on:

The number of synthetic tests you want to configure

The type of tests you want to run

Table 9-2 provides a worksheet for determining how many phones you need.

Table 9-2 Number of Phones Required for Synthetic Tests 

Number of Tests
Type of Test
Phones Needed for Test
Total Phones Needed
 

Phone Registration

1 (synthetic phone)

 
 

Dial-Tone

1 (synthetic phone)

 
 

End-to-End Call with real phones

2 (1 synthetic phone and 1 real phone)

 
 

End-to-End Call with synthetic phones

2 (synthetic phones)

 
 

TFTP Download

0

 
 

Emergency Call (without On Site Alert Number)

2 (synthetic phones)

 
 

Emergency Call (with On Site Alert Number)

3 (synthetic phones)

 
 

Cisco Conference Connection

2 (synthetic phones)

 
 

Message-Waiting Indicator

2 (synthetic phones)

 

Configuring Phones

When you configure phones in a Cisco Unified Communications Manager, you must consider the requirements listed in Meeting the Requirements for Target Phones and record the phone information as you enter it. A sample worksheet is provided in Synthetic Test Worksheets.

Meeting the Requirements for Target Phones

For the following synthetic tests, there are special requirements for the target phones:

Message-Waiting Indicator Test—When creating the subscriber on Cisco Unity that you are going to use for synthetic testing, configure the subscriber according to the following:

The Set subscriber for self-enrollment at next login check box must be deselected, or you must use a real phone to dial into the Cisco Unity device and complete the personalization process.

Set the password option to Password never expires.

The destination phone for the Message-Waiting Indicator Test should be configured as CALL FORWARD after X number of rings before moving to voicemail. If it is configured for CALL FORWARD ALWAYS, the test will fail.

Emergency Call Test—The outgoing PSAP must use a local phone (not 911). Also, for the OSAN, use a synthetic phone only (do not use your local onsite security phone).

Cisco Conference Connection Test—For Cisco Unified Communications Manager Release 4.0, when you are configuring a route pattern in Cisco Unified Communications Manager to connect to Cisco Conference Connection, you must select the Allow overlap sending option.

Recording Phone Extension Numbers on a Worksheet

As you configure phones, record them on a worksheet similar to those in Table 9-11 through Table 9-14. Use the worksheet that is appropriate for the synthetic test you are configuring.


Note Do not use phone extension numbers that consist of more than twelve digits.


Use a copy of the worksheets to record:

Cisco Unified Communications Manager—You can obtain a list of Cisco Unified Communications Managers from the Create Synthetic Test page. For instructions on opening the Create Synthetic Test page, see Maintaining Synthetic Tests.

Phone extension numbers and MAC addresses—Record the phone extension numbers and MAC addresses you plan to use.

Passwords and usernames—Record the passwords and usernames you plan to use.

Maintaining Synthetic Tests

The Synthetic Tests page lists any synthetic tests that have been set up. To open the Synthetic Tests page, select Diagnostics > Synthetic Tests.


Note If you do not have the required software license, you will not be able to use synthetic tests. The Diagnostic tab will not appear in Operations Manager.


These topics explain how to use the Synthetic Tests page:

Creating Synthetic Tests

Importing Synthetic Tests

Exporting Synthetic Tests

Editing Synthetic Tests

Viewing Synthetic Test Details

Starting and Stopping Synthetic Tests

Deleting Synthetic Tests

Viewing Synthetic Test Results

Figure 9-1 shows an example of the Synthetic Tests page.

Figure 9-1 Synthetic Tests Page

Heading
Description

Test Name

The name provided by the user.

Test Type

The type of synthetic test that is configured.

Voice Application

The IP address of the server where the application is located.

Status

Test status.

Other Details

Any notes.


Creating Synthetic Tests

Before creating synthetic tests, you must configure phones, following the recommendations in Configuring Applications for Synthetic Tests. When you create synthetic tests, use the worksheet recommended in Configuring Phones to assist you in entering the correct data.


Note If you do not have the required software license, you will not be able to use synthetic tests.



Note Do not create more than 100 end-to-end call tests that run at one-minute intervals. Configure additional end-to-end call tests to run at various intervals other than one minute.


You can also set up synthetic tests from the Service Level View (see Setting Up Synthetic Tests, page 2-27), as well as from the Launch tools menu that is located on the Detailed Device View and Alert Details page.

The following sections describe the steps for creating synthetic tests:

Creating a Phone Registration Test

Creating an End-to-End Call Synthetic Test

Creating a TFTP Download Synthetic Test

Creating a Cisco Conference Connection Synthetic Test

Creating an Emergency Call Synthetic Test

Creating a Message-Waiting Indicator Synthetic Test

Creating a Phone Registration Test

You can only configure one Phone Registration test per Cisco Unified Communications Manager.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Create. The Create Synthetic Test page appears.

Step 3 From the Test Type pull-down menu, select Phone Registration Test.

Step 4 From the group selector in the left pane, select the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system for which you want to set up the test.

Step 5 Click the arrow button next to the Cisco Unified Communications Manager/Express field to enter the name or IP address of the selected device.

Step 6 Enter the synthetic phone's MAC address. If you used the group selector to choose the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system, the MAC address field is automatically populated.


Note The MAC address for synthetic phones must be between 00059a3b7700 and 00059a3b8aff and must be in the format 00059a3b7700.


Step 7 Select a protocol type.

Step 8 Select a parameter type:

If you select Extension, enter the extension for the phone.

If you select SIP URI, enter the SIP Uniform Resource Identifier (SIP URI).


Note The SIP URI should be in the format sip:extn@ccm; for example, sip:7690@ct-sd.cisco.com.


Step 9 Select a criteria for success, either Registration Success or Registration Failure.

Step 10 If desired, you can change the registration time threshold setting (default is 2000 milliseconds).


Note The phone registration threshold measures the time that it takes for a phone (SIP or SCCP phone) to register with a Cisco Unified Communications Manager. If the threshold is exceeded, a warning event is generated.


Step 11 In the Run pane configure when the test should run.

If you want the test to run immediately, select the now radio button.

If you want to schedule the test to run at certain intervals, do the following:

Select the every radio button.

Choose how often you want the test to run.

Enter the times between which you want the test to run.

Select the days on which the test should run.

Enter a test name.

Step 12 Click Create.


Creating Dial-Tone Synthetic Tests

You can configure only one dial-tone test per Cisco Unified Communications Manager.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Create. The Create Synthetic Test page appears.

Step 3 From the Test Type pull-down menu, select Dial-Tone Test.

Step 4 From the group selector in the left pane, select the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system for which you want to set up the test.

Step 5 Click the arrow button next to the Cisco Unified Communications Manager/Express field to enter the name or IP address of the selected device.

Step 6 Enter the synthetic phone's MAC address. If you used the group selector to choose the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system, the MAC address field is automatically populated.


Note The MAC address for synthetic phones must be between 00059a3b7700 and 00059a3b8aff and must be in the format 00059a3b7700.


Step 7 If desired, you can change the dial-tone time threshold setting (default is 500 milliseconds).


Note The dial-tone time threshold measures the time between when an SCCP phone goes offhook to when it receives a dial tone from Cisco Unified Communications Manager. If the threshold is exceeded, a warning event is generated.


Step 8 In the Run pane configure when the test should run.

If you want the test to run immediately, select the now radio button.

If you want to schedule the test to run at certain intervals, do the following:

Select the every radio button.

Choose how often you want the test to run.

Enter the times between which you want the test to run.

Select the days on which the test should run.

Enter a test name.

Step 9 Click Create.


Creating an End-to-End Call Synthetic Test

You have the option of configuring the target phone as a real phone or a synthetic phone. The default setting is a synthetic phone.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Create. The Create Synthetic Test page appears.

Step 3 From the Test Type pull-down menu, select End-to-End Call Test.

Step 4 In the Caller pane, do the following:

Enter the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


Enter the synthetic phone's MAC address. If you used the group selector to choose the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system, the MAC address field is automatically populated.


Note The MAC address for synthetic phones must be between 00059a3b7700 and 00059a3b8aff and must be in the format 00059a3b7700.


Select a protocol type.

Select a parameter type:

If you select Extension, enter the extension for the phone.

If you select SIP URI, enter the SIP Uniform Resource Identifier (SIP URI).


Note The SIP URI should be in the format sip:extn@ccm; for example, sip:7690@ct-sd.cisco.com.


Step 5 In the Recipient pane, do the following:

Select either the Synthetic Phone or Real Phone radio button.

Enter the name or IP address of the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


Enter the phone's MAC address.

Select a protocol type (if you selected the Real Phone radio button, this option is grayed out).

Select a parameter type (if you selected the Real Phone radio button, this option is grayed out): If you select Extension, enter the extension for the phone. If you select SIP URI, enter the URI.


Note The Parameters area is grayed out when Synthetic Phone is selected.


Step 6 In the Parameters pane, do the following:

(Optional) Select Wait for Answer. If you selected the Synthetic Phone radio button, this option is grayed out.

(Optional) Select Enable RTP transmission. If you selected the Synthetic Phone radio button, this option is grayed out.

Choose a criterion for success, either Call Success or Call Failure.

If desired, you can change the call setup time threshold setting (default is 10000 milliseconds).


Note The call setup time threshold measures the time between when you are done dialing the number to when the Cisco Unified Communications Manager sets up the call (using SIP or SCCP phones). If the threshold is exceeded, a warning event is generated.


Step 7 In the Run pane configure when the test should run.

If you want the test to run immediately, select the now radio button.

If you want to schedule the test to run at certain intervals, do the following:

Select the every radio button.

Choose how often you want the test to run.

Enter the times between which you want the test to run.

Select the days on which the test should run.

Enter a test name.


Note Do not create more than 100 end-to-end call tests that run at 1-minute intervals. Configure any additional end-to-end call tests to run at various intervals greater than 1 minute.


Step 8 Click Create.


Creating a TFTP Download Synthetic Test

You can configure only one TFTP download test for each Cisco Unified Communications Manager.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Create. The Create Synthetic Test page appears.

Step 3 From the Test Type pull-down menu, select TFTP Download Test.

Step 4 From the group selector in the left pane, select the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system for which you want to set up the test.

Step 5 Click the arrow button next to the TFTP Server field, to enter the name or IP address of the selected device.

Step 6 In the Run pane configure when the test should run.

If you want the test to run immediately, select the now radio button.

If you want to schedule the test to run at certain intervals, do the following:

Select the every radio button.

Choose how often you want the test to run.

Enter the times between which you want the test to run.

Select the days on which the test should run.

Enter a test name.

Step 7 Click Create.


Creating a Cisco Conference Connection Synthetic Test

You can configure only one Cisco Conference Connection test for each Cisco Conference Connection Server.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Create. The Create Synthetic Test page appears.

Step 3 From the Test Type pull-down menu, select Cisco Conference Connection Test.

Step 4 In the CCC Parameters pane, enter the following:

Cisco Conference Connection server name or IP address.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Conference Connection field.


Username.

Password.

Meeting ID.

Access Number (route pattern between the Cisco Unified Communications Manager and the Cisco Conference Connection server).

Step 5 In the First Caller pane, enter the following:

a. The Cisco Unified Communications Manager where Cisco Conference Connection is configured.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


b. The phone's MAC address. Use the format 00059a3b7700. If you used the group selector to choose the Cisco Unified Communications Manager, the MAC address field is automatically populated.


Note The MAC address for synthetic phones must be between 00059a3b7700 and 00059a3b8aff and must be in the format 00059a3b7700. Operations Manager verifies only that the MAC address number entered in the Create Synthetic Test page is syntactically valid. It is your responsibility to make sure the correct numbers are entered, as configured in the Cisco Unified Communications Manager.


Step 6 In the Second Caller pane, enter the following:

a. The name or IP address of the Cisco Unified Communications Manager where Cisco Conference Connection is configured.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


b. The phone's MAC address. Use the format 00059a3b7700.

Step 7 In the Run pane configure when the test should run.

If you want the test to run immediately, select the now radio button.

If you want to schedule the test to run at certain intervals, do the following:

Select the every radio button.

Choose how often you want the test to run.

Enter the times between which you want the test to run.

Select the days on which the test should run.

Enter a test name.

Step 8 Click Create.


Creating an Emergency Call Synthetic Test

The Emergency Call synthetic test is supported only on Cisco Emergency Responder Release 1.2.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Create. The Create Synthetic Test page appears.

Step 3 From the Test Type pull-down menu, select Emergency Call Test.

Step 4 In the CER Parameters pane, enter the following:

The name or IP address of the system where Cisco Emergency Responder is installed.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Emergency Responder field.


Emergency phone number.

Step 5 In the Caller pane, enter the following:

The name or IP address of the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express for the caller's phone.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


The synthetic phone's MAC address. If you used the group selector to choose the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system, the MAC address field is automatically populated.


Note The MAC address for synthetic phones must be between 00059a3b7700 and 00059a3b8aff and must be in the format 00059a3b7700. Operations Manager verifies only that the MAC address number entered in the Create Synthetic Test page is syntactically valid. It is your responsibility to make sure the correct numbers are entered, as configured in the Cisco Unified Communications Manager.


Step 6 In the PSAP pane, enter the following:

The Public Safety Answering Point (PSAP) Cisco Unified Communications Manager or Cisco Unified Communications Manager Express.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


The PSAP phone's MAC address.

Step 7 (Optional) If there is an On Site Alert Number (OSAN), select the On Site Alert Number check box, and enter the following in the OSAN pane:

The name or IP address of the OSAN Cisco Unified Communications Manager or Cisco Unified Communications Manager Express.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


The OSAN phone's MAC address.

Step 8 In the Run pane configure when the test should run.

If you want the test to run immediately, select the now radio button.

If you want to schedule the test to run at certain intervals, do the following:

Select the every radio button.

Choose how often you want the test to run.

Enter the times between which you want the test to run.

Select the days on which the test should run.

Enter a test name.

Step 9 Click Create.


Creating a Message-Waiting Indicator Synthetic Test

Ensure that


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Create. The Create Synthetic Test page appears.

Step 3 From the Test Type pull-down menu, select Message-Waiting Indicator Test.

Step 4 In the Unity Parameters pane, enter a Cisco Unity, Cisco Unity Express, or Cisco Unity Connection system for which you want to set up the test.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unity/Unity Express/Unity Connection field.


Step 5 In the Caller pane, enter the following:

The name or IP address of the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express for the caller's phone.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


The synthetic phone's MAC address. If you used the group selector to choose the Cisco Unified Communications Manager or Cisco Unified Communications Manager Express system, the MAC address field is automatically populated.


Note The MAC address for synthetic phones must be between 00059a3b7700 and 00059a3b8aff and must be in the format 00059a3b7700. Operations Manager verifies only that the MAC address number entered in the Create Synthetic Test page is syntactically valid. It is your responsibility to make sure the correct numbers are entered, as configured in the Cisco Unified Communications Manager.


Step 6 In the Recipient pane, enter the following:

The name or IP address of the recipient Cisco Unified Communications Manager or Cisco Unified Communications Manager Express.


Note You can use the group selector in the left pane to enter a device: Select the device in the group selector, and then click the arrow button next to the Cisco Unified Communications Manager/Express field.


The phone's MAC address.

The phone's extension number.

The voice mail password.


Note Ensure that you do not use the Call Forward All option on this phone or the test will fail. Instead, use the Forward No Answer to Voicemail option for the configuration of the recipient Cisco Unified Communications Manager or Cisco Unified Communications Manager Express.


Step 7 In the Run pane configure when the test should run.

If you want the test to run immediately, select the now radio button.

If you want to schedule the test to run at certain intervals, do the following:

Select the every radio button.

Choose how often you want the test to run.

Enter the times between which you want the test to run.

Select the days on which the test should run.

Enter a test name.

Step 8 Click Create.



Tip After you perform a Cisco Unified Communications Manager version upgrade, Cisco Unity synthetic tests that use the Cisco Unified Communications Manager that you upgraded might stop working. If this problem occurs, you should delete the Cisco Unity synthetic test, and then add the synthetic test again.


Importing Synthetic Tests

You can import multiple synthetic tests at one time by using a comma-separated values (CSV) file.

Before You Begin

Verify that your seed file is formatted correctly. For details, see Formatting Synthetic Test Import Files.

Place the seed file on the server, in the NMSROOT\ImportFiles directory. If you do not have access to the directory, contact a local administrator for the server where Operations Manager is installed.


Note NMSROOT is the directory where Operations Manager is installed on your system. If you selected the default directory during installation, it can be entered as "C:\Program Files\CSCOpx" or C:\PROGRA~1\CSCOpx.



Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.


Note If you do not have the required software license, you will not be able to use Synthetic tests. The Diagnostic tab will not appear in Operations Manager.


Step 2 Click Import. The Import Synthetic Test page appears.

Step 3 Enter the name of the seed file in the Filename field and click OK.


Formatting Synthetic Test Import Files

You can find an example of an import file in the <NMSROOT>\Importfiles folder.


Note NMSROOT is the directory where Operations Manager is installed on your system. If you selected the default directory during installation, it can be entered as "C:\Program Files\CSCOpx" or C:\PROGRA~1\CSCOpx.


The general format for a synthetic test seed file is as follows:

If you create the import file manually, the import file header should be:

Cisco Systems synthetic test import, version=2.0;type=CSV;source=manual

All values must be separated with a vertical bar (|).

The schedule column must use the following formatting:

MONTH,DAYSOFMONTH,DAYSOFWEEK,HOUR,MINUTE

Month—0-11

Day of month—1-31

Day of week—0-6 (0 = sunday)

Hour—0-23

Minute—0-59

Each specifier can be a number, a range, comma-separated numbers and a range, or an asterisk.

Month and days of the month fields cannot be changed. You should enter an asterisk (*).

Day of week can have an asterisk to represent all days, or it can have a comma-separated list of days. For Hour, you can enter an asterisk to represent 24 hours, or you can enter a range. Minute can be an asterisk, to represent all, or it can be a range.

Only the following schedule types are supported:

*;*;*;*;* —All days, 24 hours

*;*;2-4;*;* —Tuesday to Thursday, 24 hours

*;*;*;8-20;* —All days between 8:00 a.m. and 8:00 p.m.

*;*;*;8;20-59:*;*;*;9-19;*:*;*;*;20;0-40 —All days between 8:20 a.m. and 8:40 p.m.

Phone Registration and Dial-Tone Tests

Phone Registration test format: REGISTRATION|TestName|PollInterval|Schedule|CCMAddress|MACAddress|SrcPhoneProtocol|SIPURI_OR_EXTN

Table 9-3 Import File Format for Phone Registration and Dial-Tone Tests 

Column Number
Description

1

Type of test—REGISTRATION

2

Test name.

3

Polling interval.

4

Schedule.

5

Cisco Unified Communications Manager to which the phone is connected.

6

Phone's MAC address.

7

Phone's protocol (SCCP or SIP).

8

SIP URI or extension number.


Example of a Phone Registration test import file:

REGISTRATION|reg test|60|*;*;*;*;*|ipif-skate.cisco.com|00059A3B7780|SCCP|4002

Dial-Tone Tests

Dial-tone test format:
OFFHOOK|TestName|PollInterval|Schedule|CCMAddress|MACAddress

Table 9-4 Import File Format for Dial-Tone Tests 

Column Number
Description

1

Type of test—DIALTONE

2

Test name.

3

Polling interval.

4

Schedule.

5

Cisco Unified Communications Manager to which the phone is connected.

6

Phone's MAC address.


Example of a dial-tone test import file:

OFFHOOK|dial-tone|60|*;*;*;*;*|ipif-skate.cisco.com|00059A3B7781

End-to-End Call Test

End-to-End Call test format: ENDTOENDTEST|TestName|PollInterval|Schedule|SrcCCM|SrcMAC|isDestRealPhone|DestCCM|DestMAC|Extn|WaitForAnswer|EnableRTP|SrcPhoneProtocol|SRC_SIPURI_OR_EXTN|DestPhoneProtocol

Table 9-5 File Format for End-to-End Call Test 

Column Number
Description

1

Type of test—ENDTOENDTEST

2

Test name.

3

Polling interval.

4

Schedule.

5

Caller Cisco Unified Communications Manager.

6

Caller MAC address.

7

Whether or not the recipient phone is a real phone. Enter true or false.

8

Recipient Cisco Unified Communications Manager.

9

Recipient MAC address.

10

Recipient extension number.

11

Wait for answer. Enter true or false.

12

Enable RTP transmission. Enter true or false.

13

Phone's protocol (SCCP or SIP).

14

SIP URI or extension number.

15

Destinations phone's protocol (SCCP or SIP).


Example of an End-to-End test import file:

ENDTOENDTEST|endtoend test|60|*;*;*;*;*|ipif-skate.cisco.com|00059A3B7782|FALSE 
|ipif-skate.cisco.com|00059A3B7783|4002|TRUE|FALSE|SCCP|4004|SCCP

TFTP Download Test

TFTP test format: TFTP|TestName|PollInterval|Schedule|CCMAddress

Table 9-6 Import File Format for TFTP Download Test 

Column Number
Description

1

Type of test—TFTP.

2

Test name.

3

Polling interval.

4

Schedule.

5

Cisco Unified Communications Manager.


Example of a TFTP download test import file:

TFTP|tftp download|60|*;*;*;*;*|ipif-skate.cisco.com

Message-Waiting Indicator Test

End-to-End Call test format: MWITEST|TestName|PollInterval|Schedule|UnityAddress|SrcCCM|SrcMAC|DestCCM|DestMAC|Extn|Password

Table 9-7 Import File Format for Message-Waiting Indicator Test 

Column Number
Description

1

Type of test—MWITEST.

2

Test name.

3

Polling interval.

4

Schedule.

5

Cisco Unity system.

6

Caller Cisco Unified Communications Manager.

7

Caller MAC address.

8

Recipient Cisco Unified Communications Manager.

9

Recipient MAC address.

10

Recipient extension number.

11

Recipient voice mail password.


Example of a Message-waiting indicator test import file:

MWITEST|mwi test|300|*;*;*;*;*|10.76.91.155|10.76.91.148|00059A3B7B00|10.76.91.148 
|00059A3B7B01|71418001|13579

Cisco Conference Connection Test

Cisco Conference Connection Test format: CCCTEST|TestName|PollInterval|Schedule|CCCAddress|FirstCCM|FirstMAC|SecondCCM|SecondMAC|CCCUserName|CCCPassword|MeetingID|CCCAccessNum|CCCTargetE164

Table 9-8 Import File Format for Cisco Conference Connection Test 

Column Number
Description

1

Type of test—CCCTEST.

2

Test name.

3

Polling interval.

4

Schedule.

5

Cisco Conference Connection system.

6

First caller Cisco Unified Communications Manager.

7

First caller MAC address.

8

Second caller Cisco Unified Communications Manager.

9

Second caller MAC address.

10

Cisco Conference Connection username.

11

Cisco Conference Connection password.

12

Meeting ID number.

13

Cisco Conference Connection access number.


Example of a Cisco Conference Connection test import file:

CCCTEST|conference conn test|120|*;*;*;*;*|10.76.91.105|10.76.91.99|00059A3B7F00 
|10.76.91.99|00059A3B7F01|cccjtapi|cisco|444444|123444444|1234

Emergency Call Test

Emergency Call Test format: EMERGENCYCALLTEST|TestName|PollInterval|Schedule|CERAddress|SrcCCM|SrcMAC|PsapCCM|PsapMAC|EmergencyNumber|enableOsan|OsanCCM|OsanMAC

Table 9-9 Import File Format for Emergency Call Test 

Column Number
Description

1

Type of test—CCCTEST.

2

Test name.

3

Polling interval.

4

Schedule.

5

Cisco Emergency Responder system.

6

Caller Cisco Unified Communications Manager.

7

Caller MAC address.

8

Public Safety Answering Point (PSAP) Cisco Unified Communications Manager.

9

PSAP MAC address.

10

Emergency number.

11

Enable On Site Alert Number (OSAN). Enter true or false.

12

OSAN Cisco Unified Communications Manager.

13

OSAN MAC address.


Example of an Emergency Call test import file:

EMERGENCYCALLTEST|emergency call test|600|*;*;*;*;*|10.76.35.211|10.76.93.75|00059A3B7789 
|10.76.93.75|00059A3B7790|911|TRUE|10.76.38.111|00059A3B7791

Exporting Synthetic Tests

You can export the synthetic tests that you have created to a file on your Operations Manager server. If needed, you can use this file to import your configured synthetic tests back into Operations Manager, or to import the tests into another Operations Manager system.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Click Export. The Export Synthetic Test page appears.

Step 3 Enter a name for the export file.

Step 4 Click OK. All your synthetic tests are exported to a single file.


Editing Synthetic Tests


Note Every time you create or edit a test that requires a phone extension number and a MAC address, you should edit them as a pair. Do not edit one independently of the other.



Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Select the synthetic test you want to edit.

Step 3 Click Edit. The Edit Synthetic Test page appears.

Step 4 Enter or change the desired information.

Step 5 Click Edit. Your changes will be saved.


Viewing Synthetic Test Details

In the Synthetic Test Details page you can view the parameters that have been configured for a test.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Select the synthetic test.

Step 3 Click View. The Synthetic Test Details page appears. The details displayed vary depending on the type of test.


Starting and Stopping Synthetic Tests

Synthetic tests can be started or stopped. You can select multiple tests at one time to start or stop. If a test is running while you are trying to stop it, a message appears stating the test's details.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Select the synthetic tests that you want to either start or stop.

Step 3 Click Start or Stop (depending on the desired action). A confirmation box appears.

Step 4 Click Yes.


Deleting Synthetic Tests


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Select the synthetic test you want to delete.

Step 3 Click Delete.

Step 4 Click Yes in the confirmation box.


Note If you click Cancel before clicking OK, the synthetic tests will not be deleted.



Viewing Synthetic Test Results

You can view the results of synthetic tests in a report format. As with any of the reports in Operations Manager, you can print the report or export it to a file.

The Synthetic Tests Results report provides the following information:

Test status (passed or failed).

The day and time that the test finished.

Any error messages.


Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Select the synthetic test that you want to see the results for.

Step 3 Click Results. The Synthetic Tests Results report appears.


Scheduling Synthetic Tests

When you create a synthetic test, you have the option of running the test now, or scheduling the test to run at regular intervals.

If you want to change the time at which the test should run, you must edit the synthetic test in the Edit Synthetic Test page.


Note If the system time of the Operations Manager server is changed backward, the synthetic tests will not execute until the time has elapsed and the system time reaches the original time at which the change was done. For example, if at 10:00 a.m. the system time is changed to 9:00 a.m., the tests will not start executing until the system time is 10:00 a.m.



Note Your login determines whether or not you can perform this task. For information on user security, see Understanding Your User Role, page 1-23.



Step 1 Select Diagnostics > Synthetic Tests. The Synthetic Tests page appears.

Step 2 Select the synthetic test you want to edit.

Step 3 Click Edit. The Edit Synthetic Test page appears.

Step 4 In the Run area, enter or change the desired schedule information.

Step 5 Click Edit. Your changes will be saved.


Synthetic Test Notes

Table 9-10 contains information you should be aware of when working with synthetic tests.

Table 9-10 Synthetic Test Notes 

Summary
Explanation

Synthetic tests do not run for 30 minutes after the Operations Manager processes are started. However, during this time, you can still create, edit, or delete tests.

Starting Operations Manager processes places a high load on the system. To prevent synthetic tests from failing during this time, Operations Manager delays starting them.

You can change the default setting by doing the following:

1. Add the following default settings in the AMAServer.properties file located in <NMSRoot>\etc\cwsi:

AMAMonitor.InitialDelay-30

2. Stop and restart the synthetic transaction server using the following commands:

pdterm STServer

pdexec STServer

3. Start the VHMSTIntegrator process using the pdexec VHMSTIntegrator command.

When the interval of a synthetic test is decreased from a high value to a low value, the first results for the new value may take longer than the new interval to report.

Each synthetic test executes at a time that is controlled by its interval setting. Immediately after you decrease the interval setting for a synthetic test, that transaction might not execute again until a total elapsed time that is longer than the new interval. For example, if you decrease an interval from 180 seconds to 60 seconds, the first results for the new interval may take as long as 240 seconds to report.

One-time synthetic test failures sometimes occur.

Occasionally, one-time synthetic test failures occur. Such failures can be due to high loads on the Operations Manager system or other factors that cause Operations Manager to be unable to receive some events from applications.

Multiple conferences with the same meeting ID are created and are not deleted, slowing the performance of Cisco Conference Connection database operations.

When synthetic tests for Cisco Conference Connection (CCC) fail, the conferences they create might not be deleted from the CCC Past Conferences database.

If a synthetic test fails after a conference is created but before it is stopped and deleted, the next occurrence of the test results in the termination of the conference, but the conference is not deleted.

You should periodically delete any old conferences used for synthetic testing. Delete the old conferences through the CCC user interface.

Cisco Unity Message-waiting indicator synthetic tests may fail.

If a Cisco Unity synthetic test fails and the Message-Waiting Indicator light is on, you must configure a real phone with the same extension number used in the test and delete the voice mails manually. Alternatively, you can use the Message Store Manager tool to remove the voice mails. Once this is completed, the test will pass.


Synthetic Test Worksheets

Recording Cisco Unified Communications Manager Information

Table 9-11 Cisco Unified Communications Manager Worksheet for Synthetic Test Configuration 

Cisco Unified Communications Manager:
Synthetic Test
MAC Address
Destination Phone Extension Number
Destination Phone Cisco Unified Communications Manager

Phone Registration

 

Dial-Tone

 

End-to-End Call—source phone

 

End-to-End Call—destination phone (synthetic phone)

     

End-to-End Call—destination phone (real phone)

 

Phone Registration

 

Dial-Tone

 

End-to-End Call—source phone

 

End-to-End Call—destination phone (synthetic phone)

     

End-to-End Call—destination phone (real phone)

 

Phone Registration

 

Dial-Tone

 

End-to-End Call—source phone

 

End-to-End Call—destination phone (synthetic phone)

     

End-to-End Call—destination phone (real phone)

 


Recording Cisco Emergency Responder Information

Table 9-12 Cisco Emergency Responder Worksheet for Synthetic Test Configuration 

Parameter
Name or Number
Source

Cisco Unified Communications Manager

 

MAC address

 
Destination

Emergency number

 
Public Safety Answering Point

Cisco Unified Communications Manager

 

MAC address

 
On Site Alert

Cisco Unified Communications Manager

 

MAC address

 

Recording Cisco IP Conference Connection Information

The username, password, and access number are required for the Cisco Conference Connection Test.

Table 9-13 Cisco IP Conference Connection Worksheet for Synthetic Test Configuration 

Parameter
Name or Number
Cisco Conference Connection

Username

 

Password

 

Meeting ID

 

Access number

 
First Caller

Cisco Unified Communications Manager

 

MAC address

 
Second Caller

Cisco Unified Communications Manager

 

MAC address

 

Recording Cisco Unity Information

Table 9-14 Cisco Unity Worksheet for Synthetic Test Configuration 

Parameter
Name or Number
Caller

Cisco Unified Communications Manager

 

MAC address

 
Recipient

Cisco Unified Communications Manager

 

MAC address

 

Phone extension number

 
Voice Mail

Password