clm_server_rename.pl

Esta herramienta actualiza los enlaces del artefacto público URI de Jazz Team Server para la solución de Rational para Collaborative Lifecycle Management (CLM). En concreto, la herramienta actualiza los URI que están almacenados en los archivos de configuración del servidor de IBM Rational ClearQuest Web. La herramienta también actualiza los URI almacenados en los registros OSLCLink en la base de datos de usuario de ClearQuest.

Sinopsis

cqperl clm_server_rename.pl -username nombre_usuario -password contraseña [ -dbset conjunto_db ] -dbname nombre_conjuntobd –oldprefix prefijo_anterior –newprefix prefijo_nuevo [ -remapconfigfiles | -preview número | -update ] [ -help ] [ -man ]

Descripción

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.

Estos son varios tipos de enlaces para artefactos de la solución de Rational para CLM:
  • Enlaces estructurales describen las relaciones entre recursos o artefactos y son necesarios para mantener la rastreabilidad y la integración de datos.
  • Enlaces incluidos son URI que pueden incluirse en un campo o nodo de texto de un recurso. Los enlaces incluidos pueden ser enlaces con ancla o enlaces de texto sin formato.
    • Enlaces con ancla se muestran al usuario como un hipervínculo navegable. Por ejemplo, en un widget de texto enriquecido, estos enlaces se declaran como tales y normalmente se almacenan en una estructura como <a href=...>.
    • Enlaces de texto sin formato son URI que se escriben en un widget de texto pero no se representan como hiperenlaces navegables.

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:

WAS_profile_home\installedApps\nodecell\TeamEAR.ear\cqweb.war\WEB-INF\classes

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.

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.

Limitaciones

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.

Opciones y argumentos

-username nombre_usuario
Inicie sesión con el nombre de un usuario administrador con privilegios de superusuario.
-password contraseña
Contraseña de un usuario administrador con privilegios de superusuario.
-dbset conjunto_db
Nombre de la conexión de la base de datos.
-dbname nombre_db
Nombre de la base de datos de usuario.
–oldprefix prefijo_anterior
Especifica una serie URI existente. El formato URI debe empezar por http e incluir el contexto de aplicación seguido por una barra inclinada (/).
–newprefix prefijo_nuevo
Especifica una nueva serie URI para sustituir a la serie URI existente especificada por la opción –oldprefix. El formato URI debe empezar por http e incluir el contexto de aplicación seguido por una barra inclinada (/).
-remapconfigfiles
Importante: Al utilizar esta opción, debe ejecutar la herramienta en el directorio donde está instalada la herramienta.

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.

-preview número
Muestra una vista previa de los cambios que se realizarán en el número de registros OSLCLinks en la base de datos de ClearQuest que contiene la serie URI prefijo_anterior. También informa del número total de registros OSLCLinks que contienen la serie URI prefijo_anterior. No se realiza ningún cambio en la base de datos del usuario cuando se utiliza esta opción.
-update
Actualiza los enlaces del artefacto público URI de Jazz Team Server para la solución de Rational para los artefactos de CLM. En concreto, esta opción actualiza los URI que están almacenados en los registros OSLCLink de ClearQuest.

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:

clm_server_rename_aaaammdd_hhmmss.txt

donde:

aaaammdd
Fecha en la que se ejecuta la herramienta, especificada en año, mes y día
hhmmss
Hora en la que se ejecuta la herramienta, especificada en hora, minutos y segundos

Por ejemplo, clm_server_rename_20120405_211711.

Ejemplos

  • Para el servidor denominado MyCQWebServer, vuelva a correlacionar los enlaces de artefacto URI de Jazz Team Server en los archivos de configuración del servidor web de ClearQuest que coinciden con la serie URI especificada a continuación.

    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.

  • Previsualice los cinco registros OSLCLinks de la base de datos de ClearQuest que coinciden con la serie URI especificada a continuación y qué aspecto tendrían los registros si el contexto de la aplicación se cambia de jazz a ccm.

    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

  • Cambie el protocolo del URI en los registros OSLCLinks de ClearQuest que coincidan con la serie URI especificada a continuación, de http a https.

    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/

  • Cambie el nombre del servidor del URI en los registros OSLCLinks de ClearQuest que coincidan con la serie URI especificada a continuación, de servername a newservername.

    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/

Consulte también

Volver a correlacionar los URI después de renombrar un servidor CLM, Cambiar el URI público utilizando la operación para renombrar el servidor


Comentarios