mkreplica

Erstellt ein Replikat.

Anwendbarkeit

Produkt Befehlstyp
MultiSite Unterbefehl "multiutil"
Plattform
UNIX®
Windows®

Übersicht

  • Eine vorhandene Datenbank duplizieren, wobei ein neues Replikatobjekt und ein Replikaterstellungspaket generiert werden:
    mkrep/lica

    –exp/ort[
    –cl/an clanname ] [ –site sitename ] –fam/ily familienname
    –u/ser benutzername [ –p/assword] kennwort
    [–max/size größe ] [–c/omments kommentare ]
    [–size id-blockgröße ] [ –thres/hold id-block-schwellenwert ]
    {
    {–sh/ip | –fsh/ip} -wor/kdir pname-für-temporäres-verzeichnis
    [–sc/lass speicherklasse ]
    [ –pex/pire datum-zeit ]
    [–not/ify e-mail-adresse ]
    | –out pname-der-paketdatei } hostname:sitename...

  • Replikaterstellungspaket importieren, um ein neues Benutzerdatenbankreplikat und ein neues Schema-Repository-Replikat zu erstellen:
    mkrep/lica

    –imp/ort
    { –site sitename–repo/sitory datenbankinfo [ –vendor
    vendor-type ] datenbankparameter
    }
    { [ –data/base datenbankinfo [ –vendor anbietertyp ] datenbankparameter
    [ –c/omments kommentare ] { pname-der-paketdatei|paketverzeichnispfad }...

  • Replikaterstellungspaket importieren, um ein neues Replikat in demselben Clan wie das vorhandene Schema-Repository auf der aktuellen Site zu erstellen:
    mkrep/lica

    –imp/ort {
    [–cl/an clanname ] [ -site sitename ] –u/ser benutzername
    [–p/assword ] kennwort { –data/base datenbankinfo
    [ –vendor anbietertyp ] datenbankparameter
    [ –c/omments kommentare ] { pname-der-paketdatei|paketverzeichnispfad }...

Beschreibung

Anmerkung: Vor der Replikation der ersten Datenbank in einem Clan müssen Sie die Datenbankgruppe aktivieren, zu der die Datenbank gehört. Ferner sollten Sie ein Upgrade der zu replizierenden Datenbanken auf die neueste Schemaversion durchführen.

Die Ausführung des Befehls mkreplica –export kann längere Zeit dauern. Die Datenbank und das Schema-Repository sind während des Exports gesperrt. Stellen Sie vor Ausführung von mkreplica –export sicher, dass alle Benutzer abgemeldet sind.

Die Erstellung eines neuen Replikats ist ein Prozess in drei Phasen:

  1. Mit dem Befehl mkreplica –export wird der Inhalt der angegebenen Benutzerdatenbank und des zugeordneten Schema-Repositorys dupliziert. Auf diese Weise wird ein logisches Replikaterstellungspaket generiert, das an eine oder mehrere andere Sites übertragen wird. Ein logisches Paket kann in mehrere physische Pakete unterteilt werden. Bei Verwendung von –fship oder –ship generiert mkreplica außerdem für jedes physische Paket eine Versandauftragsdatei.
    Anmerkung: Die Erstellung mehrerer Replikate mit einem mkreplica –export-Befehl ist effizienter als die Verwendung mehrerer Befehle des Typs mkreplica –export.
  2. Das Paket wird an eine oder mehrere andere Sites gesendet.
  3. Auf jeder Empfangssite überprüft der Befehl mkreplica –import zunächst, ob das Replikaterstellungspaket von einem System mit identischer Betriebssystemcodepage exportiert wurde. Wenn die Codepages der Export- und der Importkomponente nicht übereinstimmen, wird das neue Replikat nicht erstellt. Wenn eine Übereinstimmung vorliegt, verwendet der Befehl –import das Replikaterstellungspaket zur Erstellung eines neuen Replikats. Das neue Replikat besteht aus zwei replizierten Datenbanken, einem Schema-Repository und einer Benutzerdatenbank. Der Befehl variiert, wenn Sie einer Familie ein Benutzerdatenbankreplikat hinzufügen, das sich im selben Clan wie ein vorhandenes Schema-Repositorys befindet.

Leere Anbieterdatenbanken erstellen

Auf jeder neuen Site muss der Administrator leere Anbieterdatenbanken für die Replikatdaten erstellen. Wenn es sich um das erste Replikat auf der neuen Site handelt, werden mindestens zwei leere Anbieterdatenbanken benötigt, eine für das Schema-Repository-Replikat und eine für das Benutzerdatenbankreplikat.

Anmerkung: Wenn Sie einer vorhandenen Site ein neues Benutzerdatenbankreplikat hinzufügen, müssen Sie keine Anbieterdatenbank für das Schema-Repository erstellen. Sie können das neue Benutzerdatenbankreplikat dem vorhandenen Schema-Repository auf Ihrer Site zuordnen.

oplog-Informationen

Bei der ersten Replikation einer Datenbank wird das Operationsprotokoll der Datenbank (oplog) aktiviert. Alle zu replizierenden Operationen werden im oplog aufzeichnet. Die Protokollierung von Operationen wird fortgesetzt, bis alle Replikate gelöscht sind und nur die ursprüngliche Datenbankgruppe übrig ist. Die Erstellung zusätzlicher Replikate wird in oplog-Einträgen aufgezeichnet. Vorhandene Replikate werden über den Standardsynchronisationsmechanismus über ein neues Replikat informiert.

Anmerkung: Stellen Sie vor Eingabe des Befehls mkreplica –export sicher, dass auf der ursprünglichen Site MultiSite-Lizenzen installiert sind. Nach Aktivierung der ursprünglichen Datenbankgruppe kann der Entwickler ohne eine MultiSite-Lizenz (zusätzlich zu einer Rational ClearQuest-Lizenz) nicht auf die Datenbankgruppe zugreifen. Zur Ausführung von mkreplica –export ist ebenfalls eine MultiSite-Lizenz erforderlich.

ID-Blöcke einem Replikat zuordnen

MultiSite legt fest, wie viele Satz-IDs jedem Replikat zugeordnet werden. Diese Zuordnung erfolgt mit Hilfe von ID-Blöcken (ID-Gruppen).

Jedem Replikat wird bei der Erstellung ein ID-Block mit 4096 IDs zugeordnet. Wenn ein Replikat den Schwellenwert von 1024 verbleibenden IDs erreicht, wird ein weiterer Block mit 4096 IDs zugeordnet. Dadurch soll sichergestellt werden, dass alle IDs eindeutig sind. Die Zuordnung von ID-Blöcken erfolgt während der Synchronisation intern über das aktive Schema-Repository.

Je nach Auslastungsgrad einer Replikatfamilie kann es hilfreich sein, die Größe der ID-Blöcke zu erhöhen, die einem Replikat zugeordnet sind. Wenn Sie beispielsweise mit den Standardeinstellungen versuchen, eine große Anzahl von Fehlern zu übergeben, werden die ersten 4096 erfolgreich übergeben; alle weiteren Übergaben schlagen jedoch fehl.

Bei der Erstellung eines Replikats mit dem Befehl mkreplica –export können Sie mit der Option –size (in Verbindung mit der Option –threshold) festlegen, wie viele IDs einem Replikat zugeordnet werden. Diese Einstellungen können mit dem Befehl chreplica modifiziert werden.

Replikaterstellungspakete

Mit jedem Aufruf von mkreplica –export wird ein logisches Replikaterstellungspaket erstellt. Das trifft auch dann zu, wenn mit einem mkreplica-Befehl mehrere neue Replikate erstellt werden. Jedes Paket enthält mindestens eine Replikatspezifikation, die den Namen des neuen Replikats und den Synchronisationsserver angibt, der dem neuen Replikat zugeordnet ist.

Die Benutzerdatenbank und das Schema-Repository sind während der Exportphase gesperrt.

Mit der Option –maxsize wird ein logisches Paket in mehrere physische Pakete aufgeteilt, um den Einschränkungen des Übertragungsmediums Rechnung zu tragen.

Wiederherstellung nach fehlgeschlagenen Importen

Wenn der Import eines Replikats unterbrochen wird oder aus irgendeinem Grund fehlschlägt (z. B. aufgrund eines Stromausfalls), müssen Sie die Anbieterdatenbanken löschen, neue Anbieterdatenbanken für die fehlgeschlagene Importoperation erstellen und mkreplica –import erneut ausführen.

Es ist möglich, dass der Import des Schema-Repositorys erfolgreich ist, der Import des Benutzerdatenbankreplikats jedoch fehlschlägt. In diesem Fall müssen Sie die für das Benutzerdatenbankreplikat vorgesehene Anbieterdatenbank löschen und erneut erstellen.

Verwendete Pakete bereinigen

Replikaterstellungspakete werden nach dem Import nicht gelöscht. Nach dem Import eines Replikaterstellungspakets mit mkreplica –import muss das Paket gelöscht werden.

Fehlerbehebung bei Paketübermittlungsfehlern

Wenn ein Paket nicht übermittelt werden kann, wird es über die Zwischenspeicher- und Übertragungsfunktion an den Administrator der Site des ursprünglichen Replikats zurückgesendet. 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.

Einschränkungen

Sperren: Dieser Befehl schlägt fehl, wenn die Datenbank gesperrt ist (z. B. während des Upgradeprozesses) oder wenn eine andere Rational ClearQuest MultiSite-Operation ausgeführt wird.

Sonstige: Eine Datenbank kann nicht für einen Host repliziert werden, der mit einer anderen Version von MultiSite ausgeführt wird. Der Befehl mkreplica –export kann auf jeder Site ausgeführt werden, Sie sollten den Befehl jedoch immer auf der Site des aktiven Schema-Repositorys ausführen, um die Erstellung mehrerer Sites mit demselben Namen zu vermeiden.

Optionen und Argumente: Exportphase

Clan, Site und Familie angeben

Standardeinstellung
Clan: Der erste Clan, der auf dieser Site repliziert wird. Wenn für diesen Host mehrere dbset-Verbindungen registriert sind, ist –clan erforderlich.

Site: Aktuelle Site. Wenn auf diesem Host mehrere Sites vorhanden sind, ist –site erforderlich.

Familie: Keine Standardeinstellung; Sie müssen eine Familie angeben.

–cl/an clanname
Der Name für den Clan des Replikats.
–site sitename
Der Name für die Site des Replikats.
–fam/ily familienname
Benutzerdatenbankfamilie: Der Datenbankname, der bei der Erstellung der Benutzerdatenbank zugeordnet wurde.

Schema-Repository-Familie: Nicht zutreffend. Bei der Ausführung des Befehls mkreplica wird das der angegebenen Benutzerdatenbankfamilie zugeordnete Schema-Repository in das Replikaterstellungspaket eingefügt.

Standardeinstellung: Keine.

Benutzernamen und Kennwort angeben

Standardeinstellung
Sie müssen einen Benutzernamen und ein Kennwort angeben.
–u/ser benutzer
Der Name eines Benutzers mit Superuserberechtigungen.
–p/assword kennwort
Das dem angegebenen Benutzer zugeordnete Kennwort.

Größe des Replikaterstellungspakets angeben

Standardeinstellung
Wird –maxsize nicht angegeben, hängt die Standardpaketgröße von der Art des Versands ab:
  • Mit –ship oder –fship erstellte Pakete sind nicht größer als die in der MultiSite-Steuerkonsole angegebene maximale Paketgröße.
  • Mit –out erstellte Pakete sind nicht größer als 2 GB.

    Der Befehl mkreplica schlägt fehl, wenn versucht wird, ein Paket zu erstellen, dessen Größe die vom System unterstützte Größe übersteigt.

–max/size größe
Die maximale Größe eines physischen Pakets, ausgedrückt als Zahl gefolgt von einem Buchstaben. Beispiel:
500k
500 Kilobyte
20m
20 Megabyte
1,5g
1,5 Gigabyte

Kommentar angeben

Standardeinstellung
Keine.
–c/omments kommentare
Kommentare, die zusammen mit den Informationen zum Replikat gespeichert werden sollen.

ID-Blockzuordnung angeben

Standardeinstellung
ID-Blockgröße: 4096. ID-Block-Schwellenwert: 25 Prozent.
–size id-blockgröße
Die Größe des ID-Blocks. Sie können eine Zahl zwischen 1 und 1023 eingeben. Der Wert von id-blockgröße wird mit 100 multipliziert, um die tatsächliche ID-Blockgröße zu erhalten. Wenn Sie beispielsweise einen ID-Block von 30.000 angeben möchten, verwenden Sie die Zahl 300; wenn Sie einen ID-Block von 25.000 angeben möchten, verwenden Sie die Zahl 250.
–thres/hold id-block-schwellenwert
Die Anzahl der Satz-IDs, die dem Replikat zugeordnet werden. id-block-schwellenwert wird als ganze Zahl angegeben, die einen Prozentsatz darstellt. Sie können eine Zahl zwischen 1 und 63 eingeben. Wenn die Anzahl der verbleibenden Satz-IDs, die verwendet werden sollen, den angegebenen Prozentsatz für die aktuelle ID-Blockgröße unterschreitet, wird ein zusätzlicher Block zugeordnet.

Disposition des Replikaterstellungspakets

Standardeinstellung
Keine. Sie müssen angeben, wie das mit mkreplica –export erstellte Replikaterstellungspaket gespeichert und an andere Sites übertragen werden soll.
–shi/p –fsh/ip
Speichert das Replikaterstellungspaket in mindestens einer Datei in einer Speicherposition der Zwischenspeicher- und Übertragungsfunktion. Jedes physische Paket wird von einer separaten Versandauftragsdatei begleitet, die angibt, wie und wo die Übermittlung erfolgen soll.

–fship (force ship) ruft shipping_server auf, um das Replikaterstellungspaket zu senden. –ship speichert das Paket in einer Speicherposition. Rufen Sie shipping_server auf, um das Paket zu senden.

Der verfügbare Speicherplatz auf der Plattenpartition, auf der sich die Speicherposition befindet (auf dem Sende- und auf dem Empfangshost) muss größer gleich der Größe des Replikaterstellungspakets sein.

–wor/kdir temporäres-verzeichnis
Ein Verzeichnis, das von mkreplica als temporärer Arbeitsbereich verwendet wird; dieses Verzeichnis wird bei der Beendigung von mkreplica gelöscht. Dieses Verzeichnis darf noch nicht vorhanden sein.
–sc/lass speicherklasse
Gibt die Speicherklasse des Pakets und den Versandauftrag an. mkreplica sucht in der MultiSite-Steuerkonsole (Windows) oder in der Datei shipping.conf (Linux und UNIX) nach der Speicherklasse, um die Position der zu verwendenden Speicherposition zu bestimmen.

Standardeinstellung: mkreplica speichert das Paket in der Speicherposition, die für die Klasse cq_default angegeben wird.

–out pname-der-paketdatei
Der Name des ersten physischen Replikaterstellungspakets. Zusätzliche Pakete werden in den Dateien pname-der-paketdatei_2, pname-der-paketdatei_3 usw. gespeichert.

Die Replikaterstellungspakete werden nicht automatisch übermittelt; verwenden Sie hierzu eine geeignete Methode. Sie können ein Paket mit –out erstellen und dieses anschließend mit Hilfe der Zwischenspeicher- und Übertragungsfunktion übermitteln.

Vorgehensweise bei Paketübermittlungsfehlern

Standardeinstellung
Wenn ein Paket nicht übermittelt werden kann, wird es über die Zwischenspeicher- und Übertragungsfunktion an den Administrator der Site des ursprünglichen Replikats 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.
–pex/pire datum-zeit
Gibt an, zu welchem Zeitpunkt die Zwischenspeicher- und Übertragungsfunktion die Paketübermittlungsversuche einstellt und eine E-Mail-Nachricht bezüglich des Fehlers generiert. Diese Option setzt den Verfallszeitraum für die Speicherklasse in der Datei shipping.conf (Linux und UNIX) oder in der MultiSite-Steuerkonsole (Windows) außer Kraft.

Das Argument datum-zeit kann eines der folgenden Formate aufweisen:

datum.zeit | datum | zeit | now
Dabei gilt Folgendes:
datum:
= wochentag | langes-datum
zeit:
= h[h]:m[m][:s[s]] [UTC [ [ + | - ]h[h][:m[m] ] ] ]
wochentag:
= today |yesterday |Sunday | ... |Saturday |Sun | ... |Sat
langes-datum:
= t[t]monat[[jj]jj]
monat:
= January |... |December |Jan |... |Dec

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.

Beispiele:
  • 22-November-2002
  • sunday
  • yesterday.16:00
  • 0
  • 8-jun
  • 13:00
  • today
  • 9-Aug.10:00UTC
–not/ify e-mail-adresse
Die Übermittlungsfehlernachricht wird an die angegebene E-Mail-Adresse gesendet.

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.

Replikatspezifikationen

Standardeinstellung
Keine.
hostname:sitename...
Ein oder mehrere Argumente, die jeweils ein neues Replikat angeben, das anhand dieses Pakets auf einer anderen Site erstellt werden soll.
hostname
Der Synchronisationsserver für das neue Replikat. hostname muss für Hosts in unterschiedlichen Domänen verwendbar sein. Anhand dieses Servers legt der Zwischenspeicher- und Übertragungsmechanismus fest, wie Aktualisierungspakete an das Replikat weitergeleitet werden. Achten Sie darauf, dass diese Angaben stets korrekt sind, auch wenn Ihre Site die Zwischenspeicher- und Übertragungsfunktion nicht verwendet.

hostname kann entweder die IP-Adresse des Hosts oder der Computername (z. B. minuteman) sein. Es wäre möglich, dass Sie einen IP-Domänennamen anfügen müssen, z. B. minuteman.purpledoc.com.

Verwenden Sie unter Linux und UNIX den Befehl uname –n, um den Computernamen anzuzeigen. Unter Windows kann der Computername über das Symbol System in der Systemsteuerung aufgerufen werden. Klicken Sie unter Windows 2000 auf die Registerkarte Netzwerkidentifikation. Klicken Sie unter Windows NT® Server 2003 auf die Registerkarte Computername.

sitename
Der Name, mit dem das Replikat in multiutil-Befehlen angegeben wird. Der Sitename muss eine Kennung sein und kann aus maximal 50 Zeichen bestehen. Dieser Name muss innerhalb des jeweiligen Clans eindeutig sein: in einem Clan können zwei Sites nicht denselben Namen haben.

Optionen und Argumente: Importphase für Schema-Repositorys und Benutzerdatenbanken

Site und Datenbankinformationen angeben

Standardeinstellung
Keine.
–site sitename
Der Name der Site, in die das Replikat importiert wird. Der Sitename wurde dem Replikat beim Export zugeordnet. Wenn Sie den Sitenamen nicht kennen, wenden Sie sich an den Administrator der exportierenden Site.
–repo/sitory datenbankinfo
Die Datenbankinformationen für die verwendete Anbieterdatenbank.
Anbieterdatenbank
Wert für "datenbankinfo"
DB2
Datenbankname
Oracle
SID (Oracle-System-ID)
SQL Server
Name der physischen Datenbank
–vendor anbietertyp
Der verwendete Datenbankanbieter. Die folgenden Anbietertypen werden unterstützt: DB2, ORACLE und SQL_SERVER.
datenbankparameter
Die erforderlichen Datenbankparameter sind dieselben Parameter, die für die Verbindung mit einer Rational ClearQuest-Datenbank erforderlich sind. Notieren Sie diese Parameter bei der Erstellung der Anbieterdatenbank, in die das Replikat importiert wird.

Beim Import eines Replikats müssen Sie die Datenbankparameter der Anbieterdatenbank für das Schema-Repository-Replikat und der Anbieterdatenbank für das Benutzerdatenbankreplikat angeben. Sie müssen diese Datenbanken vor dem Import eines Replikatpakets erstellen.

Anbieterdatenbank
Wert für "datenbankparameter"
DB2
–server servername –dbologin name-des-datenbankeigners [ kennwort-des-datenbankeigners ] [–connectopts verbindungsoptionen ]
Oracle
–server servername –dbologin name-des-datenbankeigners kennwort-des-datenbankeigners [–connectopts verbindungsoptionen ]
SQL Server
–server servername –dbologin name-des-datenbankeigners [ kennwort-des-datenbankeigners ] [–connectopts verbindungsoptionen ]
–data/base datenbankinfo
Die Benutzerdatenbankinformationen für die verwendete Anbieterdatenbank.
Anbieterdatenbank
Wert für "datenbankinfo"
DB2
Datenbankname
Oracle
SID (Oracle-System-ID)
SQL Server
Name der physischen Datenbank
–c/omments kommentare
Kommentare, die zusammen mit den Informationen zum Replikat gespeichert werden sollen.

Position des Replikaterstellungspakets angeben

Standardeinstellung
Keine.
pname-der-paketdatei | paketverzeichnispfad...
Gibt den Pfadnamen für ein Replikaterstellungspaket an. Bei einem logischen Paket, das auf mehrere Plattendateien aufgeteilt ist, durchsucht mkreplica das Verzeichnis mit pname-der-paketdatei auf zugehörige physische Pakete.

Wenn Sie außerdem ein oder mehrere Argumente vom Typ paketverzeichnispfad angeben, sucht mkreplica in diesen Verzeichnissen nach zusätzlichen Paketen.

Optionen und Argumente: Importphase nur für Benutzerdatenbanken

Wenn Sie einem vorhandenen Clan eine Benutzerdatenbankfamilie hinzufügen, müssen Sie nur für das Benutzerdatenbankreplikat eine Anbieterdatenbank erstellen.

Clan und Site angeben

Standardeinstellung
Clan: Der erste Clan, der auf dieser Site repliziert wird. Wenn für diesen Host mehrere dbset-Verbindungen registriert sind, ist –clan erforderlich.

Site: Aktuelle Site. Wenn auf diesem Host mehrere Sites vorhanden sind, ist –site erforderlich.

–cl/an clanname
Der Name für den Clan des Replikats.
–site sitename
Der Name für die Site des Replikats.

Benutzernamen und Kennwort angeben

Standardeinstellung
Sie müssen einen Benutzernamen und ein Kennwort angeben.
–u/ser benutzer
Der Name eines Benutzers mit Superuserberechtigungen.
–p/assword kennwort
Das dem angegebenen Benutzer zugeordnete Kennwort.

Datenbankinformationen angeben

–data/base datenbankinfo
Die Benutzerdatenbankinformationen für die verwendete Anbieterdatenbank.
–vendor anbietertyp datenbankparameter
Geben Sie den verwendeten Datenbankanbieter ein. Die folgenden Anbietertypen werden unterstützt: DB2, ORACLE und SQL_SERVER.
Wenn –vendor == DB2,
datenbankinfo := Aliasname der Datenbank (IBM® Treiber) oder Datenbankname (DataDirect-Treiber)
datenbankparameter := -server servername
-dbo/login name-des-datenbankeigners [ kennwort-des-datenbankeigners ]
[ -con/nectopts verbindungsoptionen ]
Wenn –vendor == ORACLE,
datenbankinfo := Oracle-SID
datenbankparameter := -server servername
-dbo/login name-des-datenbankeigners [ kennwort-des-datenbankeigners ]
[ -con/nectopts verbindungsoptionen ]
Wenn –vendor == SQL_SERVER,
datenbankinfo := Name der physischen Datenbank
datenbankparameter := -server servername
-dbo/login name-des-datenbankeigners [ kennwort-des-datenbankeigners ]
[ -con/nectopts verbindungsoptionen ]

datenbankinfo und datenbankparameter für DB2, Oracle und Microsoft SQL Server angeben

Jeder Datenbankanbieter verfügt über eine Standardportnummer:

Tabelle 1. Standardportnummern der Datenbankanbieter
Anbieter Standardport
DB2 50000
Oracle 1521
Microsoft SQL Server 1433

Wenn Ihre Datenbank einen anderen Port verwendet, müssen Sie diesen im Parameter verbindungsoptionen angeben. Wenn Sie beispielsweise eine Oracle-Datenbank an Port 1526 verwenden, geben Sie den folgenden Befehl ein:

multiutil mkreplica -imp -site SITEA -repo CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_1 admin_1 -con PORT=1526 -data CQDEV -server cqsvr3 -vendor ORACLE -dbo admin_2 admin_2 -con PORT=1526 C:\TEMP\admin\mk_SITEA.xml

Wichtiger Hinweis: Weitere Informationen zu unterstützten Werten für Anbieterdatenbanken finden Sie unter "Eigenschaften für Anbieterdatenbanken" im Abschnitt "Rational ClearQuest verwalten" der Hilfe.

–c/omments kommentare
Kommentare, die zusammen mit den Informationen zum Replikat gespeichert werden sollen. Diese Kommentare werden in der Schema-Repository-Datenbank auf der importierenden Site gespeichert und in Rational ClearQuest Designer im Fenster für Datenbankeigenschaften angezeigt.

Position des Replikaterstellungspakets angeben

pname-der-paketdatei|paketverzeichnispfad...
Gibt den Pfadnamen für ein Replikaterstellungspaket an. Bei einem logischen Paket, das auf mehrere Plattendateien aufgeteilt ist, durchsucht mkreplica das Verzeichnis mit pname-der-paketdatei auf zugehörige physische Pakete.

Wenn Sie außerdem ein oder mehrere Argumente vom Typ paketverzeichnispfad angeben, sucht mkreplica in diesen Verzeichnissen nach zusätzlichen Paketen.

Standardeinstellung: Keine.

Beispiele

In den folgenden Beispielen wurden die Zeilen zur besseren Lesbarkeit aufgeteilt. Jeder Befehl muss in einer einzelnen Zeile eingegeben werden.

Exporte

  • Generieren Sie im Replikat boston_hub ein Replikaterstellungspaket für die Familie DEV, um ein neues Replikat mit dem Namen sanfran_hub zu erstellen. Der Synchronisationsserver für das neue Replikat ist goldengate.

    multiutil mkreplica -export -clan telecomm -site boston_hub -family DEV
    -u susan -p kennwort -out c:\cqms\boston_hub.xml goldengate:sanfran_hub

    Multiutil: Packet file `c:\cqms\boston_hub.xml' generated

  • Generieren Sie im Replikat boston_hub ein Paket, das beim Import in das Replikat sanfran_hub ein Replikat der Datenbank der LAB-Familie erstellt.

    multiutil mkreplica -export -clan telecomm -site boston_hub -family LAB
    -user susan -p kennwort -out c:\cqms\lab.xml goldengate:sanfran_hub

    Multiutil: Packet file `c:\cqms\lab.xml' generated

  • Generieren Sie im Replikat tokyo ein Replikaterstellungspaket für das Replikat sydney, und geben Sie –fship zur umgehenden Weiterleitung des Pakets an.

    multiutil mkreplica -export -clan testing -site tokyo -family TEST
    -user masako -p kennwort -fship -workdir c:\cqms\working -sclass
    cq_default taronga:sydney

    Multiutil: Packet file
    `c:\cqms\working\mk_TOKYO_29-January-02_09-47-27.xml' generated
    multiutil: Shipping order
    "C:\temp\cqms\ms_ship\outgoing\sh_o_mk_TOKYO_29-January-02_09-47-27.xml"
    generated.
    multiutil: Attempting to forward/deliver generated packets...
    multiutil:   -- Forwarded/delivered packet
    C:\temp\cqms\ms_ship\outgoing\mk_TOKYO_29-January-02_09-4

  • Wie das vorherige Beispiel, aber speichern Sie die Paketdatei in einer Speicherposition, um sie zu einem späteren Zeitpunkt mit Hilfe der Zwischenspeicher- und Übertragungsfunktion zu versenden.

    multiutil mkreplia -export -clan telecomm -site boston_hub -family DEV
    -user susan -password kennwort -c "make a new replica for sanfran_hub"
    -ship -workdir c:\temp\working -sclass cq_default
    -pexpire 22-November-2003
    goldengate:sanfran_hub

Importe

  • Importieren Sie das neue Datenbankreplikat sanfran_hub und das zugehörige Schema-Repository-Replikat in SQL Server-Datenbanken.

    multiutil mkreplica -import -site sanfran_hub
    -repository sanfran_schemarepo
    -vendor SQL_SERVER -server sb_server -dbologin jcole kennwort
    -database sanfran_userdb -vendor SQL_SERVER
    -dbologin jcole kennwort

  • Importieren Sie ein neues Benutzerdatenbankreplikat, das zur Site sydney gehört, in den Clan testing. Das neue Benutzerdatenbankreplikat wird in eine SQL Server-Datenbank importiert.

    multiutil mkreplica -import -clan testing -site sydney -user bfife
    -p kennwort -database syd_userdb -vendor SQL_SERVER
    -dbologin bfife kennwort


Feedback