instaling and managing call...

Installing & Managing Call Generator

© InfoVista Sweden AB, 2000-2017. All rights reserved. of 39 21 July 2017

TEMS™ Monitor Master v10.4.4

Installing & Managing

Call Generator

Document: MM-0064-Q

Created by: EWJP

Status: Released



Copyright © InfoVista Sweden AB, 2000-2017. All rights reserved. Unauthorized copying, distribution and use of the

document or its content is strictly prohibited. All registered trademarks, quotes, products or service names are

acknowledged.

Note: In this guide the term "Monitor Master" refers to the InfoVista product "TEMS Monitor Master".

InfoVista Sweden AB

Laboratorgränd 3, 931 62

Skelleftea, Sweden

TEMS Monitor Master is part of the TEMS Portfolio, from InfoVista.

www.infovista.com

Version Overview

Version Date Author Modification

1.0 21/07/2017 EWJP Initial release

Information in this document is subject to change without notice. For the latest version, please visit

https://customerportal.tems.infovista.com

Document Management

File name: call_generator.pdf

Pages: 39

Released on: 21/07/2017

Approved by: GJ

http://www.infovista.com/

https://customerportal.tems.infovista.com/



Table of Contents CHAPTER 1 - INTRODUCTION .................................................................................................................................... 5

SCOPE ................................................................................................................................................................................ 5

INSTALLATION OVERVIEW ................................................................................................................................................ 5

THIS GUIDE ........................................................................................................................................................................ 5

CHAPTER 2 - REQUIREMENTS.................................................................................................................................... 6

OVERVIEW ........................................................................................................................................................................ 6

CALL GENERATOR HARDWARE ......................................................................................................................................... 6

CALL GENERATOR SOFTWARE .......................................................................................................................................... 6

PROFESSIONAL SERVICES .................................................................................................................................................. 7

CHAPTER 3 - SETTING UP PHONE CONNECTIONS ............................................................................................... 8

OVERVIEW ........................................................................................................................................................................ 8

SETTING UP ANALOG CARDS ............................................................................................................................................ 8

SETTING UP DIGITAL CARDS ............................................................................................................................................. 8

CHAPTER 4 - INSTALLING THE VOICE INTERFACE SOFTWARE .................................................................. 10

OVERVIEW ...................................................................................................................................................................... 10

INSTALLING THE VOICE INTERFACE SOFTWARE .............................................................................................................. 10

CHAPTER 5 - INSTALLING CALL GENERATOR SOFTWARE ........................................................................... 12

OVERVIEW ...................................................................................................................................................................... 12

INSTALLING THE CALL GENERATOR SOFTWARE .............................................................................................................. 12

CHECKING THE UL XML FILES ....................................................................................................................................... 17

PUBLISHING RESULTS FOR USE BY MONITOR MASTER .................................................................................................... 18

LIMITING DATA GROWTH BY PURGING RESULTS .............................................................................................................. 20

CHAPTER 6 - INSTALLING THE VOICE INTERFACE CARDS ........................................................................... 22

OVERVIEW ...................................................................................................................................................................... 22

CONTROLLING POWER USAGE (PCI EXPRESS CARDS) ..................................................................................................... 22

INSTALLING VOICE INTERFACE CARDS ........................................................................................................................... 22

CONFIGURING VOICE INTERFACE CARDS ........................................................................................................................ 23

CHAPTER 7 - CONFIGURING CALL GENERATOR .............................................................................................. 26

OVERVIEW ...................................................................................................................................................................... 26

CONFIGURING CALL GENERATOR ................................................................................................................................... 26

DETECTING PBX TONES ................................................................................................................................................. 28

CHAPTER 8 - TROUBLESHOOTING ......................................................................................................................... 31

TROUBLESHOOTING CALL GENERATOR .......................................................................................................................... 31

TROUBLESHOOTING E1 AND T1 LINES ............................................................................................................................. 32

APPENDIX A: WINDOWS POWERSHELL ............................................................................................................... 35

APPENDIX B: UPDATING CALL GENERATOR ...................................................................................................... 36

APPENDIX C: REFERENCES ...................................................................................................................................... 37

INDEX ............................................................................................................................................................................... 38



Chapter 1 - Introduction

Scope This document describes how to install and configure Call Generator for use with TEMS Monitor Master. In a

Monitor Master system, Call Generator is used to answer voice calls from mobile modems (Mobile Originated

calls), to support voice quality testing for mobile-to-fixed line calls.

Monitor Master also supports mobile-to-mobile (Mobile Terminated) calls, but they do not use Call Generator.

Call Generator can be used with other TEMS products (TEMS Automatic, TEMS Investigation and TEMS Pocket).

Such applications are not described here - see NT11-6171 for details.

Installation Overview The installation process generally consists of these following steps:

Check that your system meets the requirements

Install the Voice Interface software on the server

Install the Call Generator software on the server

Install the Voice Interface cards on the server

Configure Call Generator for use with TEMS Monitor Master

This guide 1. Introduction

2. Requirements

3. Setting up the Phone Connections

4. Installing the Voice Interface software

5. Installing Call Generator software

6. Installing the Voice Interface cards

7. Configuring Call Generator

8. Troubleshooting

A. Windows PowerShell

B. Updating Call Generator

C. References

Chapter 2 - Requirements


Chapter 2 - Requirements

Overview A Call Generator solution will usually be built by purchasing the appropriate components from InfoVista Sweden

AB as agreed during the initial technical assessment of the customer's requirements. These components include:

Hardware

Software

Professional Services

Call Generator Hardware The Call Generator server is built from hardware components supplied by InfoVista Sweden AB, which may

include:

Server Solution Call Generator (1-90 channels). A rack mounted server including Window O/S and SQL

Server. (While alternative server hardware may be requested by the customer, suitability cannot be

guaranteed)

Calling Card 12 ports PCI-e + Connect SW License for Calling Card 12 ports PCI-e

Calling Card E1 30 ports PCI-e + Connect License for Calling Card E1 30 ports PCI-e

Calling Card T1 24 ports PCI-e + Connect License for Calling Card T1 24 ports PCI-e

Note: If testing of digital (ISDN) lines is required, please confirm availability in advance.

Call Generator also requires:

A separate phone circuit to the PBX for each call it is expected to handle in parallel

A PBX configured to use a single group number for all incoming calls to Call Generator (a linear hunting

group)

The hardware required will be agreed as part of the initial technical assessment for each customer and form part of

the commercial agreement with the customer.

Call Generator Software The Call Generator server will require software components chosen from this list:

Call Generator 1.0 SW package

CS Channel Package License (1-12 channels)

PESQ SW Package License (1-32 channels)

POLQA SW Package License (1-32 channels)

The software required will be agreed as part of the initial technical assessment for each customer and form part of

the commercial agreement with the customer.



Professional Services Initial setup and configuration of a Call Generator solution will require assistance from TEMS Professional

Services, which is chargeable by the day.

The number of days (and cost) will be agreed as part of the initial technical assessment for each customer and form

part of the commercial agreement with the customer.

Chapter 3 - Setting up Phone Connections


Chapter 3 - Setting up Phone Connections

Overview This chapter describes how to:

Set up analog connections (to use analog Voice Interface cards)

Set up digital connections (to use digital Voice Interface cards)

Setting Up Analog Cards

Routing calls to channels

If analog Voice Interface cards are used, a single group number is used for all incoming calls even if multiple cards

are installed. The calling party is then directed to one of the channels on the Voice Interface card. Each channel is a

separate wire associated with a unique hidden phone number, distinct from the group number.

The company switch (PBX) must be set up as follows:

The first channel on the Voice Interface card must be connected to the first hidden phone number, the

second channel to the second hidden phone number, and so on.

Each incoming (MO) call must be directed to the lowest-numbered channel available: use channel #1 if it is

free, otherwise use channel #2 if free, etc. (This is usually called a Linear Hunting Group.)

When the Call Generator makes outgoing (MT) calls, it prefers the highest-numbered channels.

Note: Outgoing calls are not supported by Monitor Master at this time but support may be added in a future

revision.

This configuration makes sure that MO and MT calls will never interfere.

Physical connections

Call Generator requires a separate analog line for each call it must handle. For details of connecting analog cards to

your phone system, see the Quick Installation Guide which is delivered with the cards.

Setting Up Digital Cards

Routing Calls to Channels

A digital Voice Interface card normally uses one phone number for incoming calls. If multiple cards are installed,

each card has its own phone number. There are however no further underlying hidden phone numbers as in the

analog case; each card is connected to a single trunk in which all channels (timeslots) are multiplexed.

If several cards are installed, their order is defined by their slot number.

The company switch (PBX or PABX) must be set up as follows:

Each incoming (MO) call must be directed to the lowest-numbered channel (timeslot) available in the trunk.

That is, start with card #1 and use channel #1 if it is free, otherwise use channel #2 if free, and so on. If all

channels on card #1 are busy, proceed to card #2, testing channels from #1 onwards.



When the Call Generator makes outgoing (MT) calls, it prefers the highest-numbered cards and channels,

searching for available channels in exactly the opposite order compared to the routine for incoming calls.

Note: This functionality is not provided by Monitor Master at this time but may be added in a future

version.

This configuration reduces the risk of MO and MT calls interfering with each other.

Note: This means in particular that the switch must not allocate timeslots randomly to incoming calls as that would

allow Call Generator (while initiating an MT call) to grab a line that the switch has already allocated to an

incoming (MO) call.

Checksum setup

CRC4 is enabled on the Voice Interface card by default. It must be enabled in the PABX as well.

Physical connections

The physical connector on the Voice Interface card (D/300JCT-E1, D/240JCT-T1) is a RJ-48C (for pinouts see the

Quick Installation Guide which is delivered with the cards).

It is important that the cabling between the ISDN board in the switch (PABX) and the connector box (on the wall) is

correct. The connector on the ISDN board in the PBX varies with the vendor, so the cable to the connector box must

be adapted accordingly. If the cabling between the PBX and the connector box is correct, a Cat-5 Ethernet cable can

be used to connect the connector box to Call Generator. Use an "ordinary" Cat-5 network cable or a crossover (1-4,

2-5, 4-1, 5-2) cable, depending on how the PBX is set up.

The PABX must use the ISDN PRI E1 protocol (not E1 CAS/R2).

See also the diagram below:

Chapter 4 - Installing the Voice Interface Software


Chapter 4 - Installing the Voice Interface Software


Install the Voice Interface Software on the Call Generator

We recommend you do so before installing the Voice Interface cards in the server.

Installing the Voice Interface Software Proceed as follows to install the drivers for the Dialogic Voice Interface Cards:

1. Log in to the Call Generator server as a user with local admin privileges.

2. Browse to the Dialogic 6.0 PCI Windows Server 2008 folder on the Call Generator CD.

3. Double-click Setup.exe

4. Click Next to start the installation.

5. Enter your customer information and click Next.

6. Accept the default destination directories by clicking Next twice.

7. Select the components to install:

Tick the Core Runtime Package and Demos options.

For digital cards, tick all the ISDN Protocols.

8. Click Next.

9. Accept the installation of third-party software, i.e. click Yes.



10. A popup about Java Runtime Environment appears. Dismiss it by clicking OK.

11. Accept the default name for the Program Folder and click Next.

If a popup window appears, click OK and the installation will continue.

12. Verify that the setup settings summary is correct, and click Next to start copying files:

13. When the installation has finished, select the No, I will restart my computer later option and click Finish.

Chapter 5 - Installing Call Generator Software




Install the Call Generator software and database

Check that UL XML files are generated

Publish results for use by Monitor Master

Limit data growth by purging results

Installing the Call Generator software 1. Run SetupCallGenerator.exe from the Call Generator CD.

2. Select the TEMS Investigation option and click Next.



3. The Measurement database setup screen appears:

4. If you have an existing database to upgrade, select it from the list box on the left.

5. Change the MCC and MNC values if necessary.

6. There is normally no need to edit any of the other fields. Click Next.

7. The components to be installed are listed like this:

and can include:

Microsoft .NET Framework 4.0 - if not already installed

Windows Installer 4.5 - if not already installed

Microsoft SQL Server 2008 Express



TEMS Automatic Database

Measurement Database

Call Generator

8. Click Finish to begin installing files.

9. If .NET Framework 4.0 or Windows Installer 4.5 were listed (need to be installed), they will be installed and

you will be prompted to reboot the server. Reboot the server, then start the installation process again from

the beginning (step 1).

If these components were not listed (are already installed) you will begin the database setup:

10. Click Next.



11. Accept the installation path by clicking Next.

12. Click Install to install the database. Once that has finished you will begin the Call Generator setup:



13. Click Next.

14. Tick the checkbox to accept the License Agreement, and click Next.



15. Accept the installation path by clicking Next.

16. Click Install to install Call Generator.

17. When notified that the installation is complete, click OK.

18. If the server is not running on Windows Server 2008 R2, you need to verify that the right version of

Windows PowerShell is installed and configured correctly. See Appendix A, Windows PowerShell.

Checking the UL XML files This section describes how to check that XML files are generated for UL AQM values:

1. In Windows PowerShell, run this command:

Get-ExecutionPolicy

2. The response should be "RemoteSigned". If you get a different response, run this command:

Set-ExecutionPolicy RemoteSigned

This dialog appears:

Execution Policy Change

The execution policy helps protect you from scripts that you do not trust. Changing the execution policy

might expose you to the security risks described in the about_Execution_Policies help topic.

Do you want to change the execution policy?

[Y] Yes [N] No [S] Suspend [?] Help (default is "Y"): Y

Type Y to agree.

3. Start SQL Server Management Studio.

4. Connect to the measurement database and check the tTIConfig table by executing this query:

SELECT [InstallDir]

FROM [dbo].[tTIConfig]

5. You should see a result like this:

InstallDir



-------------

C:\Program Files (x86)\TEMS\Database\Application\utils

6. Check that the TEMS-ExportPESQXML.ps1 script is in the specified directory.

Publishing results for use by Monitor Master One way to allow Monitor Master scripts to access the metrics or degraded samples produced by the Call

Generator, is to publish results via HTTP, as follows.

Hint: For information on capturing and analyzing Call Generator results, see Using Call Generator and The Voice

Quality Measurement Scripts in the Story Boarder User Guide, or search the Help for "Using Call Generator".

Publishing results files

Call Generator stores its results files in the following location:

C:\TIPESQ\yyyymmdd\caller-phone-number

Within this folder, the results for each call are stored as a separate result file, called nnnn.xml - where nnnn is a

random 4-digit number.

For example:

C:\TIPESQ\20130408\012339999999\1234.xml

is a results file created on 2013-04-08 (April 8, 2013) for calls from phone number 01233-9999999. Notice that the

filename (e.g. 1234.xml) is NOT based on a sequence number or serial number, so you can't tell the most recent file

by its name.

To allow Monitor Master scripts to access their results on Call Generator, you could add an ASP page to extract the

phone number and date from the query sent by the Monitor Master script, find the most recent results file in that

folder, and return it as an XML document for the Monitor Master script to analyze.

On the Call Generator Server:

1. Launch IIS Manager and use it to add the C:\TIPESQ folder as a virtual directory. (This folder should have

been created by the Call Generator installer. If it has not, create it.)

2. Create an ASP page in this directory called latest.asp and type the following code into it (or download the

latest.asp file from the Standard Scripts folder):

<%

phone = Request.QueryString("phone")

dateFolder = Request.QueryString("date")

phone = Replace(phone, "+", "0")

Set fso = Server.CreateObject ("Scripting.FileSystemObject")

path = Server.MapPath(dateFolder & "/" & phone & "/")

Dim latest

Set latest = Nothing

Set fd = fso.GetFolder(path)

For Each f in fd.Files

If Not latest Is Nothing Then

If latest.DateLastModified < f.DateLastModified Then

Set latest = f

End If

Else

Set latest = f

End If

Next



Set ts = latest.OpenAsTextStream()

Response.ContentType = "text/xml"

Response.Write(ts.ReadAll)

%>

3. Once Call Generator setup is complete (as described in subsequent chapters) you can check operation by

using the standard script QM Voice Quality (M2M) - this is described in the Story Boarder User Guide.

Publishing degraded sample files

Call Generator stores its degraded samples (recordings) for each call it receives in the following location by default:

C:\Program Files (x86)\TEMS\Call Generator\AQM\Recordings

Within this folder, there is a separate file for each degraded sample, named as follows:

MTUcaller-phone-number_Timetimestamp_measurement-typescoreSentenceNosentence-number.al

Notice that there is an underscore separator between the caller-phone-number and Time and between the timestamp

and measurement-type, but there is no separator between the measurement-type and score.

For example:

MTU0447917103192_Time17.13.7.312_PESQ2.309948_SentenceNo1.al

is for a call from 044-7917-103192 at 17:37:07.312, with a PESQ score of 2.309948 using sentence (sample) #1.

These files contain the degraded audio in A-Law compressed format. We recommend you use CoolEdit to open

them.

One way to allow Monitor Master scripts to access these files, is to add an ASP page to Call Generator to publish

them. The page could extract the phone number, score and date from the query sent by the Monitor Master script

and return the filenames of the most recent degraded samples for that phone number, score and date. To provide

access to the files themselves, you could publish the root folder. Monitor Master script can then use this

information to download the files.

On the Call Generator Server:

1. Assuming the C:\TIPESQ folder has been added as a virtual directory (see above).

2. Create an ASP page in this directory called samples.asp and type the following code into it (or download

the samples.asp file from the Standard Scripts folder) :

<%

Dim recPath, phone, score

phone = Request.QueryString("phone") & ""

score = Request.QueryString("score") & ""

minDate = Request.QueryString("mindate") & ""

phone = Replace(phone, "+", "0")

recPath = "C:\Program Files (x86)\TEMS\TEMS Call Generator\AQM\Recordings"

Set fso = Server.CreateObject ("Scripting.FileSystemObject")

Set recFolder = fso.GetFolder (recPath)

Response.Write "<files>" & vbCrLf

For Each f in recFolder.Files

If Check(f, phone) And Check(f, score) And CheckDate(f, minDate) Then

Response.Write "<file>" & f.Name & "</file>" & vbCrLf

End If

Next



Response.Write "</files>"

Response.ContentType = "text/xml"

%>

<%

Function Check(file, val)

Check = val = "" Or Instr(f.Name, val) > 1

End Function

Function CheckDate(file, d)

If d = "" Then CheckDate = True Else CheckDate = file.DateCreated > CDate(d)

End Function

%>

3. To allow Monitor Master scripts to download the files, you could use IIS to publish the root directory

(C:\Program Files (x86)\TEMS\TEMS Call Generator\AQM\Recordings) as a virtual directory - to make

the files accessible via HTTP. Scripts can then use the Download HTTP Scene (or function) to fetch the files.

4. Once Call Generator setup is complete (as described in subsequent chapters) you can check operation by

using the standard script QM Voice Quality M2F - this is described in the Story Boarder User Guide.

Limiting data growth by purging results For each call handled, Call Generator creates and stores:

A results file

Multiple degraded sample files

It has no mechanism for the automatic deletion of any of these files, so over time disk space will reduce -

eventually impacting performance and stability.

To avoid this happening, we recommend that you implement a routine manual or automatic purge of old files.

How often you do so and how long you keep a file before purging it depends on many factors, including:

disk size and free space

frequency of testing

the importance of historical data to your application

whether data can be archived before deletion

Manual deletion once a month using DOS commands or Windows Explorer may well be sufficient if Call

Generator has plenty of disk space and is lightly used; an automatic solution would be preferred if it's used heavily

and would typically use Windows Scheduler and Windows Scripting - beyond the scope of this guide.

Note: QM maintenance scripts are not supported by Call Generator, so cannot be used to implement Call

Generator purging.

Purging results files

Call Generator stores results files in the following location:

C:\TIPESQ\yyyymmdd\caller-phone-number

Within this folder, the results for each call are stored as a separate result file, called nnnn.xml - where nnnn is a

random 4-digit number.

Purging should be a simple matter of deleting old directories. For example:

On the first of each month, delete all folders for the month before last



Purging degraded sample files

Call Generator stores the degraded samples (recordings) for each call in the following location by default:

C:\Program Files (x86)\TEMS\Call Generator\AQM\Recordings

Within this folder, there is a separate file for each degraded sample, named as follows:

MTUcaller-phone-number_Timetimestamp_measurement-typescoreSentenceNosentence-number.al

Notice that there is no indication of the date of the call in the filename - all the degraded sample files are in this

single folder.

Any purging mechanism will need to examine the file timestamps to determine which files are old. For example:

Once a week, browse the recording directory, sort by file date, then select and delete all files that are more

than one month old

Chapter 6 - Installing the Voice Interface Cards




Control power usage by PCI Express cards

Install the Voice Interface cards

Configure the Voice Interface cards

Hint: For further guidance on these topics, please refer to the customer documentation for the Voice Interface cards

(see Appendix C, References).

Controlling power usage (PCI Express Cards) If you are going to install PCI Express Voice Interface cards (digital or analog), make sure they will be supplied

with sufficient power:

If the server hardware and OS support Power Budgeting (as described in the PCI Express specification), the

server and card will negotiate power consumption requirements, and no further action is needed.

If the server hardware and OS do not support Power Budgeting, the PCI Express card must be physically

configured in a specific way, and the PCI Express slot used must satisfy certain minimum requirements. See

the Installation Guide for the Voice Interface card for details (see Appendix C, References).

To find out whether Power Budgeting is supported check the Windows Event Viewer.

Installing Voice Interface Cards To install a single Voice Interface card in the server, proceed as follows. To install multiple cards, simply repeat the

procedure for each one - and connect a CT Bus cable between them.

1. Turn off the server and insert the Voice Interface card into a free PCI Express or PCI slot.

2. Start up the server again.

3. A Found New Hardware dialog will pop up. Select the No, not this time option and click Next.



4. You'll be asked how to install the software for the new hardware like this:

5. Choose the Install the software automatically option and click Next.

6. You'll be warned that the driver has not been signed, like this:

Click Yes to proceed.

7. Click Finish to install the drivers and restart the computer if prompted.

Configuring Voice Interface Cards This section describes how to configure a single Voice Interface card. If you have multiple cards, repeat the

procedure for each one.

1. From the Start menu, select Programs / Intel Dialogic System Release 6.0 PCI / Configuration Manager /

DCM.

2. The automatic detection should list the Voice Interface cards you've just installed, like this:



If it does not, select Auto Detect Devices from the System menu.

3. If the system has been started, stop it by selecting Stop System from the System menu.

4. Right-click the Voice Interface card to configure in the tree structure and choose Configure Device from the

popup menu.

5. In the Properties dialog that appears, select the Country tab:

Set the Country parameter to the appropriate value by selecting it from the dropdown list.

6. If you are using a Digital card (D/300JCT-E1, D/240JCT-T1), select the Interface tab:



Set the ISDNProtocol parameter according to your service provider settings, i.e. enter the designation for

the digital board ISDN network interface (in Europe: CTR4; in the U.S.A: 5ESS).

7. Click OK to save the changes and close the Properties dialog.

8. From the Settings menu, select System / Device autostart / Start System.

9. If you see the error message Failed to set device autostart, ignore it and click OK.

10. From the System menu, select Start System.

11. Wait for the system to start up, then exit the Intel Dialogic Configuration Manager.

12. Restart the server.

Chapter 7 - Configuring Call Generator




Configure Call Generator for use with Monitor Master

Detect the tones used for signaling by your PBX (Analog cards)

Configuring Call Generator Note: If you do not know the tone signals used by your Analog PBX, you should find out before starting this

process. See Detecting PBX Tones, below.

1. From the Start menu, choose TEMS > Utilities > Call Generator Configuration Tool.

2. Select the Database settings tab.

3. Enter these settings:

Server name: host-name\TEMSPESQDB

Database: Measurement

User name: tems

Password: tems00



4. Switch to the Telephone settings tab:


Select the type of voice board you are using: Digital board or Analog board.

Phone number: Type the Call Generator phone number (group number).

Line extension: Type the extension used by the Call Generator when dialing out. (Ignore for TEMS

Monitor Master, because it only uses Call Generator to receive calls.)

AQM limit: Recordings with a PESQ or POLQA score lower than this will be saved. Set to 5 to save

all recordings; set to 0 to save no recordings. Should be set to 0 initially.

6. If using an Analog voice board, enter the following tone signals to recognize events (see below):

Call end tone

One frequency: Detects Call End tone signals composed of a single tone. Specify the frequency

and duration of the tone signal.

Two frequencies: Detects Call End tone signals composed of two superimposed tones. Specify

the frequency of each tone and the duration of the tone signal.

Alert tone

One frequency: Detects Alert tone signals composed of a single tone. Specify the frequency

and duration of the tone signal.

Two frequencies: Detects Alert tone signals composed of two superimposed tones. Specify the

frequency of each tone and the duration of the tone signal.

Note 1: Configure these parameters to suit your network; the required settings differ between locations.

Note 2: The frequency range is 300-3500 Hz, and the duration range is 40-10000 ms. When two frequencies

are used, the voice board cannot detect frequency components closer than 65 Hz.

7. In the right-hand (Actions) pane, click Apply configuration to save your settings in the database.



8. Switch to the Service settings tab.


Service startup type defaults to Automatic. This means that the Call Generator service always starts

up when the server is rebooted. Chose Manual if you want to control when the Call Generator

service starts. Choose Disabled to shut down the Call Generator service completely.

ServiceMonitor database connection settings: These are the login settings the Service Monitor will

use to login to the SQL server. If the SQL server password has been changed from the default, enter

the correct password here.

10. In the right-hand (Actions) pane, click Start Call Generator service to launch the Call Generator service.

11. The Call Generator configuration is now finished. Choose the Exit option from the File menu to exit the

Configuration Tool. You will see a prompt Save console settings. This refers to the Configuration Tool

settings, not the Call Generator settings so it can be ignored - the choice you make is not important.

12. The Call Generator service now starts. You can see this by the text string in the Actions pane changing to

Stop Call Generator service, and by the service appearing in the Windows Task Manager on the Services

tab. You can stop the service in either of these places if you want.

Detecting PBX Tones Note: This section only applies to Analog cards and can be ignored if you are using Digital cards.

If you do not know the tone signals used by your network, ask your PSTN or PBX provider. If that does not help,

you can train your Voice Interface cards and drivers to work with your telephone lines by using the PBXpert

utility.

Even if you are using lines that do not pass through a PBX you may need to use this utility to train your Voice

Interface card. Do not be confused by the name PBXpert - a better name would have been "Line Learner".

For detailed information on using PBXpert, please refer to the user documentation supplied with it (see Appendix

C, References). We have created these simplified instructions to help you understand how to take advantage of this

powerful configuration tool quickly.

PBXpert uses two telephone lines connected to your Voice Interface card: One line calls the other and performs a

number of operations, then the second line calls the first line. This is all done automatically by a built-in wizard.

Once the process is finished you can configure your Voice Interface cards to use the configuration information

generated.

The following instructions are a summary only - you may need to refer to the PBXpert documentation for details.

1. Make sure that your Voice Interface card is installed and operational.



2. Connect telephone lines (at least) to the first two channels B1C1 and B1C2 of your Voice Interface card and

make a note of their phone numbers.

3. Run PBXpert (from C:\Program Files\Dialogic\BIN assuming a default installation).

4. The PBXpert Wizard starts immediately - click Cancel to exit. You need to configure the Wizard before

running it.

5. From the toolbar, select Settings.

6. Enter the Phone Number for Line A (B1C1) and Line B (B1C2). Use defaults for board and channel number

(i.e. #1 and #1 for Line A; #1 and #2 for Line B).

7. Choose Line A as the Learning Channel.

8. Enter the Dial Prefix (if required by your PBX to get an outside line).

9. Select the Advanced tab.

10. Tick the option Learn Disconnect Tone from Inbound Channel.

11. All configuration is now done; click OK.

12. Select Wizard from the toolbar.

13. Wizard step 1: Click Next.

14. Wizard step 2: Enter a name and model number for your PBX or telephone lines. This will be used to create

a name for the configuration file which is known as a "Tone Set File". For example: Manufacturer = Ericsson,

Model = MD110. Be sure to note where your file is stored. Then click Next.

If you see the warning message "Cannot load TAPI DLL" ignore it and click OK.

15. Wizard step 3: Click Next.

16. Wizard step 4: The selected board number should be according to your settings, i.e. #1 (see Enter the Phone

Number for Line A (B1C1) and Line B (B1C2). Use defaults for board and channel number (i.e. #1 and #1 for Line A;

#1 and #2 for Line B). above). Click Next.

17. Wizard step 5: The phone number and selected channel number for Line A should be according to your

settings (see Enter the Phone Number for Line A (B1C1) and Line B (B1C2). Use defaults for board and channel

number (i.e. #1 and #1 for Line A; #1 and #2 for Line B). above). Click Next.

18. Wizard step 6: The phone number and selected channel number for Line B should be according to your

settings (see Enter the Phone Number for Line A (B1C1) and Line B (B1C2). Use defaults for board and channel

number (i.e. #1 and #1 for Line A; #1 and #2 for Line B). above). Click Next.

19. Wizard step 7: Check the information you entered, and if it is OK click Next.

20. Click OK to acknowledge the "Unable to add PBX to TAPI" warning.

21. Now the PBXpert/32 Wizard Auto Line Test will run. When it has finished, click OK.

22. Wizard step 8: Click Next to begin learning the tones your PBX uses. When the learning is complete:

If all tones were learned correctly, click Keep Data.

If any tones were not learned, click Discard Data and use the Back button to go back and check your

setup information, then run the test again.

23. Wizard step 9: Click Next to begin testing your TSF (Tone Set File). When the testing is complete, click OK.

24. Wizard step 10: This screen shows a summary of the settings you entered in wizard steps 2 through 5 and

the definitions in the new tone set:



If you need to change any of these settings, click the Back button as necessary to return to the

appropriate step and try again.

If all is well, click Finish to close the PBXpert/32 Wizard and display the new tone set in the open

TSF.

25. Make a note of the Disconnect (Call End) and Ring (Alert) tones.

26. Stop Call Generator and enter the "Learned" configuration.

27. Use an RTU to call Call Generator and verify in the Call Generator trace that calls are ended by Call End

tone detection.



Chapter 8 - Troubleshooting

Troubleshooting Call Generator

General advice

These actions are always useful for troubleshooting the Call Generator.

Configure Call Generator trace (logging):

Open CallGeneratorTrace.ini in the Call Generator installation folder to see a file like this:

[CallGenerator]

outputtype=file

output="C:\Program Files (x86)\TEMS\Call Generator\trace\CallGenTrace.log"

maxentries=50000

fullaction=backup

backupextension=".BUP"

execute=notepad.exe

timeformat=""

# MESSAGE reports MESSAGES, WARNINGS and ERRORS

# WARNING reports WARNINGS and ERRORS (not messages)

# ERROR reports ERRORS (not warnings or messages)

# i.e. MESSAGE is everything, WARNING is any problem, and ERROR is any serious

problem.

[CallGen Main]

tracelevel=MESSAGE

[CallGen Channel]

tracelevel=MESSAGE

[CallGen Scheduler]

tracelevel=MESSAGE

[CallGen AQM]

tracelevel=MESSAGE

[CallGen DSP]

tracelevel=MESSAGE

The output line can be used to change the trace file name from the default

The tracelevel lines can be used to select the logging level for each component ([main], [channel],

[scheduler], [AQM] and [DSP])

Add a hash sign ( # ) to the start of a tracelevel line to disable logging for that component; remove the

hash sign to enable logging for that component

Set tracelevel to MESSAGE to report information messages, warnings and errors; set tracelevel to

WARNING to report warnings and errors; set tracelevel to ERRORS to report errors only

Save the file to implement your changes

If the trace function is enabled Call Generator will produce a trace file in plain-text format, by default

named CallGenTrace.log, stored in the same folder as the CallGeneratorTrace.ini file.

Inspect the Windows Event Viewer for Call Generator events and Dialogic related events.

If Call Generator connects to the database but fails to start the voice board

Action:

Run the Dialogic Configuration Manager (from Start / Program / Dialogic System Software).



Use it to try to start the service.

Look in the Windows Event Viewer log for additional information.

If Call Generator terminates after the first call with a "Playback error"

Action:

Run the Dialogic Configuration Manager (from Start / Program / Dialogic System Software).

Use it to stop the service.

Select Configure Device from the Action menu.

Select the Telephony Bus tab and set PCM Encoding to ALAW:

(This should normally be set during the installation process.)

If Call Generator stops with "Number of lines in use" set to zero

Action:

Verify that the phone lines are connected to the voice board.

Troubleshooting E1 and T1 lines This section describes how to verify that an E1 or T1 line is correctly configured in the switch to match the Voice

Interface card. That can be verified by running the ISDIAG application, which is installed with the Voice Interface

SR 6.0 driver. ISDIAG is a console application, and its EXE file is located under C:\Program Files\Dialogic\BIN if

the installation has been done properly.

First of all, ensure that the Call Generator is terminated and that the voice board is connected to the E1/T1 line.

Also verify that the Dialogic service is started and that the configuration of the Voice Interface card is correct

(ISDN Protocol, Country, etc).



1. Open a command console (DOS prompt) and move to C:\Program Files\Dialogic\BIN folder (assuming you

installed the Voice Interface SR driver as described in Chapter 4).

2. Start the ISDIAG utility by typing isdiag followed by the appropriate options. The syntax is:

isdiag board-no channel-no board-type type trace-mode voice

For example: to open board #1 (see in DCM) channel #1 on E1 for SCbus with voice support, type:

isdiag 1 1 e s v

For help type isdiag ?

3. Verify that the alarm indicators are OK (equal to zero); see below.

LOS: Loss Of Signal

0 = no alarm, 1 = loss of signal

OOF: Out Of Frame

0 = no alarm, 1 = frame sync error

RAI: Remote Alarm Indicator (also called Yellow Alarm for T1)

0 = no alarm, 1 = remote alarm detected

AIS: Alarm Indication Signal

0 = no alarm, 1 = AIS detected

CRC: CRC Status (E1 only)

0 = no alarm, 1 = local CRC error

R/E: Remote CRC Error Indicator (E1 only)

0 = no alarm, 1 = remote CRC error

DCH: D Channel Status

0 = D channel is up, 1 = loss of D channel

If there are any alarms (alarm indicator = 1) tell the customer service provider (responsible for

installation and service) so they can investigate further.

4. Verify that Call Generator can receive calls. Make a call to the ISDIAG application from a mobile and from a

fixed telephone.

When the call is established, select drop call (Option 5) from the main menu. Verify that all signaling

is correct.

If any problem occurs, enable the trace (Option 10) start/stop/browse trace and repeat the test. Open

the trace file and analyze it to identify the problem. Analyzing the trace is tricky and requires good

knowledge, so it is best done by the customer service provider (responsible for installation and

service).

5. Verify that Call Generator can make calls to a mobile and to a fixed telephone. First of all, set up call

parameters:

Select Set call parameters from main menu and:

Change destination number type to Unknown (Option 0).

Change destination number plan to Unknown (Option 0).

Change user info: Layer 1 protocol to A-law (Option 3) for Europe and Mu-law (Option 2) for

US.

Select make call (Option 6) from the main menu and enter a phone number.

When the call is established select drop call (Option 5) from the main menu.



Verify that all signaling is correct.

If any problems occur:

Enable the trace (Option 10) start/stop/browse trace and repeat the test.

Open the trace file and analyze it to determine the problem. Again, the analysis is best left to

the customer service provider staff.



Appendix A: Windows PowerShell

If Call Generator is installed on a server that is not running Windows Server 2008 R2, you need to make sure that

the right version of Windows PowerShell is installed and that it is configured correctly. Proceed as follows:

1. Turn off UAC.

2. Open an elevated command prompt: In the Start menu search box, type cmd, and when cmd.exe appears,

right-click it and select Run as administrator.

3. At the CMD command prompt, type powershell

4. At the PowerShell prompt, type $host.version

5. The Major version should be 2 as shown. If not, you have the wrong version and need to install the right

version:

Visit Windows Update or follow this link: support.microsoft.com/kb/968929.

Download the Windows Management Framework (Windows PowerShell 2.0, WinRM 2.0, and BITS

4.0) installer

Run the installer

http://support.microsoft.com/kb/968929

Appendix B: Updating Call Generator


Appendix B: Updating Call Generator

To update the Call Generator software:

1. Connect the server to the Internet.

2. Run TEMSCallGeneratorUpdate.exe (from C:\Program Files (x86)\TEMS with a default installation).

3. This program will check for and install any updates that are available. Simply follow the instructions

displayed by the installer.



Appendix C: References

For more information see:

Voice Quality Measurement in the Story Boarder User Guide

Using Call Generator in the Story Boarder User Guide

AQM in TEMS Products (NT12-6517)

Call Generator Installation Guide (NT11-6171)

Dialogic Diva Media Board Installation Guide - www.dialogic.com

http://www.dialogic.com/

Index


Index

A

ASP page, 18

C

Call Generator

ASP page, 18

configuring, 26

installing, 5

overview, 5

PBX tones, 28

phone connections, 8

purging results, 20

requirements, 6, 8

software, 12

tones used for signalling, 28

trace files, 31

troubleshooting, 31

UL XML files, 17, 18

updating, 36

voice interface cards, 22

voice interface software, 10

Configuring

Call Generator, 23, 26

Call Generator logging, 31

Voice Interface cards, 23

D

Detecting PBX Tones, 28

Dialogic

Configuration Manager, 23

drivers, 10

user guides, 37

Voice Interface Cards, 23

E

Example Scripts

latest.asp, 18

samples.asp, 18

F

Fixed Lines, 5

I

Installing

Call Generator, 5

Call Generator ASP page, 18

Call Generator hardware, 8, 10

Call Generator purging, 20

Call Generator software, 12, 22, 26

L

latest.asp, 18

Learning PBX Tones, 28

Logging, 31

Logs

Call Generator, 31

M

MO Calls, 5

Mobile Originated Calls, 5

Mobile Terminated Calls, 5

MT Calls, 5

O

Overview

Call Generator, 5

P

PBXpert, 28

Professional Services, 7

Purging

Call Generator results, 20

R

Requirements




Routing analog calls to Call Generator, 8

Routing digital calls to Call Generator, 8

S

samples.asp, 18

T

Tones used by Call Generator, 28

Troubleshooting


U

Updating

Call Generator software, 36

Using

Dialogic Configuration Manager, 23

V

Voice Interface Cards

configuring, 23

installing, 8, 22

power usage (PCIe), 22

routing analog calls, 8

routing digital calls, 8

software, 10

user guides, 37

instaling and managing call...

Documents