Actualización de Rational Engineering Lifecycle Manager

Para actualizar su versión de Rational Engineering Lifecycle Manager a la versión más reciente, deberá realizar una instalación yuxtapuesta de la nueva versión.

Antes de empezar

Si va a actualizar los productos integrados con Rational Engineering Lifecycle Manager, asegúrese de que sigue las instrucciones de Actualización de la pila de productos Rational Engineering Lifecycle Manager

Procedimiento

  1. Instale Rational Engineering Lifecycle Manager utilizando las instrucciones de Instalación de Rational Engineering Lifecycle Manager y Lifecycle Query Engine. Esto instalará:
    • Rational Engineering Lifecycle Manager v4.0.6
    • Jazz Team Server v 4.0.6
    • La aplicación Gestión de configuración
    Importante:
    • Asegúrese de seleccionar un grupo de paquetes y un directorio distintos de los de la instalación original.
    • Asegúrese de seleccionar la misma raíz de contexto que la instalación anterior.
  2. Si utiliza WebSphere Application Server, siga estos pasos.
    1. Realice una copia de seguridad del perfil de WebSphere Application Server. Abra un indicador de mandatos y vaya a la carpeta bin del directorio de instalación de WebSphere Application Server. Por ejemplo, C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\bin. Ejecute el siguiente mandato. Fíjese que si está activada la seguridad de WebSphere Application Server, también deberá proporcionar el nombre de usuario y la contraseña:
      backupConfig.bat <Vía de acceso a un nuevo archivo comprimido para crear una copia de seguridad del perfil> <nombre de usuario administrativo primario WAS> y <contraseña administrativa WAS>
      Por ejemplo, backupConfig.bat C:\WAS_backup\clm_40_profile.zip -username WAS admin -password WAS admin password.
    2. Desinstale las aplicaciones existentes de WebSphere Application Server. Para desinstalar los archivos war de la aplicación, vaya a cada servidor de aplicaciones y realice los pasos siguientes.
      1. Inicie sesión en WebSphere Application Server Integrated Solutions Console en https://nombre_host:9043/ibm/console/logon.jsp.
      2. Pulse Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere.
      3. Detenga y desinstale las siguientes aplicaciones: relm.war, vvc.war, lqe.war, SPARQL_Gateway.war
      4. Guarde los cambios en la configuración principal cuando se le solicite.
    3. Actualice las propiedades personalizadas JAZZ_HOME y log4j.configuration.
      1. Inicie sesión en WebSphere Application Server Integrated Solutions Console en https://nombre_host:9043/ibm/console/logon.jsp.
      2. Pulse Servidores>Tipos de servidor>Servidores de aplicaciones WebSphere.
      3. Pulse el nombre del servidor para abrirlo. El nombre de servidor predeterminado es server1.
      4. En la sección Infraestructura del servidor, pulse Gestión de Java y procesos>Definición de procesos.
      5. En Propiedades adicionales, pulse Máquina virtual Java.
      6. Cambie la vía de acceso de Lifecycle Query Engine y SPARQL Gateway a la nueva ubicación.
      7. Localice el campo de texto Argumentos de JVM genéricos y añada la siguiente variable de entorno al proceso de inicio de JVM: -Dlqe.config.location=file://drive:\carpeta_instalación_lqe\server\conf\lqe
      8. En Propiedades adicionales, pulse Propiedades personalizadas.
      9. Pulse JAZZ_HOME y actualice este valor a file:///4.0.6_install_dir/server/conf. Por ejemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf.
      10. Pulse log4j.configuration y actualice su valor a file:///4.0.6_install_dir/server/conf/startup_log4j.properties. Por ejemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_4.0.6/server/conf/startup.log4j.properties.
      11. Si se conecta a una base de datos Oracle, asegúrese de que ORACLE_JDBC_DRIVER_FILE apunte al archivo del controlador JDBC correcto.
      12. Guarde los cambios en la configuración principal cuando se le solicite.
    4. Detenga WebSphere Application Server.
    5. Limpie los directorios temporales de WebSphere Application Server. Vaya a cada servidor de aplicaciones y elimine el contenido relacionado con Rational Engineering Lifecycle Manager de los siguientes directorios wscache y temp en el perfil. Según las aplicaciones instaladas anteriormente, los directorios siguientes estarán presentes bajo el perfil y podrán eliminar: relm_war, lqe_war, sparql y los datos relacionados con vvc.
      WAS_profile_root\wscache (por ejemplo: C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
      WAS_profile_root\temp (por ejemplo: C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    6. Limpie el directorio logs. Vaya a cada servidor de aplicaciones y elimine los registros relacionados con Rational Engineering Lifecycle Manager del directorio logs en el perfil. Un directorio logs típico puede ser: C:\Archivos de programa\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
  3. Para migrar la base de datos:
    Opción Descripción
    Derby Suprima las bases de datos Derby que se han instalado con la actualización y sustitúyalas por los archivos de Derby de la instalación original.
    rm -rf $newRELMHome/server/conf/jts/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/jts/indices
    rm -rf $newRELMHome/server/conf/relm/derby/repositoryDB
    rm -rf $newRELMHome/server/conf/vvc/derby/repositoryDB
    cp -R $oldRELMHome/server/conf/jts/derby/repositoryDB $newRELMHome/server/conf/jts/derby
    cp -R $oldRELMHome/server/conf/jts/indices $newRELMHome/server/conf/jts
    cp -R $oldRELMHome/server/conf/relm/derby/repositoryDB $newRELMHome/server/conf/relm/derby
    cp -R $oldRELMHome/server/conf/relm/indices $newRELMHome/server/conf/relm
    cp -R $oldRELMHome/server/conf/vvc/derby/repositoryDB $newRELMHome/server/conf/vvc/derby
    cp -R $oldRELMHome/server/conf/vvc/indices $newRELMHome/server/conf/vvc
    DB2 u Oracle Para obtener instrucciones completas, consulte la documentación proporcionada por el proveedor de la base de datos. A continuación, se muestra un proceso de ejemplo para DB2 que se puede utilizar como directriz.
    1. Detenga el Jazz Team Server antiguo.
    2. En DB2, localice la base de datos utilizada por la instalación anterior de las aplicaciones de JTS.
    3. Realice una copia de seguridad de cada base de datos utilizada por una aplicación JTS.
    4. Pulse con el botón derecho cada base de datos y seleccione Restaurar > Restaurar en la base de datos nueva.
    5. Escriba un nombre para la base de datos y seleccione el directorio que contiene la copia de seguridad.
    6. Abra el archivo <JazzInstallDir>/server/conf/jts/teamserver.properties.
    7. Sustituya el nombre de la base de datos Jazz por el nombre que ha proporcionado, como se muestra en el siguiente ejemplo.
      #
      # Configuración de DB2
      #
      
      # Comente las líneas anteriores, quite los comentarios de las tres siguientes líneas y personalice la ubicación de ejemplo para utilizar DB2
      #com.ibm.team.repository.db.vendor = DB2
      #com.ibm.team.repository.db.jdbc.location=//localhost:50000/JAZZ:fullyMaterializeLobData=false;user=db2admin;password={password};
      #com.ibm.team.repository.db.jdbc.password=db2admin
    8. Repita los pasos d-g para cada base de datos que deba restaurar.
    9. Guarde los cambios.
  4. Actualice la aplicación Gestión de configuración utilizando el script vvc_upgrade.bat. Se actualizarán los archivos de configuración y los archivos de base de datos, y se volverán a compilar los índices de texto. Para obtener una descripción detallada de cómo actualizar la aplicación Gestión de configuración, consulte la guía de actualización disponible en: Guía de actualización interactiva de la gestión de configuración un ejemplo de los parámetros para Linux sería :
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • Si actualiza una topología de instalación distribuida (varias máquinas), deberá añadir el siguiente parámetro al script vvc_upgrade: -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    • Si utiliza WebSphere Application Server, deberá añadir un parámetro al script vvc_upgrade indicándole que no actualice Tomcat:-oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    Nota: La aplicación Gestión de configuración también se puede instalar con Rhapsody Design Manager. Cuando esté instalando Rational Engineering Lifecycle Manager también se le ofrecerá la opción de instalar la aplicación Gestión de configuración, que resulta útil si desea instalar la aplicación en una máquina distinta de Rhapsody Design Manager. Solo una de estas opciones debe integrarse con Jazz Team Server. Si elige instalar el componente en varias máquinas, cuando instale y actualice el componente, asegúrese de seleccionar el correcto.
  5. Actualice Rational Engineering Lifecycle Manager ejecutando relm_upgrade.sh
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    Esto realizará tres actualizaciones. En primer lugar, actualizará los archivos de configuración. En segundo lugar, los archivos de base de datos. En tercer lugar, recreará los índices de texto.
    Nota: Debe establecer el parámetro de la versión anterior en el script relm_params antes de ejecutar el script de actualización. Una descripción de este parámetro y otros parámetros disponibles pueden encontrarse en: Referencia de script relm_upgrade.
  6. La información de configuración de Lifecycle Query Engine y el componente SPARQL Gateway debe importarse a la nueva instalación. Debe copiar manualmente las versiones anteriores en el nuevo Jazz Team Server.
    rm -rf $newRELMHome/server/conf/lqe
    cp -R $oldRELMHome/server/conf/lqe $newRELMHome/server/conf/lqe
    rm -rf $newRELMHome/server/conf/SPARQL_Gateway
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway $newRELMHome/server/conf/SPARQL_Gateway
  7. Edite las propiedades de SPARQL Gateway para eliminar la propiedad DBLocation. En el siguiente archivo, elimine la línea de DBLocation: $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties
  8. Si utiliza Oracle, asegúrese de que el archivo ojdbc.jar de Oracle (controlador JDBC) esté disponible en el siguiente directorio: $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.propertiesnewRELMHome\JazzTeamServer\server\oracle
  9. Si utiliza WebSphere Application Server, despliegue los archivos relm.war, vvc.war, lqe.war y sparql_gateway.war. Reinicie WebSphere Application Server.
  10. Inicie Jazz Team Server.
  11. Abra la página de administración de LQE https://server:port/lqe/web/admin. Se mostrará un mensaje que indica que LQE está en modalidad de actualización y no está disponible. Pulse Iniciar actualización. Una vez que se completa esta operación estarán disponibles los orígenes de datos.
  12. Asegúrese de que exista un archivo credentials.txt con el siguiente contenido: adminUserId, adminPassword, repositoryURL, smartCard, certificateFile Si no existe ya, cree el archivo. Por ejemplo, el archivo de credenciales debe ser similar al siguiente:
    adminUserId=yourAdminUserId
    adminPassword=yourAdminPassword 
    repositoryURL=https://yourserver.com:9443/vvc 
    smartCard=<none>
    certificateFile=<none>
  13. Ejecute el siguiente mandato desde el directorio Configuration_Application_install_dir/server
    • Linux: ./repotools-vvc.sh -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt
    • Windows: repotools-vvc.bat -migration_vvc_updateResourcesCommand credentialsFile=credentials.txt

Qué hacer a continuación

Una vez actualizado todo el software necesario, Lifecycle Query Engine deberá volver a indexar su contenido. Se han añadido nuevos vocabularios a Lifecycle Query Engine en 4.0.3, y si desea que Rational Engineering Lifecycle Manager utilice los datos incluidos en estos vocabularios, deberá volver a indexar la aplicación.
Tabla 1. Visión general de los requisitos de reindexación por producto
Producto v1.x a v4.0.6 v4.0.3 a v4.0.6 v4.0.4 a v4.0.6 v4.0.5 a v4.0.6
Rational Team Concert Reindexar es obligatorio Reindexar no es obligatorio Reindexar no es obligatorio Reindexar no es obligatorio
Rational Quality Manager Reindexar es obligatorio Reindexar recomendado. Se ha añadido una nueva propiedad llamada oslc:shortld a todos los recursos de QM. Si desea utilizar esta propiedad en cualquier consulta, debe volver a indexar. Reindexar no es obligatorio Reindexar no es obligatorio
Rhapsody Design Management No requiere volver a indexar, pero es posible que se eliminen las entradas de índice duplicadas y se mejore el rendimiento. Vuelva a indexar si se van a utilizar nuevo datos en las consultas. Reindexar no es obligatorio Reindexar no es obligatorio Reindexar no es obligatorio
Rational DOORS Se recomienda encarecidamente volver a indexar para los datos de producción. Se recomienda volver a indexar si ha creado consultas frente al URI de mailto. Se recomienda volver a indexar para los datos de producción. Se recomienda volver a indexar si ha creado consultas frente al URI de mailto. No es necesario volver a indexar. No es necesario volver a indexar.
Rational DOORS Next Generation No aplicable No aplicable Reindexar no es obligatorio Reindexar no es obligatorio
Rational Engineering Lifecycle Manager Reindexar es obligatorio Reindexar es obligatorio Reindexar es obligatorio Reindexar es obligatorio
Jazz Team Server Users TRS (jts/trsUsers) Reindexar es obligatorio Reindexar no es obligatorio Reindexar no es obligatorio Reindexar no es obligatorio

Comentarios