################################################################################################################
Files Delivered
################################################################################################################
sip_scenario.vN.N.NN.zip
Unzip the archive file and read the file readme.text

Compressed archive file consists of

readme.text
This file
a description of the capabilites and syntax of the sip_scenario program. This is a must to read.

sip_scenario.pl: 
This is the perl script source file.

sip_scenario.exe: 
This is an windows executable version of sip_scenario.pl that does not require perl to be preinstalled.

sip_scenario.ini
contains user preferences for the sip_scenario.pl program. This file is automatically included
when sip_scenario.pl is started. If the file is not present then this file is not used.
This file is optional.

ethereal_trace.dump
This is an actual ethernet trace of several Sip phones and a proxy. Ethereal was used to generate this file.

There are there sets of batch files that are delivered to show all the functions of sip_scenario.pl
There are several basic modes of operation for sip_scenario. The goal of these different configurations
is to show all the capabilities of the sip scenario generator tool. I expect that most users will change these
setting. I did. Some options will not be used. The most complex options will be used.
There will be a batch file for each of these modes.

1) Debug 
2) Test Documentation
3) Final Documentation
4) User Defined Scenarios

Batch Files
ethereal_trace_debug.bat
ethereal_trace_test_doc.bat
ethereal_trace_final_doc.bat
user_scenario.bat
test.bat

Output files
ethereal_trace_debug.html
ethereal_trace_debug_index.html
ethereal_trace_debug.txt
ethereal_trace_test_doc.html
ethereal_trace_test_doc_index.html
ethereal_trace_test_doc.txt
ethereal_trace_final_doc.html
ethereal_trace_final_doc_index.html
ethereal_trace_final_doc.txt
user_scenario.html
user_scenario_index.html
user_scenario.txt
test.html
test.html
test.txt

################################################################################################################
##### General Information
################################################################################################################

The command documentation and syntax is specified in the header section of the file sip_scenario.pl.

Each of the batch files describes that basic commands that are being illustrated.

Each of the four batch files contain illustration on various commands are used.

Print the first section of sip_scenario.pl to get a list of arguments that are possible.

################################################################################################################
##### Windows PC section.
################################################################################################################

sip_scenario.exe was tested on a Windows 2000 Intel PentiumIII PC.

Unzip all files from sip_scenario.zip and place them in a folder.

execute the following command from a command window

sip_scenario.exe ethereal_trace.dump 
This will generate four files
	ethereal_trace.txt 
	ethereal_trace.html 
	ethereal_trace_index.html 
	ethereal_trace_indexhtml.html 

Batch files illustrate other ways this program can be executed.

run one of the batch files that was included. for example use ethereal_trace_debug.bat
Run ethereal_trace_debug.bat 
1) double click on file ethereal_trace_debug.bat 
or
2) execute ethereal_trace.bat from a command window.
open a command window.
cd to the appropiate folder.
execute the following
cmd /c ethereal_trace_debug.bat

This will re-create the file ethereal_trace_debug.html

################################################################################################################
##### Debug 
################################################################################################################

1) Execute the batch file from the command using "cmd /c ethereal_trace_debug.bat"
	A) check for parsing errors if any
	B) check the reasons why packets were filtered out.
2) Insure all the required IP addresses are defined.
3) Is the file sip_scenario.ini defined in the local directory?

################################################################################################################
#####  Linux / Solaris Section
################################################################################################################

Unzip all files from sip_scenario.zip and place them in a folder.
execute the following command from a command window
ln -s sip_scenario.pl /usr/local/bin/sip_scenario
chmod a+x sip_scenario.pl
chmod a+x /usr/local/bin/sip_scenario

sip_scenario ethereal_trace.dump 
This will generate four files
	ethereal_trace.txt 
	ethereal_trace.html 
	ethereal_trace_index.html 
	ethereal_trace_indexhtml.html 

################################################################################################################