Este tema describe cómo actualizar
Rational Quality Manager
versión 2 a la versión 3 utilizando el script qm_upgrade.
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.
Importante: Para utilizar el script de actualización en un entorno distribuido donde instaló Gestión de calidad por separado desde Jazz Team Server,
el script de actualización tiene que poder acceder a la unidad o al sistema de archivos donde está instalado Jazz Team Server . En Windows, por ejemplo, la correlación debe tener la forma mapped drive letter:\server\conf. Una vía de acceso absoluta (\\machine
name\installdir\server\conf) no funcionará. La unidad montada se tiene que configurar con privilegios lectura-escritura-ejecución para la cuenta de administrador.
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 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
el script de actualización ha 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 que el script haya terminado de importar los datos de usuario
y licencia a
Jazz Team Server.
- Realice una copia de seguridad de su base de datos y del 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 existente de la versión 2.
- Cambie al directorio dir_instalación_RQM2\server
de la versión 2.
- Ejecute 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:
Windows: repotools -export toFile=c:\tmp\export.tar
Unix/Linux: ./repotools.sh -export toFile=/tmp/export.tar
donde toFile especifica el nombre del archivo
TAR al que se exporta el repositorio.
- Si todavía no ha instalado
Jazz Team Server,
descargue e 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á desplegando en WebSphere Application Server,
detenga y desinstale las aplicaciones jazz.war y help.war de la versión 2.
- 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.
- En la instalación de la versión 3, abra una ventana de mandato nueva, vaya a JazzInstallDir\server y ejecute el script upgrade\qm_upgrade.bat en Windows o el script upgrade/qm_upgrade.sh en UNIX .
Nota: Puede ejecutar el script especificando todos los argumentos en la línea de mandatos. Como alternativa, si va a volver a ejecutar el script de actualización varias veces, también puede editar el archivo de parámetros del script y ejecutar una línea de mandatos abreviada. Consulte
12 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 las vías de acceso contienen espacios, asegúrese de que las delimita entre comillas.
Si instaló Jazz Team Server versión
3.0.1 junto con la aplicación QM, y es la primera o única aplicación que está instalando, la sintaxis del mandato es la siguiente:
Windows:
upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -createJTSTables
Unix/Linux:
./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -createJTSTables
Nota: El parámetro -createJTSTables se aplica a instalaciones donde está instalando Jazz Team Server 3.0.1 por primera vez.
Si instaló Jazz Team Server versión 3 por separado desde la aplicación QM, como en un despliegue distribuido, tiene que especificar la ubicación del servidor Jazz Team Server 3.0.1 y
y ejecutar el script desde el directorio de instalación de QM 3.0.1. En este caso, incluya el argumento -newJTSHome .
Windows:
upgrade\qm_upgrade.bat -oldApplicationHome RQM201InstallDir\server\conf -importFromFile c:\tmp\export.tar -newJTSHome JTS301InstallDir\server\conf
Unix/Linux:
./upgrade/qm_upgrade.sh -oldApplicationHome RQM201InstallDir/server/conf -importFromFile /tmp/export.tar -newJTSHome JTS301InstallDir\server\conf
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 la línea de mandatos de arriba.
- El parámetro -jtsURL es el URI público de
Jazz Team Server.
De forma predeterminado, el URI público de
Jazz Team Server
se obtiene del URI público de la aplicación. Este parámetro se debe especificar en un despliegue
distribuido donde
Jazz Team Server
se ejecuta en una instancia de servidor diferente de la de la aplicación QM.
- Si Jazz Team Server 3.0.1
aún se está ejecutando, debe detenerlo antes de que el script inicie el proceso
de migración de información de usuario y licencia. Jazz Team Server
y las aplicaciones que dependen de él estarán fuera de línea.
Si necesita más detalle acerca de las opciones de línea de mandatos, escriba el siguiente mandato:
Windows: upgrade\qm_upgrade.bat -help
Unix/Linux: ./upgrade/qm_upgrade.sh -help
Este
script completa las tareas siguientes:
- Actualiza los archivos de configuración versión 3 del modo siguiente:
- Importa los datos exportados de la versión 2 del archivo TAR
a la base de datos de Gestión de calidad (QM) de la versión 3 utilizando el mandato
repotools-jazz -import.
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.
- Exporta los datos de usuario y licencia de la base de datos de Gestión de calidad (QM).
- Importa los datos de usuario QM y licencia a Jazz Team Server.
- Importa los datos de correlación de usuario a la base de datos de QM.
La aplicación QM utiliza la correlación para comunicarse con la base de datos de
Jazz Team Server.
- Opcional: Como alternativa al paso anterior, puede abrir el archivo de parámetros del script, modificar los valores predeterminados y ejecutar una forma abreviada de la línea de mandatos.
Las versiones en inglés y traducidas de los archivos de parámetros están ubicadas en el directorio JazzInstallDir\server\upgrade\params\qm_params.bat en Windows o ./params/qm_params.sh en UNIX .
- Para obtener el nombre exacto del archivo de parámetros para su idioma, en el directorio JazzInstallDir\server\upgrade , ejecute locale.bat -qm -showParamFileName en Windows y ./locale.sh -qm -showParamFileName en UNIX.
- Abra qm_params o una versión traducida para editar y especificar valores para cada uno de los parámetros. Uno de los parámetros que debe establecerse es la vía de acceso al directorio OLD_APPLICATION_HOME. Si las vías de acceso contienen espacios, asegúrese de que las delimita entre comillas. ConsulteJazzInstallDir\server\upgrade\doc\qm_help.txt para obtener información acerca de cada uno de los parámetros.
- 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 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 un 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.
- 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.
Nota: Si la aplicación QM está instalada aparte, también tendrá que iniciar la aplicación CLM.
- 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).
- 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 y
Registro de aplicaciones adicionales con Jazz Team Server.
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.