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áximo
    [–lim/it núm-paquetes ] ]
    {     { –sh/ip| –fsh/ip }
    –wor/kdir directorio [ –sc/lass clase-almacenamiento ]
    [–pex/pire fecha ]
    [–not/ify correo electrónico ]
    | –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 los cambios que se han producido en la réplica en dicho sitio (y quizá 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 en el paquete de actualización a su réplica en 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 utilizarlo en todas las ubicaciones especificadas; el paquete puede ser utilizado para actualizar sólo esas replicas en particular.

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 los archivos temporales en directorio especificado 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 siguientes situaciones:

  • 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 visualiza un mensaje de explicación.

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

En algunos casos, syncreplica –import comienza a aplicar operaciones a 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 todo el paquete de actualización de nuevo.

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 única invocación de syncreplica –import aplica un paquete satisfactoriamente a todas las réplicas de destino asociadas con el servidor de sincronización, el paquete de actualización se suprimirá cuando el mandato termine su labor. Si el paquete se procesa con varios mandatos syncreplica –import, no se suprime.

Activación de ganchos

Los ganchos 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 sistema principal 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 sistema principal, se necesita –clan.

Sitio: Sitio actual. Si hay más de un sitio en este sistema principal, –site es necesario.

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 del paquete de actualización

Valor predeterminado
Cuando no especifica –maxsize, el método de envío que utilice determina el tamaño predeterminado de las siguientes maneras:
  • 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 son mayores de 2 GB.
–max/size tamaño-paquete-máximo [ –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 ya no es mayor que el tamaño-paquete-máximo. Utilice esta opción cuando está limitado el espacio de disco para la bahía de almacenamiento o área de transferencia.

Configuración del paquete de actualización

Valor predeterminado
Ninguno. Debe especificar cómo van a almacenarse los paquetes de actualización creados por syncreplica –export y transmitirse a otros sitios. 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 de servidor de sincronización se crean con mkreplica –export y pueden cambiarse 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 sistema principal 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-elec
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 sistema principal 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
Ninguno.
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 sistema principal, se necesita –clan.

Sitio: Sitio actual. Si hay más de un sitio en este sistema principal, –site es necesario.

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
Ninguno.
–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 sistema principal actual. Cualquier paquete de actualización no procesado pensado para las réplicas asociadas a este sistema principal se aplica a las réplicas correspondientes en el sistema principal. 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 sistema principal actual es un sistema principal 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