chmaster

Transfiere la maestría de un objeto

Aplicabilidad

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

Sinopsis

chmaster

[ –cl/an nombre-clan ] [ –site nombre-sitio ] –fam/ily nombre-familia
–u/ser nombre-usuario [ –p/assword ] contraseña
nueva-réplica-maestra  { { selector-entidad... | { –all[ –l/ong] |
–working/master } [ –f/orce réplica-obsoleta | –forceall] }
}

Descripción

Este mandato transfiere la maestría de uno o más objetos de una réplica a otra. Sólo la réplica actual se ve afectada inmediatamente; se notifica a otras réplicas las transferencias de maestría a través del intercambio normal de paquetes de actualización.

Restricciones

Identidades: Debe tener privilegios de superusuario.

Maestría: La réplica actual debe dominar el objeto. El uso de –force o –forceall altera temporalmente esta restricción, pero no debe utilizar estas opciones salvo en circunstancias especiales.

Opciones y argumentos

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. Debe especificar MASTR cuando utilice la opción –workingmaster.

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 nueva réplica maestra

Valor predeterminado
Ninguna.
nueva-réplica-maestra
Nombre de la réplica a la que transfiere la maestría.

Especificación de objetos

Valor predeterminado
Ninguno. Debe especificar un objeto concreto (selector-entidad), todos los objetos de una réplica (–all) o sólo el depósito de esquemas de trabajo.
selector-entidad
Especifica el objeto cuya maestría desea cambiar. Puede cambiar la maestría de los objetos siguientes:
Objeto
Sintaxis
Registro
tipo-registro:ID-registro
Usuario o grupo
user:nombre-usuario

group:nombre-grupo

Elemento Espacio de trabajo público
"workspace:Public Queries\nombre-carpeta\nombre-consulta"
Elemento Espacio de trabajo personal
"workspace:Personal Queries(nombre-usuario)\nombre-carpeta\nombre-consulta"
Registro sin estado cuyo nombre no sea exclusivo
tipo-registro:ID-registro<nombre-sitioclave>
Elemento de espacio de trabajo cuyo nombre no sea exclusivo
"workspace:nombre-consulta<nombre-sitioclave>"
Usuario o grupo cuyo nombre no sea exclusivo
user:nombre-usuario<nombre-sitioclave>

group:nombre-grupo<nombre-sitioclave>

Para obtener información sobre cómo hacer que estos nombres sean exclusivos, consulte el apartado "Resolución de problemas de operaciones de MultiSite - Resolución de conflictos de denominación" en esta guía.

–a/ll [ –l/ong ]
Transfiere a nueva-réplica-maestrala maestría de todos los objetos situados en y controlados por la réplica que especifique con –clan, –site y –family. Si se producen errores, el mandato continúa, pero después de finalizar, informa de que no todos los cambios de maestría han sido satisfactorios.

Con –long, chmaster lista los objetos cuya maestría está cambiando.

Nota: Para cambiar la maestría de un depósito de esquemas de trabajo, utilice –workingmaster.
–working/master
Transfiere la maestría de un depósito de esquemas de trabajo al sitio que especifique. Puede utilizar la opción –workingmaster únicamente en el sitio del depósito de esquemas de trabajo.

Cuando utilice esta opción, debe especificar –family MASTR.

–f/orce réplica-obsoleta
Importante: El uso incorrecto de la opción –force puede llevar a divergencias entre las réplicas de una familia.

Con –force, chmaster transfiere la maestría de todos los objetos de la réplica especificada con réplica-obsoleta. Utilice este formulario de chmaster sólo cuando la réplica réplica-obsoleta ya no esté disponible (por ejemplo, si se suprimió de forma accidental).

–forceall
Importante: El uso incorrecto de la opción –forceall puede llevar a divergencias entre las réplicas de una familia.

Con –forceall, chmaster transfiere la maestría de un objeto a una réplica especificada, aunque la réplica actual no domine el objeto.

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.

  • Transfiera la maestría del usuario admin desde la réplica boston_hub a sanfran_hub.

    multiutil chmaster -clan telecomm -site boston_hub
    -family DEV -user
    susan -p passwd sanfran_hub user:admin

    Multiutil: The mastership of record 'admin' of type 'user' has been
    changed from 'BOSTON_HUB' to 'SANFRAN_HUB'.
    Multiutil: The mastership of some users or groups has been transferred
    from this site. The local user administrator must update user
    databases at the new mastering site 'sanfran_hub' before these changes
    will be visible to any user database.

  • En la réplica tokyo, que contiene el depósito de esquemas de trabajo, transfiera la maestría de todos los esquemas y tareas de depósito de esquemas de trabajo a la réplica sydney.

    multiutil chmaster -clan testclan -site tokyo -family MASTR
    -user masako -p passwd sydney -workingmaster

    Multiutil: The working master has been changed from 'TOKYO' to 'SYDNEY'.

  • Transfiera la maestría de todos los objetos de la base de datos DEV, controlada por la réplica sanfran_hub, a la réplica boston_hub.

    multiutil chmaster -clan telecomm -site sanfran_hub -family DEV
    -user jcole -p passwd boston_hub -all

    Multiutil: Total number of objects changed: 5.

  • Similar al ejemplo anterior, pero utilice la opción –long.

    multiutil chmaster -clan telecomm -site sanfran_hub -family DEV
    -user jcole -p passwd boston_hub -all -long

    Multiutil: The mastership(s) of the following object(s) in database
    'DEV' was(were) changed from 'SANFRAN_HUB' to 'BOSTON_HUB'.

    Multiutil: Type: customer, display Name: John Smith.
    Multiutil: Type: customer, display Name: Ethan Hunt.
    Multiutil: Type: customer, display Name: Jane Smith.
    Multiutil: Type: customer, display Name: Anne Johnson.
    Multiutil: Type: customer, display Name: Joe Lee.

  • En la réplica boston_hub, transfiera la maestría de todos los elementos controlados por la réplica bangalore a la réplica boston_hub. Suponga que bangalore ya no está disponible.

    multiutil chmaster -clan telecomm -site boston_hub -family DOC
    -user susan -password passwd boston_hub -all -force bangalore

    Cambie la maestría de usuarios y grupos del depósito de esquemas bangalore a boston_hub.

    multiutil chmaster -clan telecomm -site boston_hub -family MASTR
    -user susan -password passwd boston_hub -all -force bangalore

    Cambie la maestría del depósito de esquemas de trabajo de bangalore a boston_hub:

    multiutil chmaster -clan telecomm -site boston_hub -family MASTR
    -user susan -password passwd boston-hub -workingmaster -force bangalore

  • En boston_hub, utilice –forceall para cambiar la maestría del usuario admin de sanfran_hub a tokyo.

    multiutil chmaster -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd tokyo user:admin –forceall

    Multiutil: The mastership of record 'admin' of type 'user' has
    been changed from 'SANFRAN_HUB' to 'TOKYO'.


Comentarios