En este tema se describen los pasos para redenominar un despliegue piloto o de producción completa.
Antes de empezar
Puesto que LQE no se puede migrar automáticamente, debe ser eliminado de
la lista de aplicaciones registradas de
Jazz Team Server y
Jazz Team Server
debe reiniciarse antes de iniciar el proceso de redenominación de servidor.
- Inicie sesión en la página Administración de Jazz Team Server.
Apunte al navegador web hacia https://hombre_host:puerto/jts/admin.
- Pulse sobre la pestaña Servidor.
- En el panel izquierdo, en la sección Configuración, pulse Aplicaciones registradas.
- Elimine
Lifecycle
Query Engine
como una aplicación registrada.
- Detenga el servidor de Lifecycle
Query Engine.
- Reinicie Jazz Team Server.
Nota: Después del renombrado, los servidores de origen deben estar permanentemente fuera de servicio para evitar la contaminación del entorno de producción.
Acerca de esta tarea
La función de redenominación del servidor utiliza un archivo de correlaciones para determinar los URL que se deben redenominar. Se proporciona un mandato repotools para generar un archivo de correlaciones inicial. El archivo de correlaciones contiene pares origen-destino para el Jazz Team Server y todas las aplicaciones, así como otros URL aportados por aplicaciones. Consulte Archivo de correlación para una redenominación de servidor si desea más detalles acerca del archivo de correlación.
Procedimiento
- Preparar y revise el archivo de correlaciones previamente a la redenominación real mientras los servidores están todavía en línea, siguiendo los pasos descritos en el tema Preparación del archivo de correlación.
El resultado final de la fase de preparación es un archivo de correlación que se genera en el Jazz Team Server de origen.
El archivo de correlaciones contiene pares origen-destino para el Jazz Team Server y todas las aplicaciones, así como otros URL aportados por aplicaciones.
- Realice una copia de seguridad del entorno de origen existente y copie los índices de texto y los archivos de configuración de aplicación en una nueva instalación de destino. Para sistemas distribuidos, vaya al servidor adecuado para copiar los archivos.
Nota: Si se está realizando un renombrado en la misma ubicación y no se está moviendo a hardware nuevo, se está copiando el entorno desde una instalación a una segunda instalación dentro del mismo sistema.
- Detenga Jazz Team Server y las aplicaciones distribuidas que se registran con Jazz Team Server.
Además, detenga cualquier otra aplicación que se vea afectada por la redenominación del servidor, o las integraciones afectadas y admitidas.
Nota: Mientras el servidor o los servidores estén inactivos, los usuarios no podrán
crear o atravesar enlaces desde sistemas externos que se integran con el despliegue
de
Rational Engineering Lifecycle
Manager
que está a punto de redenominarse.
- Realice una copia de las bases de datos del entorno de origen, incluida la base de datos de Jazz Team Server, las bases de datos para las aplicaciones y la base de datos del depósito de datos.
Si está cambiando el servidor o proveedor de bases de datos, consulte Traspaso de la base de datos para ver los pasos adicionales.
- Copie los índices JFS/text de la instalación de origen en la instalación de destino.
En los siguientes ejemplos de un servidor Linux se supone que las unidades de los sistemas de producción se montan en redes.
Si no es posible en su entorno, utilice otros métodos de transferencia de archivos para asegurarse de que se copien los archivos.
cp -R SourceJazzInstallDir/server/conf/jts/indices TargetJazzInstallDir/server/conf/jts
cp -R SourceJazzInstallDir/server/conf/relm/indices TargetJazzInstallDir/server/conf/relm
- Copie los archivos de configuración de la aplicación de la instalación de origen en la instalación de producción de destino. Al igual que en el paso anterior, los ejemplos siguientes son para un servidor
Linux y se supone que las unidades de los sistemas de producción se montan en redes.
cp SourceJazzInstallDir/server/conf/jts/teamserver*.properties TargetJazzInstallDir/server/conf/jts
cp SourceJazzInstallDir/server/conf/relm/teamserver*.properties TargetJazzInstallDir/server/conf/relm
cp SourceJazzInstallDir/server/conf/admin/admin.properties* TargetJazzInstallDir/server/conf/admin
cp SourceJazzInstallDir/server/conf/admin/friends.rdf* TargetJazzInstallDir/server/conf/admin
- Copie el archivo de correlaciones en el directorio TargetJazzInstallDir\server del servidor de producción de destino. Consulte Preparación del archivo de correlación para obtener detalles sobre el archivo de correlaciones.
- Realice la parte de la redenominación del servidor fuera de línea importando el archivo de correlaciones en el producto
Jazz Team Server de producción de destino, utilizando el mandato
repotools-jts -importURLMappings.
- Si tiene un despliegue todo en uno, importe el archivo de correlaciones utilizando el mandato repotools-jts -importURLMappings como se indica a continuación:
- repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt"
- ./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt"
La redenominación comenzará fuera de línea en Jazz Team Server, antes de que el servidor se reinicie.
- Si dispone de un despliegue distribuido y con permiso para correlacionar unidades de red, correlacione una unidad de red del host de
Jazz Team Server con cada uno de los hosts de aplicaciones. A continuación, cree un archivo (por ejemplo, serverConfFile.txt) que contenga una lista de directorios server/conf remotos en el despliegue con el formato siguiente:
# Remote CCM server
x:/JazzTeamServer/server/conf
# Remote QM server
y:/JazzTeamServer/server/conf
# Remote RM server
z:/JazzTeamServer/server/conf
Finalmente, continúe con el mandato repotools-jts -importURLMappings y añada el parámetro serverConfFile= tal como se muestra a continuación.
- repotools-jts.bat -importURLMappings
fromFile=".\mappings.txt" serverConfFile=".\serverConf.txt"
- ./repotools-jts.sh -importURLMappings
fromFile="./mappings.txt" serverConfFile="./serverConf.txt"
- Si tiene un despliegue distribuido y no están permitido correlacionar unidades de red, siga con el mandato repotools-jts -importURLMappings (sin el parámetro serverConfFile=).
A continuación, copie el archivo server/conf/jts/.mappingEvent en los directorios de configuración de la aplicación remota (server/conf/nombre_aplicación), es decir, ccm, qm y rm.
El archivo de eventos se genera cuando se importan las correlaciones. Debe copiar el archivo
.mappingEvent después de importar el archivo de correlación pero antes de iniciar el servidor.
El archivo .mappingEvent contiene información que necesitan las aplicaciones para ponerse en contacto con el producto
Jazz Team Server en su nueva ubicación. El contenido del archivo .mappingEvent es el mismo para un producto Jazz Team Server determinado y sus aplicaciones registradas.
Verifique que la redenominación haya resultado satisfactoria comprobando la salida de la consola y el archivo JazzInstallDir/server/repotools-jts_importURLMappings.log.
Si aparecen errores, o si detecta que se ha equivocado en el archivo de correlaciones, consulte
Resolución de problemas en la redenominación del servidor para localizar y corregir el problema.
- Inicie Jazz Team Server y las aplicaciones distribuidas que se haya instalado.
En este momento, las aplicaciones se sincronizarán con Jazz Team Server para aplicar las correlaciones de URL y actualizar sus datos de almacén de datos. Esto debería tomar alrededor de cinco minutos para un conjunto de datos pequeño y hasta treinta minutos o más para un conjunto de datos muy
grande.
- Inicie sesión en Jazz Team Server en https://host nuevo:puerto/jts/serverRenameStatus.
Esto inicia el propio proceso de redenominación. Cuando la redenominación se ha completado, podrá verificar la redenominación y realizar las acciones correctivas que se requieran. Durante el proceso de verificación, Jazz Team Server y todas las aplicaciones se pondrán en modalidad de sólo lectura, pero se podrán explorar los datos y buscar enlaces rotos y URL no correlacionados.
Consulte Verificación de los URL y enlaces tras un renombrado de servidor si desea detalles.
- Antes de completar el proceso de verificación, asegúrese de haber realizado las verificaciones adicionales específicas del producto que se describen en Finalización del proceso de verificación del renombrado de un servidor. Cuando tiene la certeza de que los datos renombrados son correctos, pulse la casilla de verificación He verificado el nombre del
servidor ... y pulse Finalizar.
Llegados a este punto, Jazz Team Server y todas las aplicaciones registradas saldrán del modo de solo lectura y podrá reanudarse el uso normal del producto.
- Solo producción completa: Si tiene una segunda Jazz Team Server o aplicaciones adicionales que están enlazadas con el nombre Jazz Team Server, debe ejecutar repotools-jts -importURLMappings en la segunda Jazz Team Server.
Este paso es necesario para actualizar los enlaces desde el segundo servidor al servidor renombrado.
Importante: No genere un nuevo archivo de correlaciones. Debe utilizar el mismo archivo de correlaciones que ha utilizado para el primer servidor redenominado.
- Copie el archivo de correlaciones editado del primer servidor en el segundo servidor.
Asegúrese de incluir las correlaciones correctivas que haya aplicado del proceso de verificación.
- Revise el archivo de correlaciones y, si es necesario, elimine los pares de origen/destino que no desea aplicar al segundo servidor.
- Realice la redenominación en el segundo servidor repitiendo del paso 3 al paso 6 en el segundo Jazz Team Server.
Qué hacer a continuación
Cuando se hayan realizado los pasos de esta tarea, siga estos pasos en
Finalización de la redenominación de servidor de Lifecycle Query Engine para volver a añadir LQE y volver a generar el índice.