chmaster

Transfere o controle de um objeto

Aplicabilidade

Produto Tipo de Comando
MultiSite Subcomando de multiutil
Plataforma
UNIX
Windows

Sinopse

chmaster

[ –cl/an clan-name ] [ –site site-name ] –fam/ily family-name
–u/ser username [–p/assword ] password
new-master-replica  { { entity-selector... | { –all[ –l/ong] |
–working/master } [ –f/orce obsolete-replica | –forceall] }
}

Descrição

Esse comando transfere o controle de um ou mais objetos de uma réplica para outra. Apenas a réplica atual é afetada imediatamente; outras réplicas são notificadas das transferências de controle por meio da troca normal de pacotes de atualização.

Restrições

Identidades: você deve ter privilégios de Superusuário.

Controle: sua réplica atual deve controlar o objeto. A utilização de –force ou –forceall substitui essa restrição, mas essas opções devem ser utilizadas apenas em circunstâncias especiais.

Opções e Argumentos

Especificando o Clã, o Site e a Família

Padrão
Clã: primeiro clã replicado nesse site. Se houver mais de uma conexão dbset registrada nesse host, –clan será obrigatório.

Site: site atual. Se houver mais de um site nesse host, –site será obrigatório.

Família: nenhum padrão; você deve especificar uma família.

–cl/an clan-name
Nome do clã da réplica.
–site site-name
Nome do site da réplica.
–fam/ily family-name
Família do banco de dados do usuário: nome fornecido ao banco de dados do usuário quando ele foi criado.

Família do repositório de esquemas: o nome da família é MASTR. Você deve especificar MASTR ao utilizar a opção –workingmaster.

Especificando um Nome de Usuário e uma Senha

Padrão
Você deve especificar um nome de usuário e uma senha.
–u/ser user
Nome de um usuário com privilégios de superusuário.
–p/assword password
Senha associada ao usuário especificado.

Especificando a Nova Réplica Master

Padrão
Nenhuma.
new-master-replica
O nome da réplica para a qual você está transferindo o controle.

Especificando Objetos

Padrão
Nenhuma. Você deve especificar um objeto específico (entity-selector), todos os objetos em uma réplica (–all) ou apenas o repositório de esquemas de trabalho.
entity-selector
Especifica o objeto cujo controle você deseja alterar. Você pode alterar o controle dos seguintes objetos:
Objeto
Sintaxe
Registro
record-type:record-id
Usuário ou grupo
user:username

group:group-name

Item de Espaço de trabalho público
"workspace:Public Queries\folder-name\query-name"
Item de Espaço de trabalho pessoal
"workspace:Personal Queries(username)\folder-name\query-name"
Registro sem estado cujo nome não é exclusivo
record-type:record-id<keysite-name>
O item de Espaço de trabalho cujo nome não é exclusivo
"workspace:query-name<keysite-name>"
Usuário ou grupo cujo nome não é exclusivo
user:username<keysite-name>

group:group-name<keysite-name>

Para obter informações sobre como criar nomes exclusivos, consulte "Resolução de Problemas de Operações do MultiSite - Resolvendo Conflitos de Nomenclatura" neste guia.

–a/ll [ –l/ong ]
Transfere para new-master-replica o controle de todos os objetos localizados na, e controlados pela, réplica especificada com –clan, –site e –family. Se ocorrerem erros, o comando continuará, mas após a conclusão, ele relatará que nem todas as alterações de controle obtiveram êxito.

Com –long, chmaster lista os objetos cujo controle está em alteração.

Nota: Para alterar o controle de um repositório de esquemas de trabalho, utilize –workingmaster.
–working/master
Transfere o controle de um repositório de esquemas de trabalho para o site especificado. A opção –workingmaster pode ser utilizada apenas no site do repositório de esquemas de trabalho.

Ao utilizar essa opção, você deve especificar –family MASTR.

–f/orce obsolete-replica
Importante: O uso incorreto da opção –force pode resultar em divergências entre as réplicas de uma família.

Com –force, chmaster transfere o controle de todos os objetos na réplica especificada com obsolete-replica. Utilize esse formato de chmaster apenas quando a réplica obsolete-replica não estiver mais disponível (por exemplo, foi excluída indevidamente).

–forceall
Importante: O uso incorreto da opção –forceall pode resultar em divergências entre as réplicas de uma família.

Com –forceall, chmaster transfere o controle de um objeto para uma réplica especificada, mesmo se a réplica atual não controlar o objeto.

Exemplos

Nestes exemplos, as linhas são quebradas por questões de legibilidade. Cada comando deve ser digitado em uma única linha física.

  • Transfira o controle do usuário admin da réplica boston_hub para 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.

  • Na réplica tokyo, que contém o repositório de esquemas de trabalho, transfira o controle de todos os esquemas e de todas as tarefas do repositório de esquemas de trabalho para a 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'.

  • Transfira o controle de todos os objetos no banco de dados DEV, controlados pela réplica sanfran_hub, para a 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.

  • Semelhante ao exemplo anterior, mas utilize a opção –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.

  • Na réplica boston_hub, transfira o controle de todos os itens controlados pela réplica bangalore para a réplica boston_hub. Suponha que bangalore não esteja disponível.

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

    Altere o controle de usuários e grupos do repositório de esquemas bangalore para boston_hub.

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

    Altere o controle do repositório de esquemas de trabalho de bangalore para boston_hub:

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

  • Em boston_hub, utilize –forceall para alterar o controle do usuário admin de sanfran_hub para 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'.


Feedback