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. Para obtener ejemplos adicionales, consulte Topologías y archivos de correlaciones para configurar un entorno de transferencia de prueba y Topologías y archivos de correlaciones para el escenario de piloto a producción.
El archivo de correlaciones contiene pares de URL origen-destino para Jazz Team Server, sus aplicaciones CLM 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 CLM que se registra en un producto Jazz Team Server distinto pero que es amigo de este producto Jazz Team Server representa un URL afectado. Una integración externa como, por ejemplo, Rational ClearQuest también representa un URL afectado.
# JTS
source=https://clmhost.example.org:9443/jts
target=https://clmhost2.example.org:9443/jts
#Additional Urls included in rename by clmhost.example.org:9443/jts
# ADMIN
source=https://clmhost.example.org:9443/admin
target=https://clmhost2.example.org:9443/admin
#(CLM Help URL)
source=https://clmhost.example.org:9443/clmhelp
target=https://clmhost2.example.org:9443/clmhelp
# CCM
source=https://clmhost.example.org:9443/ccm
target=https://clmhost2.example.org:9443/ccm
# RM
source=https://clmhost.example.org:9443/rm
target=https://clmhost2.example.org:9443/rm
# ADDITIONAL URLs included in rename by RM
source=https://clmhost.example.org:9443/converter/htmlgen
target=https://clmhost2.example.org:9443/converter/htmlgen
# QM
source=https://clmhost.example.org:9443/qm
target=https://clmhost2.example.org:9443/qm
#The following list of URLs represent external servers that integrate with this Jazz Team Server or with applications registered to it.
# https://friend1.example.org:9443/jts/rootservices (Friend Entry)
# 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 de todas sus aplicaciones registradas. También puede ver los pares de URL que aportan las aplicaciones como, por ejemplo, el par de URL de ayuda de CLM que aporta Jazz Team Server y el par de URL de convertidor que aporta la aplicación RM.
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://clmhost.example.org:9443/jts
#target=https://clmhost2.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. Debería dejar comentados estos URL puesto que están pensados solamente con fines de consulta. También tendrá que comprobar que los URL formen parte de un escenario soportado. Compruebe la documentación de redenominación del servidor para la topología con el fin de verificarlo.
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.
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 CLM 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
No se permite utilizar el mismo destino más de una vez. Si dispone de varias entradas amigas, utilice dummyhost2, dummyhost3, etcétera. 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.
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/
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 clmhost.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:
source=https://clmhost.example.org:9443
target=https://newhost.example.org:9443
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, supongamos que existe un CCM que se está ejecutando en https://clmhost.example.org/ccm. En este caso, CCM se habrá desplegado en un servidor utilizando el puerto predeterminado (configurando el puerto para el servidor de aplicaciones o utilizando un servidor http del proxy inverso que se ejecuta en el puerto predeterminado). En CLM, 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://clmhost.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 clmhost.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://clmhost.example.org/ccm
target=https://newhost.example.org/ccm
source=https://clmhost.example.org:443/ccm
target=https://newhost.example.org:443/ccm
Las aplicaciones CLM tratan los URL como sensibles a mayúsculas y minúsculas. El URL https://clmhost:443/jts es distinto de https://CLMHOST:443/jts. Asegúrese de mantener las mayúsculas y minúsculas en los URL de origen o no se correlacionarán.
Si lo desea, cambie las mayúsculas y minúsculas en los URL de destino. Por ejemplo, se permite la correlación siguiente:
source=https://CLMHOST:443/jts
target=https://clmhost:443/jts
Si está utilizando un archivo de correlaciones simplificado, asegúrese de que todos los URL estén escritos igual. Si dispone de los siguientes URL de origen:
https://clmhost:443/jts
https://CLMHOST:443/ccm
y utiliza una correlación simplificada:
source=https://clmhost:443
target=https://clmhost:9443
Solamente se correlacionará el primer URL. El segundo URL no se correlacionará. Para arreglarlo, añada otra correlación para:
source=https://CLMHOST:443
target=https://CLMHOST:9443
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.
La redenominación del servidor se permite en z/OS y el proceso es el mismo en z/OS que en otros sistemas operativos salvo que no se utiliza el mandato de herramientas de repositorio -generateURLMappings. En su lugar, personalice el miembro JCL de muestra BLZGENMP en hlq.SBLZSAMP, donde hlq es el calificador de alto nivel especificado durante la instalación de SMP/E. Consulte la cabecera de comentarios en BLZGENMP si desea instrucciones detalladas acerca de la personalización.