Call generator

This module is intended to be used for load testing. It can generate large number of calls originated from Yate on an arbitrary protocol or to some number.

The call generator can be controlled from the Remote manager as it processes "engine.command" messages. Alternatively these messages can be generated from Yate's command line like this:

 yate 'callgen set called=1234' 'callgen start'

or something like this:

 yate 'callgen set callto=sip/sip:1234@gw' 'callgen start'

Supported commands:

 callgen set paramname=value

Sets the value of parameter paramname to value.

 callgen set paramname

Display the current value of the parameter paramname.

 callgen info

Display statistics about the current call session:

• total calls made
• how many got ringing
• how many got answered
• number of running calls
• number of calls left to make in the current session

 callgen start

Start the calls generator.

 callgen stop

Stops the call generator and drops all current calls.

 callgen pause

Pause the call generator - do not generate new calls. Current calls continue to completion.

 callgen resume

Resume generating new calls.

 callgen drop

Drop all current calls but continue to generate new ones.

 callgen single

Make a single call.

 callgen load

Load the parameters from the callgen.conf file. The [parameters] section of this file is used although you are advised not to rely on the section name or file location - these may change in future versions.

 callgen save

Save the parameters to the callgen.conf file. This operation can be disabled from the same config file by setting:

 [general]
 cansave=false

The following parameters are relevant:

 callto

Location to call, should be something like sip/sip:user@ip. It takes precedence over called

 called

Called number to use in routing. It is ignored if callto is set.

 caller

Caller number to use in calls.

 source

Data source to attach to the outgoing call. You can use something like tone/ring

 maxlife

Maximum lifetime of the call in milliseconds. If not set it defaults to 60000 (one minute).

 minlife

Minimum lifetime of the call in milliseconds. If set calls will have a random lifetime between minlife and maxlife.

 numcalls

Number of calls to generate in this session, default 100.

 maxcalls

Maximum number of simultaneous calls, defaults to 5. The actual number depends on how fast the calls are generated and destroyed.

 avgdelay

Average delay between new calls in milliseconds. Defaults to 1000. If the current number of calls falls below maxcalls a new call will be generated after a time randomly distributed between 0 and 2*avgdelay.