Actualización fuera de línea a 3.0.1 utilizando el script de actualización

Este tema describe cómo actualizar IBM® Rational Requirements Composer de la versión 2 a la versión 3.0.1 utilizando el script rm_upgrade.

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 suceso en un nodo de red se correlacione con un suceso correspondiente en otro. Para evitar problemas, se pueden superar estos retos mediante el despliegue empresarial del servicio 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.

Importante: Para utilizar el script de actualización en un entorno distribuido donde se ha instalado la aplicación Gestión de requisitos (RM) independientemente de Jazz Team Server, el script de actualización debe poder acceder a la unidad o al sistema de archivos donde está instalada RM. En Windows, por ejemplo, el montaje debe tener esta forma: letra_unidad_montada:\server\conf. Una vía de acceso absoluta, por ejemplo \\<nombre_máquina>\dir_instalación_JTS301\server\conf no funcionará. La unidad montada se tiene que configurar con privilegios lectura-escritura-ejecución para la cuenta de administrador.

Puede seguir estas instrucciones de actualización para utilizar el script de actualización si tiene un despliegue de servidor único o si tiene un despliegue distribuido y puede montar una unidad desde Jazz Team Server y Gestión de requisitos.

Si está utilizando un despliegue de red distribuido y no se le permite montar la unidad o si es un administrador avanzado y piensa completar cada paso manualmente, puede seguir las instrucciones de Actualización fuera de línea a 3.0.1 manualmente. Los pasos manuales detallan los scripts que se están llevando a cabo.

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 nombre de archivo contiene un espacio, debe escribir el parámetro entre comillas dobles, por ejemplo "C:\Archivos de programa\IBM".

Procedimiento

  1. Revise este tema Descripción del proceso de despliegue y actualización. Revise también los temas de la sección siguiente Planificación del despliegue y de la actualización según sea necesario.
    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 el software cumplen o superan los requisitos mínimos para la aplicación. Consulte los requisitos del sistema. Verifique la siguiente información en el archivo teamserver.properties actual 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:
    com.ibm.team.repository.server.webapp.url=https\://hostname.example.com\:9443/jazz
  3. Descargue el software de IBM Rational Requirements Composer y cualquier otra aplicación de la solución Rational para Collaborative Lifecycle Management (CLM) que se deba instalar de la página de proyecto de 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 ejemplo siguiente 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. Esta selección instalará la aplicación RM con la opción necesaria para conservar la raíz de contexto /rdm de la versión 2 para RM, lo cual es necesario para conservar los enlaces a los artefactos RM. Si no se 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. Ejecute el script de actualización fuera de línea. 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 ejecute el script de actualización upgrade\rm_upgrade.bat en Windows o el script de actualización upgrade/rm_upgrade.sh en los sistemas AIX o Linux. Cuando el script se ejecute, utilizará el valor de idioma del entorno local del sistema.
    Nota: Puede ejecutar el script especificando todos los argumentos en la línea de mandatos. De manera alternativa, si va a volver a ejecutar el script de actualización varias veces, también puede editar el archivo de parámetros de script y ejecutar una línea de mandatos abreviada. Consulte el Paso14 para obtener instrucciones acerca del archivo de parámetros.
    Importante:
    • Aunque el archivo de script está ubicado en el directorio de actualización, debe ejecutarse desde el directorio del servidor. Igualmente, si la vía de acceso contiene espacios, asegúrese de escribir el nombre de vía de acceso entre comillas dobles.
    • Si ha utilizando licencias flotantes en Rational Requirements Composer versión 2, existe un problema conocido en el que 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.

    Si ha instalado Jazz Team Server versión 3.0.1 junto con la aplicación RM y esta actualización es para la primera o la única aplicación que está actualizando, la sintaxis del mandato es la siguiente:

    Windows:

    upgrade\rm_upgrade.bat -oldApplicationHome dir_instalación_RRC2\server\conf -importFromFile c:\tmp\export.tar -createJTSTables 

    AIX o Linux:

    ./upgrade/rm_upgrade.sh -oldApplicationHome dir_instalación_RRC2/server/conf -importFromFile /tmp/export.tar -createJTSTables 
    Nota: El parámetro -createJTSTables se aplica a instalaciones donde está instalando Jazz Team Server versión 3.0.1 y cualquiera de los productos de Gestión cooperativa del ciclo de vida por primera vez. No tiene que incluir este parámetro en el mandato si está instalando la aplicación RM sola, porque Jazz Team Server versión 3.0.1 existe en otras partes. 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 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 .

    Windows:

    dir_instalación_JTS301\server upgrade\rm_upgrade.bat -oldApplicationHome
    dir_instalación_RRCS2\server\conf -importFromFile c:\tmp\export.tar -newApplicationHome
    dir_instalación_RRC301\server\conf -jtsURL https://nombre_dominio_completo:puerto/jts

    AIX o Linux:

    dir_instalación_JTS301/server ./upgrade/rm_upgrade.sh -oldApplicationHome
    dir_instalación_RRCS2/server/conf -importFromFile /tmp/export.tar -newApplicationHome
    dir_instalación_RRC301/server/conf -jtsURL https://nombre_dominio_completo:puerto/jts
    Nota:
    • Si tiene un despliegue distribuido y no ha configurado Jazz Team Server versión 3.0.1, puede añadir el parámetro -createJTSTables al ejemplo de línea de mandatos anterior.
    • 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.

    Para obtener más detalles sobre las opciones de línea de mandatos, escriba uno de estos mandatos:

    Windows: upgrade\rm_upgrade.bat -help

    AIX o Linux: ./upgrade/rm_upgrade.sh -help

    Debido a la cantidad de información a migrar, la migración fuera de línea puede tardar mucho tiempo en completarse.
    Atención: Durante la migración fuera de línea, debe revisar las solicitudes que visualizan el contenido de los archivos fusionados, específicamente la conexión de base de datos que se especifica en el archivo teamserver.properties, y editar los archivos fusionados si es necesario.

    Este script completa las tareas siguientes:

    1. Actualiza los archivos de configuración de la versión 3.0.1 del modo siguiente:
      • Ejecuta el mandato -migration_rm_updateConfigurationFiles y actualiza los archivos de configuración y Tomcat. Entre [E] para ejecutar el mandato, [S] para saltarse el paso o pulse [Intro] para cancelar la ejecución del script.
        Importante: No modifique las propiedades para conectarse a la base de datos de almacén de datos, incluso si están establecidas actualmente en Derby. Utilice el asistente de configuración de servidor sólo para modificar estas propiedades.
        Nota: Si aún no ha instalado 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.
      • Una vez se hayan fusionado los archivos de configuración satisfactoriamente, entre [C] para continuar. Se abre una ventana de Bloc de notas (o un editor vi en los sistemas AIX o Linux) en la que puede verificar el archivo de Jazz Team Server teamserver.properties. Verifique que la raíz de URI público indicada por la propiedad com.ibm.team.repository.server.webapp.url es correcta. Verifique también que las propiedades de la base de datos son correctas. Cuando lo haya hecho, guarde los cambios si los hubiera y cierre el editor para continuar con la ejecución del script.
      • Copia el archivo .xml de usuarios de Tomcat versión 2.
      • Fusiona el archivo friendsconfig.rdf de la versión 2, que contiene la lista de servidores que se configuran para la integración de repositorios cruzados, con la versión 3.0.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.
    2. Importa los datos exportados de la versión 2 de RM del archivo .tar a la base de datos de Jazz Team Server versión 3.0.1 utilizando el mandato repotools-jts -import de Windows o el mandato ./repotools-jts.sh -import de los sistemas AIX o Linux.
      Nota:
      • La importación de repositorios grandes para la aplicación de Gestión de requisitos de la versión 3.0.1 puede producir 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 visualizar la lista Rational Requirements Composer detallada de los cambios realizados a los archivos de configuración, consulte Cambios de Rational Requirements Composer.
  14. Opcional: Como alternativa al paso anterior, puede abrir el archivo de parámetros del scripts, modificar los valores predeterminados y ejecutar una forma abreviada de la línea de mandatos. Para obtener información detallada acerca de estos valores, consulte rm_upgrade.

    Las versiones en inglés y traducidas de los archivos de parámetros están ubicadas en el directorio dir_instalación_Jazz\server\upgrade\params\rm_params.bat en Windows o en el directorio ./params/rm_params.sh en sistemas AIX o Linux.

    1. Para obtener el nombre exacto del archivo de parámetros para el idioma correspondiente, en el directorio dir_instalación_Jazz\server\upgrade, ejecute el mandato locale.bat -rm -showParamFileName en Windows y el mandato ./locale.sh -rm -showParamFileName en sistemas AIX o Linux.
    2. Abra el archivo rm_params o una versión traducida del mismo para editarlo y especifique valores para cada parámetro. Un parámetro que se debe establecer es la vía de acceso al directorio OLD_APPLICATION_HOME. Asegúrese de que la vía de acceso no contiene espacios. 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, establezca OLD_APPLICATION_HOME="C:\Program Files\IBM\RRCS2002\server\conf". Consulte el archivo dir_instalación_Jazz\server\upgrade\doc\rm_help.txt para obtener información sobre cada parámetro.
  15. Verifique que los archivos de configuración y los datos de repositorio se han actualizado. Para obtener detalles, consulte Verificación de los archivos de configuración durante la actualización y -migration_rm_updateConfigurationFiles.
  16. Cuando la migración fuera de línea haya finalizado, realice una copia de seguridad de la base de datos y de todo el directorio de la versión 3.0.1 del servidor Jazz Team Server 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 más detalles, consulte Configuración de WebSphere Application Server para la actualización de la versión 3.
  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