Exporta o importa paquetes de actualización
–exp/ort
[ –cl/an nombre-clan ] [ –site nombre-sitio ] –fam/ily nombre-familia
–u/ser nombre-usuario [–p/assword ] contraseña [–max/size tamaño-paquete-máx
[–lim/it núm-paquetes ] ]
{ { –sh/ip| –fsh/ip }
–wor/kdir directorio [ –sc/lass clase-almacenamiento ]
[–pex/pire fecha ]
[–not/ify correo-e ]
| –out { nombrev-archivo-paquete | nombrev-área-transf } }
réplica ...
–imp/ort
[ –cl/an nombre-clan ] [ –site nombre-sitio ] –fam/ily nombre-familia
–u/ser nombre-usuario [ –p/assword ] contraseña
{ –rec/eive[ –sc/lass clase-almacenamiento ]
| { nombrev-archivo-paquete | nombrev-área-transf } ... }
[ -plug/epoch ]
–cancel [ –force] [ –active ] –host nombre-sist-princ –job ID-trabajo ]
La sincronización de una réplica con una o más réplicas iguales es un proceso de tres fases:
Contenido de un paquete de actualización:
En todos los casos, syncreplica –export crea un único paquete de actualización lógico para su uso en todos los destinos especificados; el paquete puede utilizarse para actualizar únicamente esas réplicas concretas.
MultiSite está diseñado para llevar a cabo una actualización eficaz de las réplicas. syncreplica –export intenta excluir operaciones que se han enviado anteriormente. (Sin embargo, no hay nada malo en enviar una operación varias veces a la misma réplica; la primera operación se importa y las operaciones idénticas posteriores se pasan por alto.)
syncreplica –export almacena archivos temporales en el directorio que especifique con la opción –workdir. Este directorio no debe existir ya y se suprimirá después de que se cree el paquete de exportación.
Se aplica un paquete de actualización a las réplicas adecuadas asociadas al servidor de sincronización que ha recibido el paquete. No es preciso que especifique réplicas o ubicaciones de almacenamiento concretas.
El proceso de importación aplica paquetes de actualización en el orden correcto. Por consiguiente, puede especificar paquetes en cualquier orden en la línea de mandatos.
La réplica de base de datos no se bloquea para las operaciones de base de datos normales durante la fase de importación, pero que se bloquea para todas las demás operaciones de MultiSite.
syncreplica –import no procesa un paquete de actualización en las situaciones siguientes:
En estos casos, syncreplica –import muestra un mensaje de explicación.
En algunos casos, syncreplica –importt empieza a aplicar operaciones en una réplica, pero falla con un mensaje de error. Por ejemplo, otro proceso puede haber bloqueado la base de datos, causando una anomalía en la importación. Después de desbloquear la base de datos, puede ejecutar syncreplica –import para procesar de nuevo todo el paquete de actualización.
No hay problema en importar paquetes de actualización que ya se hayan procesado satisfactoriamente; no se realizará el mismo cambio dos veces.
Si una sola invocación de syncreplica import aplica un paquete satisfactoriamente a todas las réplicas de destino asociadas al servidor de sincronización, el paquete de actualización se suprimirá cuando el mandato complete su labor. Si el paquete se procesa con varios mandatos syncreplica –import, no se suprime.
Los enganches de Rational ClearQuest no se activan en respuesta a los cambios efectuados durante la importación de paquetes.
syncreplica resuelve los conflictos de denominación entre los objetos creados en réplicas distintas.
syncreplica no informa a los usuarios de Rational ClearQuest sobre actualizaciones de las réplicas. Todos los usuarios activos ven las actualizaciones al cabo de unos segundos, mediante las rutinas normales de sondeo de base de datos de Rational ClearQuest.
Si no puede entregarse un paquete, éste se envía mediante el recurso de almacenar y reenviar al servidor de sincronización para la réplica de origen. Se envía un mensaje al administrador del recurso de almacenar y reenviar. Esto se produce después de que hayan fallado intentos repetidos de entregar el paquete y el tiempo asignado se haya agotado; también puede producirse cuando se desconozca el host de destino o un archivo de datos no exista. Los valores de configuración del recurso de almacenar y reenviar especifican el periodo de caducidad, la dirección de correo electrónico del administrador y el programa de notificación.
Sitio: Sitio actual. Si hay más de un sitio en este host, se necesita –site.
Familia: Sin valor predeterminado; debe especificar una familia.
Familia de depósitos de esquemas: El nombre de familia es MASTR.
La opción –limit limita el número de paquetes que syncreplica genera; cada paquete no es mayor que el valor de tamaño-paquete-máx. Utilice esta opción cuando está limitado el espacio de disco para la bahía de almacenamiento o área de transferencia.
El uso de –fship (forzar envío) invoca el servidor de envíos para enviar el paquete de actualización inmediatamente. El uso de –ship no invoca este servidor.
Los paquetes de actualización no se entregan automáticamente; utilice un método adecuado para entregarlos. Puede crear un paquete utilizando –out y entregarlo utilizando el recurso de almacenar y reenviar.
El argumento fecha-hora puede tener cualquiera de los formatos siguientes:
Especifique la hora en formato de 24 horas, relativa al huso horario local. Si omite la hora, el valor predeterminado es 00:00:00. Si omite la fecha, el valor predeterminado es today (hoy). Si omite el siglo, el año o una fecha específica, se utiliza la más reciente. Especifique UTC si desea que la hora se resuelva en el mismo momento independientemente del huso horario. Utilice el operador más (+) o menos (-) para especificar un desplazamiento positivo o negativo respecto a la hora UTC. Si especifica UTC sin desplazamientos de hora o minuto, el valor predeterminado es GMT (hora del meridiano de Greenwich). (Las fechas anteriores al 1 de enero de 1970 UTC (Hora Universal Coordinada) no son válidas.)
Si se produce una anomalía en un host Windows que no tiene habilitada la notificación por correo electrónico, aparecerá un mensaje en el Visor de sucesos de Windows. El mensaje incluye el valor dirección-correo-e especificado con esta opción y una nota que solicita que se informe a este usuario del estado de la operación.
Sitio: Sitio actual. Si hay más de un sitio en este host, se necesita –site.
Familia: Sin valor predeterminado; debe especificar una familia.
Familia de depósitos de esquemas: El nombre de familia es MASTR.
Explora las bahías de almacenamiento del host actual. Cualquier paquete de actualización no procesado pensado para las réplicas asociadas a este host se aplica a las réplicas correspondientes en el host. Con –sclass, syncreplica sólo explora las bahías de almacenamiento de la clase de almacenamiento especificada.
Si syncreplica encuentra paquetes de creación de réplicas, envía correo al administrador de almacenar y reenviar. (Si el host actual es un host Windows y la notificación de correo electrónico no está habilitada, se visualizará un mensaje en el Visor de sucesos de Windows.) Utilice mkreplica para importar estos paquetes de creación de réplicas.
En estos ejemplos, las líneas se quiebran para una mayor facilidad de lectura. Debe entrar cada mandato en una sola línea física.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family SAMPL -user susan -p passwd -out c:\cqms\sanfran_hub_sync.xml
sanfran_hub
Multiutil: Packet file `c:\cqms\sanfran_hub_sync.xml' generated
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -maxsize 500mb -workdir c:\work
-ship -sclass cq_default sanfran_hub
Multiutil: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-55-16.xml' generated
multiutil: Shipping order
"C:\temp\cqms\ms_ship\outgoing\sh_o_sync_BOSTON_HUB_26-March-02_
10-55-16.xml" generated.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -password p -maxsize 500mb -workdir
c:\work -fship -sclass cq_default sanfran_hub
Multiutil: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-56-43.xml' generated
multiutil: Shipping order "C:\cqms\ms_ship\outgoing\sh_o_sync_
BOSTON_HUB_26-March-02_10-56-43.xml" generated.
multiutil: Attempting to forward/deliver generated packets...
multiutil: -- Forwarded/delivered packet
C:\cqms\ms_ship\outgoing\sync_BOSTON_HUB_26-March-02_10-
---- NOTE: consult the NT event log for errors.
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV
-user jcole -p passwd -receive -sclass cq_storage
Multiutil: 4 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet C:\temp\cqms\ms_ship\incoming\sync_
boston_hub_22-January-02_11-10-34.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xm
Multiutil: 1 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet c:\cqms\sanfran_hub_sync.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xml
Multiutil: The UPDATE_PACKET packet sent from boston_hub at
2002-01-22 15:15:50 is destined for schema revision 2, not 1;
re-execute syncreplica after site admin has upgraded database.
Multiutil: 2 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: Preserving packet c:\cqms\sanfran_hub_sync.xml.
multiutil syncreplica -import -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -receive
Multiutil: 1 transactions from SANFRAN_HUB have been replayed
into the MASTR database
Multiutil: 2 transactions from SANFRAN_HUB have been replayed
into the DEV database
Multiutil: Deleting packet C:\temp\cqms\ms_ship\incoming\sync_
SANFRAN_HUB_07-February-02_11-24-49.xml