Este tema describe cómo preparar el archivo de correlaciones que
utilizará más adelante en la redenominación real de Jazz Team Server.
Puede preparar y revisar el archivo de correlación antes de la redenominación real mientras los servidores siguen estando en línea.
Antes de empezar
Importante: Para habilitar la redenominación del servidor debe obtener un archivo de claves de características de IBM® Software Support. Al ponerse en contacto con el personal de soporte de IBM, mencione que está solicitando un "archivo de claves de funciones de redenominación de servidor".
Acerca de esta tarea
Hay varios pasos que debe realizar antes de redenominar el servidor. En gran parte, esto implica preparar y revisar el archivo de correlación que se utilizará para realizar la operación de redenominación.
En el archivo de correlaciones se muestran los URL de origen existentes y los URL de destino redenominados en su despliegue. Estos incluyen los URL de Jazz Team Server,
las aplicaciones Jazz y cualquier otra aplicación que no se vea afectada.
Puede realizar estos pasos en un despliegue de todo en uno, donde Jazz Team Server y las aplicaciones
Jazz están todos instalados en el mismo sistema, o en un despliegue distribuido, donde las aplicaciones Jazz se han instalado en varios sistemas. Estos pasos preparatorios se pueden utilizar con varios escenarios, por ejemplo cuando un sistema se mueve a una nueva ubicación física, cuando se configura un recinto de seguridad de pruebas en un sistema nuevo o el caso de una consolidación del centro de datos que implica un entorno redenominado de sistemas nuevos.
- Tras actualizar Jazz Team Server (JTS)
y todas las aplicaciones Jazz, inicie
Jazz Team Server y verifique que las aplicaciones se hayan registrado correctamente con el 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.
- Compruebe que todas las aplicaciones se hayan registrado.
Si no es así, regístrelas.
- Si ha registrado alguna aplicación en el paso anterior, reinicie Jazz Team Server.
- Abra un indicador de mandatos en el sistema donde se ha instalado Jazz Team Server y vaya al directorio
JazzInstallDir\server.
Nota: Asegúrese de realizar este paso y los pasos siguientes en el producto Jazz Team Server original, incluso si va a pasar a un hardware nuevo.
- Utilice el mandato repotools-jts -generateURLMappings para generar un archivo de correlaciones inicial para utilizarlo como plantilla para posteriores ediciones, tal como se muestra a continuación. Si ya ha ejecutado el mandato, o si ya existe el archivo, añada el parámetro overwrite=true.
- Windows: repotools-jts.bat
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
- Linux: ./repotools-jts.sh
-generateURLMappings toFile=mappings.txt adminUserId=<adminId>
adminPassword=<adminPassword> additionalURLFile=additionalurl.txt
La salida de este mandato es un archivo de correlaciones que lista el URL
público de origen existente y un URL de destino predeterminado para
Jazz Team Server
y cada aplicación Jazz (Rational Engineering Lifecycle
Manager, Lifecycle
Query Engine, Jazz
Reporting Service)
que se registre con Jazz Team Server.
También identifica los URL de origen y de destino para el archivo WAR de ayuda y los sistemas externos que se ven afectados.
Además, se crea un segundo archivo que contiene una lista de todos los URL que puede que sea necesario correlacionar o que hagan referencia a integraciones de terceros que puede que deba tener en cuenta. Puede añadir estos URL en el archivo de correlaciones. Para despliegues simples, es habitual que este archivo no contenga URL adicionales. Si incluye el parámetro additionalURLFile=additionalurl.txt,
puede especificar un nombre distinto para este archivo. Para obtener más detalles acerca de este parámetro, consulte Mandato de herramientas del repositorio para generar el archivo de correlaciones de redenominación de servidor.
Compruebe que no haya errores en el archivo de registro en JazzInstallDir/server/repotools-jts_generateURLMappings.log.
- Revise y edite cuidadosamente el archivo de correlación generado. Busque errores tipográficos en el nombre de host, puerto o contextos de raíz.
Algunos de estos errores topográficos no los detectan las herramientas de redenominación del servidor y pueden llevarle a un producto que no funcione. Familiarícese con la estructura del archivo de correlación consultando Archivo de correlación para una redenominación de servidor.
- Verifique que exista un par origen-destino para cada aplicación que se va a redenominar y para el archivo WAR de ayuda.
- Edite target= urls para las entradas que desee redenominar sean los destinos correctos.
Nota: Si está redenominando un número de puerto de JTS o cualquier aplicación, tendrá que actualizar la información del puerto en la servidor de aplicaciones
después de la redenominación, pero
antes de reiniciar los servidores. Si está redenominando una raíz de contexto de JTS o cualquier aplicación, consulte
Cambio de la raíz de contexto.
- Si utiliza '#', se comenta el par origen-> destino de todos los URL que no desee redenominar.
- Revise la lista de los URL afectados. Aunque el mandato busca todos los URL conocidos en el despliegue, es posible que falte alguno. Si es necesario correlacionar alguno de estos URL afectados, elimine el comentario del par de origen/destino para los URL afectados y proporcione el nuevo URL de destino. Si tiene dudas sobre el entorno, hable con un administrador antes de continuar con la redenominación.
- Revise el archivo additionalurls.
Para obtener detalles, consulte Mandato de herramientas del repositorio para generar el archivo de correlaciones de redenominación de servidor.
Nota: Si se realizan cambios de configuración en el despliegue de CLM antes de continuar con la redenominación real, incluidas las aplicaciones adicionales, tendrá que volver a generar el archivo de correlación.
- Utilice el mandato repotools-jts
-verifyURLMappings para verificar el archivo de correlación.
- repotools-jts.bat -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
- ./repotools-jts.sh -verifyURLMappings
mappingFile=mappings.txt repositoryURL=<serverURL> adminUserId=<adminId>
adminPassword=<adminPassword>
Para obtener más información sobre los tipos de verificaciones que realiza este mandato, consulte Mandato de herramientas del repositorio para verificar un archivo de correlación.
- Si el escenario implica hardware nuevo, instale
Rational Engineering Lifecycle
Manager
en los sistemas nuevos. NO ejecute el asistente de configuración de Jazz ni inicie Jazz Team Server.
Qué hacer a continuación
Continúe con la redenominación del servidor. Para obtener detalles, consulte
Traspaso de un despliegue piloto o de producción completa utilizando la redenominación de servidor.