–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 ] [–c/omments comentarios ]
[–size tamaño-bloque-ID ] [ –thres/hold umbral-bloque-ID ]
{
{–sh/ip | –fsh/ip} -wor/kdir nombrev-dir-temp
[–sc/lass clase-almacenamiento ]
[ –pex/pire fecha-hora ]
[–not/ify dir-correo-e ]
| –out nombrev-archivo-paquete } nombre-sist-princ:nombre-sitio ...
–imp/ort
{ –site nombre-sitio–repo/sitory info-bd [ –vendor
tipo-proveedor ] parám-bd
}
{ [ –data/base info-bd [ –vendor tipo-proveedor ] parám-bd
[ –c/omments comentarios ] { nombrev-archivo-paquete|vía-acceso-dir-paquete }...
–imp/ort {
[–cl/an nombre-clan ] [ -site nombre-sitio ] –u/ser nombre-usuario
[–p/assword ] contraseña { –data/base info-bd
[ –vendor tipo-proveedor ] parám-bd
[ –c/omments comentarios ] { nombrev-archivo-paquete|vía-acceso-dir-paquete }...
El mandato mkreplica –export puede tardar mucho tiempo. La base de datos y el depósito de esquemas se bloquean mientras una exportación esté en curso. Asegúrese de que todos los usuarios han finalizado la sesión antes de ejecutar mkreplica –export.
La creación de una nueva réplica es un proceso de tres fases:
En cada sitio nuevo, el administrador debe crear bases de datos de proveedor vacías para los datos de réplica. Si es la primera réplica del nuevo sitio, necesita como mínimo dos bases de datos de proveedor vacías, una para la réplica del depósito de esquemas y otra para la réplica de la base de datos de usuario.
Cuando una base de datos se replica por primera vez, se habilita el registro de operaciones de la base de datos. Todas las operaciones que se van a replicar se registran en el registro de operaciones. El registro de operaciones continúa hasta que se suprimen todas las réplicas, dejando sólo el conjunto de bases de datos original. La creación de réplicas adicionales se registra en entradas del registro de operaciones. Las réplicas existentes reconocen una nueva réplica mediante el mecanismo de sincronización estándar.
MultiSite controla cuántos números de ID de registro se asignan a cada réplica. Esta asignación se realiza utilizando bloques de ID (grupos de ID).
De forma predeterminada, se da a cada réplica un bloque de ID de 4096 ID cuando se crea. Cuando una réplica alcanza un umbral de 1024 ID que quedan por utilizar, se asigna otro bloque de ID de 4096 ID para asegurar que todos los ID son únicos. El depósito de esquemas de trabajo maneja internamente la asignación de bloques de ID durante la sincronización.
En función del nivel de actividad de una familia de réplicas, puede ser útil aumentar el tamaño de los bloques de ID que se asignan a una réplica. Por ejemplo, con los valores predeterminados, si intenta enviar un número elevado de defectos, los primeros 4096 se envían satisfactoriamente pero los envíos posteriores fallan.
Para controlar a cuántos ID se asigna una réplica, puede utilizar la opción –size combinada con la opción –threshold cuando cree una réplica con el mandato mkreplica –export. Puede modificar estos valores con el mandato chreplica.
Cada invocación de mkreplica –export crea un único paquete lógico de creación de réplicas. (Esto es verdadero aunque cree varias réplicas nuevas con un solo mandato mkreplica.) Cada paquete incluye una o varias especificaciones de réplica, cada una de las cuales indica el nombre de la nueva réplica y el servidor de sincronización asociado a la nueva réplica.
La base de datos de usuario y el depósito de esquemas se bloquean durante la fase de exportación.
La opción –maxsize divide el único paquete lógico en varios paquetes físicos para cumplir las limitaciones del soporte de transferencia.
Si una importación de réplica se interrumpe o falla por cualquier motivo (una interrupción de alimentación, por ejemplo), debe suprimir las bases de datos de proveedor, crear bases de datos de proveedor nuevas para la operación de importación anómala y volver a ejecutar mkreplica –import.
Es posible que la importación del depósito de esquemas sea satisfactoria pero que la importación de la réplica de la base de datos de usuario falle. En este caso, debe suprimir y volver a crear la base de datos de proveedor que estaba pensada para la réplica de base de datos de usuario.
Los paquetes de creación de réplicas no se suprimen después de la importación. Después de importar un paquete de creación de réplicas con mkreplica –import, debe suprimir el paquete.
Si no puede entregarse un paquete, éste se envía mediante el recurso de almacenar y reenviar al administrador del sitio de 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.
Bloqueos: Este mandato falla si se bloquea la base de datos (por ejemplo, durante el proceso de actualización) o mientras se realiza otra operación de Rational ClearQuest MultiSite.
Otros: No puede replicar una base de datos en un host que ejecute una versión diferente de MultiSite. Puede ejecutar mkreplica –export en cualquier sitio; sin embargo debería ejecutarlo siempre en el sitio del depósito de esquemas de trabajo para evitar la creación de varios sitios con el mismo nombre.
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: No es aplicable. Cuando se ejecuta mkreplica, el depósito de esquemas asociado de la familia de bases de datos de usuario que especifique se incluye en el paquete de creación de réplicas.
Valor predeterminado: Ninguno.
–fship (forzar envío) invoca shipping_server para enviar el paquete de creación de réplicas. –ship coloca el paquete en una bahía de almacenamiento. Para enviar el paquete, invoque shipping_server.
La partición de disco donde está ubicada la bahía de almacenamiento (en el host remitente y el host receptor) debe tener un espacio disponible igual o mayor que el tamaño del paquete de creación de réplicas.
Valor predeterminado: mkreplica coloca el paquete en la ubicación de la bahía de almacenamiento especificada para la clase cq_default.
Los paquetes de creación de réplicas no se entregan automáticamente; utilice un método adecuado para entregarlos. Puede crear un paquete utilizando –out y entregarlo posteriormente 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.
nombre-sist-princ puede ser la dirección IP del host o el nombre del sistema, por ejemplo, minuteman. Puede que tenga que agregar un nombre de dominio IP, por ejemplo, minuteman.purpledoc.com.
En Linux y el sistema UNIX, utilice el mandato uname –n para mostrar el nombre del sistema. En Windows, el nombre del sistema es accesible desde el icono Sistema en el Panel de control. En Windows 2000, pulse la pestaña Identificación de red. En Windows NT Server 2003, pulse la pestaña Nombre de sistema.
Cuando se importa una réplica, debe especificar los parámetros de base de datos de la base de datos de proveedor para la réplica del depósito de esquemas y la base de datos de proveedor de la réplica de la base de datos de usuario. Debe crear estas bases de datos antes de importar un paquete de réplica.
Si también especifica uno o más argumentos de vía-dir-paquete, mkreplica buscará paquetes adicionales en estos directorios.
Sitio: Sitio actual. Si hay más de un sitio en este host, se necesita –site.
Especificación de info-bd y parám-bd para DB2, Oracle y Microsoft SQL Server
Cada proveedor de bases de datos tiene un número de puerto predeterminado:
Proveedor | Puerto predeterminado |
---|---|
DB2 | 50000 |
Oracle | 1521 |
Microsoft SQL Server | 1433 |
Si la base de datos utiliza un puerto diferente, debe especificarlo utilizando el parámetro opciones-conexión. Por ejemplo, si tiene una base de datos de Oracle en el puerto 1526, escriba el mandato siguiente:
multiutil mkreplica -imp -site SITEA -repo CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_1 admin_1 -con PORT=1526 -data CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_2 admin_2 -con PORT=1526 C:\TEMP\admin\mk_SITEA.xml
Importante: Para obtener más información sobre los valores soportados para las bases de datos de proveedor, consulte el tema "Propiedades de la base de datos de proveedor" en la sección Administración de Rational ClearQuest de la Ayuda.
Si también especifica uno o más argumentos de vía-dir-paquete, mkreplica buscará paquetes adicionales en estos directorios.
Valor predeterminado: Ninguno.
multiutil mkreplica -export -clan telecomm -site boston_hub -family DEV
-u susan -p passwd -out c:\cqms\boston_hub.xml goldengate:sanfran_hub
Multiutil: Packet file `c:\cqms\boston_hub.xml' generated
multiutil mkreplica -export -clan telecomm -site boston_hub -family LAB
-user susan -p passwd -out c:\cqms\lab.xml goldengate:sanfran_hub
Multiutil: Packet file `c:\cqms\lab.xml' generated
multiutil mkreplica -export -clan testing -site tokyo -family TEST
-user masako -p passwd -fship -workdir c:\cqms\working -sclass
cq_default taronga:sydney
Multiutil: Packet file
`c:\cqms\working\mk_TOKYO_29-January-02_09-47-27.xml' generated
multiutil: Shipping order
"C:\temp\cqms\ms_ship\outgoing\sh_o_mk_TOKYO_29-January-02_09-47-27.xml"
generated.
multiutil: Attempting to forward/deliver generated packets...
multiutil: -- Forwarded/delivered packet
C:\temp\cqms\ms_ship\outgoing\mk_TOKYO_29-January-02_09-4
multiutil mkreplia -export -clan telecomm -site boston_hub -family DEV
-user susan -password passwd -c "make a new replica for sanfran_hub"
-ship -workdir c:\temp\working -sclass cq_default
-pexpire 22-November-2003
goldengate:sanfran_hub
multiutil mkreplica -import -site sanfran_hub
-repository sanfran_schemarepo
-vendor SQL_SERVER -server sb_server -dbologin jcole passwd
-database sanfran_userdb -vendor SQL_SERVER
-dbologin jcole passwd
multiutil mkreplica -import -clan testing -site sydney -user bfife
-p passwd -database syd_userdb -vendor SQL_SERVER
-dbologin bfife passwd