Creación y modificación de una conexión de repositorio externo

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 Configuración de proyecto > Permisos; 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:

  1. Inicie una sesión en el cliente Rational Team Concert.
  2. En la vista Artefactos de equipo, pulse con el botón derecho del ratón sobre la conexión al repositorio y seleccione Administrar > Reglas de sincronización. En la vista Reglas de sincronización, pulse con el botón derecho del ratón sobre Conexiones a repositorio externo y seleccione Nueva > Conexión a repositorio externo.
  3. 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:

    1. Inicie y detenga la pasarela ClearQuest, que expande el archivo cqconnector.war.
    2. 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" />
    3. 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>
    4. 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.
    5. 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.

Comentarios

¿Le ha servido de ayuda? Puede incluir sus comentarios en Jazz.net (registro obligatorio): Comentarios en el foro o envíe un error