Configurando o Servidor da Web ClearQuest para Comunicação Entre Servidores

Use a janela Comunicação Entre Servidores da interface Configuração de Site para especificar um provedor de serviço OSLC de destino com o qual deseja estabelecer comunicação de servidor para servidor.

Sobre Esta Tarefa

Insira as informações sobre o local do servidor de destino e uma frase de código a ser usada como segredo OAuth. Em seguida, solicite acesso a esse servidor para criar uma chave do consumidor OAuth e armazene as informações na lista de amigos. Quando a chave OAuth for autorizada pelo outro servidor, o Servidor da Web ClearQuest poderá interagir com o servidor de destino.

Procedimento

  1. Efetue logon no ClearQuest Web como um usuário com privilégios Super Usuário.
  2. Clique em Administração do Site > Comunicação Entre Servidores na barra de ferramentas do ClearQuest Web. A janela Comunicação Entre Servidores é aberta.
  3. Especifique as informações solicitadas sobre o servidor de destino com o qual deseja estabelecer comunicação:
    1. No campo Título, insira um título para identificar um servidor de destino. Exemplo:
      • My RTC Server para identificar um servidor Rational Team Concert
      • My RQM Server para identificar um servidor Rational Quality Manager
      • My RNDG Server para identificar um servidor Rational DOORS Next Generation
      • Meu CQWeb Server2 para identificar outro Servidor da Web ClearQuest
    2. No campo URI de Serviços Raiz, insira o URI para os serviços raízes do aplicativo que deseja incluir como um amigo usando o seguinte formato:
      Para os produtos baseados no servidor Jazz:
      https://friend-server:port-number/context/rootservices
      em que as variáveis possuem as seguintes definições:
      friend-server
      Nome do host do servidor amigo.
      Atenção: Certifique-se de especificar o nome do host ao usar a URL pública com um nome de domínio completo. Não especifique o endereço IP.
      port-number
      Número da porta na qual o servidor é acessado.
      context
      Contexto do aplicativo. Esse é um parâmetro configurável. A seguir estão os valores padrão:
      • Rational Team Concert
        Atenção: O contexto do aplicativo para o Rational Team Concert foi alterado da versão 2.0.0.x para a versão 3.0 e posterior. Você deve atualizar o URI de Root Services na janela Administração do Site > Comunicação Entre Servidores se a comunicação entre servidores foi configurada anteriormente com o Rational Team Concert 2.0.0.x e você desejar agora configurar a comunicação com o Rational Team Concert 3.0 e posterior.
        • No Rational Team Concert 2.0.0.x: jazz
        • No Rational Team Concert 3.0 e posterior: ccm
      • Rational Quality Manager:
        Atenção: O contexto do aplicativo para o Rational Quality Manager foi alterado na versão 3.0.1 e posterior. Você deve atualizar o URI de Root Servicesna janela Administração do Site > Comunicação Entre Servidores se a comunicação entre servidores foi configurada anteriormente com uma versão anterior do Rational Quality Manager.
        • No Rational Quality Manager 3.0: jazz
        • No Rational Quality Manager 3.0.1: qm
      • Versões específicas do Rational Requirements Composer:
        • No Rational Requirements Composer 3.0.1: rm
        Atenção: Se o upgrade de um projeto do Rational Requirements Composer 2.x for feito para 3.0.1, você deverá reter o contexto do aplicativo rdm em vez de usar o contexto rm. Consulte os seguintes tópicos para obter detalhes:

      Exemplos

      A seguir há vários exemplos dos URIs de Root Servicespara os provedores de serviços OSLC baseados em servidor Jazz:

      https://jazz1.bldg1.india.mycompany.com:9443/ccm/rootservices

      https://jazz4.bldg5.japan.mycompany.com:9443/qm/rootservices

      https://jazz4.bldg5.spain.mycompany.com:9443/rm/rootservices

      Para o Servidor da Web ClearQuest:
      Atenção: O contexto do aplicativo para o servidor da Web ClearQuest foi alterado de Rational ClearQuest versão 7.1.1 (oslc/cqrest) para a versão 7.1.2 (cqweb/oslc). Você deve atualizar qualquer código que usa o URI do ClearQuest OSLC Change Management para usar o novo URI base, conforme descrito a seguir. Consulte a Especificação de API do ClearQuest OSLC Change Management em https://jazz.net/wiki/bin/view/Main/RcmRestCmApi para obter detalhes.
      Atenção: Configurar a comunicação do Servidor da Web do ClearQuest para usar o SSL é altamente recomendado porque uma senha do usuário é enviada em formato texto não criptografado quando o usuário efetua logon.
      • Para o ClearQuest versões 7.1.2 e 7.1.2.1:
        Atenção: Para o ClearQuest versões 7.1.2 e 7.1.2.1, o SSL é suportado apenas na porta 12443. A ajuda instantânea completa não funciona quando a porta 12443 é usada.
        • Se o SSL estiver configurado:

          https://hostname:12443/context/oslc/repo/dbset/discovery

        • Se o SSL não estiver configurado:

          http://hostname/context/oslc/repo/dbset/discovery

      • Para o ClearQuest versão 7.1.2.2:
        • Se o SSL estiver configurado:

          https://hostname/context/oslc/repo/dbset/discovery

        • Se o SSL não estiver configurado:

          http://hostname/context/oslc/repo/dbset/discovery

      em que as variáveis possuem as seguintes definições:
      hostname
      Nome do host do servidor amigo.
      Atenção: Certifique-se de especificar o nome do host ao usar a URL pública com um nome de domínio completo. Não especifique o endereço IP.
      context
      Contexto do aplicativo. Por exemplo, cqweb para o servidor da Web ClearQuest.
      dbset
      Nome do Repositório (conjunto de banco de dados)

      O nó discovery no URI é o servidor da Web ClearQuest equivalente do URI rootservices do servidor Jazz.

      Exemplo

      Para o ClearQuest versão 7.1.2.2, a seguir há um exemplo de um URI de Root Servicespara um provedor de serviços OSLC baseado no Servidor da Web ClearQuest configurado para usar a comunicação SSL:

      https://cqweb4.bldg4.china.mycompany.com/cqweb/oslc/repo/mydbset/discovery

    3. . Nos campos Segredo OAuth e Redigitar Segredo, insira uma frase de código de Segredo OAuth a ser associada á nova chave do consumidor OAuth.
      Atenção: Nesta etapa, não insira a própria chave, insira uma frase mais curta para ser associada à chave.
    4. Opcional: Marque a caixa de seleção Confiável. Consumidores confiáveis podem compartilhar a autorização com outros consumidores confiáveis e não requerem aprovação do usuário para acessar os dados.
      Atenção: Para produtos ou Web sites externos, é uma melhor prática desmarcar a caixa de seleção Confiável.
    5. Clique em Solicitar Acesso. Uma chave provisória é solicitada no servidor de destino e as informações de acesso são incluídas na seção de Lista de Amigos do Servidor da página. Uma nova entrada é incluída na seção Autorizar Chave Provisória.
    6. Autorize a chave do consumidor OAuth provisória.
      Nesse ponto, a solicitação de acesso não é autorizada no servidor de destino. Use um dos seguintes métodos para aprovar a solicitação:
      1. Clique em Conceder acesso para a chave provisória se esse link aparecer na seção Autorizar Chave Provisória e você tiver privilégios de administrador (membro do grupo JazzAdmins para servidores baseados em Jazz) no servidor de destino.
        • Se o servidor de destino for um servidor baseado em Jazz, consulte a ajuda doRational Team Concert para obter instruções sobre como autorizar uma chave provisória.
        • Se o servidor de destino for outro servidor da Web ClearQuest, consulteAprovando uma Chave do Consumidor OAuth.
        Nota: O link Conceder acesso para a chave provisória não aparecerá se o provedor OAuth não fornecer um URI de autorização. O Rational ClearQuest e o Rational Team Concert podem fornecer esse link; o Rational Quality Manager não fornece. Você deverá escolher essa opção se o link Conceder acesso para a chave provisória não aparecer na seção Autorizar Chave Provisória ou se não tiver privilégios de administrador no servidor de destino.
      2. Registre o valor de chave provisório. Se você tiver privilégios de administrador no servidor de destino, será possível efetuar logon no servidor de destino e aprovar a solicitação por si só. Caso contrário, você deverá solicitar ao administrador do servidor de destino para aprovar sua solicitação. Pode ser necessário fornecer o valor de chave provisório para o administrador do servidor de destino.

Feedback