Una conexión de repositorio externo es un elemento de Rational Team Concert
cuyas propiedades contienen información que el Jazz Team Server
necesita para crear una conexión con un repositorio externo. Necesita crear una conexión a repositorio
externo para la pasarela ClearQuest.
Antes de empezar
Para crear, modificar y suprimir conexiones a repositorio externo, debe tener asignada
una licencia de acceso de cliente de desarrollador o de ClearQuest Connector. Además, el área de proyecto debe estar configurada para conceder permisos a su rol de usuario. Para establecer permisos, abra el área de proyecto, pulse sobre la pestaña Configuración de proceso; pulse ; seleccione un rol y Conectores
de elementos en la lista Acciones permitidas.
Por qué y cuándo se efectúa esta tarea
Puede
utilizar el asistente de Configuración de ClearQuest Connector
para crear una conexión de repositorio externo. Este tema muestra cómo crear una conexión de
repositorio externo utilizando el cliente Eclipse de
Rational Team Concert.
También muestra cómo inhabilitar o habilitar la sincronización saliente
para la conexión de repositorio externo. Si crea una conexión de repositorio externo
utilizando el Asistente de Configuración de ClearQuest Connector, debe
habilitar la sincronización saliente para la misma. El asistente
crea la conexión de repositorio externo con la sincronización saliente
inhabilitada.
Para crear una conexión a repositorio externo:
- Inicie una sesión en el cliente Rational Team Concert.
- En la vista Artefactos de equipo, pulse con el botón derecho del ratón
sobre la conexión al repositorio y seleccione . En la vista Reglas de
sincronización, pulse con el botón derecho del ratón sobre Conexiones a repositorio externo y
seleccione .
- Si ha iniciado una sesión en más de un repositorio de Jazz, seleccione aquel para
el que desee crear una conexión a repositorio externo. Pulse Siguiente.
En la ventana Conexión a repositorio externo, escriba un nombre para la conexión en el
campo Nombre. Especifique el URI de la pasarela ClearQuest
en el campo Información de conexión. Por
ejemplo: http://YOUR-CQ-GATEWAY-HOST:8081/cqconnector/gateway.
Si el servidor Tomcat que alberga la pasarela ClearQuest está configurado para requerir autenticación de usuario para las solicitudes de servicio, especifique valores en los campos ID de
usuario y Contraseña. En caso contrario, deje en blanco
estos campos. El ID de usuario y la contraseña que escriba deben coincidir con
los especificados en el archivo tomcat-users.xml del directorio directorio-instalación/gateway/tomcat/conf.
Puede restringir el acceso a la conexión a repositorio externo
si establece permisos en un área de proyecto y la selecciona después
en el campo Área de proyecto. Una vez haya establecido
un área de proyecto para una conexión a repositorio externo, no podrá cambiarla.
Si necesita indicar en el campo un área de proyecto diferente o ninguna,
puede suprimir la conexión a repositorio externo y crear otra.
Si
necesita detener de manera temporal la sincronización desde el servidor Jazz a esta pasarela ClearQuest, seleccione Inhabilitar
sincronización saliente. Es posible que desee inhabilitar la sincronización saliente
cuando realice tareas de mantenimiento en la base de datos de usuarios ClearQuesty no esté disponible temporalmente. Para
habilitar la sincronización saliente, elimine la marca de selección del recuadro
Inhabilitar sincronización saliente. Pulse Guardar para guardar la conexión
a repositorio externo.
Los números de puerto predeterminados para las conexiones a repositorio
externo son 8444, para conexiones de capa de sockets seguros (SSL), y 8081,
para conexiones que no sean SSL. Para cambiar un número de puerto predeterminado, edite
el archivo server.xml en el directorio /jazz/connectors/gateway/tomcat/conf. Para inhabilitar las conexiones
que no sean SSL y configurar el servidor Tomcat para requerir autenticación de usuario,
realice los siguientes pasos:
- Inicie y detenga la pasarela
ClearQuest,
que expande el archivo cqconnector.war.
- Edite el archivo server.xml en el directorio directorio-instalación/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 el archivo web.xml en el directorio
directorio-instalación/gateway/tomcat/webapps/cqconnector/gateway/WEB-INF
para eliminar los signos de comentario del elemento siguiente:
<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 el archivo tomcat-users.xml en el directorio /jazz/connectors/gateway/tomcat/conf. El ID de usuario y la contraseña predeterminados son cqconnector. Cambie la contraseña.
También puede si lo desea cambiar el ID de usuario.
- De forma predeterminada, la contraseña del archivo tomcat-users.xml
se almacena en texto plano, pero puede cifrar la contraseña y configurar
Tomcat para que la reconozca. Para ello, utilice el mandato repotools –convertTomcatUsers.
Navegue hasta el directorio JazzInstallDir/server/repotools.
Escriba el mandato y especifique la vía de acceso al archivo tomcat-users.xml.
Por ejemplo:
repotools –convertTomcatUsers tomcatUsersPath=install-directory/gateway/tomcat/conf/tomcat-users.xml
El archivo
tomcat-users.xml convertido se llamará tomcat-users.xml.converted.
Cámbiele el nombre por tomcat-users.xml. Si necesita modificar la contraseña en
algún momento, deberá cambiarla en una copia del archivo original sin codificar
y volver a ejecutar repotools –convertTomcatUsers. Conserve el archivo
original y sin codificar en un lugar seguro.
Después de ejecutar el mandato,
edite el archivo server.xml file en el directorio /jazz/connectors/gateway/tomcat/conf
del siguiente modo:
Comente el siguiente elemento:
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"/>
Descomente
el siguiente elemento:
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase"
digest="SHA-1"
digestEncoding="UTF-8"/>
Resultados
La conexión a repositorio externo que cree aparecerá en el nodo
Conexiones a repositorio externo de la vista
Reglas de
sincronización.