Configuraiton

SG-Runner:

Directory definition

Root directory: /opt/sea/sg-runner

Configuration precedence:
- Test-specific configuration overrides environment configuration.
- Environment configuration overrides common configuration.
Scenario configuration:
- Provides default values when no more specific configuration applies.
- Acts as a fallback mechanism.
Scenario templates:
- Driven by the Jinja2 templating engine.

/opt/sea/sg-runner
├── bin/        # Executable tools
├── sbin/       # Main sg-runner scripts
├── etc/        # Common configuration
├── docs/       # Documentation
├── sw/         # Extra tools and software
├── store/      # Test store
└── shared/     # Test execution directories

Test Store

store/
├── env/            # Environment settings
├── scens/          # Scenario settings
│   └── dico/       # Dictionary files
└── tests/          # Test setup
    └── data/       # Test data

Test Exeutions directories

shared/
├── .run/                 # Symlink to the last test execution directory
├── runs/                 # Contains all test execution directories
├── tests/
│   └── <test_name>/      # Symlinks to test execution directories by test
└── hosts/
    └── <host_name>/      # Symlinks to test execution directories by host

Environment definition

Main enviroment file: ./env/<env_name>/.yml

Parameter	Description
`env_name`	Environment used for the setup.
`ScenEnv`	File containing the main environment configuration for a specific scenario
`envName`	Same as the file name, without the extension
`envDesc`	Description of the environment node
`envSeagull`	Seagull configuration details (see below)
`envJmeter`	JMeter configuration details (see below)

Test definition

Main test file: ./test/<test_name>/test.yml
Test data: ./test/<test_name>/data/

Parameter	Description
`TestName`	Must match the test directory name (`<test_name>`).
`TestDesc`	Human-readable test description.
`TestEnv`	Environment configuration name (environment directory).
`ScenName`	Scenario name used by the setup script.
`ScenStore`	Main configuration source for the scenario.
`ScenEngine`	Scenario engine: • `SG` – Seagull • `JM` – JMeter
`ScenEnv`	Scenario environment configuration (file name without extension).
`ScenAttr`	Attributes applied to the selected scenario.
`sourceDataFile`	Path to the source data file (e.g. `./test/data/profile_C.csv`).

Seagull scenario defination

Scnearios configuraion

Scneario file: ./scens/<scen_name>/scen.yml

Parameter	Description
`scenName`	Main scenarion name
`scenDesc`	Human-readable test description.
`scenTemplates`	The seagull conf, scenario or report jinjaj templates
`Channels`	Attributes applied to the Gy/Sy connection. Required for new environments: IP, Port, Realm/Host
`reportSetup`	report generation settings
`dataAttr`	header number is line above data are valid, report template
`responseTimeRepartition`	Time intervals used to group and measure response times.
`logLevel`	Logging level: `A` (All), `W` (Warnings), `U` (User), `E` (Errors), `T` (Traffic events)
`backgroundExec`	Enables execution in the background.
`tcpdump`	Network capture configuration (interface and filter using `tcpdump` syntax).
`pcapEnabled`	Enables or disables packet capture globally.
`defaultBehaviour`	Deafult seagull beahaviour
`callTimeoutMs`	Call time out between messages drive TPS
`callTimeoutAbortBehaviour`	In case of tameout, no expected message recesived beahvaiour
`msgCheckBehaviour`	message check beahaviour

Perfromance test model

Test model: for perfromance test are given at Traffic Model file

JMeter scenario defination

Scnearios configuraion

Scneario file: ./scens/<scen_name>/scen.yml

Parameter	Description
`scenName`	Main scenarion name
`scenDesc`	Human-readable test description.
`scenTemplates`	The jmeter prop, scenario or report jinjaj templates
`reportSetup`	report generation settings
`dataAttr`	header number is line above data are valid, report template
`logLevel`	Logging level:
`backgroundExec`	Enables execution in the background.
`tcpdump`	Network capture configuration (interface and filter using `tcpdump` syntax).
`pcapEnabled`	Enables or disables packet capture globally.
`threadGroupTrNumber1`	Thread Group-1 thread’s number
`threadGroupRampUp1`	Thread Group-1 ramp up
`threadGroupLoop1`	Thread Group-1 loop counter
`reqTimeoutMs`	Request time out
`reqSleep1Ms`	Sleeping msec.

This is a general configuration, but it depends on the scenario itself.

Perfromance test model

Test model: is very similar as seagull test model

Getting Started Procedures