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. Utilizar –force o –forceall altera temporalmente esta restricción, pero no debe utilizar estas opciones excepto 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 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. 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
Ninguno.
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 en 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 la publicación IBM Rational ClearQuest MultiSite Administrator's Guide.

–a/ll [ –l/ong ]
Transfiere a nueva-réplica-maestra la maestría de todos los objetos ubicados en y controlados por la réplica especificada 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 sólo 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 conducir a divergencias en una familia.

Con –force, chmaster transfiere la maestría de todos los objetos en 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 conducir a divergencias entre las réplicas en una familia.

Con –forceall, chmaster transfiere la maestría de un objeto a una réplica especificada, incluso si la réplica actual no controla 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 esquema 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 utiliza 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