–exp/ort
[–cl/an clanname ] [ –site sitename ] –fam/ily familienname
–u/ser benutzername [–p/assword ] kennwort [–max/size max-paketgröße
[–lim/it anzahl-pakete ] ]
{ { –sh/ip| –fsh/ip }
–wor/kdir verzeichnis [ –sc/lass speicherklasse ]
[–pex/pire datum ]
[–not/ify e-mail ]
| –out { pname-der-paketdatei | pname-des-zwischenspeicherungsbereichs } }
replikat...
–imp/ort
[–cl/an clanname ] [ –site sitename ] –fam/ily familienname
–u/ser benutzername [ –p/assword] kennwort
{ –rec/eive[ –sc/lass speicherklasse ]
| { pname-der-paketdatei | pname-des-zwischenspeicherungsbereichs } ... }
[ -plug/epoch ]
Die Synchronisation eines Replikats mit mindestens einem gleichgeordneten Replikat ist ein Prozess in drei Phasen:
Inhalt eines Aktualisierungspakets:
In allen Fällen erstellt syncreplica –export ein logisches Aktualisierungspaket, das von allen angegebenen Zielreplikaten verwendet wird; das Paket kann nur zur Aktualisierung dieser Replikate verwendet werden.
MultiSite wurde für die effiziente Aktualisierung von Replikaten konzipiert. syncreplica –export versucht, bereits gesendete Operationen auszuschließen. Es ist allerdings unproblematisch, eine Operation mehrere Male an ein Replikat zu senden; die erste Operation wird importiert, und nachfolgende Operationen werden ignoriert.
syncreplica –export speichert temporäre Dateien in dem Verzeichnis, das mit der Option –workdir angegeben wird. Dieses Verzeichnis darf noch nicht vorhanden sein; nach Erstellung des Exportpakets wird es gelöscht.
Ein Aktualisierungspaket wird auf die entsprechenden Replikate angewendet, die dem Synchronisationsserver zugeordnet sind, der das Paket empfangen hat. Die Angabe bestimmter Replikate oder Speicherpositionen ist nicht erforderlich.
Der Importprozess wendet Aktualisierungspakete in der richtigen Reihenfolge an. Deshalb können die Pakete in der Befehlszeile in beliebiger Reihenfolge angegeben werden.
Während der Importphase wird das Datenbankreplikat nicht für normale Datenbankoperationen, aber für alle anderen MultiSite-Operationen gesperrt.
Aktualisierungspakete werden von syncreplica –import in den folgenden Situationen nicht verarbeitet:
In diesen Fällen zeigt syncreplica –import eine erklärende Nachricht an.
In einigen Fällen beginnt syncreplica –import mit der Anwendung von Operationen auf ein Replikat, scheitert aber mit einer Fehlernachricht. Ein anderer Prozess könnte die Datenbank zum Beispiel gesperrt haben, so dass der Import fehlschlug. Nach dem Entsperren der Datenbank können Sie syncreplica –import ausführen, um das gesamte Aktualisierungspaket erneut zu verarbeiten.
Aktualisierungspakete, die bereits erfolgreich verarbeitet wurden, können problemlos importiert werden; Änderungen werden nur einmal vorgenommen.
Wenn ein einzelner Aufruf von syncreplica –import ein Paket erfolgreich auf alle dem Synchronisationsserver zugeordneten Zielreplikate anwendet, wird das Aktualisierungspaket nach Abschluss des Befehls gelöscht. Bei Verarbeitung des Pakets mit mehreren syncreplica –import-Befehlen wird es nicht gelöscht.
Hooks in Rational ClearQuest werden aufgrund von Änderungen während des Paketimports nicht gestartet.
syncreplica löst Namensunverträglichkeiten von Objekten auf, die in unterschiedlichen Replikaten erstellt wurden.
syncreplica informiert die Benutzer von Rational ClearQuest nicht über Aktualisierungen von Replikaten. Allen aktiven Benutzern werden Aktualisierungen innerhalb weniger Sekunden unter Verwendung der normalen Routinen für Datenbankabfragen in Rational ClearQuest angezeigt.
Wenn ein Paket nicht übermittelt werden kann, wird es über die Zwischenspeicher- und Übertragungsfunktion an den Synchronisationsserver für das ursprüngliche Replikat gesendet. Der Administrator der Zwischenspeicher- und Übertragungsfunktion erhält eine E-Mail-Nachricht. Diese Aktionen werden ausgeführt, wenn wiederholte Versuche der Paketübermittlung fehlgeschlagen sind und die zugeordnete Zeit abgelaufen ist; es kann auch sein, dass der Zielhost unbekannt oder eine Datendatei nicht vorhanden ist. Die Konfigurationseinstellungen der Zwischenspeicher- und Übertragungsfunktion geben den Verfallszeitraum, die E-Mail-Adresse des Administrators und das Benachrichtigungsprogramm an.
Site: Aktuelle Site. Wenn auf diesem Host mehrere Sites vorhanden sind, ist –site erforderlich.
Familie: Keine Standardeinstellung; Sie müssen eine Familie angeben.
Schema-Repository-Familie: Der Familienname ist MASTR.
Mit der Option –limit wird die Anzahl der von syncreplica generierten Pakete eingeschränkt; jedes Paket ist nicht größer als maximale-paketgröße. Verwenden Sie diese Option, wenn der Plattenspeicherplatz für die Speicherposition oder den Zwischenspeicherungsbereich begrenzt ist.
Mit –fship (force ship) wird der Versandserver aufgerufen, um das Aktualisierungspaket sofort zu senden. Mit –ship wird der Server nicht aufgerufen.
Die Aktualisierungspakete werden nicht automatisch übermittelt; verwenden Sie hierzu eine geeignete Methode. Sie können ein Paket mit –out erstellen und dieses mit Hilfe der Zwischenspeicher- und Übertragungsfunktion übermitteln.
Das Argument datum-zeit kann eines der folgenden Formate aufweisen:
Geben Sie die Zeit im 24-Stunden-Format bezogen auf die Ortszeitzone an. Erfolgt keine Angabe, wird der Standardwert 00:00:00 verwendet. Wenn Sie das Datum weglassen, lautet der Standardwert today. Wenn Sie das Jahrhundert, das Jahr oder ein bestimmtes Datum weglassen, wird der aktuellste Wert verwendet. Geben Sie UTC (Coordinated Universal Time) an, wenn die Zeit unabhängig von der Zeitzone auf einen einheitlichen Zeitpunkt gesetzt werden soll. Mit dem Operator plus (+) oder minus (-) können Sie eine positive oder negative Abweichung von der UTC-Zeit angeben. Wenn Sie UTC ohne Stunden- oder Minutenabweichungen angeben, wird als Zeit standardmäßig Westeuropäische Zeit (WEZ) verwendet. Datumsangaben vor dem 1. Januar 1970 (UTC-Zeit) sind ungültig.
Wenn der Fehler auf einem Windows-Host auftritt, auf dem die E-Mail-Benachrichtigung nicht aktiviert ist, wird in der Windows-Ereignisanzeige eine Nachricht angezeigt. Die Nachricht enthält den Wert von e-mail-adresse, der mit dieser Option angegeben wurde, sowie einen Hinweis darauf, dass der Benutzer über den Status der Operation informiert werden sollte.
Site: Aktuelle Site. Wenn auf diesem Host mehrere Sites vorhanden sind, ist –site erforderlich.
Familie: Keine Standardeinstellung; Sie müssen eine Familie angeben.
Schema-Repository-Familie: Der Familienname ist MASTR.
Durchsucht die Speicherpositionen des aktuellen Hosts. Nicht verarbeitete Aktualisierungspakete für Replikate, die diesem Host zugeordnet sind, werden auf die entsprechenden Replikate auf dem Host angewendet. Mit –sclass durchsucht syncreplica nur die Speicherpositionen der angegebenen Speicherklasse.
Wenn syncreplica Replikaterstellungspakete findet, wird eine E-Mail an den Administrator der Zwischenspeicher- und Übertragungsfunktion gesendet. Wenn der aktuelle Host ein Windows-Host und die E-Mail-Benachrichtigung nicht aktiviert ist, wird in der Windows-Ereignisanzeige eine Nachricht angezeigt. Verwenden Sie mkreplica, um diese Replikaterstellungspakete zu importieren.
multiutil syncreplica -export -clan telecomm -site boston_hub
-family SAMPL -user susan -p kennwort -out c:\cqms\sanfran_hub_sync.xml
sanfran_hub
Multiutil: Packet file `c:\cqms\sanfran_hub_sync.xml' generated
multiutil syncreplica -export -clan telecomm -site boston_hub
-family DEV -user susan -p kennwort -maxsize 500mb -workdir c:\work
-ship -sclass cq_default sanfran_hub
Multiutil: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-55-16.xml' generated
multiutil: Shipping order
"C:\temp\cqms\ms_ship\outgoing\sh_o_sync_BOSTON_HUB_26-March-02_
10-55-16.xml" generated.
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: Packet file
`C:\work\sync_BOSTON_HUB_26-March-02_10-56-43.xml' generated
multiutil: Shipping order "C:\cqms\ms_ship\outgoing\sh_o_sync_
BOSTON_HUB_26-March-02_10-56-43.xml" generated.
multiutil: Attempting to forward/deliver generated packets...
multiutil: -- Forwarded/delivered packet
C:\cqms\ms_ship\outgoing\sync_BOSTON_HUB_26-March-02_10-
---- NOTE: consult the NT event log for errors.
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV
-user jcole -p kennwort -receive -sclass cq_storage
Multiutil: 4 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet 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 kennwort c:\cqms\sanfran_hub_sync.xm
Multiutil: 1 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: 2 transactions from boston_hub have been replayed
into the DEV database
Multiutil: Deleting packet c:\cqms\sanfran_hub_sync.xml
multiutil syncreplica -import -clan telecomm -site sanfran_hub
-family DEV -user jcole -p kennwort c:\cqms\sanfran_hub_sync.xml
Multiutil: The UPDATE_PACKET packet sent from boston_hub at
2002-01-22 15:15:50 is destined for schema revision 2, not 1;
re-execute syncreplica after site admin has upgraded database.
Multiutil: 2 transactions from boston_hub have been replayed
into the MASTR database
Multiutil: Preserving packet c:\cqms\sanfran_hub_sync.xml.
multiutil syncreplica -import -clan telecomm -site boston_hub
-family DEV -user susan -p kennwort -receive
Multiutil: 1 transactions from SANFRAN_HUB have been replayed
into the MASTR database
Multiutil: 2 transactions from SANFRAN_HUB have been replayed
into the DEV database
Multiutil: Deleting packet C:\temp\cqms\ms_ship\incoming\sync_
SANFRAN_HUB_07-February-02_11-24-49.xml