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
- 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.
- 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
- 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.
- Detenga el servidor
IBM Rational Requirements Composer
versión 2.
- 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:
- Exporte los datos de la base de datos existente de
IBM Rational Requirements Composer
versión 2.
- Cambie al directorio de
IBM Rational Requirements Composer
versión 2 dir_instalación_RRC2\server.
- 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.
- 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.
- Si no ha instalado
Jazz Team Server
versión 3.0.1, instale
Jazz Team Server.
No ejecute el asistente de configuración.
- 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.
- 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.
- Al final de la instalación, seleccione Ninguno para
Qué programa desea iniciar, pulse Finalizar y,
a continuación, pulse Salir.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.