Comenzando en la versión 4.0 de productos para la solución de Rational para Collaborative Lifecycle Management (CLM), los administradores pueden cambiar el URI público de un Jazz Team Server o una solución de Rational para la aplicación CLM después del despliegue, si utilizan la operación para renombrar el servidor. Dichos cambios necesitan sus correspondientes actualizaciones a la solución de Rational para los recursos de CLM basados en el URI. Para ClearQuest Bridge, estos enlaces de artefacto para la solución Rational para recursos de producto CLM (IBM Rational Team Concert, IBM Rational Quality Manager e IBM Rational DOORS Next Generation) se almacenan en los archivos de configuración de ClearQuest Web Server y en los registros OSCLinks en la base de datos de usuario de ClearQuest.
ClearQuest proporciona la herramienta clm_server_rename.pl para volver a correlacionar los enlaces estructurales de URI que están almacenados en los archivos de configuración de ClearQuest Web y en los registros OSLCLinks. Utilice la herramienta para volver a correlacionar el protocolo, el nombre de host, el número de puerto y el contexto de la aplicación de los enlaces estructurales.
Ejecutar la herramienta
Debe tener privilegios de administrador local y privilegios de superusuario de ClearQuest para ejecutar la herramienta clm_server_rename.pl.
La herramienta se encuentra en este directorio del archivo cqweb.war:
El programa cqperl.exe se encuentra en el directorio donde está instalado ClearQuest.
Antes de ejecutar la herramienta clm_server_rename.pl, es una buena idea establecer la variable de entorno TEMP a un directorio donde usted tenga acceso de escritura. En caso contrario, asegúrese de que tiene acceso de escritura en el directorio donde está ejecutando la herramienta.
Debe ejecutar la herramienta varias veces.
Por ejemplo, si ClearQuest se integra con IBM Rational Team Concert e IBM Rational Quality Manager, y se renombran Jazz Team Server for Rational Team Concert y el servidor Rational Quality Manager, debe ejecutar la herramienta con la opción -remapconfigfiles dos veces: una vez para volver a correlacionar los URI para los enlaces de artefacto de Rational Team Concert y la otra para volver a correlacionar los URI para los enlaces de artefacto de Rational Quality Manager.
Por ejemplo, si ClearQuest se integra con IBM Rational Team Concert e IBM Rational Quality Manager, y se renombran Jazz Team Server for Rational Team Concert y el servidor Rational Quality Manager, debe ejecutar la herramienta con la opción -update dos veces: una vez para volver a correlacionar los URI para los enlaces de artefacto de Rational Team Concert y la otra para volver a correlacionar los URI para los enlaces de artefacto de Rational Quality Manager.
Consulte Volver a correlacionar los URI después de renombrar un servidor CLM para finalizar los detalles del procedimiento.
Consulte la sección Opciones y argumentos para obtener una descripción de las opciones de línea de mandatos.
La herramienta clm_server_rename.pl vuelve a correlacionar los enlaces estructurales que están almacenados en los archivos de configuración del servidor web ClearQuest y en los registros OSLCLinks. La herramienta no vuelve a correlacionar los enlaces incluidos almacenados en los registros de ClearQuest. Estos enlaces de ancla pueden incluirse en adjuntos a un registro o en campos como, por ejemplo, descripciones o notas. Según el esquema, estos campos pueden convertirse en sólo lectura después del envío o después de añadir una nota. Esto significa que los enlaces de ancla incluidos se dividirán después de ejecutar la herramienta. Puede escribir código para arreglar estos enlaces, según sea necesario.
Un ejemplo de un enlace con ancla incluida que permanece dividida después de ejecutar la herramienta implica a la solución de Rational para la integración CLM entre Rational ClearQuest y Rational Quality Manager. Cuando un artefacto de Rational Quality Manager se enlaza a un registro de ClearQuest, Rational Quality Manager inserta un enlace URI al artefacto del campo de descripción del registro.
Vuelve a correlacionar los enlaces del artefacto público URI de Jazz Team Server para la solución de Rational para las aplicaciones CLM. En concreto, esta opción vuelve a correlacionar los URI que están almacenados en los archivos de configuración del servidor web de ClearQuest. La herramienta realiza una copia de los archivos de configuración antes de correlacionar los URI.
Una vez ha ejecutado la herramienta con esta opción, debe reiniciar el servidor web de ClearQuest. A continuación, se vuelve a configurar la comunicación entre servidores en el servidor web y los usuarios pueden crear nuevos enlaces URI a la solución de Rational para los artefactos de CLM. Sin embargo, si sigue los enlaces existentes a la solución de Rational para los artefactos de CLM, no funcionará hasta que ejecute de nuevo la herramienta con la opción -update.
Cuando la herramienta se ejecuta con esta opción, captura los cambios de los registros OSLCLinks en el archivo de registro. Si se establece la variable de entorno TEMP, el archivo de registro se graba en el directorio especificado; de lo contrario, el archivo de registro se graba en el directorio donde lo está ejecutado, siempre que usted tenga acceso de escritura. En el archivo de registro se utiliza la siguiente convención de nombres de archivos:
donde:
Por ejemplo, clm_server_rename_20120405_211711.
C:\was_profiles\MyCQWebServer\installedApps\Node02Cell\TeamEAR.ear\cqweb.war\WEB-INF\classes>cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix https://clm7.mycompany.com/ccm/ -newprefix https://clm7.mycompany.com/jazz/ -remapconfigfiles
Iniciado: Volver a correlacionar los URI en el archivo de configuración friendsconfig.rdf.
Completado: Volver a correlacionar los URI en el archivo de configuración friendsconfig.rdf.
Iniciado: Volver a correlacionar los URI en el archivo de configuración project-area-links.rdf.
Completado: Volver a correlacionar los URI en el archivo de configuración project-area-links.rdf.
Iniciado: Volver a correlacionar los URI en el archivo de configuración oauth-consumers.rdf.
Completado: Volver a correlacionar los URI en el archivo de configuración oauth-consumers.rdf.
cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix https://servername.com:9443/jazz/ -newprefix https://servername.com:9443/ccm/ -preview 5
cqperl clm_server_rename.pl -username admin -password secret -dbset 8.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://servername.com:9443/jazz/
cqperl clm_server_rename.pl -username admin -password secret -dbset 7.0.0 -dbname SAMPL -oldprefix http://servername.com:9443/jazz/ -newprefix https://newservername.com:9443/jazz/