Actualización del servidor de la versión 3.0.1.x con WebSphere Application Server 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 WebSphere Application Server 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 el servidor y 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 que se proporcionan. 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.
  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.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.
  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. 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.
  6. 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.
  7. Desinstale las aplicaciones de la versión 3.0.1.x de WebSphere Application Server llevando a cabo los pasos siguientes:
    1. Inicie sesión en WebSphere Application Server Integrated Solutions Console en: https://example.com:9043/ibm/console/logon.jsp
    2. Pulse Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere.
    3. Fíjese que la correlación de los roles de seguridad de las siguientes aplicaciones de la versión 3.0.1.x de forma que se puedan volver a crear para las contrapartidas en la versión 4:
      • jts_war
      • ccm_war
      • qm_war
    4. Detenga y desinstale las siguientes aplicaciones de la versión 3.0.1.x:
      • jts_war
      • ccm_war
      • qm_war
      • rm_war
      • clmhelp_war
      • admin_war
    5. Guarde los cambios en la configuración principal cuando se le solicite.
  8. Actualice JAZZ_HOME y las propiedades personalizadas de log4j.configuration completando los siguientes pasos:
    1. Inicie sesión en WebSphere Application Server Integrated Solutions Console en: https://example.com:9043/ibm/console/logon.jsp
    2. Pulse Servidores > Tipos de servidor > WebSphere Application Servers.
    3. Pulse el nombre del servidor para abrirlo. El nombre del servidor predeterminado es "server1."
    4. En la sección Infraestructura del servidor, seleccione Gestión de Java y procesos> Definición de proceso.
    5. En Propiedades adicionales, seleccione Máquina virtual Java.
    6. En Propiedades adicionales, seleccione Propiedades personalizadas.
    7. Seleccione JAZZ_HOME y actualice su valor por: archivo:///<4.0_configuration_dir>. Por ejemplo, archivo:///etc/jazz40.
    8. Seleccione log4j.configuration y actualice su valor por: archivo:///<4.0_configuration_dir>/startup_log4j.properties. Por ejemplo, archivo:///etc/jazz40/startup_log4j.properties.
    9. Guarde los cambios en la configuración principal cuando se le solicite.
    Para obtener información adicional, consulte Configuración de un WebSphere Application Server.
  9. Detenga WebSphere Application Server.
  10. Suprima los archivos y directorios temporales de WebSphere y borre la memoria caché completando los pasos siguientes:
    1. Vaya al directorio temporal en el perfil de WebSphere Application Server, normalmente, en algún lugar parecido a éste: <raíz_perfil_WAS>/temp/<nombre_nodo>/<nombre_servidor> y suprima todos los directorios <aplicación>_war.
    2. Vaya a <raíz_perfil_WAS>/temp/wscache y suprima el directorio <aplicación>_war si existe.
  11. 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. Suprima las líneas que contienen los parámetros siguientes:
      oldTomcatHome
      newTomcatHome 
    2. Cambie la siguiente línea desde: updateTomcatFiles=yes por updateTomcatFiles=no
    3. 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.
    4. 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.
  12. 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. Suprima las líneas que contienen los parámetros siguientes:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. Cambie la siguiente línea desde: updateTomcatFiles=yes por updateTomcatFiles=no
    3. 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.
    4. 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.
    5. 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.
  13. 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. Suprima las líneas que contienen los parámetros siguientes:
      oldTomcatHome
      newJTSTomcatHome
      newApplicationTomcatHome
    2. Cambie la siguiente línea desde: updateTomcatFiles=yes por updateTomcatFiles=no
    3. 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.
    4. 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.
  14. 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. Suprima las líneas que contienen los parámetros siguientes:
      oldTomcatHome
      newJTSTomcatHome 
      newApplicationTomcatHome
    2. Cambie la siguiente línea desde: updateTomcatFiles=yes por updateTomcatFiles=no
    3. 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.
    4. 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.
  15. 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.
  16. 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.
  17. 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.
  18. 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.
  19. 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 
  20. 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.
  21. Inicie WebSphere Application Server.
  22. Despliegue los archivos WAR de la versión 4 en WebSphere Application Server completando los pasos siguientes:
    1. Inicie sesión en WebSphere Application Server Integrated Solutions Console en: https://example.com:9043/ibm/console/logon.jsp
    2. Abra la página Aplicaciones empresariales seleccionando Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere
    3. Instale los siguientes archivos WAR de la versión 4:
      • jts.war
      • ccm.war
      • qm.war
      • rm.war
      • clmhelp.war
      • admin.war
    4. Correlacione los roles de seguridad para las siguientes aplicaciones de la versión 4 de acuerdo según lo que haya anotado cuando ha realizado la instalación en un paso anterior:
      • jts_war
      • ccm_war
      • qm_war
  23. Inicie las aplicaciones desde WebSphere Application Server Integrated Solutions Console:
    • jts_war
    • ccm_war
    • qm_war
    • rm_war
    • clmhelp_war
    • admin_war
  24. Restablezca el servidor abriendo un navegador y pegando los URL siguientes:
    https://jts_server.mydomain.com:9443/jts/admin#action=com.ibm.team.repository.admin.serverReset
    https://ccm_server.mydomain.com:9443/ccm/admin#action=com.ibm.team.repository.admin.serverReset
    https://qm_server.mydomain.com:9443/qm/admin#action=com.ibm.team.repository.admin.serverReset
    Nota: Debe reiniciar el servidor para que el restablecimiento del servidor entre en vigor.
  25. 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.
  26. 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