yardinit


FUNKTION


Durchführung von Verwaltungstätigkeiten in einem DBS.

SYNTAX



yardinit [ -v ] [ -f ] [ -F ] [ -l ] { [ -q ] -i | -s | -m | -o |
     -c -t <pid> | -V | -a <device> <dbspace-name> <size> <offset> }

BESCHREIBUNG


Das Programm yardinit verwendet die Shellvariable YARDDBS, um den aktuellen DBS Namen (dbsname) zu ermitteln. Prüfen Sie insbesondere bei der Initialisierung eines DBS, daß die Variable den richtigen Wert enthält.

Die einzelnen Optionen haben die folgende Bedeutung:

-i
Das DBS dbsname wird initialisiert. Alle bestehenden Daten auf den Partitionen des DBS werden gelöscht. Dies ist nur bei der Neuanlage eines DBS erforderlich.

-q
Diese Option kann nur bei der Initialisierung eines DBS verwendet werden. Sie verhindert, daß alle Plattenpartitionen bei der Initialisierung auf Festplattenfehler geprüft werden, wodurch sich eine deutliche Zeitersparnis ergibt.

-m
Das DBS dbsname wird in den Maintenance Mode gebracht. Befand sich das DBS vorher im Offline Mode, wird ein Recovery durchgeführt sowie ein Shared-Memory Segment und Semaphoren angelegt. Ein Zugriff auf Datenbanken für reguläre Benutzer ist nicht möglich. Treten während des Recovery Fehler auf, bleibt das DBS im Offline Mode. In diesem Fall können zusätzlich die Optionen -f und -F verwendet werden, um das DBS hochzufahren. Befand sich das DBS vorher im Online Mode, wird die Anmeldung neuer Benutzer verhindert. Das Shared-Memory Segment sowie die Semaphoren bleiben erhalten. Dieser Wechsel ist nur möglich, wenn kein Benutzer mehr an das DBS angemeldet ist.

-o
Das DBS dbsname wird in den Online Mode gebracht. Es muß sich vorher im Maintenance Mode befunden haben. In diesem Mode steht das DBS für alle Benutzer zur Verfügung.

-s
Das DBS dbsname wird in den Offline Mode gebracht. Es muß sich vorher im Maintenance Mode befunden haben. Alle Puffer des Shared-Memory werden auf Platte gespeichert, und das oder die Shared-Memory Segmente sowie die Semaphoren werden gelöscht.

-t
Dem angegebenen Prozeß wird das Signal SIGTERM als Aufforderung zur Beendigung gesendet. Diese Option ist vor allem unter Windows NT sinnvoll. Unter UNIS ist sie gleichbedeutend mit einem kill -SIGTERM <pid>.

-a
Eine neue Partition wird an das Dbspace dbspace-name angehangen (Zeile F der Konfigurationsdatei). Existiert das angegebene Dbspace nicht, so wird es neu angelegt. Diese Option kann nur im Online Mode verwendet werden. Über device muß der absolute Pfadname des Raw-Devices oder des Cooked Files angegeben werden. Werden von dem jeweiligen System keine Raw-Devices unterstützt, kann alternativ zu einem Cooked File auch ein Block-Device verwendet werden. Über size und offset muß die Größe und der Offset in KB angegeben werden.

-c
Ein Checkpoint wird ausgeführt.

-V
Die Version von yardinit wird ausgegeben.

-v
Während der Initialisierung gibt yardinit aus, welches Device gerade initialisiert wird, und wieviel von diesem Device schon initialisiert wurde.

-f
Tritt während des Recovery beim Wechsel vom Offline in den Maintenance Mode ein Fehler auf, bleibt das DBS normalerweise im Offline Mode. Mit dieser Option kann erreicht werden, das trotz eines Fehlers im Recovery der Wechsel in den Maintenance erfolgt.

-F
Durch diese Option wird die Ausführung eines Recovery beim Wechsel vom Offline in den Maintenance Mode umgangen.

Diese Option gefährdet die Datenkonsistenz. Sie sollte nur verwendet werden, wenn ansonsten kein Wechsel in den Maintenance Mode mehr möglich ist. Anschließend sollte über yardtool ein logischer Export aller Datenbanken durchgeführt werden und das DBS nach der Prüfung der exportierten Daten neu initialisiert werden.

-l
Durch diese Option wird die Freigabe aller logischen Logfiles während des Wechsels vom Offline zum Maintenance Mode erreicht, ohne daß diese vorher gesichert wurden. Dies ist sinnvoll, wenn die Logfiles vorher vollgelaufen sind, da sich ein DBS mit vollen Logfiles nicht wieder starten läßt. Diese Option hat nur in Verbindung mit der Option -m eine Wirkung und sollte nur im Notfall verwendet werden. Normalerweise sollte im laufenden Betrieb darauf geachtet werden, daß die Logfiles nicht volllaufen.



VERWEIS


Zur Verwendung von yardinit siehe auch Kapitel 2, Installation, sowie Kapitel 3, YARD-SQL Datenbankserver.


DIAGNOSE


Die Shellvariable YARDHOME muß gesetzt sein.

Die Shellvariable YARDDBS muß gesetzt sein.

Das DBS muß je nach Option im Offline, Maintenance oder Online Mode sein.