Configuración de un entorno de transferencia de prueba con datos de producción

En este tema se describe cómo utilizar la función de redenominación del servidor para preparar un entorno de transferencia con los datos de producción reales. Un entorno de transferencia es un recinto de seguridad de prueba que está aislado del entorno de producción. Se puede utilizar para probar nuevas funciones o características con datos reales sin que ello impacte en la base de datos de producción.

Acerca de esta tarea

Importante: Este procedimiento no puede utilizarse para actualizar el entorno desde un release anterior. La redenominación del servidor solamente recibe soporte en la versión 4 y en releases más recientes. Por lo tanto, la actualización a la versión 4 es un requisito previo a la configuración de un entorno de transferencia utilizando la redenominación del servidor.

La función de redenominación del servidor utiliza un archivo de correlaciones para determinar los URL que se deben redenominar. Se proporciona un mandato repotools para generar un archivo de correlaciones inicial. El archivo de correlaciones contiene pares origen-destino para el Jazz Team Server y todas las aplicaciones, así como otros URL aportados por aplicaciones. Consulte Comprensión del archivo de correlación que utiliza la redenominación de servidor si desea más detalles acerca del archivo de correlación. Consulte en Topologías y archivos de correlaciones para configurar un entorno de transferencia de prueba los diagramas de topología de ejemplo y los archivos de correlaciones.

Cuando se planifica un entorno de transferencia, tiene que ser especialmente cuidadoso de no contaminar los datos de producción o viceversa. Puede conseguirlo de dos formas, añadiendo entradas al archivo hosts, si está permitido en el entorno y creando correlaciones para enmascarar los servidores que no están presentes en su entorno de transferencia. Asegúrese de incluir en la correlación los servidores CLM adicionales o los productos no CLM que pudieran estar conectados al servidor de producción. Consulte el paso 3.c y Correlaciones ficticias para entornos de transferencia si desea más detalles.

Por ejemplo, puede que tenga la aplicación Gestión de cambios y configuración (CCM) en un servidor de producción con enlaces a CCM en otro servidor de producción, y los enlaces a Gestión de calidad (QM) todavía en otro servidor de producción. Además, puede que disponga de integraciones a productos no CLM como, por ejemplo, Rational ClearQuest. En este caso, debería desenmascarar primero los URL de los servidores CCM y QM adicionales y asegurarse de que el URL de Rational ClearQuest también esté desenmascarado o si no, correlacionado a un servidor de pasarela Rational ClearQuest de transferencia.

Importante: No conecte ningún cliente de Rational Team Concert a los repositorios de producción o de transferencia. Utilice siempre un espacio de trabajo de transferencia para conectarse al servidor de transferencia.

En el diagrama siguiente se muestran los principales pasos necesarios para configurar un entorno de transferencia utilizando la redenominación de servidor. Se da por supuesto que las últimas versiones de CLM (versión 4) y RRDI (versión 2) ya están instaladas.

Escenario de producción a transferencia

Procedimiento

  1. Prepárese para la redenominación siguiendo los pasos descritos en el tema Preparación del archivo de correlación.

    Asegúrese de crear correlaciones ficticias para cualquiera de los URL afectados en el archivo de correlaciones. Puede hacerlo para evitar enlaces cruzados entre los entornos de transferencia y de producción. Consulte Correlaciones ficticias para entornos de transferencia si desea detalles.

    El resultado final de la fase preparatoria es un archivo de correlación que se genera en el producto Jazz Team Server de origen. Tras recuperar y editar detenidamente el archivo de correlación, cópielo en el directorio JazzInstallDir\server del producto Jazz Team Server de destino en el entorno de transferencia.

  2. Realice una copia de seguridad del entorno de producción de la versión 4 y copie los índices de texto y los archivos de configuración de la aplicación en el servidor de transferencia de destino.

    Puesto que tiene que detener los servidores de producción mientras lleva a cabo estos pasos, asegúrese de elegir un momento oportuno para realizar la copia de seguridad, preferiblemente justo antes de configurar el entorno de transferencia. Si se realizan cambios en el entorno de producción antes de continuar con la redenominación real, tendrá que volver a generar el archivo de correlación antes de importarlos en el servidor de transferencia. Mientras los usuarios están inactivos, éstos no podrán crear o atravesar enlaces desde sistemas externos que se integran con el despliegue de CLM que está a punto de redenominarse.

    1. Detenga el producto Jazz Team Server y las aplicaciones CLM distribuidas que se hayan registrado con Jazz Team Server en el entorno de producción.
    2. Realice una copia de seguridad de todas las bases de datos en el entorno de producción de la versión 4.0 de CLM, incluida la base de datos Jazz Team Server, las bases de datos de aplicaciones CCM y QM, y la base de datos del almacén de datos. Copie las bases de datos del entorno de producción al entorno de transferencia siguiendo los pasos de Traspasar la base de datos de CLM.
    3. Copie los índices JFS/text del servidor de producción de origen al servidor de transferencia de destino. (Para sistemas distribuidos, vaya al servidor adecuado para copiar los archivos.)

      En los siguientes ejemplos de un servidor Linux se da por supuesto que las unidades de los sistemas de transferencia se montan en redes. Si no es posible en su entorno, utilice otros métodos de transferencia de archivos para asegurarse de que se copien los archivos.

      cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
      cp -R SourceJazzInstallDir/server/conf/ccm/indices TargetJazzInstallDir/server/conf/ccm
      cp -R SourceJazzInstallDir/server/conf/qm/indices TargetJazzInstallDir/server/conf/qm
    4. copie los archivos de configuración de aplicación del servidor de producción origen al servidor de transferencia de destino. (Para sistemas distribuidos, vaya al servidor adecuado para copiar los archivos.) Al igual que en el paso anterior, los ejemplos siguientes son para un servidor Linux y se supone que las unidades de los sistemas de transferencia se montan en redes.
      cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties  TargetJazzInstallDir/server/conf/jts
      cp SourceJazzInstallDir/server/conf/ccm/teamserver*.properties  TargetJazzInstallDir/server/conf/ccm
      cp SourceJazzInstallDir/server/conf/qm/teamserver*.properties  TargetJazzInstallDir/server/conf/qm
      cp SourceJazzInstallDir/server/conf/admin/admin.properties*  TargetJazzInstallDir/server/conf/admin
      cp SourceJazzInstallDir/server/conf/admin/friends.rdf*  TargetJazzInstallDir/server/conf/admin
      cp SourceJazzInstallDir/server/conf/rm/fronting.properties  TargetJazzInstallDir/server/conf/rm
      cp SourceJazzInstallDir/server/conf/rm/friendsconfig.rdf  TargetJazzInstallDir/server/conf/rm
    5. Copie el archivo de correlaciones en el directorio TargetJazzInstallDir\server del servidor de producción. Consulte Preparación del archivo de correlación para obtener detalles sobre el archivo de correlaciones.
      Nota: Si los cambios de configuración se realizan en el despliegue de CLM antes de llevar a cabo el paso siguiente, tendrá que volver a generar el archivo de correlación.
    6. Reinicie todos los servidores CLM y permita que los usuarios continúen utilizando el entorno de producción. Los pasos restantes se aplican todos al entorno de prueba de transferencia.
  3. Realice los siguientes pasos en el entorno de prueba de transferencia:
    1. Restaure las copias de seguridad de bases de datos del entorno de producción al entorno de transferencia. Es recomendable utilizar un servidor de base de datos independiente del que se utiliza en el entorno de transferencia para evitar sobrecargar el servidor de base de datos de producción.
    2. Sustituya los parámetros de conexión de base de datos en los archivos JazzInstallDir/server/conf/applicationName/teamserver.properties de forma que apunten a los parámetros de conexión de la copia de transferencia de la base de datos del entorno de prueba. Estos incluyen las entradas para la base de datos de jts, las bases de datos de las aplicaciones ccm y qm, la base de datos del almacén de datos y las contraseñas actualizadas.
    3. Como precaución adicional a las correlaciones ficticias en el archivo de correlaciones, si en su entorno está permitido, actualice el archivo de hosts para impedir el acceso a los URL del sistema de producción y para evitar ediciones accidentales en artefactos del servidor de producción.

      El objetivo es resolver los nombres de host en una dirección IP falsa que no la esté utilizando ningún otro servidor CLM en el entorno de producción. Por ello, si un servidor del entorno de transferencia intenta establecer una conexión con un servidor de producción, fallará la conexión.

      Realice una lista de todos los nombres de host distintos que aparezcan en el archivo de correlación. Puede tratarse de URL de origen o URL afectados. Para cada nombre de host individual, cree una entrada en el archivo de hosts que correlaciona el nombre de host con una dirección IP falsa. Tiene que editar el archivo de hosts para todos los servidores del entorno de transferencia, incluidos los servidores de terceros y las estaciones de trabajo de cliente. En el siguiente archivo de hosts se muestran las entradas de ejemplo para el servidor de transferencia:

       # 10.10.10.10 refers to an IP address that does not host a clm application. 
        10.10.10.10   ProductionServerP1
        10.10.10.10   ProductionServerP2
        10.10.10.10   ProductionServerP3
    4. Abra un indicador de mandatos en el directorio JazzInstallDir\server e importe el archivo de correlaciones en el producto Jazz Team Server de destino utilizando el mandato repotools-jts -importURLMappings.
      • Si tiene un despliegue todo en uno, importe el archivo de correlaciones utilizando el mandato repotools-jts -importURLMappings como se indica a continuación:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        La redenominación comenzará fuera de línea en Jazz Team Server, antes de que el servidor se reinicie.

      • Si dispone de un despliegue distribuido y con permiso para correlacionar unidades de red, correlacione una unidad de red del host de Jazz Team Server con cada uno de los hosts de aplicaciones. A continuación, cree un archivo (por ejemplo, serverConfFile.txt) que contenga una lista de directorios server/conf remotos en el despliegue con el formato siguiente:
         # Remote CCM server
           x:/JazzTeamServer/server/conf
           # Remote QM server
           y:/JazzTeamServer/server/conf
           # Remote RM server
           z:/JazzTeamServer/server/conf

        Finalmente, continúe con el mandato repotools-jts -importURLMappings y añada el parámetro serverConfFile= tal como se muestra a continuación.

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt" serverConfFile="C:\serverConf.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="/opt/mappings.txt" serverConfFile="/opt/serverConf.txt"

      • Si dispone de un despliegue CLM distribuido y no está permitido correlacionar unidades de red, siga con el mandato repotools-jts -importURLMappings tal como se muestra a continuación:

        For Windows operating system repotools-jts.bat -importURLMappings fromFile="C:\mappings.txt"

        For Unix operating systems ./repotools-jts.sh -importURLMappings fromFile="opt/mappings.txt"

        A continuación, copie el archivo server/conf/jts/.mappingEvent en los directorios de configuración de la aplicación remota (server/conf/nombre_aplicación), es decir, ccm, qm y rm. Debe copiar el archivo .mappingEvent después de importar el archivo de correlación pero antes de iniciar el servidor.

        El archivo .mappingEvent contiene información que necesitan las aplicaciones para ponerse en contacto con el producto Jazz Team Server en su nueva ubicación. El contenido del archivo .mappingEvent es el mismo para un producto Jazz Team Server determinado y sus aplicaciones registradas.

      Verifique que la redenominación haya resultado satisfactoria comprobando la salida de la consola y el archivo server/repotools-jts_importURLMappings.log. Si aparecen errores, o si detecta que se ha equivocado en el archivo de correlaciones, consulte Resolución de problemas en la redenominación del servidor para localizar y corregir el problema.

      Nota: Los servidores que se ejecutan en z/OS deben redenominarse utilizando el miembro del JCL de muestra HLQ.SBLZSAMP(BLZRENAM). Consulte la cabecera de comentarios en BLZRENAM si desea instrucciones detalladas acerca de la personalización.
  4. Inicie Jazz Team Server y las aplicaciones CLM distribuidas que se registran con Jazz Team Server.

    En este momento, las aplicaciones CLM se sincronizarán con Jazz Team Server para aplicar las correlaciones de URL y actualizar sus datos de almacén de datos. Esta acción debería tardar unos cinco minutos para un conjunto de datos pequeño y hasta 30 minutes o más para un conjunto de datos muy grandes.

  5. Inicie sesión en Jazz Team Server en https://host nuevo:puerto/jts/serverRenameStatus para comprobar el estado de la redenominación.

    Espere hasta que se hayan terminado todas las redenominaciones de aplicaciones y se haya completado el paso Finalización de la redenominación del servidor. Verifique que aparezca el siguiente mensaje: La redenominación del servidor se ha completado satisfactoriamente. Jazz Team Server y las aplicaciones están totalmente operativos. Puede empezar a utilizar los servidores inmediatamente y no es necesario reiniciar el equipo.

    Si aparecen errores, consulte Resolución de problemas en la redenominación del servidor para localizar y corregir el problema.

    Nota: Los intentos de iniciar sesión en la interfaz de usuario de web para cualquiera de las aplicaciones de CLM antes de finalizar la redenominación, le redirigirán a esta página de estado.
  6. Lleve a cabo los pasos de verificación de la redenominación del servidor descritos en Verificación de la redenominación del servidor.
    Nota: Si ha introducido correlaciones ficticias para proteger el entorno de producción, debería ver errores sobre estos URL en la sección Aplicaciones y amigos de la página Diagnósticos de aplicaciones en el servidor de transferencia.
  7. Opcional: lleve a cabo los pasos siguientes para configurar Rational Reporting for Development Intelligence (RRDI) en el entorno de transferencia:
    1. Realice una copia de seguridad de las bases de datos siguientes desde el entorno de producción y restáurelas en un servidor de base de datos nuevo para la nueva instalación de RRDI en el entorno de transferencia:
      • La base de datos del almacén de contenido (por ejemplo, RICM)
      • El almacén de datos (por ejemplo, RIDW, si todavía no se ha realizado la copia de seguridad ni se ha restaurado).
    2. Instale la versión 2.0 de Rational Reporting for Development Intelligence en el entorno de transferencia. Para obtener detalles, consulte Instalación de Rational Reporting for Development Intelligence utilizando Installation Manager.
    3. Configure el servidor de informes ejecutando la aplicación de configuración de RRDI. Para obtener detalles, consulte Tareas tras la instalación. Recuerde llevar a cabo estas acciones:
      • En la página Configurar base de datos del almacén de contenido, especifique las propiedades de conexión para la base de datos del almacén de contenido (por ejemplo, RICM) que ha restaurado en el paso 7.a.
      • En la página Configurar almacén de datos, especifique las propiedades de conexión para la base de datos del almacén de datos (por ejemplo, RIDW) que ha restaurado en el paso 7.a.
    4. Inicie sesión en Jazz Team Server y actualice los URL del servidor de informes almacenados en Propiedades avanzadas de Jazz Team Server y las páginas de administración de CCM y QM para que apunten al servidor de informes RRDI de transferencia.
      Nota: Este paso solamente es necesario si al archivo de correlaciones le faltan los URL para RRDI.
    5. Verifique que todos los informes importados anteriormente desde el servidor de informes de RRDI de producción continúen funcionando.
    6. Los informes o las vistas de informes de Cognos con una acción establecida en Ver el informe más reciente, se deben ejecutar tras una redenominación del servidor CLM para actualizar el informe HTML guardado en la memoria caché.
      1. Inicie la sesión en el servidor de informes RRDI.
      2. Busque informes o vistas de informe con versiones de salida en la guardadas en la memoria caché.
        Nota: Si existe una versión de salida guardada en la memoria caché para un informe o una vista de informe, puede pulsar Ver las versiones de salida de este informe para ver los informes guardados en la memoria caché. Si los informes o las vistas de informe se generaron antes de la redenominación del servidor CLM, debe volver a ejecutar los informes o las vistas de informe para actualizarlos. De lo contrario, los usuarios que ejecuten los informes o las vistas de informe verán enlaces obsoletos que apuntan al servidor CLM antiguo.
      3. Pulse Ejecutar con opciones para volver a ejecutar los informes o las vistas de informes.
      4. En el visor de informes, pulse Conservar esta versión > Guardar informe para actualizar las versiones de salida en la memoria caché asociadas con los informes o las vistas de informes.
    7. Importe un informe nuevo desde el servidor de informes de RRDI de transferencia. Verifique que la importación sea correcta y que el informe importado se ejecute sin problemas.
    8. Si ha configurado informes en tiempo real de Rational Quality Manager en RRDI, siga los pasos para generar el archivo xdc para el servidor nuevo y configúrelo en el gestor de ODBC de 32 bits. Para obtener detalles, consulte Configuración de informes en tiempo real.
  8. Si está incluyendo otros componentes en el entorno de transferencia como, por ejemplo, Jazz Build Engines, clientes de Rational Team Concert, Rational ClearQuest o Rational ClearCase, lleve a cabo los pasos adicionales que sean necesarios. Para obtener detalles, consulte Restricciones e información adicional.

Comentarios