Actualización del servidor de la versión 3.0 con Tomcat y DB2 para z/OS

En este tema se describen los pasos necesarios para actualizar el servidor de la versión 3.0 de Rational Team Concert (RTC) a las aplicaciones de la versión 4 de la solución de Rational para Collaborative Lifecycle Management (CLM) con una configuración que utiliza un servidor de aplicaciones Tomcat y DB2 para z/OS.

Antes de empezar

Haga copias de los miembros BLZSAMP, por lo que puede revisar los archivos originales si es necesario. Revise las anotaciones de trabajo de los ejemplos después de enviar los trabajos. El código de retorno previsto es 0.

Acerca de esta tarea

En los pasos siguientes se va a migrar la configuración de la versión 3.0 de RTC a una configuración de la versión 4.0 de CLM.

Procedimiento

  1. Instale el paquete de la versión 4 de CLM utilizando la instalación de SMP/E. La ubicación de configuración de la versión 4 debe ser diferente de la ubicación de configuración de la versión 3.0. La instalación del paquete SMP/E proporciona herramientas de copia de seguridad de bases de datos nuevas que se utilizan para la actualización. Para obtener detalles, consulte Visión general del proceso de instalación SMP/E.
    Nota: Los FMID de la versión 4 han cambiado de forma que no hay PDF para actualizar de la versión 3.0 a la versión 4.
  2. Realice una copia de seguridad de los repositorios de la versión 3.0 utilizando los programas de utilidad UNLOAD y LOAD de DB2 para z/OS proporcionados. Para obtener detalles, consulte Uso del proceso de carga y descarga de DB2 para hacer copia de seguridad. Puede utilizar otras herramientas para realizar copias de seguridad si las herramientas se han probado y verificado.
    Importante: Debe realizar copias de seguridad de sus repositorios antes de continuar con una actualización porque el proceso de actualización realiza cambios en el modelo de repositorio que no se pueden retrotraer.
    1. Para verificar los procedimientos de copia de seguridad y restauración, siga los pasos para llevar a cabo las acciones UNLOAD y LOAD en una nueva base de datos y prefijo de esquema nuevo.
    2. Utilice el ejemplo de trabajo BLZCREDB de la versión 3.0 para crear las tablas en las bases de datos nuevas.
    3. Para probar totalmente los procedimientos de copia de seguridad y restauración de la base de datos, cree bases de datos adicionales para cada repositorio. Las bases de datos recién creadas deben tener los mismos permisos que las bases de datos existentes.
    4. Cree directorios UNIX System Services independientes (ussWorkDir) para cada base de datos.
    5. Utilice prefijos de esquema de repositorio que tienen el mismo número de caracteres.
    6. Verifique que se hayan creado satisfactoriamente los nuevos repositorios de la versión 3.0 antes de proceder con los pasos de actualización.
  3. Configure Jazz Team Server (JTS) modificando y sometiendo el miembro de ejemplo BLZCPJTS SBLZSAMP de la versión 4 para preparar los directorios de la estructura de configuración y de trabajo del servidor, incluida la aplicación Administración de proyecto de ciclo de vida.
    Nota: Los directorios de configuración (JAZZ_HOME) y trabajo que cree para la versión 4 deben ser distintos de los directorios de la versión 3.0 de forma que los programas de utilidad de actualización puedan fusionar las dos versiones. Por ejemplo, el directorio de configuración predeterminada para la versión 3.0 es /etc/jazz, por tanto, para la versión 4, utilice /etc/jazz40. De igual modo, para el directorio de trabajo, utilice /u/jazz40.
    Siga las instrucciones del miembro de ejemplo o consulte Creación de directorios adicionales para aplicaciones de Jazz Team Server y de la solución de Rational para Collaborative Lifecycle Management.
  4. Configure el servidor de Gestión de cambios y configuración (CCM) modificando y sometiendo el miembro de ejemplo BLZCPCCM SBLZSAMP de la versión 4 para preparar la estructura de directorios de configuración y trabajo del servidor nuevo con las definiciones de CCM. Siga las instrucciones del miembro de ejemplo o consulte Creación de directorios adicionales para aplicaciones de Jazz Team Server y de la solución de Rational para Collaborative Lifecycle Management.
  5. Cree una nueva base de datos DB2 para z/OS denominada RIDW para utilizarla como almacén de datos y otorgar permisos. Para obtener detalles, consulte Configuración de DB2 para z/OS que utilizar con Jazz Team Server.
  6. Despliegue las aplicaciones iniciando y deteniendo el servidor Tomcat de la versión 4 (o despliegue los archivos ccm.war y jts.war).
    Nota: Si los archivos web.xml de la aplicación de la versión 3.0 se han personalizado (por ejemplo, para dar soporte a un registro LDAP), los pasos restantes migrarán esos archivos personalizados a las aplicaciones de la versión 4 y modificarán el archivo web.xml de cada aplicación. Sin embargo, los archivos .war se habrán firmado por lo que las modificaciones solamente se podrán realizar en la versión desplegada del archivo .war. Si se vuelven a desplegar las aplicaciones después de la migración, los archivos de la versión 3.0 se tendrán que volver a personalizar manualmente.
  7. Migre la configuración de servidor JTS. Utilice las herramientas de repositorio para fusionar los valores del archivo de configuración de la versión 3.0 en los archivos de configuración de la versión 4 para JTS modificando el miembro de ejemplo BLZJTSU SBLZSAMP de la versión 4. Antes de someter el trabajo BLZJTSU, lleve a cabo los pasos siguientes:
    1. Sustituya la variable @pathPrefix@ para que apunte al prefijo de la vía de acceso de los archivos binarios de la versión 4.
      Nota: El mandato de las herramientas de repositorio migration_jts_updateConfigurationFiles que utiliza este miembro de ejemplo se ha añadido en la versión 3.0.1. Si @pathPrefix@ apunta a las versiones anteriores, el mandato de las herramientas de repositorio no utilizará el mandato de actualización de la versión 4.
    2. Complete las instrucciones del trabajo de ejemplo BLZJTSU.
    Someta el trabajo BLZJTSU y revise la salida del trabajo y el archivo de propiedades actualizado.
    Nota: Las propiedades del almacén de datos que apuntan al almacén de datos Derby se conservan como parte de esta fusión pero se direccionarán en un paso posterior.
  8. Migre la configuración de servidor CCM. Utilice las herramientas de repositorio para fusionar los valores del archivo de configuración de la versión 3.0.1.x en los archivos de configuración de la versión 4 para CCM modificando el miembro de ejemplo BLZCCMU SBLZSAMP de la versión 4. Antes de someter el trabajo BLZCCMU, lleve a cabo los pasos siguientes:
    1. Cambie la siguiente línea desde: applicationContextRoot=jazz por applicationContextRoot=ccm. El contexto de aplicación debería ser /ccm a menos que el servidor de la versión 3 se migre desde la versión 2.x.
    2. Sustituya la variable @pathPrefix@ para que apunte al prefijo de la vía de acceso de los archivos binarios de la versión 4.
      Nota: El mandato de herramientas de repositorio migration_ccm_updateConfigurationFiles utilizado por este miembro de ejemplo se ha añadido en la versión 3, si @pathPrefix@ apunta a versiones anteriores, el mandato de herramientas de repositorio no utilizará el mandato de actualización de la versión 4.
    3. Complete las instrucciones del trabajo de ejemplo BLZCCMU.
    Someta el trabajo BLZCCMU y revise la salida del trabajo y el archivo de propiedades actualizado.
    Nota: Las propiedades del almacén de datos que apuntan al almacén de datos Derby se conservan como parte de esta fusión pero se direccionarán en un paso posterior.
  9. Detenga el servidor Tomcat de la versión 3 de RC.
  10. Copie los archivos de índica llevando a cabo los pasos siguientes:
    1. Copie los índices JFS/text de la versión 3 a la versión 4. Para sistemas distribuidos vaya al servidor adecuado y copie los archivos.
      • Abra un indicador de mandatos y especifique el mandato siguiente para borrar el directorio de índices predeterminado de la versión 4.0:
        rm -rf <4.0_configuration_dir>/jts/indices
        rm -rf <4.0_configuration_dir>/ccm/indices
        Abra un indicador de mandatos y escriba el mandato siguiente para copiar los índices de la versión 3 en la versión 4:
        cp -R <3.0_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
        cp -R <3.0_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
      Edite los archivos teamserver.properties de JTS y CCM para asegurarse de que com.ibm.team.fulltext.indexLocation y com.ibm.team.jfs.index.root.directory tienen la información de ubicación correcta.
  11. Actualice la base de datos JTS. Utilizar las herramientas de repositorio para añadir tablas de bases de datos de la versión 4.0 en el repositorio JTS modificando y sometiendo una copia del miembro de ejemplo BLZADDTB SBLZSAMP de la versión 4. La variable de aplicación @appl@ debe establecerse en jts. Siga las instrucciones incluidas con el miembro de ejemplo y revise detenidamente la salida del trabajo.
  12. Actualice la base de datos CCM. Si ha configurado la aplicación CCM, utilice las herramientas de repositorio para añadir las tablas de bases de datos de la versión 4.0 en el repositorio CCM modificando y sometiendo una copia del miembro de ejemplo BLZADDTB SBLZSAMP de la versión 4. La variable de aplicación @appl@ debe establecerse en ccm. Siga las instrucciones incluidas con el miembro de ejemplo y revise detenidamente la salida del trabajo.
  13. Opcional: configure el almacén de datos. Edite los archivos teamserver.properties de JTS y CCM para que incluyan los valores del repositorio de almacenes de datos. Los mismos valores irán a los tres archivos.
    Importante: Si ahora no va a implementar el almacén de datos autónomo, puede omitir este paso. Sin embargo, si lo omite, deberá omitir el paso de configuración del almacén de datos cuando utilice el asistente de configuración de Jazz Team Server.
    Si ahora está configurando el almacén de datos, deberá actualizar los archivos teamserver.properties de JTS y CCM para que incluyan los parámetros del almacén de datos db2z y eliminar las propiedades del almacén de datos Derby existentes. Específicamente, coméntelos utilizando el símbolo # como en este ejemplo:
    #com.ibm.team.datawarehouse.db.net.port 
    #com.ibm.team.datawarehouse.db.vendor=DERBY (or derby_net) 
    #com.ibm.team.datawarehouse.db.jdbc.location=/directoryInYourWorkdirectory or 
    #com.ibm.team.datawarehouse.db.jdbc.location=//localhost\:1527// ...
    Añada la siguiente información:
    com.ibm.team.datawarehouse.db.vendor = db2z 
    com.ibm.team.datawarehouse.db.jdbc.location=//ipAddress:ipPort/location:user=jazzDBuser;password={password}; 
    com.ibm.team.datawarehouse.db.jdbc.password=jazzDBpswd
    # The database user for whom proper permissions will be granted
    com.ibm.team.datawarehouse.report.user = RPTUSERcom.ibm.team.datawarehouse.db.db2.dsn.dbname=RIDW 
  14. Si ha actualizado el archivo teamserver.properties para el almacén de datos, cree un repositorio de almacenes de datos modificando y sometiendo el miembro de ejemplo BLZCREDB SBLZSAMP de la versión 4 para crear las tablas de almacenes de datos. Establezca la variable de aplicación @appl@ en jts. El mandato de las herramientas de repositorio @repotoolsCommand@ es -createWarehouse.
  15. Inicie los servidores Tomcat de la versión 4 modificando y sometiendo el miembro de ejemplo BLZSRVD SBLZSAMP de la versión 4. Asegúrese de que la variable @confPath@ del directorio de configuración y la variable @workPath@ del directorio de trabajo estén establecidas en los valores de los nuevos directorios de la versión 4.
  16. Active las licencias completando los pasos siguientes:
    1. Inicie sesión como administrador para Jazz Team Server de la versión 4.0.
    2. Vaya a la página Administración del servidor> Gestión de clave de licencia y active las licencias.
      Nota: no es necesario ejecutar la configuración en el sistema de la versión 4.0 puesto que ya todo está configurado.
    Notas de licencias:
    • Con los releases de objetivos, debe activar las licencias de acceso temprano enviadas con el objetivo.
    • Para el release final de la versión 4.0, deberá adquirir nuevas licencias. Las licencias de la versión 4 son compatibles con las aplicaciones de la versión 3, pero las aplicaciones de la versión 4 no funcionan con las licencias de la versión 3. Para obtener más información, consulte Gestión de licencias.
  17. Si desea añadir las aplicaciones Gestión de calidad (QM) o Gestión de requisitos (RM), siga las instrucciones para las instalaciones nuevas. Para obtener detalles, consulte Instalación y configuración de Jazz Team Server y la solución de Rational para aplicaciones Collaborative Lifecycle Management en z/OS.

Comentarios