Actualización del servidor de la versión 3.0.1.x 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.1.x de la solución de Rational para aplicaciones Collaborative Lifecycle Management (CLM) a la versión 4 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.1.x a una configuración de la versión 4.0.

Procedimiento

  1. Instale el paquete de la versión 4 de CLM utilizando la instalación de SMP/E. La ubicación de la configuración de la versión 4 debe ser distinta de la ubicación de la configuración de la versión 3.0.1.x. 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 para la versión 4 se han cambiado de forma que no haya PTF para actualizar de la versión 3.0.1.x a la versión 4.
  2. Detenga todos los servidores de la versión 3.0.1.x.
  3. Realice una copia de seguridad de los repositorios de la versión 3.0.1.x 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 trabajo de ejemplo BLZCREDB de la versión 3.0.1.x 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. Si está restaurando una copia del almacén de datos, debe restaurarse en un subsistema DB2z/OS distinto porque no pueden existir dos almacenes de datos en un subsistema.
    5. Cree directorios UNIX System Services independientes (ussWorkDir) para cada base de datos.
    6. Utilice prefijos de esquema de repositorio que tienen el mismo número de caracteres.
    7. Verifique que se hayan creado satisfactoriamente los nuevos repositorios de la versión 3.0.1.x antes de proceder con los pasos de actualización.
  4. Configure un servidor Tomcat modificando y sometiendo el miembro de ejemplo BLZPOPT SBLZSAMP de la versión 4 para preparar los directorios de la estructura de configuración y de trabajo del servidor Tomcat nuevos. Asegúrese de que los directorios de configuración sean diferentes de los directorios de configuración utilizados en la instalación de la versión 3.0.1.x. 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. 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.1.x 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.1.x 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.
  6. 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.
  7. Configure el servidor Gestión de calidad (QM) modificando y sometiendo el miembro de ejemplo BLZCPQM SBLZSAMP de la versión 4 para preparar la estructura de directorios de trabajo y de configuración del servidor nuevo con las definiciones de QM. Siga las instrucciones del miembro de ejemplo.
  8. Configure el servidor Gestión de requisitos (RM) modificando el miembro de ejemplo BLZCPRM SBLZSAMP de la versión 4 para preparar la estructura de directorios de trabajo y de configuración del nuevo servidor con las definiciones de RM. Siga las instrucciones del miembro de ejemplo.
  9. 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.1.x 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 4 se tendrán que volver a personalizar manualmente.
  10. 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.1.x 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.
  11. 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.0.1.x 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.0.1.x, 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.
  12. Migre la configuración de servidor QM. 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 QM modificando el miembro de ejemplo BLZQMU SBLZSAMP de la versión 4. Antes de someter el trabajo BLZQMU, 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 herramientas de repositorio migration_qm_updateConfigurationFiles utilizado por este miembro de ejemplo se ha añadido en la versión 3.0.1.x, si @pathPrefix@ apunta a versiones anteriores, el mandato de herramientas de repositorio no utilizará el mandato de actualización de la versión 4.
    2. Complete las instrucciones del trabajo de ejemplo BLZQMU.
    Someta el trabajo BLZQMU 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.
  13. Migre la configuración de servidor RM. 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 RM modificando el miembro de ejemplo BLZRMU SBLZSAMP de la versión 4. Antes de someter el trabajo BLZRMU, 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 herramientas de repositorio migration_rm_updateConfigurationFiles utilizado por este miembro de ejemplo se ha añadido en la versión 3.0.1.x, si @pathPrefix@ apunta a versiones anteriores, el mandato de herramientas de repositorio no utilizará el mandato de actualización de la versión 4.
    2. Complete las instrucciones del trabajo de ejemplo BLZRMU.
    Someta el trabajo BLZRMU 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.
  14. Copie los archivos de índica llevando a cabo los pasos siguientes:
    1. Copie los índices JFS/text de la versión 3.0.1.x 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
        rm -rf <4.0_configuration_dir>/qm/indices
      • Abra un indicador de mandatos y escriba el mandato siguiente para copiar los índices de la versión 3.0.1.x en la versión 4:
        cp -R <3.0.1.x_configuration_dir>/jts/indices <4.0_configuration_dir>/jts/indices
        cp -R <3.0.1.x_configuration_dir>/ccm/indices <4.0_configuration_dir>/ccm/indices
        cp -R <3.0.1.x_configuration_dir>/qm/indices <4.0_configuration_dir>/qm/indices
      Edite los archivos JTS, CCM y QM teamserver.properties para asegurarse de que com.ibm.team.fulltext.indexLocation y com.ibm.team.jfs.index.root.directory tengan la información de ubicación correcta.
  15. 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.
  16. 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.
  17. Actualice la base de datos QM. Si ha configurado la aplicación QM, utilice las herramientas de repositorio para añadir las tablas de bases de datos de la versión 4.0 en el repositorio de QM 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 qm. Siga las instrucciones incluidas con el miembro de ejemplo y revise detenidamente la salida del trabajo.
  18. Opcional: configure el almacén de datos. Edite los archivos teamserver.properties de JTS, CCM y QM para que incluyan valores para el 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, CCM y QM 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 
  19. Actualice el almacén de datos. Si ha configurado el almacén de datos, utilice las herramientas del repositorio para actualizar el repositorio de almacenes de datos modificando y sometiendo una copia del miembro de ejemplo BLZDWHUP SBLZSAMP de la versión 4. Siga las instrucciones incluidas con el miembro de ejemplo y revise detenidamente la salida del trabajo.
  20. 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.
  21. 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.
  22. Migre Rational Requirements Composer (RRC). Si ha configurado las aplicaciones de RM, debe ejecutar el programa de utilidad de la migración en línea de RM llevando a cabo los pasos siguientes:
    1. Abra un navegador, borre la memoria caché del navegador y vaya al cliente web de RM. Especifique el nombre del servidor y el número de puerto en el URL siguiente: https://nombre_servidor:puerto/rdm/web/projects/migration. El puerto predeterminado es 9443. La página detecta que hay una migración en progreso y que se inicia el asistente de migración.
    2. Acepte la licencia de Rational Requirements Composer - Analyst Client Access.
    3. Pulse Abrir panel de servicio de migración y seleccione el asistente de migración para iniciar la migración de Rational Requirements Composer. Se informa al administrador de la página web de migración del estado acerca del área de almacenamiento que se está procesando y de cuándo comienza la indexación mientras se está llevando a cabo la migración.
      Importante: Una vez empezada la migración, no puede cancelar esta operación hasta que la migración se ha completado.
      Una vez que la migración se ha completado, los datos de Rational Requirements Composer se vuelven a indexar.
    4. Una vez que se ha completado la reindexación, la aplicación realiza comprobaciones de validación y coherencia en los datos migrados y proporciona información de retorno al administrador.
    5. Cuando se visualice el mensaje que indica que ha finalizado la migración, pulse Cerrar. A continuación se le redirigirá a la aplicación RRC.
    Para obtener detalles adicionales, consulte Pasos de actualización de migración en línea.

Comentarios