Actualización manual a Rational Quality Manager y Jazz Team Server 3.0.1

Este tema describe el proceso manual para actualizar Rational Quality Manager versión 2 a la versión 3.

Antes de empezar

Antes de comenzar la actualización, asegúrese de que los relojes en todas 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.

En un entorno de WebSphere Application Server, se recomienda cambiar la vía de acceso de instalación a una que no contenga espacios, como C:\IBM\JazzTeamServer. Si alguno de los parámetros de ruta de archivo o de nombre de archivo contiene un espacio, debe rodear el parámetro con comillas.

Si está actualizando desde la versión 2.0.1 iFix02 o superior, actualiza a la versión 2.0.1.1 o superior antes de exportar los datos. A continuación, ejecute el siguiente mandato repotools en el servidor de la versión 2 para evitar errores potenciales con el proceso de exportación-importación.

Windows: repotools -repairRequests

Unix/Linux: ./repotools.sh -clean -repairRequests

Los usuarios de versiones anteriores a 2.0.1 iFix02 pueden ignorar este paso.

Procedimiento

  1. Revise los temas de la sección en Planificación del despliegue y de la actualización según sea necesario.
  2. Verifique el archivo teamserver.properties versión 2 existente para la propiedad URL pública com.ibm.team.repository.server.webapp.url y para obtener la información para conectarse al servidor de base de datos, normalmente 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 URL público en la versión 3.0.1. Si no se ha establecido el URL público, utilice la interfaz de web administrativa de la versión 2 (Propiedades avanzadas) para establecer el URL de nombre de host calificado (https://hostname.example.com:port) antes de la actualización.

    La línea de URL público en teamserver.properties debe parecerse a:
    com.ibm.team.repository.server.webapp.url=https\://<hostname.example.com>\:9443/jazz
  3. Descargue el software de Rational Quality Manager desde la página de proyecto adecuada en jazz.net. Para obtener instrucciones, consulte Descarga del medio de instalación del producto.
  4. Detenga el servidor versión 2.
    Nota: Si está trabajando en un entorno distribuido y ya ha instalado Jazz Team Server 3.0.1, para minimizar el tiempo de inactividad para Jazz Team Server y otras aplicaciones, opcionalmente puede dejar el servidor en ejecución hasta que haya terminado de importar los datos de la versión 2 a la base de datos de Quality Management (QM) de la versión 3. En ese punto, debe detener Jazz Team Server. Puede reiniciarlo después de haber terminado de importar los datos de usuario y licencia a Jazz Team Server (14).
  5. Realice una copia de seguridad de su base de datos versión 2 y el archivo teamserver.properties en una ubicación temporal. De manera predeterminada, al archivo teamserver.properties está ubicado en InstallDir\server\conf\jazz\teamserver.properties en la versión 2. Para obtener instrucciones para la copia de seguridad, consulte los temas siguientes:
  6. Exporte los datos del repositorio de la versión 2 existente utilizando el mandato repotools -export y guarde el archivo fuera de la estructura de directorios de Rational Quality Manager, como se muestra en el ejemplo siguiente de la versión 2.0.1:
    repotools -export toFile=c:\export.tar teamserver.properties=c:\Program%20Files\IBM\RQM201\server\conf\jazz\teamserver.properties

    donde toFile especifica el nombre del archivo TAR al que se exporta el repositorio y teamserver.properties especifica la vía de acceso al archivo teamserver.properties.

    Nota: Puede encontrar instrucciones detalladas para utilizar repotools en Getting Started with Repository Migration y en Repotools command line reference. Asegúrese de utilizar la versión de repotools que se incluye con el producto existente de la versión 2.
  7. Si todavía no ha instalado Jazz Team Server, instale el servidor, la aplicación Gestión de calidad y las claves de licencia base necesarias en una ubicación nueva en disco. Si ya ha instalado el servidor, instale la aplicación de Gestión de calidad. Para obtener instrucciones, consulte Instalación con IBM Installation Manager.
    Importante: Los requisitos, los defectos y otros elementos de trabajo ya no se crean en la aplicación Gestión de calidad, como sucedía en la versión 2. Los equipos de prueba que deseen sacar partido de estas prestaciones, también deben instalar Gestión de requisitos y Gestión de cambios y configuración. En un entorno distribuido, se pueden instalar estas aplicaciones por separado.

    Durante la instalación, seleccione Utilizar raíz de contexto de Rational Quality Manager 2.x. Esto instalará la aplicación QM en una raíz de contexto de /jazz en lugar de /qm. Esta opción es necesaria para preservar los enlaces a artefactos QM. Si no se selecciona esta opción, la actualización fallará. Para obtener detalles, consulte Descripción del proceso de despliegue y actualización.

  8. Al final de la instalación, seleccione Ninguno para Qué programa desea iniciar.
  9. Si está utilizando una base de datos que no es la base de datos Derby predeterminada, cree las bases de datos de la versión 3.

    Las bases de datos son necesarias para la Jazz Team Server, Gestión de calidad, Gestión de cambios y configuración y Depósito de datos. No necesita crear una base de datos para Gestión de requisitos porque la Gestión de requisitos 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. Abra una nueva ventana de mandatos en la versión 3.0.1 (dir_instalación_RQM301/server) y escriba repotools-jazz -migration_qm_updateConfigurationFiles oldApplicationHome=dir_instalación_RQM2/server/conf para fusionar los archivos de configuración de Jazz de la versión 2 con los de la versión 3.

    Si instaló la versión 3.0.1 de Jazz Team Server por separado desde la aplicación QM, como en un despliegue distribuido, haga lo siguiente:

    • Monte la unidad o el sistema de archivos donde esté instalado Jazz Team Server .
    • Especifique la ubicación de Jazz Team Server 3.0.1 en la línea de mandatos -migration_qm_updateConfigurationFiles incluyendo el argumento -newJTSHome .

    Este mandato completa las tareas siguientes:

    • Actualiza los archivos teamserver.properties versión 3 para las aplicaciones y JTS basándose en la información del archivo teamserver.properties de Jazz versión 2.
    • Copia el contenido del archivo users.xml de Tomcat.
    • Copia el archivo friendsconfig.rdf, que contiene la lista de servidores configurados para la integración de repositorios cruzados.
    • Fusiona el contenido de los archivos server.xml y web.xml (valores LDAP) de la versión 2 con el de los archivos de la versión 3
  11. Verifique los archivos de configuración. Para obtener detalles, consulte Verificación de los archivos de configuración durante la actualización y -migration_qm_updateConfigurationFiles.
  12. Si está desplegando en WebSphere Application Server, detenga y desinstale las aplicaciones jazz.war y help.war de la versión 2.
  13. Importe los datos de Rational Quality Manager del repositorio de la versión 2 exportado al nuevo repositorio de Gestión de calidad (QM) versión 3 utilizando el mandato repotools-jazz -import, como se muestra en el ejemplo siguiente:
    repotools-jazz -import fromFile=c:\export.tar

    donde fromFile especifica el nombre del archivo TAR del que se importará el repositorio.

    Nota: La importación de repositorios grandes para Gestión de calidad 3.0.1 puede llevar a errores OutOfMemoryException. Los clientes con un número significativo de proyectos y artefactos debe aumentar el parámetro -Xmx en el script repotools-jazz.bat o repotools-jazz.sh desde el valor predeterminado de 1500M a un valor superior. 4096M es el valor recomendado si la máquina tiene memoria suficiente y está ejecutando un SO de 64 bits.
  14. Cree la nueva base de datos de Jazz Team Server (JTS) y transfiera los datos de usuarios y licencias de la base de datos de Gestión de calidad.
    1. Exporte los datos de usuario de la aplicación Gestión de calidad utilizando el mandato siguiente repotools-jazz:
      repotools-jazz -migration_exportJTSData toFile=jtsData.tar 
    2. Importe los datos de usuarios y licencias a la base de datos de Jazz Team Server utilizando el siguiente mandato repotools-jts.
      Importante: Si esto es una instalación nueva de Jazz Team Server y cualquiera de los productos de Gestión cooperativa del ciclo de vida, el mandato repotools-jts puede incluir el parámetro createTables que crea una base de datos JTS nueva. Si ya hay una base de datos JTS existente, no incluya el parámetro createTables en la línea de mandatos, ya que esto sobrescribirá la base de datos existente.
      repotools-jts -migration_importJTSData fromFile=jtsData.tar createMappingFile=mapping-qm.txt createTables 
    3. Importe los datos de correlación de usuario a la base de datos QM utilizando el siguiente mandato repotools-jazz. La aplicación QM utiliza la correlación para comunicarse con la base de datos JTS.
      repotools-jazz -migration_importUserMapping fromMappingFile=mapping-qm.txt   
  15. Si ha creado un certificado de seguridad para utilizarlo con el release anterior, copie el certificado desde el release anterior o cree uno nuevo. Consulte Configuración de certificados de seguridad para obtener detalles.
  16. 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, Rational Quality Manager) para obtener la sintaxis del mandato.
  17. Si está desplegando en WebSphere Application Server, despliegue los archivos WAR 3.0 y correlacione los roles de seguridad con usuario y 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.
  18. Inicie el servidor de aplicaciones, Jazz Team Server versión 3 o WebSphere Application Server.
  19. Configure el servidor y cualquier aplicación CLM que instaló.

    Ejecute el asistente de configuración del servidor si está actualizando Jazz Team Server junto con la Gestión de calidad o cualquiera de las aplicaciones CLM (consulte Ejecutar el asistente de configuración. Utilice la interfaz web administrativa si está añadiendo la Gestión de calidad a un Jazz Team Server establecido (consulteRegistrar aplicaciones con Jazz Team Server).

  20. Vaya a jazz/admin y verifique que no hay errores.
  21. Migre los requisitos de la versión 2 a la aplicación Gestión de requisitos (RM). Para obtener detalles, consulte Migración de los requisitos basados en elementos de trabajo.
    Nota: Este paso es necesario si ha mantenido los requisitos de la versión 2 internamente en Rational Quality Manager. Este paso no es necesario si ha utilizado un proveedor de requisitos externo.
  22. Abra el navegador, borre la memoria caché del mismo y vuelva a conectarse al proyecto.
  23. Actualice las licencias. Consulte Conocimiento de la licencia para obtener una visión general breve. A continuación, siga los pasos de Instalación y gestión de claves de licencia.
    Nota: Las licencias de Gestor de calidad y Gestor de laboratorio en la versión 2 se llaman ahora licencias de Profesional de calidad en la versión 3. Ya no hay licencias Gestor de laboratorio aparte. Las licencias de Connector en la versión 2 todavía se llaman licencias de Connector, mientras que las licencias de Visor en la versión 2 se llaman ahora licencias de Colaborador.
  24. Si la aplicación de ayuda (clmhelp.war) está en un servidor diferente a la otra aplicación, configure la ubicación de la ayuda. Para obtener detalles, consulte Configuración de la ubicación de la ayuda en un entorno distribuido.
  25. Actualice los paneles de instrumentos

    Inicie la sesión en la aplicación como usuario administrativo y vaya a cualquier página con un panel de instrumentos. A continuación, pulse Migrar para actualizar todos los paneles de instrumentos.

  26. Actualice los informes.
    1. Inicie la migración del almacén de datos de la versión 2. Para obtener más información consulte Migración de datos de informe desde la versión 2.
    2. A continuación, inicie el cliente Rational Team Concert y actualice a las plantillas de informe más recientes. Para obtener más información consulte Actualización de las plantillas de informes predeterminadas.
    3. Si utilizó Rational Common Reporting en la versión 2, debe migrar los informes a Rational Reporting for Development Intelligence. Para obtener más detalles, consulte Migrating to Rational Reporting for Development Intelligence.
  27. Verifique que la actualización está completa. Para obtener detalles, consulte Verificación de la actualización.

Qué hacer a continuación

Una vez se haya completado la actualización, siga con Configuración de Jazz Team Server y la primera aplicación después de la actualización.
Nota: Si está actualizando desde Rational Common Reporting, realice copia de seguridad de la base de datos del almacén de datos de Rational Common Reporting existentes antes de configurar el servidor. Para obtener instrucciones para la copia de seguridad, consulte la documentación para el sistema de gestión de bases de datos relacionales que aloja el almacén de datos.

Comentarios