Actualización de Rational Engineering Lifecycle Manager que se ejecuta con Apache Tomcat

Para actualizar Rational Engineering Lifecycle Manager, instale la nueva versión del producto, actualice los archivos de configuración, añada o actualice las tablas de los repositorios de base de datos existentes y migre los datos existentes a la versión 5.0.1.

Antes de empezar

Procedimiento

  1. Instale Rational Engineering Lifecycle Manager.
    Este paso instala:
    • Rational Engineering Lifecycle Manager 5.0.1
    • Jazz Team Server 5.0.1
    • Aplicación Gestión de configuración 5.0.1
    Importante:
    • Seleccione un grupo de paquetes y un directorio que no sean los de la instalación original.
    • Seleccione la misma raíz de contexto que en la instalación anterior.

      Si actualiza desde Rational Engineering Lifecycle Manager versión 5.0 o versiones anteriores, la raíz de contexto existente de Jazz Reporting Service o de SPARQL es SPARQL_Gateway y el nombre del archivo de aplicación es SPARQL_Gateway.war. Cuando instale Rational Engineering Lifecycle Manager 5.0.1, seleccione la opción de raíz de contexto personalizada y especifique SPARQL_Gateway en el campo Valores de raíz de contexto de aplicación.

  2. Detenga el servidor Tomcat antiguo.
  3. Migre o realice una copia de seguridad de 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 de copia de seguridad de base de datos para DB2 que se puede utilizar como directriz.
    1. Asegúrese de que su Jazz Team Server antiguo se haya detenido.
    2. En DB2, localice las bases de datos que se utilizan en la instalación anterior de aplicaciones de Jazz Team Server.
    3. Realice una copia de seguridad de cada base de datos utilizada por una aplicación de Jazz Team Server.
    4. Guarde los cambios.
    Para obtener más información acerca de la copia de seguridad y restauración de la base de datos, lea la documentación de la solución Rational for Collaborative Lifecycle Management.
    SQL Server

    A continuación, se muestra un proceso de ejemplo de copia de seguridad de base de datos para SQL Server que se puede utilizar como directriz.

    • Asegúrese de que tiene el nombre de usuario y contraseña correctos.
    • Asegúrese de que ha realizado una copia de seguridad de la base de datos antes de iniciar el proceso de actualización.
    • Confirme que está instalado el controlador JDBC (Java Database Connectivity) y que está utilizando sqljdbc4.jar. En la versión 5.0.1 ya no se da soporte a JRE versión 5.0. Solo se da soporte a JRE 6.0 y 7.0.
    • Asegúrese de que se haya iniciado el servicio SQL.
    Para obtener instrucciones completas, consulte la documentación proporcionada por el proveedor de la base de datos.
    Oracle Asegúrese de que el controlador JDBC de Oracle, ojdbc.jar, esté disponible en el directorio $newRELMHome/JazzTeamServer/server/oracle.
  4. Actualice la aplicación Gestión de configuración.
    Ejecute el script vvc_upgrade para actualizar los archivos de configuración y de base de datos y para volver a compilar los índices de texto. Este es un ejemplo de parámetro:
    cd $newRELMHome/server/
    upgrade/vvc/vvc_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
    • Si actualiza una topología de instalación distribuida (de varios servidores), utilice el parámetro siguiente con el script vvc_upgrade:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck
    Consejo: La aplicación Gestión de configuración también se puede instalar con Rhapsody Design Manager. Cuando instala Rational Engineering Lifecycle Manager, tiene la opción de instalar la aplicación Gestión de configuración; esta opción resulta útil si desea instalar la aplicación en un servidor que no sea Rhapsody Design Manager. Integre únicamente una aplicación Gestión de configuración con Rational Engineering Lifecycle Manager. Si opta por instalar el componente en varios servidores, asegúrese de que selecciona el componente correcto para la instalación y actualización.
  5. Actualice Rational Engineering Lifecycle Manager.
    Ejecute el mandato relm_upgrade.sh para actualizar los archivos de configuración y de base de datos y para crear los índices de texto.
    $newRELMHome/server/upgrade/relm/relm_upgrade.sh -oldApplicationHome oldRELMHome/server/conf
  6. Transfiera la información de Lifecycle Query Engine y de Jazz Reporting Service o SPARQL Gateway existente a la nueva versión del producto.
    Copie el contenido del directorio SPARQL_Gateway en la instalación antigua al directorio SPARQL_Gateway nuevo.
    cp -R $oldRELMHome/server/conf/SPARQL_Gateway/* $newRELMHome/server/conf/SPARQL_Gateway
    Si actualiza de la versión 5.0 a la 5.0.1, vaya al Paso 7.
    Si actualiza de la versión 4.x a la 5.0.1, utilice un editor de texto para añadir las propiedades siguientes en $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties.
    • support.query.editing=false
    • support.db.derby=false
    • support.dwse=false
    • query.results.limit=3000
    • query.results.cache.timeout=300
    • user.account.cache.timeout=480
    Elimine app.properties de SPARQL_Gateway
    rm $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    Renombre SPARQL_Gateway.properties a app.properties.
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway.properties $newRELMHome/server/conf/SPARQL_Gateway/app.properties
    Renombre SPARQL_Gateway_runtime.properties a app_runtime.properties. (De forma predeterminada, SPARQL_Gateway_runtime.properties no existe, pero puede crear el archivo si necesita configurar el valor de tiempo de espera de conexión.)
    mv $newRELMHome/server/conf/SPARQL_Gateway/SPARQL_Gateway_runtime.properties $newRELMHome/server/conf/SPARQL_Gateway/app_runtime.properties
  7. Inicie el servidor Apache Tomcat.
  8. Si actualiza desde la versión 4.x, actualice Lifecycle Query Engine.

    Abra la página de administración de Lifecycle Query Engine, https://nombre_host_relm:puerto/lqe/web/admin. Un mensaje indica que la actualización de Lifecycle Query Engine está en curso y que la aplicación no está disponible. Pulse Iniciar actualización. Cuando se completa el proceso de actualización, los orígenes de datos están disponibles.

  9. Actualice la aplicación Gestión de configuración.
    1. Asegúrese de que exista un archivo credentials.txt con el siguiente contenido: adminUserId, adminPassword, repositoryURL, smartCard, certificateFile.

      Si el archivo no existe, cree el archivo. Un ejemplo de archivo de credenciales es:

      adminUserId=yourAdminUserId
      adminPassword=yourAdminPassword 
      repositoryURL=https://yourserver.com:9443/vvc 
      smartCard=<none>
      certificateFile=<none>
    2. Ejecute el mandato repotools-vvc desde el directorio dir_instalación_aplicación_configuración/server.
      • Linux./repotools-vvc.sh -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<versión_anterior> logPort=52000 logLevel=DEBUG
      • Windowsrepotools-vvc.bat -vvc_online_migrationCommand credentialsFile=credentials.txt fromVersion=<versión_anterior> logPort=52000 logLevel=DEBUG
    3. Reinicie Jazz Team Server.
    El mandato repotools de la aplicación Gestión de configuración envía una solicitud para ejecutar la aplicación Gestión de configuración y espera una respuesta. Si el mandato repotools-vvc se detiene inmediatamente con un error de autorización, verifique que el servidor se está ejecutando y que el ID de usuario y la contraseña del archivo de credenciales sean correctos.
  10. Reinicie el servidor Tomcat.
  11. Reinicie el servidor de Rational Engineering Lifecycle Manager para actualizar automáticamente los datos migrados al formato necesario en la nueva versión de la aplicación. Este proceso se denomina actualización en línea. Inicie sesión si desea ver la página de estado de la actualización.

Resultados

Cuando la actualización en línea es satisfactoria, el navegador web se renueva y abre la página de bienvenida de Rational Engineering Lifecycle Manager. Si falla un paso de actualización, examine el archivo relm.log para determinar la causa del error. Si tiene un número elevado de productos definidos en Rational Engineering Lifecycle Manager, la actualización en línea tarda mucho en completarse (hasta varias horas).

Qué hacer a continuación


Comentarios