Локальный запуск#
Для запуска требуется 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
2. Скрипт для запуска всех модулей SyTester#
sytester.sh Запускает все модули SyTester. Исполняется в одной директории с jar файлом "SyTester-1.0-exec.jar".
Для указания модулей, которые следует запустить, используются ключи утилиты. Для конфигурации запускаемых модулей используются параметры утилиты. Для целей отладки утилиты используются дополнительные ключи.
Для получения справки по работе утилиты используется аргумент 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
Запуск всех модулей с задержкой после запуска мастера
./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
Часто встречающиеся проблемы и пути их устранения#
Возможные варианты проблем |
Уведомление в консоли |
Варианты решения проблемы |
|---|---|---|
Не стартует один из модулей |
port already in use |
Проверьте не занят ли порт каким либо процессом. Завершение процесса "kill −9 PID" |
Необходим запуск чистого экземпляра ситестер без пользователей и тестовых сценариев |
- |
Перейти в каталог пользователей "cd ~" удалить файл "sytester.db" Запусть заново SyTester. |