Criando e Modificando uma Conexão Externa do Repositório

Uma conexão de repositório externo é um item do Rational Team Concert cujas propriedades contêm informações que o Jazz Team Server precisa para criar uma conexão com um repositório externo. Você precisa criar uma conexão de repositório externo para o ClearQuest Gateway.
Antes de Iniciar

Para criar, modificar e excluir conexões de repositório externo, você deve ser designado a uma Licença de Acesso ao Cliente do ClearQuest Connector ou Developer. Além disso, a área de projetos deve estar configurada para conceder permissões para sua função de usuário. Para configurar as permissões, abra a área de projetos, clique na guia Configuração do Processo, clique em Configuração do Projeto > Permissões e selecione uma função. Em seguida, selecione Conectores de Itens na lista Ações Permitidas.

Por Que e Quando Desempenhar Esta Tarefa

Você pode usar o Assistente de Configuração do ClearQuest Connector para criar uma conexão de repositório externo. Este tópico mostra como criar uma conexão do repositório externo utilizando o cliente Eclipse do Rational Team Concert. Ele também mostra como desativar ou ativar a sincronização de saída para a conexão do repositório externo. Se você criar uma conexão do repositório externo utilizando o Assistente de Configuração do ClearQuest Connector, você deve ativar a sincronização de saída para ele. O assistente cria a conexão do repositório externo com a sincronização de saída desativada.

Para criar uma conexão do repositório externa:

  1. Efetue login no cliente Rational Team Concert.
  2. Na visualização Artefatos da Equipe, clique com o botão direito do mouse na conexão do repositório e selecione Administrar > Regras de Sincronização. Na visualização Regras de Sincronização, clique com o botão direito do mouse em Conexões do Repositório Externa e selecione Nova > Conexão do Repositório Externa.
  3. Se você estiver registrado em mais de um repositório do Jazz, selecione um para o qual deseja criar uma conexão do repositório externa. Clique em Avançar. Na janela Conexão do Repositório Externa, digite um nome para a conexão no campo Nome. Digite o URI do ClearQuest Gateway no campo Informações de conexão. Por exemplo: http://YOUR-CQ-GATEWAY-HOST:8081/cqconnector/gateway. Se o servidor Tomcat que hospeda o ClearQuest Gateway está configurado para exigir a autenticação do usuário para seus pedidos de serviço, digite os valores nos campos ID de Usuário e Senha. Caso contrário, deixe esses campos em branco. O ID do usuário e a senha que você digita devem corresponder àqueles especificados no arquivo tomcat-users.xml no diretório diretório de instalação/gateway/tomcat/conf.

    É possível restringir o acesso à conexão do repositório externa pela configuração de permissões em uma área de projetos e, em seguida, selecionando essa área de projetos no campo Área de Projetos. Depois de configurar uma área de projetos para uma conexão do repositório externa, é impossível alterá-la. Se precisar configurar o campo para uma área de projetos diferente ou para nenhuma área de projeto, é possível excluir a conexão do repositório externa e criar uma nova.

    Se precisar temporariamente parar a sincronização a partir do servidor Jazz para este ClearQuest Gateway, selecione Desativar a sincronização de saída. Você pode desejar desativar a sincronização de saída ao executar manutenção no banco de dados do usuário do ClearQuest e ele estiver temporariamente indisponível. Para ativar a sincronização de saída, limpe a caixa de opção Desativar sincronização de saída. Clique em Salvar para salvar a conexão do repositório externa.

    Os números de porta padrão para conexões do repositório externa são 8444 para Secure Sockets Layer (SSL), e 8081 para conexões não-SSL. Para alterar um número de porta padrão, edite o arquivo server.xml no diretório /jazz/connectors/gateway/tomcat/conf. Para desativar conexões não-SSL e configurar o servidor Tomcat para exigir autenticação de usuário, execute as etapas a seguir:

    1. Inicie e pare o ClearQuest Gateway, que expande o arquivo cqconnector.war.
    2. Edite o arquivo server.xml no diretório install-directory/gateway/tomcat/conf para comentar este elemento:
      <Connector port="8081" maxHttpHeaderSize="8192"
          maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
          enableLookups="false" redirectPort="8444" acceptCount="100"
          connectionTimeout="20000" disableUploadTimeout="true" />
    3. Edite o arquivo web.xml no diretório install-directory/gateway/tomcat/webapps/cqconnector/gateway/WEB-INF para remover o comentário do seguinte elemento:
      <security-constraint>
         <web-resource-collection>
            <web-resource-name>secure</web-resource-name>
            <url-pattern>/*</url-pattern>
         </web-resource-collection>
         <auth-constraint>
            <role-name>*</role-name>
         </auth-constraint>
         <user-data-constraint>
            <transport-guarantee>CONFIDENTIAL</transport-guarantee>
         </user-data-constraint>
      </security-constraint>
    4. Abra o arquivo tomcat-users.xml no diretório /jazz/connectors/gateway/tomcat/conf. O ID de usuário e a senha padrão são cqconnector. Altere a senha. Opcionalmente, altere o ID do usuário.
    5. Por padrão, a senha no arquivo tomcat-users.xml não é armazenada de forma visível, mas e possível criptografá-la e configurar o Tomcat para reconhecê-la. Para fazer isso use o comando repotools-convertTomcatUsers. Navegue até o diretório JazzInstallDir/server/repotools. Insira o comando e especifique o caminho para o arquivo tomcat-users.xml Por exemplo:
      repotools –convertTomcatUsers tomcatUsersPath=install-directory/gateway/tomcat/conf/tomcat-users.xml

      O arquivo tomcat-users.xml convertido é nomeado como tomcat-users.xml.converted. Renomeie-o tomcat-users.xml. Se alguma vez for necessário alterar a senha, você deve alterá-la em uma cópia do arquivo original não codificado e, em seguida, executar o repotools -convertTomcatUsers novamente. Guarde o arquivo original não codificado em um local seguro.

      Depois de executar o comando, edite o arquivo server.xml no diretório /jazz/connectors/gateway/tomcat/conf da seguinte forma:

      Comentar a linha do seguinte elemento:

      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                   resourceName="UserDatabase"/>

      Remover comentário do seguinte elemento:

      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
                   resourceName="UserDatabase" 
                   digest="SHA-1"
                   digestEncoding="UTF-8"/>
Resultados
A conexão do repositório externa que você cria aparece sob o nó Conexões do Repositório Externas na visualização Regras de Sincronização.

Feedback

Isso ajudou? É possível fornecer feedback em Jazz.net (é necessário registrar-se): Comentar nos fóruns ou submeter um erro