Produit | Type de commande |
---|---|
MultiSite | sous-commande multiutil |
Plateforme |
---|
UNIX |
Windows |
–exp/ort
[ –cl/an nom-clan ] [ –site
nom-site ] –fam/ily
nom-famille
–u/ser nomutilisateur [–p/assword]
motdepasse [–max/size
taille-max-paquet
[–lim/it nombre-paquets ] ]
{ { –sh/ip| –fsh/ip }
–wor/kdir répertoire [
–sc/lass classe-stockage ]
[–pex/pire date ]
[–not/ify email ]
| –out { nomchemin-fichier-paquet |
nomchemin-zone-activation-données } }
réplique ...
–imp/ort
[ –cl/an nom-clan ] [ –site
nom-site ] –fam/ily
nom-famille
–u/ser nomutilisateur [–p/assword
] motdepasse
{ –rec/eive[ –sc/lass classe-stockage ]
| { nomchemin-fichier-paquet | nomchemin-zone-attente } ... }
[ -plug/epoch ]
La synchronisation d'une réplique avec une ou plusieurs répliques soeurs s'effectue en trois phases :
Contenu d'un paquet de mise à jour :
Dans tous les cas, syncreplica –export crée un seul paquet de mise à jour logique pour toutes les destinations indiquées. Le paquet ne peut être utilisé que pour mettre à jour ces répliques particulières.
MultiSite est conçu pour procéder à une mise à jour efficace des répliques. syncreplica –export tente d'exclure les opérations qui ont déjà été envoyées. (Toutefois, il n'y a aucun risque à envoyer une opération plusieurs fois à la même réplique. La première opération est appliquée et les opérations identiques suivantes sont ignorées.)
syncreplica –export conserve ses fichiers temporaires dans le répertoire indiqué par l'option –workdir. Ce répertoire ne doit pas préexister. Il est supprimé une fois le paquet d'exportation créé.
Le paquet de mise à jour est appliqué aux répliques appropriées et associées au serveur de synchronisation qui a reçu le paquet. Vous n'avez pas à préciser de répliques ou d'emplacements de stockage particuliers.
Le processus d'importation applique les paquets de mise à jour dans le bon ordre. Par conséquent, vous pouvez indiquer les paquets dans n'importe quel ordre sur la ligne de commande.
La réplique de base de données n'est pas verrouillée pendant l'importation pour les opérations normales de base de données, mais elle l'est pour toutes les autres opérations de MultiSite.
La commande syncreplica –import ne traite pas de paquet de mise à jour dans les situations suivantes :
Dans tous ces cas, syncreplica –import affiche un message d'explication.
Dans certains cas, la commande syncreplica –import commence à appliquer des opérations à une réplique, mais échoue en affichant un message d'erreur. Par exemple, un autre processus peut avoir verrouillé la base de données, entraînant l'échec de l'importation. Une fois la base de données déverrouillée, vous pouvez exécuter syncreplica –import de nouveau pour traiter tout le paquet de mise à jour.
Il n'y a aucun risque à importer des paquets de mise à jour dont le traitement a déjà réussi. Le même changement ne sera pas effectué deux fois.
Si un unique appel de la commande syncreplica –import réussit à appliquer un paquet à toutes les répliques cibles associées à un serveur de synchronisation, ce paquet est supprimé lorsque la commande achève sa tâche. S'il faut plusieurs commandes syncreplica –import pour traiter le paquet, ce dernier n'est pas effacé.
Aucun crochet Rational ClearQuest n'est émis en réponse à des changements effectués pendant l'importation de paquets.
La commande syncreplica résout les conflits de dénomination entre les objets créés dans différentes répliques.
syncreplica n'informe pas les utilisateurs de Rational ClearQuest des mises à jour des répliques. Quelques secondes suffisent pour que tous les utilisateurs actifs voient les mises à jour, grâce à des routines normales d'interrogation de base de données de Rational ClearQuest.
Si un paquet ne peut être livré, il est renvoyé au serveur de synchronisation de la réplique d'origine, grâce à la fonction de store-and-forward. Un message électronique est envoyé à l'administrateur store-and-forward. Ceci se produit lorsque plusieurs tentatives de livraison de paquet ont échoué et lorsque le temps alloué a expiré. Ceci peut également se produire lorsque l'hôte de destination est inconnu ou lorsqu'un fichier de données n'existe pas. Les paramètres de configuration de store-and-forward précisent le délai d'expiration, l'adresse e-mail de l'administrateur et le programme de notification.
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.
Famille de référentiel de schémas : Le nom de la famille est MASTR.
L'option –limit limite le nombre de paquets générés par syncreplica. La taille de chaque paquet n'est pas supérieure à taille-max-paquet. Utilisez cette option lorsque l'espace disque de votre baie de stockage ou zone d'attente des données est limité.
L'utilisation de –fship (pour forcer la livraison) appelle le serveur de livraison pour envoyer immédiatement le paquet de mise à jour. Le fait d'utiliser –ship n'appelle pas ce serveur.
Les paquets de mise à jour ne sont pas livrés automatiquement. A vous d'utiliser une méthode appropriée pour ce faire. Vous pouvez créer un paquet avec l'option –out, puis le livrer par la fonction store-and-forward.
L'argument date-heure peut avoir n'importe lequel des formats suivants :
Précisez l'heure au format 24 heures, dans le fuseau horaire local. Si vous n'indiquez pas l'heure, la valeur par défaut est 00:00:00. Si vous n'indiquez pas la date, la valeur par défaut est today. Si vous n'indiquez pas le siècle, l'année ou une date spécifique, la valeur la plus récente est utilisée. Précisez UTC si vous souhaitez que l'heure soit résolue quel que soit le fuseau horaire. Utilisez l'opérateur plus (+) ou moins (-) pour indiquer un décalage positif ou négatif par rapport à l'heure UTC. Si vous précisez UTC sans décalage horaire en heure ou minutes, le réglage par défaut est Greenwich Mean Time (GMT). (Les dates antérieures au 1er janvier 1970 Universal Coordinated Time (UTC) ne sont pas valides.)
En cas d'échec sur un hôte Windows où la notification par e-mail n'est pas activée, un message s'affiche dans l'observateur d'événements de Windows. Il mentionne l'adresse-e-mail indiquée par cette option, ainsi qu'une note demandant d'informer cet utilisateur du statut de l'opération.
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.
Famille de référentiel de schémas : Le nom de la famille est MASTR.
Elle explore les baies de stockage de l'hôte courant. Tout paquet de mise à jour non traité et destiné aux répliques associées à cet hôte est appliqué aux répliques concernées. Avec l'option –sclass, la commande syncreplica n'explore que les baies de stockage de la classe de stockage précisée.
Si syncreplica trouve un paquet de création de réplique, elle envoie un message électronique à l'administrateur de la fonction store-and-forward. (Si l'hôte en cours est un hôte Windows et si la notification par messagerie électronique n'est pas activée, un message s'affiche dans l'observateur d'événements de Windows. Utilisez mkreplica pour importer ces paquets de création de réplique.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family SAMPL -user susan -p passwd -out c:\cqms\sanfran_hub_sync.xml
sanfran_hub
Multiutil : fichier de paquet `c:\cqms\sanfran_hub_sync.xml' généré
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -maxsize 500mb -workdir c:\work
-ship -sclass cq_default sanfran_hub
Multiutil: fichier de paquet
`C:\work\sync_BOSTON_HUB_26-March-02_10-55-16.xml' généré
multiutil : instruction de livraison
"C:\temp\cqms\ms_ship\outgoing\sh_o_sync_BOSTON_HUB_26-March-02_
10-55-16.xml" généré.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -password p -maxsize 500mb -workdir
c:\work -fship -sclass cq_default sanfran_hub
Multiutil: fichier de paquet
`C:\work\sync_BOSTON_HUB_26-March-02_10-56-43.xml' généré
multiutil : instruction de livraison "C:\cqms\ms_ship\outgoing\sh_o_sync_
BOSTON_HUB_26-March-02_10-56-43.xml" généré.
multiutil : tentative de réacheminer/distribuer les paquets générés...
multiutil : -- paquet réacheminé/distribué
C:\cqms\ms_ship\outgoing\sync_BOSTON_HUB_26-March-02_10-
---- REMARQUE : consultez le journal des événements pour les erreurs.
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV
-user jcole -p passwd -receive -sclass cq_storage
Multiutil : 4 transactions de boston_hub have ont été réexécutées
dans la base de données MASTR
Multiutil : 2 transactions de boston_hub ont été réexécutées
dans la base de données DEV
Multiutil : suppression du paquet C:\temp\cqms\ms_ship\incoming\sync_
boston_hub_22-January-02_11-10-34.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xm
Multiutil : 1 transaction de boston_hub a été réexécutée
dans la base de données MASTR
Multiutil : 2 transactions de boston_hub ont été réexécutées
dans la base de données DEV
Multiutil : suppression du paquet c:\cqms\sanfran_hub_sync.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p passwd c:\cqms\sanfran_hub_sync.xml
Multiutil : le paquet UPDATE_PACKET envoyé depuis boston_hub à
2002-01-22 15:15:50 est destiné à la révision de schéma 2, et non 1 ;
exécutez à nouveau syncreplica une fois que l'administrateur du site aura mis à niveau la base de données.
Multiutil : 2 transactions de boston_hub ont été réexécutées
dans la base de données MASTR
Multiutil : préservation du paquet c:\cqms\sanfran_hub_sync.xml.
multiutil syncreplica -import -clan telecomm -site boston_hub
-family DEV -user susan -p passwd -receive
Multiutil : 1 transaction de SANFRAN_HUB a été réexécutée
dans la base de données MASTR
Multiutil : 2 transactions de SANFRAN_HUB ont été réexécutées
dans la base de données DEV
Multiutil : suppression du paquet C:\temp\cqms\ms_ship\incoming\sync_
SANFRAN_HUB_07-February-02_11-24-49.xml