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
- Si actualiza productos que se integran con Rational Engineering
Lifecycle Manager,
siga la secuencia de Lista de comprobación para actualizar la pila productos Rational Engineering Lifecycle Manager.
- Si actualiza desde la versión 4.x, debe obtener nuevas licencias para las aplicaciones de la versión 5.x. Las aplicaciones de la versión 5.x no funcionan con las licencias de la versión 4.x. Sin embargo, las aplicaciones de la versión 4.x funcionan con las licencias de la versión 5.x. Para obtener más información sobre las licencias, vaya a
Gestión
de licencias.
- Si actualiza desde la versión 4.x, elimine Lifecycle
Query Engine.
- Abra la página de administración de Lifecycle
Query Engine: https://nombre_host_lqe:puerto/lqe/web.
- Pulse . Seleccione el origen de datos de
Rational Engineering
Lifecycle Manager.
- En el panel Orígenes de datos, pulse
Eliminar y guarde.
Procedimiento
- 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.
- Configure el servidor de aplicaciones.
- Asegúrese de que su servidor antiguo se esté ejecutando.
- Haga una copia de seguridad del perfil de WebSphere Application Server.
- Abra un indicador de mandatos y vaya al directorio bin del directorio de instalación de WebSphere Application Server.
- 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.
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>
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.
- Desinstale las aplicaciones existentes de WebSphere Application Server.
- Inicie el servidor.
- Inicie sesión en WebSphere Application Server Integrated Solutions Console en https:/nombre_host:9043/ibm/console/logon.jsp.
- Pulse .
- Detenga y desinstale las siguientes aplicaciones: relm.war,
relmhelp.war, vvc.war, lqe.war, SPARQL_Gateway.war.
- Guarde los cambios en la configuración principal cuando se le solicite.
- Actualice las propiedades personalizadas JAZZ_HOME y log4j.configuration.
- Inicie sesión en WebSphere Application Server Integrated Solutions Console en https:/nombre_host:9043/ibm/console/logon.jsp.
- Pulse .
- Pulse el nombre del servidor para abrirlo. El nombre del servidor predeterminado es server1.
- En la sección Infraestructura del servidor, pulse .
- Bajo Propiedades adicionales, pulse Máquina virtual Java.
- Cambie la vía de acceso para
Lifecycle
Query Engine
y Jazz
Reporting Service
por la nueva ubicación.
- 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
- En Propiedades adicionales, pulse Propiedades personalizadas.
- 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.
- 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.
- Si se conecta a una base de datos Oracle, asegúrese de que ORACLE_JDBC_DRIVER_FILE apunte al archivo del controlador JDBC correcto.
- Guarde los cambios en la configuración principal cuando se le solicite.
- Establezca la biblioteca compartida de
Jazz
Reporting Service.
- En la consola administrativa, vaya a
.
- En la lista, pulse Biblioteca compartida JRS.
- 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
- En Carga de clases, asegúrese de que esté seleccionado Utilizar un cargador de clases aislado para la biblioteca compartida.
Pulse Aplicar y Guardar.
- Detenga WebSphere Application
Server.
Ejecute el mandato stopServer.sh.
Ejecute el mandato stopServer.bat.
- 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.

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)

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)
- 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:
opt/IBM/WebSphere/AppServer/profiles/AppSrv01/logs
C:\IBM\WebSphere\AppServer\profiles\AppSrv01\logs
- Inicie WebSphere Application Server.
Ejecute el mandato startServer.sh.
Ejecute el mandato startServer.bat.
- Migre o realice una copia de seguridad de la base de datos.
Asegúrese de que el controlador JDBC
de Oracle, ojdbc.jar, esté disponible en el directorio $newRELMHome/JazzTeamServer/server/oracle.
- 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
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.
- 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
- 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
- Despliegue los archivos relm.war, relmhelp.war, vvc.war, lqe.war y SPARQL_Gateway.war.
- En la consola administrativa de WebSphere
Application Server, seleccione
.
- En la página Aplicaciones empresariales, pulse
Instalar.
- En Vía de acceso a la aplicación nueva, seleccione
$newRELMHome/server/webapps/relm.war y pulse
Abrir.
- Seleccione Vía de acceso rápida y, a continuación,
Siguiente.
- 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.
- Un mensaje indica que relm.war se ha instalado
satisfactoriamente. Pulse Guardar directamente en la configuración maestra.
- 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.
- 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.
- Configure
el servidor de aplicaciones de WebSphere
para
Lifecycle
Query Engine y despliegue el archivo lqe.war.
- 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.
- Añada la referencia de biblioteca de Jazz
Reporting Service.
- Vaya a y pulse SPARQL_Gateway_war en la lista
de aplicaciones.
- En la sección Referencia, pulse Referencias de
bibliotecas compartidas.
- Seleccione el recuadro de selección situado junto a SPARQL_Gateway_war
y pulse Hacer referencia a bibliotecas compartidas.
- Seleccione Biblioteca compartida JRS y pulse la flecha
derecha.
- Pulse Aceptar. A continuación, pulse de nuevo
Aceptar para guardar los valores en la configuración maestra.
- Asegúrese de que el orden de carga de clases de
Jazz
Reporting Service
esté configurado correctamente.
- Vaya a y pulse SPARQL_Gateway_war en la lista
de aplicaciones.
- En la sección Propiedades detalladas, pulse
Carga de clases y detección de actualizaciones.
- En la sección Orden de cargadores de clases, seleccione
Clases cargadas con cargador de clases local primero (padre
último).
- Pulse Aceptar y Guardar en configuración
maestra.
- Reinicie WebSphere Application Server.
- 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.
- Actualice la aplicación Gestión de configuración.
- 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>
- Ejecute el mandato repotools-vvc desde el directorio
dir_instalación_aplicación_configuración/server.
./repotools-vvc.sh -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<versión_anterior>
logPort=52000 logLevel=DEBUG
repotools-vvc.bat -vvc_online_migrationCommand
credentialsFile=credentials.txt fromVersion=<versión_anterior>
logPort=52000 logLevel=DEBUG
- 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.
- Reinicie el servidor de aplicaciones.
Ejecute los mandatos stopServer.sh y startServer.sh.
Ejecute los mandatos stopServer.bat y
startServer.bat.
- 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).