Локальный запуск модулей#
Для запуска требуется jar файл (уточнить у администратора).
SyTester обеспечивает два варианта запуска:
Запуск jar файла SyTester
Запуск утилиты модулей SyTester - sytester.sh
Минимальная версия Java 17.
1. Запуск jar файла SyTester#
Запуск мастера#
java --add-opens=java.base/java.nio=ALL-UNNAMED -Dorg.owasp.esapi.logSpecial.discard=true -jar SyTester-1.0-exec.jar -m
GUI интерфейс доступен по адресу http://localhost:8787/ при локальном запуске мастера.
Запуск генератора#
java --add-opens=java.base/java.nio=ALL-UNNAMED -Dorg.owasp.esapi.logSpecial.discard=true -jar SyTester-1.0-exec.jar -g
Если требуется запустить на генераторе конкретный тестовый план, не используя web интерфейс SyTester, запущенного, в режиме мастера, то требуется при запуске указать абсолютный или относительный путь к файлу, содержащему тестовый план для запуска. Путь передается под ключем tp. Пример команды для запуска SyTester в режиме генератора с запуском конкретного тестового плана сразу при запуске.
java --add-opens=java.base/java.nio=ALL-UNNAMED -Dorg.owasp.esapi.logSpecial.discard=true -jar SyTester-1.0-exec.jar -g -tp C:\Users\******\Downloads\http-json-gen-sync.json
Пример команды для запуска генератора в тестовом сценарии которого необходимы proto-файлы protofile1, protofile2, …, protofilek:
java --add-opens=java.base/java.nio=ALL-UNNAMED -Dorg.owasp.esapi.logSpecial.discard=true -jar SyTester-1.0-exec.jar -g -tp "testplan.json" -proto "protofile1.proto protofile2.proto ... protofilek.proto"
В таком режиме запуска управление тестовым планом через веб интерфейс мастера не осуществляется(и генератор не обращается к мастеру за получением команд).
После завершения тестового плана SyTester генератор завершит свою работу, и сформируются отчеты в текстовом файле по пути /sytester-reports/.
Примеры отчетов можно посмотреть в папке отчет / отчет_с_ошибками.
Запуск заглушки#
java --add-opens=java.base/java.nio=ALL-UNNAMED -Dorg.owasp.esapi.logSpecial.discard=true -jar SyTester-1.0-exec.jar -s
Выше представлен запуск заглушки для протоколов: IBM MQ и Kafka. Для запуска HTTP заглушки в команду выше необходимо добавить еще один параметр со значением: -httpstubmode, а для GRPC заглушки -grpcstubmode.
java --add-opens=java.base/java.nio=ALL-UNNAMED -Dorg.owasp.esapi.logSpecial.discard=true -jar SyTester-1.0-exec.jar -s -httpstubmode true
2. Скрипт для запуска всех модулей SyTester#
sytester.sh Запускает все модули SyTester. Исполняется в одной директории с jar файлом "SyTester-1.0-exec.jar".
Для указания модулей, которые следует запустить, используются ключи утилиты. Для конфигурации запускаемых модулей используются параметры утилиты. Для целей отладки утилиты используются дополнительные ключи.
В случае запуска утилиты без аргументов (ключей и параметров), происходит запуск всех модулей со стандартной конфигурацией.
./sytester.sh
Для получения справки по работе скрипта используется аргумент help.
./sytester.sh help
Bash-скрипт запускает SyTester jar в фоновых процессах. При остановке происходит остановка всех фоновых процессов.
Ключи запуска модулей#
Ключ |
Назначение |
|---|---|
-m |
Запуск мастера |
-g | -g <port> |
Запуск генератора на стандартном/заданном порту |
-mq_s | -mq_s <port> |
Запуск MQ-заглушки на стандартном/заданном порту |
-http_s | -http_s <port> |
Запуск HTTP-заглушки на стандартном/заданном порту |
-grpc_s | -grpc_s <port> |
Запуск GRPC-заглушки на стандартном/заданном порту |
-all |
Запуск всех модулей |
Параметры запуска модулей#
Параметр |
Назначение |
|---|---|
-tp <path> |
Конфигурация пути до тестового плана, который выполняется генератором в режиме работы без мастера |
-proto "<path1> … <pathN>" |
Список путей до proto-файлов, которые используются тестовым планом в режиме работы без мастера |
Параметры, модули которых запускать не требуется, игнорируются.
Дополнительные параметры#
Параметр |
Назначение |
Значение по умолчанию |
|---|---|---|
-delay <delay> |
Задержка в секундах после запуска мастера перед запуском остальных модулей |
5 |
-jar <path> |
Путь до SyTester jar |
SyTester-1.0-exec.jar |
Ключи отладки#
Параметр |
Назначение |
|---|---|
-not_start |
Не запускать никакие модули. Утилита завершает свою работу после вывода конфигурации запуска |
-logs |
Вывод отладочных логов утилиты |
Примеры запуска#
Запуск всех модулей с задержкой после запуска мастера
./sytester.sh -all -delay 10
Запуск мастера, генератора и HTTP-заглушки на порту 8237
./sytester.sh -m -g -http_s 8237
Запуск генератора с запуском тестового плана в режиме работы без мастера
./sytester.sh -g -tp http-json-gen-sync.json
Запуск генератора с запуском тестового плана в режиме работы без мастера с proto-файлами, необходимыми для тестового плана
./sytester.sh -g -tp http-json-gen-sync.json -proto "file1.proto file2.proto"
Запуск мастера, генератора и HTTP-заглушки с установленным путем до jar файла
./sytester.sh -m -g -http_s -jar target/SyTester-1.0-exec.jar