Archivo de correlación para una redenominación de servidor

En este tema se describe la estructura del archivo de correlación generado por el mandato generateURLMappings y proporciona instrucciones sobre cómo editar el archivo de correlaciones para el despliegue.

Cuando esté preparado para generar un archivo de correlaciones, siga las instrucciones de Preparación del archivo de correlación.

El archivo de correlaciones contiene pares de URL origen-destino para Jazz Team Server, sus aplicaciones registradas y otros URL aportados por las aplicaciones. Los URL se dividen en dos tipos:

Los pares de URL que forman parte de la redenominación no incluyen toda la información en el dominio de Jazz Team Server. Entre ellos el URL público de Jazz Team Server, los URL públicos de aplicaciones y otros URL aportados por aplicaciones.

Los URL afectados incluyen otros sistemas que interactúan con esta topología pero no se hallan en el dominio de este Jazz Team Server. Una aplicación de Rational Engineering Lifecycle Manager que está registrada en un Jazz Team Server diferente pero que es amiga de este Jazz Team Server, representa un URL afectado. Una integración externa como, por ejemplo, Rational ClearQuest también representa un URL afectado.

Descripción de un archivo de correlaciones de ejemplo

# JTS
source=https://relmhost.example.org:9443/jts
target=https://relmhost2.example.org:9443/jts
#Additional Urls included in rename by relmhost.example.org:9443/jts
# ADMIN
source=https://relmhost.example.org:9443/admin
target=https://relmhost2.example.org:9443/admin
#(relm Help URL)
source=https://relmhost.example.org:9443/relmhelp
target=https://relmhost2.example.org:9443/relmhelp
# RELM
source=https://relmhost.example.org:9443/relm
target=https://relmhost2.example.org:9443/relm
# Jazz Reporting Service
source=https://relmhost.example.org:9443/sparql
target=https://relmhost2.example.org:9443/sparql

#The following list of URLs represent external servers that integrate
with this
Jazz Team Server
or with applications registered to it.

#Do not uncomment these lines as they are for reference purposes only.
# Friend Entry
#source=https://friend1.example.org:9443/jts/rootservices 
#target=https://friend1.example.org:9443/jts/rootservices 
#source=https://cqconnector.example.org:9084/cqconnector/gateway
#target=https://cqconnector.example.org:9084/cqconnector/gateway

El archivo de correlaciones generado es una plantilla que se debe editar antes de ejecutar importURLMappings. Es importante comprender toda la información del archivo de correlaciones para asegurarse de que todos los sistemas de la topología se redenominan correctamente. En la sección superior del archivo se incluyen los pares de URL que forman parte de la redenominación. En este ejemplo, puede ver los pares de URL del URL público de Jazz Team Server y todas sus aplicaciones registradas. También puede ver parejas de URL que son contribución de las aplicaciones.

Busque en cada uno de estos URL y determine cuáles cambian. Actualice los destinos para los URL de origen que se redenominarán con sus valores nuevos. Si un URL de origen determinado no se redenomina, comente el par utilizando el signo ' #'.

# JTS
#source=https://relmhost.example.org:9443/jts
#target=https://relmhost2.example.org:9443/jts

La sección inferior del archivo de correlaciones contiene una lista de los URL afectados que se han comentado. Estos URL no forman parte de esta redenominación pero se pueden ver afectados por los URL que se han modificado. A menos que necesite ocultar los URL de producción, debe dejar estos URL comentados puesto que están pensados solamente para fines de consulta.

Si está en un entorno de transferencia, siempre debería enmascarar los URL afectados para asegurarse de que no haya enlaces cruzados entre los servidores de transferencia y de producción. Consulte los detalles a continuación.

Correlaciones ficticias para proteger los datos de producción

Si necesita ocultar un URL afectado, debe eliminar el comentario del par de origen/destino y proporcionar un destino ficticio.

Cuando se configura un entorno de transferencia, es necesario que se creen correlaciones ficticias para los URL afectados en el archivo de correlaciones. Los URL afectados pueden incluir otras aplicaciones relm que son amigas de este despliegue o de los servidores externos. Para entradas amigas, cree una correlación ficticia para el URL público del amigo.

Por ejemplo, si su URL de entrada amiga es https://friendhost.example.org:9443/jts/rootservices, el URL público suele ser https://friendhost.example.org:9443/jts. Añada un par de URL en la parte final del archivo de correlaciones para desenmascarar este URL definiendo el destino en un nombre de host falso. Verifique que el nombre de host de destino ficticio sea inalcanzable antes de seleccionarlo.

# Friend
source=https://friendhost.example.org:9443/jts
target=https://dummyfriendhost.example.org:9443/jts

Para los URL afectados que no son entradas amigas, añada el par de URL siguiente en la parte final del archivo de correlaciones:

source=https://externalserver.example.org:9555/
target=https://dummyhost.example.org:9555/

No se permite utilizar el mismo destino más de una vez. Si tiene varias entradas amigas, utilice dummyhost2, dummyhost3, etc. Si tiene un despliegue de un servidor único donde Jazz Team Server y todas las aplicaciones residen en el mismo host y puerto, puede utilizar una correlación simplificada, tal como se describe a continuación.

Utilización de un archivo de correlaciones simplificado

Si tiene una topología simple, donde el protocolo, el host, el dominio y el puerto son comunes para todos los URL, el archivo de correlaciones puede verse reducido para que contenga solo una entrada origen-destino. Por ejemplo, si dispone de un despliegue todo en uno en relmhost.example.org y desea redenominarlo todo para utilizar newhost.example.org, puede editar el archivo de correlaciones generado para que sólo incluya los URL siguientes:

Nota: La correlación simplificada de relmhost.example.org a newhost.example.org solamente redenomina el producto Jazz Team Server y las aplicaciones Jazz. No redenomine las integraciones Rational o de terceros. Siempre debe ejecutar generateURLMappings para determinar si se da soporte al escenario y garantizar que todo en la topología se correlaciona correctamente.
source=https://relmhost.example.org:9443
target=https://newhost.example.org:9443
Importante: No utilice un archivo de correlación simplificado si desea distribuir el despliegue posteriormente.

URL con puertos predeterminados

Si alguno de los URL de origen utiliza el puerto predeterminado y el número de puerto predeterminado no se ha incluido de forma explícita, serán necesarios dos conjuntos de correlaciones: uno con el puerto predeterminado y otro sin el puerto predeterminado. El mandato generateURLMappings genera automáticamente las correlaciones adicionales. Los puertos predeterminados son 443 para https y 80 para http.

Por ejemplo,Rational Engineering Lifecycle Manager se ejecuta en https://relmhost.example.org/relm. En este caso, Rational Engineering Lifecycle Manager se ha desplegado en un servidor que utiliza el puerto predeterminado (configurando el puerto para el servidor de aplicaciones o utilizando un servidor http del proxy inverso en el puerto predeterminado). En Rational Engineering Lifecycle Manager, también se pueden haber almacenado los enlaces para los URL en recursos donde el puerto se incluye explícitamente en el URL, por ejemplo:

https://relmhost.example.org:443/resource/...

Debido a la posibilidad de que esos URL se puedan almacenar de ambas formas, se necesitará una correlación para cada uno de ellos. Por ejemplo, supongamos que relmhost.example.org se redenomina por newhost.example.org. En este caso, serán necesarias las correlaciones siguientes para realizar una redenominación. Los pares se generan automáticamente mediante generateURLMappings.

source=https://relmhost.example.org/relm:9443
target=https://newhost.example.org/relm

source=https://relmhost.example.org:443/relm
target=https://newhost.example.org:443/relm

Sensibilidad a las mayúsculas y minúsculas

Se recomienda indicar los URL en letras minúsculas. Los URL son sensibles a mayúsculas y minúsculas.

Errores durante la generación de los archivos de correlaciones

Debido a la cantidad de procesos implicados, es posible que se produzcan errores. Algunos errores se indican claramente como, por ejemplo, si intenta generar el archivo de correlaciones antes de iniciar el servidor, o si utiliza credenciales de inicio de sesión erróneas. Otros errores son menos obvios. Para obtener detalles acerca de los errores de redenominación del servidor, consulte Resolución de problemas en la redenominación del servidor.

Verificación de un archivo de correlaciones

Tras generar y editar el archivo de correlaciones, asegúrese de ejecutar el mandato repotools-jts -verifyURLMappings para comprobar si hay correlaciones que faltan o realizar otras verificaciones adicionales. En algunos casos, puede ignorar las correlaciones que faltan si no necesita correlacionar ese URL. Para obtener detalles adicionales, consulte Mandato de herramientas del repositorio para verificar un archivo de correlación.


Comentarios