Actualización fuera de línea a 3.0.1 manualmente

Este tema describe cómo realizar los pasos de actualización manualmente para la migración fuera de línea del servidor de IBM® Rational Requirements Composer versión 2 a la versión 3.0.1.

Antes de empezar

Antes de empezar la actualización, asegúrese de que los relojes de las máquinas estén sincronizados utilizando el NTP (Network Time Protocol - Protocolo de hora en red). La hora es el elemento crítico que permite que un evento de un nodo de red se correlacione con un evento correspondiente de otro. Estos requerimientos se pueden superar mediante el despliegue de empresa del servicio de NTP. Para obtener más información sobre NTP, visite http://www.ntp.org/. Además, todos los servidores deben utilizar el mismo método de autenticación para los usuarios.

Si pretende actualizar varios productos, consulte Orden de actualización para que le ayude a decidir qué actualizar primero.

En un entorno de IBM WebSphere Application Server, cambie la vía de acceso de instalación por una que no contenga espacios, por ejemplo C:\IBM\JazzTeamServer. Sin embargo, si algún parámetro de vía de acceso de archivo o de nombre de archivo contiene un espacio, escribir el parámetro entre comillas dobles. Por ejemplo, "C:\Archivos de programas\IBM".

Procedimiento

  1. Revise el tema Descripción del proceso de despliegue y actualización. Revise también los temas de la sección siguiente según sea necesario: Planificación del despliegue y de la actualización.
    Importante:
    • Se conservarán la raíz de contexto RM versión 2 original (/rdm) y los URI para todos los artefactos RM. La raíz de contexto de Jazz Team Server cambiará de /jazz a /jts.
    • Si se ha establecido un URI público en la instalación de la versión 2, debe utilizar el mismo URI público en la versión 3.0.1.
  2. Verifique que el hardware y software cumplen o superan los requisitos mínimos para la aplicación. Consulte los requisitos del sistema. Recupere la siguiente información del archivo teamserver.properties existente de la versión 2:
    • La propiedad de URI público - com.ibm.team.repository.server.webapp.url
    • Información para conectarse al servidor de base de datos ,por lo general com.ibm.team.repository.db.vendor, com.ibm.team.repository.db.jdbc.location y com.ibm.team.repository.db.jdbc.password.

    Debe utilizar el mismo URI público en la versión 3.0.1. Si no se ha establecido un URI público, utilice la interfaz web administrativa de la versión 2 (Propiedades avanzadas) para establecer el URI de nombre de host calificado (https://hostname.example.com:port) antes de la actualización.

    La línea de URI público en el archivo teamserver.properties será similar a este ejemplo:
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. Descargue el software de IBM Rational Requirements Composer y otras aplicaciones de la solución Rational para Collaborative Lifecycle Management (CLM) que se deban instalar en Jazz.net. Para obtener instrucciones, consulte Descarga del medio de instalación del producto.
  4. Detenga el servidor IBM Rational Requirements Composer versión 2.
  5. Realice una copia de seguridad de la base de datos de IBM Rational Requirements Composer versión 2 y del archivo teamserver.properties en una ubicación temporal (tmp). El archivo teamserver.properties contiene la ubicación de base de datos, que cada aplicación necesita para conectarse a la base de datos. De forma predeterminada, este archivo está ubicado en el archivo dir_instalación\server\conf\jazz\teamserver.properties en la versión 2. Para obtener instrucciones de copia de seguridad, consulte estos temas:
  6. Exporte los datos de la base de datos existente de IBM Rational Requirements Composer versión 2.
    1. Cambie al directorio de IBM Rational Requirements Composer versión 2 dir_instalación_RRC2\server.
    2. Ejecute el mandato repotools -export de Windows o el mandato ./repotools.sh - export de los sistemas AIX o Linux y guarde el archivo fuera de la estructura de directorios de IBM Rational Requirements Composer, como se muestra en el siguiente ejemplo de la versión 2.0.1:

    Windows: repotools -export toFile=c:\tmp\rrcdata.tar

    AIX o Linux: repotools -export toFile=/tmp/rrcdata.tar

    donde la variable toFile especifica el nombre del archivo .tar al que se exporta la base de datos.

    Nota:
  7. Si ya ha instalado Jazz Team Server versión 3.0.1, detenga todos los servidores de la versión 3.0.1 incluyendo Jazz Team Server y otras aplicaciones CLM y realice una copia de seguridad de la base de datos y del entorno de Jazz Team Server versión 3.0.1. Salte al Paso 10.
  8. Si no ha instalado Jazz Team Server versión 3.0.1, instale Jazz Team Server. No ejecute el asistente de configuración.
  9. Si aún no ha instalado Jazz Team Server versión 3.0.1 y está utilizando una base de datos distinta de la base de datos Derby predeterminada, debe crear las bases de datos de Jazz Team Server.

    Las bases de datos son necesarias para Jazz Team Server y el depósito de datos. No tiene que crear una base de datos para la aplicación Gestión de requisitos porque esa aplicación utiliza la base de datos de Jazz Team Server para el almacenamiento de datos. Consulte los temas de Configuración de la base de datos para obtener detalles sobre cada base de datos.

    Nota: Si utiliza una base de datos Oracle o de SQL Server, asegúrese de copiar el controlador de la base de datos en la ubicación correcta. Para obtener detalles, consulte Configuración de una base de datos de Oracle y Configuración de una base de datos de SQL Server.
  10. Instale la aplicación Gestión de requisitos en otra máquina. Para obtener instrucciones, consulte Instalación con IBM Installation Manager.

    Durante la instalación, seleccione Utilizar raíz de contexto de Rational Requirements Composer 2.x. Esto instalará la aplicación RM con la opción necesaria para conservar la raíz de contexto /rdm de versión 2 para RM, lo cual es necesario para conservar los enlaces a los artefactos RM. Si no selecciona esta opción, la actualización fallará. Para obtener detalles, consulte Descripción del proceso de despliegue y actualización.

  11. Al final de la instalación, seleccione Ninguno para Qué programa desea iniciar, pulse Finalizar y, a continuación, pulse Salir.
  12. Si está desplegando en WebSphere Application Server, detenga y desinstale los siguientes archivos .war de la versión 2: converter.war, jazz.war, rrc-help.war y rdm.war. Para obtener más información, consulte Configuración de WebSphere Application Server para la actualización de la versión 3.
  13. Abra una nueva ventana de mandatos desde la ubicación donde ha instalado Jazz Team Server versión 3.0.1, vaya a dir_instalación_JTS301\server y utilice el mandato siguiente para fusionar los archivos de configuración de la versión 2 con los de la versión 3.0.1: repotools-jts -migration_rm_updateConfigurationFiles oldApplicationHome=dir_instalación_RRCS20/server/conf.

    Si ha instalado Jazz Team Server versión 3.0.1 independientemente de la aplicación RM, por ejemplo en un despliegue distribuido, debe especificar la ubicación de la aplicación RM y ejecutar el script desde el directorio de instalación de Jazz Team Server versión 3.0.1. En este caso, incluya el argumento -newApplicationHome .

    repotools-jts -migration_rm_updateConfigurationFiles 
    oldApplicationHome=dir_instalación_RRC2/server/conf newApplicationHome=<dir_instalación_JTS301>/server/conf -jtsURL https://<nombre_dominio_completo>:<puerto>/jts
    Nota: El parámetro -jtsURL es el URI público de Jazz Team Server. De forma predeterminada, el URI público de Jazz Team Server se obtiene del URI público de la aplicación. Este parámetro debe especificarse en el despliegue distribuido donde se está ejecutando Jazz Team Server en una instancia de servidor diferentes a la de la aplicación RM.

    Este mandato completa las tareas siguientes:

    • Actualiza los archivos JazzInstallDir/server/conf/app/teamserver.properties de la versión 3 basándose en la información del archivo Jazz JazzInstallDir/server/conf/jazz/teamserver.properties de la versión 2. Se le dará la oportunidad de editar valores, como por ejemplo las propiedades de ubicación de base de datos de Jazz Team Server, que es información que el script no puede obtener de la versión 2.
      Nota: Si aún no ha instalado y configurado Jazz Team Server versión 3.0.1, en este punto debe entrar la propiedad de ubicación de base de datos para la nueva base de datos de Jazz Team Server que ha creado anteriormente en el Paso 9.
    • Copia el archivo .xml de usuarios de Tomcat de la versión 2.
    • Fusiona el archivo friendsconfig.rdf de la versión 2, que contiene la lista de servidores que están configurados para la integración de repositorios cruzados, con el de la versión 30.1.
    • Fusiona el contenido de los archivos server.xml y web.xml (valores de LDAP) de la versión 2 con el de los archivos de la versión 3.0.1.

    Para obtener detalles adicionales, consulte Fusión de archivos de configuración y -migration_updateConfigurationFiles.

  14. Importe los datos de Rational Requirements Composer del repositorio exportado de la versión 2 al nuevo repositorio de Gestión de requisitos (RM) de la versión 3 utilizando el mandato repotools-jts -importapplicationdata, como se muestra en el ejemplo siguiente:
    repotools-jts migration_importapplicationdata fromFile=c:\export.tar

    donde la variable fromFile especifica el nombre del archivo .tar del que se exportará el repositorio.

    Nota:
    • Si esto es una instalación nueva de Jazz Team Server y cualquiera de los productos de Gestión cooperativa del ciclo de vida, pude incluir el parámetro createTables en el enlace de mandato si está importando datos de usuario en Jazz Team Server por primera vez. El parámetro createTables crea una base de datos de Jazz Team Server e importa el contenido del archivo .tar. Si ya hay una base de datos Jazz Team Server existente, no incluya el parámetro createTables en la línea de mandatos, ya que esto sobrescribirá la base de datos existente.
    • Si ha utilizado licencias flotantes en IBM Rational Requirements Composer versión 2, existe un problema conocido donde es posible que tenga que detener el script de actualización, iniciar Jazz Team Server e instalar las licencias flotantes de la versión 3.0.1 antes de importar los datos de la base de datos de IBM Rational Requirements Composer versión 2. Para obtener más información sobre cómo realizar esta tarea, consulte https://jazz.net/library/article/659.
    • La importación de repositorios grandes para Gestión de requisitos versión 3.0.1 puede llevar a errores OutOfMemoryException. Si tiene un número significativo de proyectos y artefactos, aumente el parámetro -Xmx en el script repotools-jts.bat o repotools-jts.sh del valor predeterminado de 1500M a un valor superior. Para obtener los mejores resultados, utilice 4096M si la máquina tiene suficiente memoria.
    • Para ver la lista detallada de Rational Requirements Composer de los cambios que se efectúan en los archivos de configuración, consulte Cambios de Rational Requirements Composer.
  15. Verifique los archivos de configuración y los datos de repositorio. Para obtener detalles, consulteVerificación de los archivos de configuración durante la actualización.
  16. Cuando la migración fuera de línea haya finalizado, realice una copia de seguridad de la base de datos y del entorno de Jazz Team Server versión 3.0.1 en una ubicación diferente de la que ha utilizado para hacer la copia de seguridad de la base de datos de la versión 2. Realice la copia de seguridad antes de continuar con la migración en línea. No sobreescriba la copia de seguridad de la base de datos de la versión 2.
  17. Si ha creado un certificado de seguridad para utilizarlo con el release anterior, copie el certificado o cree uno nuevo. Consulte Configuración de certificados de seguridad para obtener detalles.
  18. Si está ejecutando el servidor de aplicaciones Tomcat como servicio de Windows, debe eliminar y volver a instalar el servicio. Consulte Ejecución de Apache Tomcat como un servicio de Windows (32 bits) para obtener la sintaxis del mandato.
  19. Si está desplegando en IBM WebSphere Application Server, despliegue los archivos WAR 3.0 y correlacione los roles de seguridad con un usuario o grupo. Para obtener detalles, consulte Configuración de WebSphere Application Server para la actualización de la versión 3 y Despliegue de aplicaciones CLM en WebSphere Application Server.
  20. Una vez completada la copia de seguridad, continúe con los pasos de la migración en línea. Para obtener más información, consulte Pasos de actualización de migración en línea.

Comentarios