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
|
|
