Executando um Planejamento na Linha de Comandos

É possível executar um planejamento ou um teste de linha de comandos fora do espaço de trabalho do Eclipse e automaticamente exportar os resultados.

Antes de Iniciar

Verifique se um arquivo Java executável (java.exe) suportado está no caminho antes de tentar executar um planejamento ou teste a partir da linha de comandos. Um arquivo executável Java suportado é fornecido com o produto. Em sistemas operacionais UNIX, o arquivo executável está localizado em .../jdk/bin/java. Em sistemas operacionais Windows, o arquivo está localizado em ...\jdk\bin\java.exe. No Linux, um servidor X deve estar disponível, mesmo ao executar a partir da linha de comandos. Consulte Executando Testes a Partir da Linha de Comandos no Linux para obter mais informações.

Procedimento

  1. Para executar um planejamento ou teste a partir da linha de comandos, vá para o diretório que contém os arquivos cmdline.bat e cmdline.sh. Ele normalmente é C:\Program Files\IBM\IBMIMShared\plugins\com.ibm.rational.test.lt.cmdlineexecuteversion_date.
  2. Emita o seguinte comando:

    cmdline -workspace workspace_full_path -project proj_rel_path -schedule sched_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -configfile file_full_path -results result_file -overwrite {true | false} -quiet -users nn -vmargs JVM_args

    Se um valor contiver espaços, coloque o valor entre aspas. Para ver a ajuda on-line para este comando, enquanto estiver no diretório que contém o arquivo .bat, digite cmdline -help.

    A tabela a seguir explica cada opção:

    Opção Descrição
    -workspace Obrigatório. O caminho completo para o espaço de trabalho do Eclipse.
    -project Obrigatório. O caminho incluindo o nome do arquivo do projeto relativo ao espaço de trabalho.
    -eclipsehome Obrigatório. O caminho completo para o diretório que contém o eclipse.exe.
    -plugins Obrigatório. O caminho completo para a pasta que contém os plug-ins. Normalmente, essa pasta está localizada em C:\Program Files\IBM\IBMIMShared\plugins.
    -schedule Opcional, mas você deve especificar -schedule ou -suite. O caminho incluindo o nome do arquivo do planejamento a ser executado relativo ao projeto.
    -suite Opcional, mas você deve especificar -suite ou -schedule. O caminho incluindo o nome do arquivo do teste a ser executado relativo ao projeto.
    -configfile Opcional. O caminho completo para um arquivo que contém os parâmetros de execução de um planejamento ou teste. Cada parâmetro deve estar em uma única linha, portanto, utilize um editor que não cause o agrupamento da linha. Quaisquer parâmetros, sejam obrigatórios ou opcionais, podem ser configurados no arquivo de configuração. Os parâmetros da linha de comandos substituem os valores neste arquivo. Não utilize aspas neste arquivo, mesmo para valores que contenham espaços.
    -results Opcional. O nome do arquivo de resultados. O arquivo de resultado padrão é o nome de planejamento ou de teste com um registro de data e hora anexado.
    -overwrite Opcional. Determina se um arquivo de resultados com o mesmo nome será sobrescrito. O valor padrão true significa que o arquivo de resultados será sobrescrito.
    -quiet Opcional. Desativa toda saída de mensagem do ativador e simplesmente retorna ao comando shell quando a execução - ou a tentativa - é concluída.
    -users Opcional. Substitui o número padrão de usuários virtuais na execução. Para um planejamento, o padrão é o número de usuários especificados no editor de planejamento. Para um teste, o padrão é um usuário. Essa opção cria uma nova cópia do planejamento que contém o número especificado de usuários.
    -vmargs Opcional. Argumentos da Java Virtual Machine a serem transmitidos. Por exemplo, -vmargs "-debug -Xmx512m". Os valores estão entre aspas porque contêm espaços.
  3. As mensagens são exibidas para indicar quando o teste ou o planejamento é ativado e quando é concluído, a menos que você inclua a opção -quiet.
  4. Emitir o comando bloqueia a área de trabalho. Para verificar o progresso do planejamento ou do teste durante a execução, chame outra área de trabalho e abra o projeto por meio dessa área de trabalho.
  5. Ao retornar ao prompt de comandos, a execução estará concluída. Outra opção, é iniciar o Performance Tester para revisar os resultados. Para exportar automaticamente os resultados depois que a execução for concluída a partir da linha de comandos, clique em Windows > Preferências > Teste > Relatórios de Teste de Desempenho > Exportar Relatórios.

Exemplo

Nota: O arquivo de configuração deve conter informações nos pares option=value. Embora os caminhos que contêm espaços devam ser colocados entre aspas na linha de comandos, não coloque espaços entre aspas no arquivo de configuração. Um arquivo de configuração de amostra é semelhante ao mostrado a seguir:
workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite

O que Fazer Depois

Depois de executar o planejamento, você pode querer exportar os resultados. Para obter informações adicionais, consulte Exportando Contadores de Relatórios Automaticamente.

Feedback