chmaster

Trasferisce la gestione di un oggetto

Applicabilità

Prodotto Tipo di comando
MultiSite comando secondario multiutil
Piattaforma
UNIX®
Windows®

Riepilogo

chmaster

[ –cl/an nome-gruppo ] [ –site nome-sito ] –fam/ily nome-famiglia
–u/ser nome utente [ –p/assword] password
nuova-replica-principale  { { selettore-entità... | { –all[ –l/ong] |
–working/master } [ –f/orce obsolete-replica | –forceall] }
}

Descrizione

Questo comando trasferisce la gestione di uno o più oggetti da una replica ad un'altra. Solo la replica corrente viene interessata immediatamente; altre repliche sono notificate dei trasferimenti di gestione mediante lo scambio normale dei pacchetti di aggiornamento.

Limitazioni

Identità: è necessario disporre dei privilegi di Super utente.

Gestione: la replica corrente deve gestire l'oggetto. Mediante le opzioni –force o –forceall sovrascrive questa restrizione, ma non si devono utilizzare queste opzioni tranne in circostanze speciali.

Opzioni ed argomenti

Specifica del gruppo, del sito e della famiglia

Valore predefinito
Gruppo: il primo gruppo replicato in questo sito. Se esiste più di un collegamento dbset registrato in questo host, –clan è obbligatorio.

Sito: il sito corrente. Se esiste più di un sito in questo host, –site è obbligatorio.

Famiglia: nessun valore predefinito; è necessario specificare una famiglia.

–cl/an nome-gruppo
Il nome del gruppo di replica.
–site nome-sito
Il nome del sito di replica.
–fam/ily nome-famiglia
La famiglia del database utente: il nome database fornito al database utente quando è stato creato.

Famiglia di repository di schemi: il nome della famiglia è MASTR. È necessario specificare MASTR quando si utilizza l'opzione –workingmaster.

Specifica di un nome utente e password

Valore predefinito
È necessario specificare un nome utente e una password.
–u/ser utente
Il nome dell'utente con privilegi di Super utente.
–p/assword password
La password associata all'utente specificato.

Specifica delle nuova replica master

Valore predefinito
Nessuno.
nuova-replica-principale
Il nome della replica a cui si trasferisce la gestione.

Specifica degli oggetti

Valore predefinito
Nessuno. È necessario specificare un oggetto particolare (selettore-entità), tutti gli oggetti in una replica (–all) o solo il repository di schemi funzionante.
selettore-entità
Specifica l'oggetto del quale si desidera modificare la gestione. È possibile modificare la gestione dei seguenti oggetti:
Oggetto
Sintassi
Record
tipo-record:id-record
Utente o gruppo
user:nome utente

group:nome-gruppo

Voce spazio di lavoro pubblico
"spazio di lavoro:Public Queries\nome-cartella\nome-query"
Voce spazio di lavoro personale
"spazio di lavoro:Personal Queries(nome utente)\nome-cartella\nome-query"
Record stateless il cui nome non è univoco
tipo-record:id-record<nome-sito chiave>
Voce spazio di lavoro il cui nome non è univoco
"spazio di lavoro:nome-query<nome-sito chiave>"
Utente o gruppo il cui nome non è univoco
user:nome utente<nome-sito chiave>

grupponome-gruppo<nome-sito chiave>

Per le informazioni sull'esecuzione di nomi univoci, consultare "Risoluzione dei problemi delle operazioni MultiSite - Risoluzione dei conflitti di denominazione" in questa guida.

–a/ll [ –l/ong ]
Trasferisce alla nuova-replica-principale la gestione di tutti gli oggetti contenuti nella replica e gestiti da essa specificata mediante –clan, –site, e –family. Se si verifica un errore, il comando continua, ma al termine, esso riporta che non tutte le modifiche di gestione sono state eseguite correttamente.

Con –long, chmaster elenca gli oggetti dei quali viene modificata la gestione.

Nota: per modificare la gestione di un repository di schemi funzionante, utilizzare –workingmaster.
–working/master
Trasferisce la gestione di un repository di schemi funzionante nel sito specificato. È possibile utilizzare l'opzione –workingmaster solo nel sito del repository di schemi funzionante.

Quando si utilizza questa opzione, è necessario specificare –family MASTR.

–f/orce replica-obsoleta
Importante: un uso non corretto dell'opzione –force può comportare delle divergenze tra le repliche in una famiglia.

Con –force, chmaster trasferisce la gestione di tutti gli oggetti nella replica specificata con replica-obsoleta. Utilizzare questo formato di chmaster solo quando la replica-obsoleta non è più disponibile (ad esempio, è stata eliminata casualmente).

–forceall
Importante: un uso non corretto dell'opzione –forceall può comportare delle divergenze tra le repliche in una famiglia.

Con –forceall, chmaster trasferisce la gestione di un oggetto nella replica specificata, anche se la replica corrente non gestisce l'oggetto.

Esempi

In questi esempi, le righe sono interrotte per agevolare la lettura. È necessario immettere ogni comando su una singola riga.

  • Trasferire la gestione dell'utente admin dalla replica 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.

  • Nella replica tokyo, che contiene il repository di schemi funzionante, trasferire la gestione di tutti gli schemi e delle attività del repository di schemi funzionante alla replica 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'.

  • Trasferire la gestione di tutti gli oggetti nel database DEV, gestito dalla replica sanfran_hub, alla replica 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.

  • Simile all'esempio precedente, ma utilizzare l'opzione –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.

  • Nella replica boston_hub, trasferire la gestione di tutte le voci gestite dalla replica bangalore nella replica boston_hub. Supporre che bangalore non sia più disponibile.

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

    Modificare la gestione di utenti e gruppi dal repository di schemi bangalore in boston_hub.

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

    Modificare la gestione del repository di schemi funzionante da bangalore in boston_hub:

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

  • In boston_hub, utilizzare –forceall per modificare la gestione dell'utente admin da sanfran_hub in 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