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 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:
- Efetue login no cliente
Rational Team Concert.
- Na visualização Artefatos da Equipe, clique com o botão direito do mouse na
conexão do repositório e selecione . Na visualização Regras de Sincronização,
clique com o botão direito do mouse em Conexões do Repositório Externa e selecione
.
- 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:
- Inicie e pare o ClearQuest Gateway,
que expande o arquivo cqconnector.war.
- 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" />
- 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>
- 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.
- 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.