How to Generate Diameter Traffic with Seagull

If followed all the steps in my blog post called “How to Install Seagull Diameter Test Tool on a Linux server” then you will now have the Seagull test tool installed in the following directory:

/opt/seagull

If it isn’t, then check you’ve followed all the steps in the “How to Install Seagull Diameter Test Tool on a Linux server“ article.

You should see the following sub-directories in the /opt/seagull directory:

[root@server1 seagull]# ls
config diameter doc logs run scenario

Here’s what they all mean:

/opt/seagull/doc directory contains documentation for all the installed protocols (if any documentation is available).
/opt/seagull/[protocol]/doc directory contains documentation for a specific protocol.

NOTE: As this series of blog articles are focused on Diameter, we’ll use the Diameter protocol from now on for this example.

/opt/seagull/diameter/config directory contains the XML configuration files and protocol dictionary files.
/opt/seagull/diameter/logs directory is initially empty but will contain execution log files when tests are run.
/opt/seagull/diameter/run directory contains the shell scripts used to run the client and server in order to execute your scenarios.
/opt/seagull/diameter/scenario directory contains configuration files that define the actual scenario (message sequence) to be run.

Step 1. Define the client configuration

Define the correct client configuration in

/opt/seagull/diameter/config/conf.client.xml

Step 2. Define the dictionary

Define the correct dictionary file in

/opt/seagull/diameter/config/base_ro.xml

Step 3. Define the scenario

Define the correct scenario file

/opt/seagull/diameter/scenario/ccr-cca.client.xml

Step 4. Create the run script

Edit the run script and make sure it uses the correct files that you have created

[root@server1 ~]# cd /opt/seagull/diameter/run
[root@server1 run]# vi start_client_gx_ccr_cca.ksh
!/bin/ksh
export LD_LIBRARY_PATH=/usr/local/bin seagull -conf ../config/conf.client.xml -dico ../config/base_ro.xml -scen ../scenario/ccr-cca.client.xml -log ../logs/ccr-cca.client.log -llevel ET

If you are using vi or vim, save and exit the file using x or wq

Step 5. Run the test!

Execute the run script to start the client

[root@server1 ~]# cd /opt/seagull/diameter/run
[root@server1 run]# ./start_client_gx_ccr_cca.ksh