scruboplog

Löscht oplog-Einträge für ein Replikat.

Anwendbarkeit

Produkt Befehlstyp
MultiSite Unterbefehl "multiutil"
Plattform
UNIX
Windows

Übersicht

scruboplog

{ [ –cl/an clanname ] [ –site sitename ] | [ –dbset Name_der_Datenbankgruppe ] }
–fam/ily familienname  –u/ser benutzername  –p/assword kennwort
–before { datum-zeit | oplog-ID }

Beschreibung

Einträge des Operationsprotokolls (oplog) müssen über einen längeren Zeitraum im Replikat aufbewahrt werden. Sie werden verwendet, wenn das Replikat Aktualisierungspakete generiert, die an alle anderen Replikate gesendet werden. oplog-Einträge können auch erforderlich sein, um andere Replikate bei der Behebung von Fehlern zu unterstützen.

Von Zeit zu Zeit sollten oplog-Einträge allerdings gelöscht werden, um den Speicherplatz auf dem Festplattenlaufwerk zu optimieren, auf dem sich das Replikat befindet. Ferner kann mit dem Befehl scruboplog das oplog eines Replikats gelöscht werden, das nicht länger verwendet wird.

Obwohl oplog-Einträge nur die Änderungen aufzeichnen, die in einem Replikat vorgenommen wurden, können diese Informationen im Laufe der Zeit genauso viel Platz wie die eigentlichen Daten beanspruchen.

Stellen Sie vor dem Löschen von oplog-Einträgen für ein Replikat sicher, dass diese nicht mehr benötigt werden und die anderen Replikate in der Familie über die Informationen verfügen, die Sie aus dem oplog des Replikats löschen möchten. Außerdem müssen vor dem Löschen von oplogs die Replikate in einer Familie synchronisiert werden.

Sie können auch mit dem Befehl scruboplog Datenbanken bereinigen, die nicht in einer ClearQuest MultiSite-Umgebung implementiert sind, und die ClearQuest Web-Volltextsuchfunktion verwenden.

Einschränkungen

Sie müssen über Superuserberechtigungen verfügen.

Optionen und Argumente

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: Der Familienname ist MASTR.

Datenbankgruppe und Familie angeben

Sie können mit dem Befehl scruboplog Datenbanken bereinigen, die nicht in einer ClearQuest MultiSite-Umgebung implementiert sind, und die ClearQuest Web-Volltextsuchfunktion verwenden.

Standardeinstellung
Datenbankgruppe: ClearQuest-Version.
Familie: Keine Standardeinstellung; Sie müssen eine Familie angeben.
dbset Name_der_Datenbankgruppe
Der Name der Datenbankverbindung.
fam/ily familienname
Benutzerdatenbankfamilie: Der Datenbankname, der bei der Erstellung der Benutzerdatenbank zugeordnet wird.
Schema-Repository-Familie: Der Familienname ist MASTR.

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.

Zu löschende Einträge angeben

Standardeinstellung
Sie müssen die Einträge angeben, die gelöscht werden sollen.
–before { datum-zeit | oplog-ID }
Löscht alle oplog-Einträge vor datum-zeit oder oplog-ID. Das Argument ist schließt oplog-Einträge, die zum angegebenen Datum oder zur angegebenen Zeit erstellt werden, und den oplog-Eintrag mit der angegebenen ID nicht ein. Diese werden nicht gelöscht.

Das Argument oplog-ID muss eine ganze Zahl sein.

Bei Verwendung dieses Befehls müssen Sie ein Jahr angeben, um ein unbeabsichtigtes Löschen von oplogs zu vermeiden. Wenn Sie ein Datum ohne Jahresangabe eingeben, geht dieser Befehl vom aktuellen Kalenderjahr aus; wenn Sie im Februar 2006 beispielsweise versuchen, alle vor dem 19. November 2005 erstellten oplogs zu entfernen und den Eintrag 19-November verwenden, löscht scruboplog alle vor dem 19. November 2006 erstellten oplogs, d. h. auch alle oplogs aus dem aktuellen Jahr (da sie vor November 2006 erstellt wurden).

Verwenden Sie dumpoplog, um das Operationsprotokoll für ein Replikat anzuzeigen. Das Argument datum-zeit kann eines der folgenden Formate aufweisen:

datum.zeit | datum | zeit
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

Beispiele

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

  • Löschen Sie die oplog-Einträge vor dem 21. Januar 2002 für die Familie DEV des Replikats boston_hub.

    multiutil scruboplog -clan telecomm -site boston_hub -family DEV
    -user susan -p passwd -before 21-January-2002

  • Löschen Sie die oplog-Einträge 1 bis 300 für die Familie TEST des Replikats tokyo.

    multiutil scruboplog -clan testing -site tokyo -family TEST
    -user masako -p passwd -before 301

  • Löschen Sie die oplog-Einträge vor dem 1. Januar 2009 für die Benutzerdatenbank PTEST der Datenbankgruppe CLSIC, wobei die Benutzerdatenbank nicht in einer ClearQuest MultiSite-Konfiguration implementiert ist:

    multiutil scruboplog -dbset CLSIC -family PTEST -user susan -p passwd -before 1-January-2009


Feedback