syncreplica

Exporta o importa paquetes de actualización

Aplicabilidad

Producto Tipo de mandato
MultiSite Submandato multiutil
Plataforma
UNIX®
Windows®

Sinopsis

  • Exporte un paquete de actualización:
    sync/replica

    –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 ...

  • Importe un paquete de actualización:
    sync/replica

    –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 ]

Descripción

La sincronización de una réplica con una o más réplicas iguales es un proceso de tres fases:

  1. En un sitio determinado, un mandato syncreplica –export crea un paquete de actualización que contiene cambios que se han producido en la réplica en ese sitio (y tal vez también en otras réplicas).
  2. El paquete se envía a uno o varios sitios más.
  3. En otro sitio, un mandato syncreplica –import aplica los cambios de paquetes de actualizaciones a su réplica de la misma base de datos. Este paso tiene lugar en todos los sitios que reciben el paquete.

Contenido de un paquete de actualización:

  • Todos los cambios que se han producido en la réplica actual desde la última actualización generada para las réplicas de destino. (Los cambios ya enviados a las réplicas de destino se excluyen del paquete).
  • Los cambios que se han producido en otras réplicas, que la réplica actual ha recibido en paquetes de actualización anteriores de esas réplicas pero que no ha pasado a las réplicas de destino.

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.

Notas sobre la fase de exportación

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.

Notas sobre la fase de importació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.

Salto de paquetes

syncreplica –import no procesa un paquete de actualización en las situaciones siguientes:

  • El paquete de actualización contiene cambios que dependen de otros cambios que no se hayan importado todavía a esta réplica. Generalmente esto quiere decir que un paquete de actualización destinado para esta réplica no se ha enviado o se ha perdido durante el transporte.
  • Se han encontrado problemas al procesar un paquete físico anterior en un paquete lógico de varias partes.

En estos casos, syncreplica –import muestra un mensaje de explicación.

Anomalías de actualización y reproducción de paquetes

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.

Supresión de paquetes de actualización

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.

Activación de enganches

Los enganches de Rational ClearQuest no se activan en respuesta a los cambios efectuados durante la importación de paquetes.

Gestión de conflictos de denominación

syncreplica resuelve los conflictos de denominación entre los objetos creados en réplicas distintas.

Retardos en las actualizaciones

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.

Manejo de errores para anomalías de entrega de paquetes

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.

Restricciones

Debe tener privilegios de superusuario.

Opciones y argumentos: Fase de exportación

Especificación del clan, sitio y familia

Valor predeterminado
Clan: Primer clan replicado en este sitio. Si hay más de una conexión dbset registrada en este host, se necesita, –clan.

Sitio: Sitio actual. Si hay más de un sitio en este host, se necesita –site.

Familia: Sin valor predeterminado; debe especificar una familia.

–cl/an nombre-clan
Nombre del clan de la réplica.
–site nombre-sitio
Nombre del sitio de la réplica.
–fam/ily nombre-familia
Familia de base de datos de usuario: Nombre de base de datos que se da a la base de datos de usuario cuando se crea.

Familia de depósitos de esquemas: El nombre de familia es MASTR.

Especificación de un nombre de usuario y contraseña

Valor predeterminado
Debe especificar un nombre de usuario y contraseña.
–u/ser usuario
Nombre de un usuario con privilegios de superusuario.
–p/assword contraseña
Contraseña asociada al usuario especificado.

Especificación del tamaño de los paquetes de actualizaciones

Valor predeterminado
Cuando no se especifica –maxsize, el método de envío que utilice determina el tamaño del paquete predeterminado de la siguiente manera:
  • Los paquetes creados con –ship o –fship no son mayores que el tamaño máximo de paquete especificado en el archivo shipping.conf (UNIX) o en el Panel de control de MultiSite (Windows).
  • Los paquetes creados con –out no tienen más de 2 GB.
–max/size tamaño-paquete-máx [ –lim/it núm-paquetes ]
El tamaño máximo para un paquete físico, expresado como un número seguido de una sola letra. Por ejemplo:
500 k
500 kilobytes
20 m
20 megabytes
1,5 g
1,5 gigabytes

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.

Configuración de paquetes de actualizaciones

Valor predeterminado
Ninguno. Debe especificar cómo van a almacenarse y transmitirse a otro sitios los paquetes creados por syncreplica –export. Si utiliza –ship o –fship y omite la opción –sclass, syncreplica coloca el paquete en la ubicación de la había de almacenamiento especificada para la clase cq_default en el archivo shipping.conf (UNIX y Linux) o en el Panel de control de MultiSite (Windows).
–shi/p –fsh/ip
Almacena el paquete de actualización en uno o más archivos en una bahía de almacenamiento de almacenar y reenviar; syncreplica crea una orden de envío distinta para cada paquete físico, que indica cómo y dónde debe entregarse. Los destinos son los servidores de sincronización asociados en la base de datos de réplica con los argumentos nombre-réplica. (Las asociaciones del servidor de sincronización se crean con mkreplica –export y se pueden cambiar con chreplica.)

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.

–wor/kdir directorio
Directorio de trabajo temporal para que syncreplica lo utilice. Este directorio no debe existir ya y se suprimirá después de que finalice el proceso de exportación syncreplica.
–sc/lass nombre-clase
Especifica la clase de almacenamiento del paquete y la orden de envío. syncreplica busca la clase de almacenamiento en el archivo shipping.conf en Linux y el sistema UNIX o en el Panel de control de MultiSite en Windows para determinar la ubicación de la bahía de almacenamiento que utilizar.
–out nombrev-archivo-paquete
Nombre del primer paquete de actualización. Los paquetes físicos adicionales, si hay alguno, se colocan en los archivos denominados nombrev-archivo-paquete_2, nombrev-archivo-paquete_3, y así sucesivamente.

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.

nombrev-área-intercambio
Directorio en que se almacenan los archivos de paquete.

Manejo de anomalías de entrega de paquetes

Valor predeterminado
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.
–pex/pire fecha-hora
Especifica la hora a la que el recurso de almacenar y reenviar deja de intentar entregar el paquete y genera en su lugar un mensaje de correo de anomalía. Esta opción altera temporalmente el periodo de caducidad para la clase de almacenamiento en el archivo shipping.conf (sistemas UNIX o Linux) o en el Panel de control de MultiSite (Windows).

El argumento fecha-hora puede tener cualquiera de los formatos siguientes:

fecha.hora | fecha | hora
donde:
fecha:
= día-de-semana | fecha-larga
hora:
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
día-de-semana:
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
fecha-larga:
= d[d]mes[[aa]aa]
mes:
= January |... |December |Jan |... |Dec

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.)

Ejemplos
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC
–not/ify dirección-correo-e
El mensaje de anomalía de entrega se envía a la dirección de correo electrónico especificada.

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.

Especificación de las réplicas de destino

Valor predeterminado
Ninguna.
réplica ...
Nombre de sitio de la réplica de destino. Puede especificar una o más réplicas de destino. Por ejemplo, boston_hub indica que boston_hub recibirá el paquete de actualización, mientras que boston_hub bangalore indica que tanto boston_hub como bangalore recibirán el paquete de actualización.

Opciones y argumentos: Fase de importación

Especificación del clan, sitio y familia

Valor predeterminado
Clan: Primer clan replicado en este sitio. Si hay más de una conexión dbset registrada en este host, se necesita, –clan.

Sitio: Sitio actual. Si hay más de un sitio en este host, se necesita –site.

Familia: Sin valor predeterminado; debe especificar una familia.

–cl/an nombre-clan
Nombre del clan de la réplica.
–site nombre-sitio
Nombre del sitio de la réplica.
–fam/ily nombre-familia
Familia de base de datos de usuario: Nombre de base de datos que se da a la base de datos de usuario cuando se crea.

Familia de depósitos de esquemas: El nombre de familia es MASTR.

Especificación de un nombre de usuario y contraseña

Valor predeterminado
Debe especificar un nombre de usuario y contraseña.
–u/ser usuario
Nombre de un usuario con privilegios de superusuario.
–p/assword contraseña
Contraseña asociada al usuario especificado.

Especificación de la ubicación de los paquetes de actualización

Valor predeterminado
Ninguna.
–rec/eive [ –sc/lass clase-almacenamiento ]
Esta opción sólo es útil si ejecuta syncreplica en el servidor de sincronización.

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.

nombrev-archivo-paquete | nombrev-área-intercambio ...
Procesa cada nombrev-archivo-paquete como un paquete de actualización. Para cada nombrev-área-intercambio especificada, localiza todos los paquetes de actualización no procesados anteriormente en el directorio y los aplica a las réplicas adecuadas.

Ejemplos

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.

Exportaciones

  • En la réplica boston_hub, genere un paquete de actualización para la réplica sanfran_hub. Almacene el paquete en c:\cqms\sanfran_hub_sync.xml.

    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

  • Coloque el archivo de paquete en una bahía de almacenamiento para enviarlo más tarde.

    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.

  • Similar al ejemplo anterior, pero envía el paquete inmediatamente.

    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.

Importaciones

  • Importe todos los paquetes de actualización entrantes en la clase de almacenamiento cq_storage.

    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

  • Procese el paquete de actualización sanfran_hub_sync.xml en la réplica sanfran_hub.

    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

  • Intente procesar el paquete de actualización sanfran_hub_sync.xml en la réplica sanfran_hub antes de que la réplica sanfran_hub se haya actualizado a la versión de esquema más reciente.

    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.

  • Procese todos los paquetes de actualización en la bahía de almacenamiento entrante.

    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


Comentarios