Выполнение теста или расписания из командной строки

Тест или расписание можно выполнить из командной строки вне рабочей области Eclipse и автоматически экспортировать результаты.

Прежде чем начать

Для запуска теста или расписания в системе Linux требуется сервер X Windows даже в том случае, если тест запускается из командной строки. Дополнительные сведения приведены в разделе Выполнение тестов из командной строки в Linux.

Если при наличии общей оболочки IBM® Rational Test Workbench Web UI Tester или IBM Rational Performance Tester с IBM Rational Test Workbench Mobile Test Edition запускается мобильный тест, переведите клиент мобильного тестирования в пассивный режим и закройте продукт.

Об этой задаче

Для отслеживания теста можно открыть отчеты в веб-браузере. См. раздел Удаленный доступ к отчетам
Прим.: В командной строке нельзя указать пароль защищенного хранилища для мониторинга ресурсов. Пароль указывается в рабочей среде. Его следует сохранить в расписании перед запуском расписания из командной строки.

Процедура

  1. Для выполнения теста или расписания из командной строки перейдите в каталог, в котором находится файл cmdline.bat или cmdline.sh. В операционной системе Windows, как правило, применяется каталог productInstallationDirectory/cmdline, например, C:\Program Files\IBM\SDP\cmdline.
  2. Выполните следующую команду:

    cmdline -workspace полный-путь-к-рабочей-области -project относительный-путь-к-проекту -eclipsehome полный-путь-к-eclipse -plugins полный-путь-к-модулю -schedule относительный-путь-к-планировщику -suite относительный-путь-к-комплекту -varfile полный-путь-к-файлу-переменных -servicename служба -serviceargs аргументы-службы -configfile полный-путь-к-файлу -results файл-результатов -overwrite {true | false} -quiet -users nn -vmargs аргументы-JVM -exportlog полный-путь-к-протоколу -exportstats путь-к-локальному-каталогу -exportstatshtml путь-к-локальному-каталогу -compare "конечный-путь-1, конечный-путь-2" -exportstatreportlist список-статистики -usercomments "любой комментарий пользователя"

    Если в каком-либо значении есть пробелы, заключите его в кавычки. Для просмотра электронной справки по этой команде перейдите в каталог, где находится файл .bat, и введите команду cmdline -help.

    В следующей таблице описаны параметры команды:

    Опция Описание
    -workspace Обязательный параметр. Полный путь к рабочей области Eclipse.
    -project Обязательный параметр. Путь к проекту, включая имя файла, относительно рабочей области.
    -eclipsehome Обязательный параметр. Полный путь к каталогу, в котором находится файл eclipse.exe.
    -plugins Обязательный параметр. Полный путь к папке с модулями. Как правило, в операционной системе Windows эта папка называется C:\Program Files\IBM\IBMIMShared\plugins.
    -schedule Необязательный параметр, однако должен быть задан один из параметров -schedule, -suite и -servicename. Путь к выполняемому расписанию, включая имя файла, относительно проекта.
    -suite Необязательный параметр, однако должен быть задан один из параметров -schedule,-suite или -servicename. Путь к выполняемому тесту, включая имя файла, относительно проекта.
    -varfile Необязательный параметр. Полный путь к файлу XML с переменными и их значениями.
    -servicename Необязательный параметр, однако должен быть задан один из параметров -schedule,-suite или -servicename. Имя выполняемой службы. Вместо теста производительности запускается указанная служба, когда она становится доступна.
    -serviceargs Необязательный параметр. Аргументы, передаваемые службе, указанной в параметре -servicename. Например, -serviceargs "-myserviceparm1 myserviceparm1value". Значения указаны в кавычках, потому что в них есть пробелы.
    -configfile Необязательный параметр. Полный путь к файлу с параметрами выполняемого теста или расписания. Каждый параметр должен быть указан в отдельной строке. Для создания файла конфигурации воспользуйтесь редактором без переноса строк. В файле конфигурации можно задать как обязательные, так и необязательные параметры. Параметры командной строки имеют более высокий приоритет, чем значения в этом файле.
    Прим.: Файл должен быть сохранен в формате UTF-8. Не пользуйтесь кавычками в этом файле, даже если значения содержат пробелы.
    -results Необязательный параметр. Имя файла результатов. По умолчанию результаты записываются в файл с именем теста или расписания, к которому добавлено системное время. Укажите имя папки относительно проекта для хранения результатов теста. Например, -results folder/resultname.
    -overwrite Необязательный параметр. Указывает, нужно ли заменять файл результатов с таким же именем. Значение по умолчанию false указывает, что создается новый файл результатов. Если указано значение true, то файл заменяется и имя файла остается прежним.
    -quiet Необязательный параметр. Отключает вывод сообщений из программы запуска и возвращает управление в командную строку после завершения выполнения или попытки выполнения.
    -users Необязательный параметр. Изменяет количество виртуальных пользователей в данном прогоне. Для расписания количество виртуальных пользователей по умолчанию задается в редакторе расписаний. Для теста по умолчанию используется один пользователь. Данный параметр создает новую копию расписания с указанным количеством пользователей.
    -vmargs Необязательный параметр.

    Для того чтобы указать максимальный размер кучи Java для процесса Java, который управляет воспроизведением командной строки, воспользуйтесь опцией -vmargs с аргументом -Xmx. Например, когда указано -vmargs -Xmx4096m, задается максимальный размер кучи 4096 МБ. Также можно указать -Xmx4096m в файле eclipse.ini рабочей среды во время воспроизведения теста из пользовательского интерфейса.

    Для облачного выполнения укажите -vmargs -Dcloudcostconfirm.

    -exportlog Необязательный параметр. Полный путь к файлу, в котором будет сохранен экспортированный протокол теста HTTP.
    -exportstats Необязательный параметр. Полный путь к каталогу, в котором будут сохранены экспортированные данные статистического отчета. Данные статистического отчета сохраняются в формате CSV в файле, имя которого создается на основе имени отчета. Если параметр -exportstatreportlist не указан, то экспортируются отчеты, указанные на странице Экспортировать отчеты окна параметров Отчет о тесте производительности.

    Атрибут -timerange можно указать вместе с атрибутом -exportstats для экспорта данных конкретных диапазонов времени. В качестве значения укажите диапазон времени из расписания. Пример: "5 Users,10 Users". В качестве разделителя применяется запятая; значение с пробелами должно быть заключено в двойные кавычки.

    -exportstatshtml

    Используйте -exportstatshtml только когда требуется экспортировать результаты веб-аналитики. Результаты экспортируются в указанный каталог. Анализируйте результаты в веб-браузере без использования рабочей среды тестирования.

    -compare

    Атрибуты -compare и -exportstatshtml позволяют экспортировать результаты в режиме сравнения. В качестве значения можно указать пути к сеансам относительно рабочей области. Пути разделяются запятой.

    -exportstatreportlist Необязательный параметр. Список указанных через запятую абсолютных путей к файлам форматов пользовательских отчетов (файлам .view), которые должны применяться для экспорта данных статистического отчета с параметром -exportstats. Этот параметр имеет более высокий приоритет, чем параметры рабочей области. Пример: -exportstatreportlist c:/customreport.view,c:/customreport2.view.
    -usercomments Необязательный параметр. Текст, указанный в двойных кавычках, будет записан в строку пользовательских комментариев отчета.
    Прим.: В системе Windows для добавления комментариев на внутреннем языке, который может не поддерживать символы Unicode, команду рекомендуется выполнять с помощью файла CommandLine.exe.
    Прим.:
    • Сообщения выдаются при запуске теста или расписания и при его завершении, если не задан параметр -quiet.
    • Эта команда блокирует рабочую область. Для просмотра хода выполнения теста или расписания нужно открыть другую рабочую область и открывать проект в ней.

Пример

Прим.: Файл конфигурации должен содержать информацию в формате параметр=значение. Хотя пути с пробелами нужно заключать в кавычки в командной строке, кавычки не требуются в файле конфигурации. Пример файла конфигурации:
workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite

Дальнейшие действия

После выполнения теста или расписания целесообразно экспортировать результаты. Дополнительная информация приведена в разделе Автоматический экспорт счетчиков отчета.

Комментарии