Com o adaptador da linha de comandos, é possível usar uma máquina de teste
de destino para execução da linha de comandos. Você deve registrar o adaptador na máquina de teste de destino para executar scripts da linha de comandos.
Antes de Iniciar
- Certifique-se de que a plataforma em que você planeja executar o adaptador da linha
de comandos suporte um mínimo de Java versão 1.5 ou posterior .
- O arquivo executável java.exe
deve ser acessível no caminho na máquina de teste de destino.
- Para iniciar o adaptador, deve-se ter estas informações:
- A URL do repositório do jazz, geralmente https://qmserver:port/qm
- Um ID de usuário que tenha as licenças apropriadas para efetuar logon como um adaptador
- A senha deste usuário
- O nome da área do projeto, se não for a área de projeto padrão
do Quality Management
- O aplicativo Quality Management deve estar em execução no servidor.
Importante: É possível executar mais de
um adaptador em uma máquina de teste de destino, mas cada adaptador deve ser um processo
separado com um nome exclusivo especificado na opção -adapterName.
Sobre Esta Tarefa
O adaptador de linha de comandos deve estar configurado e iniciado na máquina de teste de destino.
Procedimento
Conclua estas etapas na máquina de teste de destino:
- Obtenha o arquivo install-location\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip a partir da máquina de instalação. Um administrador do servidor com
acesso de leitura ao servidor pode precisar obter o arquivo compactado para
você.
- Extraia o arquivo RQMCommmandLineAdapter.zip para uma pasta da máquina de teste de destino.
- Opcional: Customize os resultados do script real,
mostrados no registro de execução do caso de teste ou no registro de execução do suíte de
teste. Para obter informações adicionais, consulte
Customizando o Adaptador da Linha de Comandos.
- Se você usar a versão 5.0 ou mais recente e desejar que os adaptadores da linha de comandos
entreguem várias solicitações em paralelo, é possível ativar esse recurso,
que fica desativado, por padrão. O recurso é ativado
incluindo-se uma propriedade. Se você não incluir a propriedade ou se configurá-la
com um valor inválido, quando vários testes forem enviados para um adaptador, eles
serão enfileirados para serem executados conforme foram recebidos.
Dica: Usar o
adaptador da linha de comandos para executar testes em paralelo é melhor para testes de
longa execução. O adaptador seleciona testes um a um com base em sua capacidade
de executar cada teste. Ele seleciona um script, inicia sua execução e, em seguida,
seleciona outro script para executar. Se os scripts forem curtos, pode
parecer que estão sendo executados em sequência.
Para ativar a execução de
teste em paralelo em um adaptador da linha de comandos:- Na máquina de destino de teste, abra o arquivo CommandLine.properties
ou um arquivo de preferências equivalente.
- Inclua a propriedade a seguir no arquivo: com.ibm.rqm.commandline.maxservedrequests=N
em que N é o número máximo de testes
a serem executados simultaneamente.
- Se o adaptador da linha de comandos estiver ativo, reinicie-o.
Quando o máximo especificado for atingido, os testes
enviados para o adaptador serão enfileirados para serem executados conforme houver espaço disponível.
- Inicie o adaptador da linha de comandos.
- Para
iniciar o adaptador da linha de comandos pela primeira vez:
Execute o arquivo em lote com os argumentos da linha de comandos, conforme mostrado:
C:\ start.bat -repository https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
[-projectArea project area] [-sleepTime sleep
time] [-configFile configuration file]
Para obter informações adicionais, consulte
Customizando o Adaptador da Linha de Comandos.
Execute
o shell script com os argumentos da linha de comandos, conforme mostrado:
$ start.sh -repository https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
[-projectArea project area] [-sleepTime sleep
time] [-configFile configuration file]
em que:
- qmserver é o nome do host ou o endereço IP
do servidor de gerenciamento de qualidade.
- port é a porta na qual o servidor de gerenciamento de
qualidade está em execução
- userid é um ID de usuário registrado para o gerenciamento de
qualidade que possui a licença para executar um adaptador.
- passwors é a senha do ID do usuário enviado.
- adapter-name é um nome de adaptador que o usuário
designou.
- project area é o nome do projeto no qual
está sendo efetuado login.
- sleep time é o intervalo de pesquisa entre pesquisas de tarefas. A configuração padrão é de 5 segundos.
- configuration file é o arquivo para armazenar e ler as configurações deste adaptador. O nome do arquivo padrão é config.ini.
O adaptador gera um arquivo de configuração para conter
as informações de registro. O arquivo de configuração é o arquivo config.ini
ou o arquivo especificado na opção -configFile.
Essas informações são reutilizadas quando o adaptador é reiniciado.
- Para
reiniciar o adaptador da linha de comandos a partir de um arquivo config.ini:
: Execute o arquivo em lote sem nenhum argumento:
C:\ start.bat
: Execute o shell script sem os argumentos de linha de comandos:
$ start.sh
Nota: Espera-se que o arquivo de configuração esteja no diretório do qual o adaptador foi iniciado.
Resultados
O sistema gera uma mensagem semelhante a esta:
Launching Adapter…
Configuration file adapterConfig.ini does not exist, adapter will use the arguments passed
Successfully created an HTTP client
The adapter is now connected
Created Commandline Adapter
O que Fazer Depois
É possível verificar o estado do adaptador no aplicativo Quality Management na máquina do testador clicando em . Certifique-se de que
o status seja verde antes de tentar executar um teste em um adaptador da linha de comandos em execução.