ElGee - The Load Generator!
General Parameters:
RUNNING_MODE
{ORIGINATING/TERMINATING/REGISTRATION} denotes the running
behaviour for elgee (defaults ORIGINATING)
SECRET
{string} password, one for all! used to authenticate the from users
in originating/registration modes
CPS
{#} desired calls per seconds. in originating mode this isthe call
attempt rate, registrations/sec in registration mode and not used in terminating
mode (defaults to 10 cps)
BURST_RATE
{#} number of requests [INVITE/REGISTER] in a burst. not used in terminating
mode (default 0 for all at a time)
UDP_PORT
{#} sip udp port of this driver (default 5060)
FROM_HOST
{host[:port]} this driver's host (default value is taken from theSystem
object in vocal)
FROM_URL
{host[:port]} host field for the FROM url in INVITE/REGISTER messages
in originating/registration mode. used to enable url based dialing. unused
in terminating mode. (defaults to FROM_HOST:UDP_PORT)
NEXT_HOST
{host[:port]} next hop host. denotes the next hop to send the
INVITE/REGISTER message in originating/registration mode and not used in
terminating mode
NEXT_PORT
TO_HOST
{host[:port]} host field for the TO url and Request URI in INVITE/REGISTER
messages in originating/registration mode. used to enable url based dialing.
unused in terminating mode. (defaults to NEXT_HOST:NEXT_PORT)
TO_PORT
LOG_FILE
{filename} name of file for system logging (defaults to stderr)
LOG_LEVEL
{STACK, ALERT, INFO, DEBUG, CRIT, ERR, EMERG} log level (defaults to
CRIT)
TOTAL_CALLS
{#} total number of calls to make (default -1 for infinte) useful for
debugging with controlled calls/registrations, not used with terminating
mode
CALL_HOLD
{#} desired call duration time in seconds (default 0 sec) for originating
mode, and during terminating mode it is the duration after which the call
is preempted (default 0 for non preemption). not used in registration mode.
TO_RANGE
{#[..#]} range of To users. in originating/terminating mode it denotes
the callee, in registration mode it denoted the user being registered
FROM_RANGE
{#[..#]} range of From users. in originating/terminating mode
it denotes the caller, if its different from To in registration mode then
denotes the 3rd party registrations
REQUEST_TIMEOUT
{#} timeout in seconds for non-Invite requests, eg., BYE in originating/terminating
mode and REGISTER in registrations (defaults to 32 sec)
MAX_RETRY
{0/1/...} number of retries for BYE/REGISTER if 200 is not received
within timeout. retry happens IFF a 1xx has been received for the request
(sipstack takes care of retrans only until 1xx has been received), else
other end is assumed dead. (default 8)
RPORT
{ON/OFF} inserting "rport" tag in via. used for testing firewall traversals
in originating/registration modes (default off)
USER
{IP/PHONE/E164} used to force the user=ip/phone tag in the To url and
req URI for INVITE/REGISTER messages. for E164 users a "+" is also prepended
to username. (by default no user tag)
TRANSPORT
{UDP/TCP} used to force the transport type of the sip messages. (default
UDP)
Originating Mode Params:
MSG_FILE
{filename} name of the file that has sample msg (by default construct
a new invite)
SDP_MEDIA
{OFF/ON} fake sdp media (default ON)
RTP_PORT
{#} fake rtp port to use in Invites (Default 0). needed for interop
reasons, otherwise some endpoints reject calls
INVITE_TIMEOUT
{#} timeout in seconds for Invite messages (default 32 sec)
RANDOM
{ON/OFF} used to enforce randomness in users, else the user range are
iterated sequentially (default off)
Registration Mode Parameters:
CONTACT_HOST
{host[:port]} contact host in the contact url (defaults to FROM_HOST:UDP_PORT)
LEASE_TIME
{#} requested expiration value for the lease in seconds (default 3600
secs). can be set to 0 for deleting the registration with specified contact
Terminating Mode Parameters:
RING_TIME
{#} ring time in seconds (defaults to 0 for immediate setup)