Executando um Planejamento na Linha de Comandos

É possível executar um planejamento ou um teste de linha de comandos fora da área 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. Nos sistemas operacionais UNIX, o arquivo executável está localizado por padrão no diretório /opt/IBM/SDP/jdk/bin/. Nos sistemas operacionais Windows, o arquivo executável é instalado por padrão no diretório C:\Program Files\IBM\SDP\jdk\bin\. 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, acesse o diretório que contém os arquivos cmdline.bat e cmdline.sh. Nos sistemas operacionais Windows, este diretório geralmente é 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 -eclipsehome eclipse_full_path -plugins plugin_full_path -schedule sched_rel_path -suite suite_rel_path -servicename service -serviceargs service_args -configfile file_full_path -results result_file -overwrite {true | false} -quiet -users nn -vmargs JVM_args -exportlog log_full_path -exportstats stats_full_path -exportstatreportlist stats_list

    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 a área de trabalho do Eclipse.
    -project Obrigatório. O caminho, incluindo o nome do arquivo, do projeto relativo à área 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. Geralmente, nos sistemas operacionais Windows, este local de pasta é C:\Program Files\IBM\IBMIMShared\plugins.
    -schedule Opcional, mas você deve especificar a opção -schedule, -suite ou -servicename. O caminho incluindo o nome do arquivo do planejamento a ser executado relativo ao projeto.
    -suite Opcional, mas você deve especificar a opção -schedule, -suite ou -servicename. O caminho incluindo o nome do arquivo do teste a ser executado relativo ao projeto.
    -servicename Opcional, mas você deve especificar a opção -schedule, -suite ou -servicename. O nome do serviço que será executado. Em vez de executar um planejamento ou teste de desempenho, o serviço especificado será executado quando se tornar disponível.
    -serviceargs Opcional. A série de argumentos que serão transmitidos para o serviço especificado pela opção -servicename. Por exemplo, -serviceargs "-myserviceparm1 myserviceparm1value". Os valores estão entre aspas porque contêm espaços.
    -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. Para criar um arquivo de configuração, use um editor que não quebre linhas. 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 retorna ao shell de comando quando a execução ou tentativa de execução é 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.
    -exportlog Opcional. O caminho completo para um arquivo no qual armazenar o log de teste de HTTP exportado.
    -exportstats Opcional. O caminho completo para um diretório no qual armazenar dados do relatório de estatísticas exportados. Os dados do relatório de estatísticas são armazenados no formato comma-separated-values (CSV), com o nome de arquivo derivado do nome de relatório. Se a opção -exportstatreportlist não for especificada, os relatórios especificados na página Exportar Relatórios das preferências Relatório de Teste de Desempenho serão exportados.
    -exportstatreportlist Opcional. Uma lista separada por vírgula de caminhos absolutos para customizar arquivos de formato de relatório (arquivos .view) que serão usados ao exportar os dados estatísticos do relatório com a opção -exportstats. Esse parâmetro substitui as preferências da área de trabalho. Por exemplo, -exportstatreportlist c:/customreport.view,c:/customreport2.view.
  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