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
- Revise los temas de la sección en Planificación del despliegue y de la actualización según sea necesario.
- 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
- 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.
- 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).
- 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:
- 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.
- 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.
- Al final de la instalación, seleccione Ninguno para Qué programa desea iniciar.
- 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.
- 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
- 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.
- Si está desplegando en WebSphere Application Server,
detenga y desinstale las aplicaciones jazz.war y help.war de la versión 2.
- 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.
- 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.
- 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
- 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
- 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
- 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.
- 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.
- 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.
- Inicie el servidor de aplicaciones,
Jazz Team Server
versión 3 o
WebSphere Application Server.
- 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).
- Vaya a jazz/admin y verifique que no hay errores.
- 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.
- Abra el navegador, borre la memoria caché del mismo y vuelva a conectarse
al proyecto.
- 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.
- 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.
- 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.
- Actualice los informes.
- 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.
- 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.
- 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.
- 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.