Actualización de Rational Engineering Lifecycle Manager que se ejecuta con WebSphere Application Server

Para actualizar Rational Engineering Lifecycle Manager, instale la nueva versión de producto, actualice los archivos de configuración, añada o actualice las tablas en los repositorios de base de datos existentes y migre los datos 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. Configure el servidor de aplicaciones.
    1. Asegúrese de que su servidor antiguo se esté ejecutando.
    2. Haga una copia de seguridad del perfil de WebSphere Application Server.
      1. Abra un indicador de mandatos y vaya al directorio bin del directorio de instalación de WebSphere Application Server.
      2. Ejecute este mandato. Si la seguridad de WebSphere Application Server está activada, especifique el nombre de usuario y la contraseña.
        Consejo: La vía de acceso del directorio al archivo comprimido debe existir antes de que inicie el proceso de copia de seguridad.
        • Linux
          backupConfig.sh <Vía_acceso_archivo_comprimido_nuevo_para_crear_copia_seguridad_de_perfil> -username <nombre_usuario_administrativo_primario_WAS> -password <contraseña_administrativa_WAS>
          Por ejemplo:
          backupConfig.sh /root/WAS_backup/relm_50_profile.zip -username <admin_WAS> -password <contraseña_admin_WAS>
        • Windows
          backupConfig.bat <Vía_acceso_archivo_comprimido_nuevo_para_crear_copia_seguridad_de_perfil> -username <nombre_usuario_administrativo_primario_WAS> -password <contraseña_administrativa_WAS>
          Por ejemplo:
          backupConfig.bat C:\WAS_backup\relm_50_profile.zip -username <admin_WAS> -password <contraseña_admin_WAS>
      El mandato concluye el servidor antes de iniciar el proceso de copia de seguridad.
    3. Desinstale las aplicaciones existentes de WebSphere Application Server.
      1. Inicie el servidor.
      2. Inicie sesión en WebSphere Application Server Integrated Solutions Console en https:/nombre_host:9043/ibm/console/logon.jsp.
      3. Pulse Aplicaciones > Tipos de aplicación > Aplicaciones empresariales WebSphere.
      4. Detenga y desinstale las siguientes aplicaciones: relm.war, relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
      5. Guarde los cambios en la configuración principal cuando se le solicite.
    4. 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 del servidor predeterminado es server1.
      4. En la sección Infraestructura del servidor, pulse Java y gestión de procesos > Definición de procesos.
      5. Bajo Propiedades adicionales, pulse Máquina virtual Java.
      6. Cambie la vía de acceso para Lifecycle Query Engine y Jazz Reporting Service por 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://unidad:/dir_instalación_lqe/server/conf/lqe

      8. En Propiedades adicionales, pulse Propiedades personalizadas.
      9. Pulse JAZZ_HOME y actualice su valor a archivo:///<dir_instalación_nueva_versión>/server/conf.

        Por ejemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/server/conf.

      10. Pulse log4j.configuration y actualice su valor a archivo:///<dir_instalación_nueva_versión>/server/conf/startup_log4j.properties.

        Por ejemplo, file:///C:/PROGRA~2/IBM/JazzTeamServer_5.0.1/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.
    5. Establezca la biblioteca compartida de Jazz Reporting Service.
      1. En la consola administrativa, vaya a Entorno > Bibliotecas compartidas.
      2. En la lista, pulse Biblioteca compartida JRS.
      3. Cambie la vía de acceso de clases desde la ubicación de instalación de Jazz Reporting Service a la ubicación nueva.

        Por ejemplo: dir_instalación_5.0.1/server/conf/SPARQL_Gateway/SharedLibrary

      4. En Carga de clases, asegúrese de que esté seleccionado Utilizar un cargador de clases aislado para la biblioteca compartida. Pulse Aplicar y Guardar.
    6. Detenga WebSphere Application Server.
      • Linux Ejecute el mandato stopServer.sh.
      • Windows Ejecute el mandato stopServer.bat.
    7. Limpie los directorios temp de WebSphere Application Server.

      Elimine el contenido relacionado de Rational Engineering Lifecycle Manager en los directorios wscache y temp del perfil. En función de las aplicaciones instaladas, es posible que estos directorios estén en el perfil y se pueden eliminar: relm_war, lqe_war, sparql y lo datos relacionados con la aplicación Gestión de configuración.

      • Linux
        raíz_perfil_WAS/wscache (por ejemplo: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp/wscache)
        raíz_perfil_WAS/temp (por ejemplo: opt/IBM/WebSphere/AppServer/profiles/AppSrv01/temp)
      • Windows
        raíz_perfil_WAS\wscache (por ejemplo: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\wscache)
        raíz_perfil_WAS\temp (por ejemplo: C:\IBM\WebSphere\AppServer\profiles\AppSrv01\temp)
    8. Limpie el directorio de registro de WebSphere Application Server.
      Vaya a cada servidor de aplicaciones y elimine los registros relacionados de Rational Engineering Lifecycle Manager del directorio de registros en el perfil. Un directorio de registros típico es:
      • Linux opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
      • Windows C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
    9. Inicie WebSphere Application Server.
      • Linux Ejecute el mandato startServer.sh.
      • Windows Ejecute el mandato startServer.bat.
  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
    • Para omitir la actualización de Tomcat, añada el parámetro siguiente al script vvc_upgrade:
      -oldApplicationHome oldRELMHome/server/conf -ignoreJTSVersionCheck -updateTomcatFiles=no
    Consejo: La aplicación Gestión de configuración también se puede instalar con Rhapsody Design Manager. Cuando esté instalando Rational Engineering Lifecycle Manager, seleccione la aplicación Gestión de configuración si desea instalar el componente en una máquina diferente a su sistema 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. Despliegue los archivos relm.war, relmhelp.war, vvc.war, lqe.war y SPARQL_Gateway.war.
    1. En la consola administrativa de WebSphere Application Server, seleccione Aplicaciones > Tipos de aplicación > Aplicaciones empresariales de WebSphere.
    2. En la página Aplicaciones empresariales, pulse Instalar.
    3. En Vía de acceso a la aplicación nueva, seleccione $newRELMHome/server/webapps/relm.war y pulse Abrir.
    4. Seleccione Vía de acceso rápida y, a continuación, Siguiente.
    5. Acepte los valores predeterminados y pulse Siguiente en el asistente de configuración. En la página Correlacionar raíces de contexto para módulos web, especifique la raíz de contexto /relm. A continuación, pulse Finalizar.
    6. Un mensaje indica que relm.war se ha instalado satisfactoriamente. Pulse Guardar directamente en la configuración maestra.
    7. Instale la documentación de Rational Engineering Lifecycle Manager, relmhelp.war. Utilice los pasos a-f anteriores. Utilice $newRELMHome/server/webapps/relmhelp.war para la vía de acceso y /relmhelp como raíz de contexto.
    8. Instale la aplicación Gestión de configuración, vvc.war. Utilice los pasos a-f anteriores. Utilice $newRELMHome/server/webapps/vvc.war para la vía de acceso y /vvc como raíz de contexto.
    9. Configure el servidor de aplicaciones de WebSphere para Lifecycle Query Engine y despliegue el archivo lqe.war.
    10. Instale la aplicación Jazz Reporting Service, SPARQL_Gateway.war. Utilice los pasos a-f anteriores. Utilice $newRELMHome/server/webapps/SPARQL_Gateway.war como vía de acceso. Utilice SPARQL_Gateway como raíz de contexto.
    11. Añada la referencia de biblioteca de Jazz Reporting Service.
      1. Vaya a Aplicaciones > Tipos de aplicaciones > Aplicaciones empresariales de WebSphere y pulse SPARQL_Gateway_war en la lista de aplicaciones.
      2. En la sección Referencia, pulse Referencias de bibliotecas compartidas.
      3. Seleccione el recuadro de selección situado junto a SPARQL_Gateway_war y pulse Hacer referencia a bibliotecas compartidas.
      4. Seleccione Biblioteca compartida JRS y pulse la flecha derecha.
      5. Pulse Aceptar. A continuación, pulse de nuevo Aceptar para guardar los valores en la configuración maestra.
    12. Asegúrese de que el orden de carga de clases de Jazz Reporting Service esté configurado correctamente.
      1. Vaya a Aplicaciones > Tipos de aplicaciones > Aplicaciones empresariales de WebSphere y pulse SPARQL_Gateway_war en la lista de aplicaciones.
      2. En la sección Propiedades detalladas, pulse Carga de clases y detección de actualizaciones.
      3. En la sección Orden de cargadores de clases, seleccione Clases cargadas con cargador de clases local primero (padre último).
      4. Pulse Aceptar y Guardar en configuración maestra.
    13. Reinicie WebSphere Application Server.
  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 de aplicaciones.
    • Linux Ejecute los mandatos stopServer.sh y startServer.sh.
    • Windows Ejecute los mandatos stopServer.bat y startServer.bat.
  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