Configurando e Iniciando o Adaptador da Linha de Comandos

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

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.
Configuração da Execução da Linha de Comandos

Procedimento

Conclua estas etapas na máquina de teste de destino:

  1. 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ê.
  2. Extraia o arquivo RQMCommmandLineAdapter.zip para uma pasta da máquina de teste de destino.
  3. 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.
  4. 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:
    1. Na máquina de destino de teste, abra o arquivo CommandLine.properties ou um arquivo de preferências equivalente.
    2. 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.

    3. 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.
  5. Inicie o adaptador da linha de comandos.
    • Para iniciar o adaptador da linha de comandos pela primeira vez:
      Ícone do Windows
      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.
      Ícone do Linux
      Ícone do Unix
      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:
      Ícone do Windows
      : Execute o arquivo em lote sem nenhum argumento:
      C:\ start.bat
      Ícone do Linux
      Ícone do Unix
      : 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 Execução > Console do Adaptador. Certifique-se de que o status seja verde antes de tentar executar um teste em um adaptador da linha de comandos em execução.

ícone de vídeo Assistir a vídeos

Lista de execução do CLM
Canal do Jazz.net
Canal de educação do usuário

ícone aprender Aprenda mais

Círculo de aprendizado do CLM
Círculo de aprendizado do Agile
Círculos de aprendizado

ícone perguntar Fazer perguntas

Fórum do Jazz.net
Fóruns do developerWorks

ícone de suporte Obter suporte

Portal de suporte
Wiki de implementação
Blog de suporte