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

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

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

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

Прим.: В Mac OS X возможность выполнения тестов из командной строки не предусмотрена.

Процедура

  1. Для выполнения теста или расписания из командной строки перейдите в каталог, в котором находится файл cmdline.bat или cmdline.sh. В операционной системе Windows этот каталог обычно называется productInstallationDirectory/cmdline. Сценарии автоматического тестирования могут пользоваться этим файлом для выполнения тестов или расписаний.
  2. Выполните следующую команду:

    cmdline -workspace полный-путь-к-рабочей-области -project относительный-путь-к-проекту -eclipsehome полный-путь-к-eclipse -plugins полный-путь-к-модулям -schedule относительный-путь-к-расписанию -suite относительный-путь-к-комплекту -varfile полный-путь-к-файлу-переменных -servicename служба -serviceargs переменные-службы -configfile полный-путь-к-файлу -results файл-результатов -overwrite {true | false} -quiet -users число -vmargs аргументы-JVM -exportlog полный-путь-к-протоколу -exportstats полный-путь-к-статистике -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 Необязательный параметр. Имя файла результатов. По умолчанию результаты записываются в файл с именем теста или расписания, к которому добавлено системное время.
    -overwrite Необязательный параметр. Указывает, нужно ли заменять файл результатов с таким же именем. Значение по умолчанию true указывает, что файл результатов подлежит замене.
    -quiet Необязательный параметр. Отключает вывод сообщений из программы запуска и возвращает управление в командную строку после завершения выполнения или попытки выполнения.
    -users Необязательный параметр. Изменяет количество виртуальных пользователей в данном прогоне. Для расписания количество виртуальных пользователей по умолчанию задается в редакторе расписаний. Для теста по умолчанию используется один пользователь. Данный параметр создает новую копию расписания с указанным количеством пользователей.
    -vmargs Необязательный параметр. Аргументы, передаваемые в виртуальную машину Java. Например, -vmargs "-debug -Xmx512m". Значения указаны в кавычках, потому что в них есть пробелы. Для перехвата данных о мониторинге ресурсов укажите -vmargs "-Drm.collect=true -Drm.collect.interval=число больше 1000".
    -exportlog Необязательный параметр. Полный путь к файлу, в котором будет сохранен экспортированный протокол теста HTTP.
    -exportstats Необязательный параметр. Полный путь к каталогу, в котором будут сохранены экспортированные данные статистического отчета. Данные статистического отчета сохраняются в формате CSV в файле, имя которого создается на основе имени отчета. Если параметр -exportstatreportlist не указан, то экспортируются отчеты, указанные на странице Экспортировать отчеты окна параметров Отчет о тесте производительности.
    -exportstatreportlist Необязательный параметр. Список указанных через запятую абсолютных путей к файлам форматов пользовательских отчетов (файлам .view), которые должны применяться для экспорта данных статистического отчета с параметром -exportstats. Этот параметр имеет более высокий приоритет, чем параметры рабочей области. Пример: -exportstatreportlist c:/customreport.view,c:/customreport2.view.
    -usercomments Необязательный параметр. Текст, указанный в двойных кавычках, будет записан в строку пользовательских комментариев отчета.
    Прим.:
    • Сообщения выдаются при запуске теста или расписания и при его завершении, если не задан параметр -quiet.
    • Эта команда блокирует рабочую область. Для просмотра хода выполнения теста или расписания нужно открыть другую рабочую область и открывать проект в ней.

Пример

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

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

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

Комментарии