chmaster

Transfère la maîtrise d'un objet

Conditions d'utilisation

Produit Type de commande
MultiSite sous-commande multiutil
Plateforme
UNIX®
Windows®

Syntaxe

chmaster

[ –cl/an nom-clan ] [ –site
nom-site ] –fam/ily
nom-famille
–u/ser nomutilisateur [
–p/assword ] motdepasse
nouvelle-réplique-maître  { {
sélecteur-entité... | { –all[
–l/ong] |
–working/master } [ –f/orce
réplique-obsolète |
–forceall] }
}

Description

Cette commande transfère la maîtrise d'un ou plusieurs objets d'une réplique à une autre. Seule la réplique en cours est modifiée immédiatement. Les autres répliques sont averties des transferts de maîtrise par l'échange normal de paquets de mise à jour.

Restrictions

Identités : Vous devez disposer des droits Super Utilisateur.

Maîtrise : Votre réplique en cours doit détenir la maîtrise de l'objet. Le fait d'utiliser les options –force ou –forceall annule cette restriction, mais vous ne devez les utiliser que dans des circonstances particulières.

Options et arguments

Précisez le clan, le site et la famille

Valeur par défaut
Clan : Premier clan répliqué sur ce site. Si cet hôte a enregistré plus d'une connexion dbset, –clan est obligatoire.

Site : Site actuel. S'il y a plus d'un site sur cet hôte, –site est obligatoire.

Famille : Pas de valeur par défaut, vous devez préciser une famille.

–cl/an nom-clan
Nom du clan de la réplique.
–site nom-site
Nom du site de la réplique.
–fam/ily nom-famille
Famille de la base de données utilisateur : Nom attribué à une base de données utilisateur lors de sa création.

Famille de référentiel de schémas : Le nom de la famille est MASTR. Vous devez préciser MASTR lorsque vous utilisez l'option –workingmaster.

Indication d'un nom d'utilisateur et d'un mot de passe

Valeur par défaut
Vous devez indiquer un nom d'utilisateur et un mot de passe.
–u/ser utilisateur
Nom d'un utilisateur bénéficiant des droits Super Utilisateur.
–p/assword motdepasse
Mot de passe associé à l'utilisateur indiqué.

Indication de la nouvelle réplique maître

Valeur par défaut
Aucune.
nouvelle-réplique-maître
Nom de la réplique à laquelle vous transférez la maîtrise.

Indication d'objets

Valeur par défaut
Aucune. Vous devez préciser un objet particulier (sélecteur-entité), tous les objets d'une réplique (–all), ou uniquement le référentiel de schémas de travail.
sélecteur-entité
Précise l'objet dont vous voulez modifier la maîtrise. Vous pouvez modifier la maîtrise des objets suivants :
Objet
Syntaxe
Enregistrement
type-enregistrement:id-enregistrement
Utilisateur ou groupe
user:nom-utilisateur

group:nom-groupe

Elément Espace de travail public
"workspace:Public Queries\nom-dossier\nom-requête"
Elément Espace de travail personnel
"workspace:Personal Queries(username)\folder-name\query-name"
Enregistrement sans état dont le nom n'est pas unique
record-type:record-id<keysite-name>
Elément d'espace de travail dont le nom n'est pas unique
"workspace:query-name<keysite-name>"
Utilisateur ou groupe dont le nom n'est pas unique
user:username<keysite-name>

group:group-name<keysite-name>

Pour plus d'informations sur la façon de rendre les noms uniques, voir "Dépannage des opérations MultiSite - Résolution des conflits de dénomination" dans le présent guide.

–a/ll [ –l/ong ]
Transfère à nouvelle-réplique-maître la maîtrise de tous les objets gérés et situés sur la réplique indiquée par –clan, –site et –family. Si des erreurs se produisent, la commande continue de s'exécuter, mais une fois terminée, elle indique que tous les changements de maîtrise n'ont pas abouti.

Avec –long, la commande chmaster affiche les objets dont la maîtrise est changée.

Remarque : Pour changer la maîtrise d'un référentiel de schémas de travail, utilisez –workingmaster.
–working/master
Transfère la maîtrise d'un référentiel de schémas de travail au site indiqué. Vous ne pouvez utiliser l'option –workingmaster que sur le site du référentiel de schémas de travail.

Lorsque vous utilisez cette option, vous devez préciser –family MASTR.

–f/orce réplique-obsolète
Important : L'utilisation incorrecte de l'option –force peut conduire à des divergences entre les répliques d'une famille.

Avec –force, chmaster transfère la maîtrise de tous les objets de la réplique précisée par réplique-obsolète. Vous n'utiliserez cette forme de la commande chmaster que si la réplique réplique-obsolète n'est plus disponible (par exemple, si elle a été supprimée de façon accidentelle).

–forceall
Important : L'utilisation incorrecte de l'option –forceall peut conduire à des divergences entre les répliques d'une famille.

Avec –forceall, chmaster transfère la maîtrise d'un objet à une réplique spécifiée, même si la réplique en cours ne détient pas la maîtrise de l'objet.

Exemples

Dans ces exemples, chaque commande a été découpée en plusieurs lignes, pour en faciliter la lecture. Cependant, chacune doit être entrée en une seule ligne.

  • Transférez la maîtrise de l'utilisateur admin depuis la réplique boston_hub vers sanfran_hub.

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

    Multiutil : la maîtrise de l'enregistrement 'admin' du type 'user' est
    passée de 'BOSTON_HUB' à 'SANFRAN_HUB'.
    Multiutil : la maîtrise de certains utilisateurs ou groupes a été transférée
    depuis ce site. L'administrateur des utilisateurs locaux doit mettre à jour les bases de données
    utilisateurs au nouveau site de maîtrise 'sanfran_hub' avant que ces changements
    ne deviennent visibles pour une base de données utilisateurs.

  • Sur la réplique tokyo, qui contient le référentiel de schémas de travail, transférez la maîtrise de tous les schémas et des tâches du référentiel de schémas de travail vers la réplique sydney.

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

    Multiutil : le working master est passé de 'TOKYO' à 'SYDNEY'.

  • Transférez la maîtrise de tous les objets de la base de données DEV détenus par la réplique sanfran_hub vers la réplique boston_hub.

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

    Multiutil : le nombre total d'objets a changé : 5.

  • Même exemple que précédemment, mais vous utiliserez l'option –long.

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

    Multiutil : la maîtrise de l'objet ou des objets suivant(s) de la base de données
    'DEV' est passée de 'SANFRAN_HUB' à '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.

  • Sur la réplique boston_hub, transférez toutes les maîtrises d'éléments détenues par la réplique bangalore vers la réplique boston_hub. Supposez que bangalore n'est plus disponible.

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

    Transférez la maîtrise des utilisateurs et groupes du référentiel de schémas de bangalore vers boston_hub.

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

    Transférez la maîtrise du référentiel de schémas de travail de bangalore vers boston_hub :

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

  • Au niveau de boston_hub, utilisez –forceall pour transférer la maîtrise de l'utilisateur admin de sanfran_hub vers tokyo.

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

    Multiutil : la maîtrise de l'enregistrement 'admin' de type 'user' est
    passée de 'SANFRAN_HUB' à 'TOKYO'.


Retour d'informations