ElGee - The Load Generator!

INDEX:
  1. intro
  2. location
  3. usage
  4. commands
  5. shutdown
Introduction:
ElGee - The Load Generator, is a VOCAL based s/w tool for generating SIP signaling load for testing large scale SIP deployments.   following are the important features of this tool:


Location:
binary                 : vocal/loadgen/elgee/bin.*/lz
configuration    : vocal/loadgen/elgee/Doc/elgee.conf

Usage:
ElGee can be invoked as follows:

Command Line Usage:    lz [-i <sampleMsg>] <source user#[@host[:port]]> <dest user#@host:port>

<sampleMsg> is an optional parameter to specify the filename of a sample SIP INVITE message. you can use it if you want to test your proxy with some specific header values in the test messages.

<source user#[@host[:port]]> should be something like 6000@x.x.x.x:pppp, the host and port are optional [default values are host = theSystem.getHostAddress(), port = 5060]

<dest user#@host:port> is same as above except no fields are optional (its not that smart yet!)

NOTE: this mode only allows for originating running mode!


Configuration File Usage:    lz [-i <sampleMsg>] -f <config file>

you can use ElGee more flexibly by using a config file. the different configurable parameters are:
General Parameters: Originating Mode Params: Registration Mode Parameters: Terminating Mode Parameters:
see the included elgee.conf  for more details.

Q. Why sample message?
A. well, you can have any "custom" headers/params etc that you may want to use in your load generation, hence just get a sample message with those headers and params (and their values!) and ElGee will generate invites with them intact. therefore, for example, to use TCP as transport, you'll need to use a sample message which has the transport param in Via and Req-Uri as TCP. (BOTH, the via and req-uri should have "trasport=TCP", or else only the request sent or reponse recieved will be in TCP, depending on wether req-uri or via has "tranport=TCP")

Command Interpretor:
User can interact with ElGee by a command interpretor. currently the commands supported by ElGee's command interpretor are: shutdown
to terminate ElGee you have to do a "ctl-C", unfortunately VOCAL api does'nt support a clean shutdown yet!