Skip to main content
Die deutsche Sprachversion wurde als Serviceleistung für Sie durch maschinelle Übersetzung erstellt. Bei eventuellen Unstimmigkeiten hat die englische Sprachversion Vorrang.

Von ONTAP unterstützte Umgebungsvariablen

Beitragende
PDFs

Umgebungsvariablen dienen der Kommunikation von Informationen zu Backup- oder Wiederherstellungsvorgang zwischen einer NDMP-fähigen Backup-Applikation und einem Storage-System. ONTAP unterstützt Umgebungsvariablen, die einen zugeordneten Standardwert haben. Sie können diese Standardwerte jedoch manuell ändern.

Wenn Sie die von der Backup-Anwendung festgelegten Werte manuell ändern, verhält sich die Anwendung möglicherweise unvorhersehbar. Dies liegt daran, dass die Sicherungs- oder Wiederherstellungsvorgänge möglicherweise nicht das tun, was die Backup-Anwendung von ihnen erwartet hatte. In einigen Fällen kann jedoch eine vernünftige Änderung dazu beitragen, Probleme zu erkennen oder zu umgehen.

In den folgenden Tabellen sind die Umgebungsvariablen aufgeführt, deren Verhalten bei Dump und SMTape häufig der Einsatz ist, sowie die Variablen, die nur für Dump und SMTape unterstützt werden. Die Tabellen enthalten zudem eine Beschreibung der Arbeitsweise der durch ONTAP unterstützten Umgebungsvariablen, wenn diese verwendet werden:

Hinweis

In den meisten Fällen, Variablen, die den Wert haben, Y auch T N akzeptieren und auch akzeptieren F.

Umgebungsvariablen werden für Dump und SMTape unterstützt

Umgebungsvariable Gültige Werte Standard Beschreibung

DEBUGGEN

Y Oder N

N

Gibt an, dass Debugging-Informationen gedruckt werden.

DATEISYSTEM

string

none

Gibt den Pfadnamen des Stammes der zu sichernden Daten an.

NDMP_VERSION

return_only

none

Die Variable NDMP_VERSION sollte nicht geändert werden. Die durch den Backup-Vorgang erstellte Variable NDMP_VERSION liefert die NDMP-Version zurück.

ONTAP legt die Variable NDMP_VERSION während eines Backups zur internen Verwendung fest und gibt die Variable zu Informationszwecken an eine Backup-Applikation weiter. Die NDMP-Version einer NDMP-Sitzung ist nicht mit dieser Variable festgelegt.

PFADNAME_TRENNZEICHEN

return_value

none

Gibt das Trennzeichen für den Pfadnamen an.

Dieses Zeichen hängt vom zu sichernden Dateisystem ab. Bei ONTAP wird dieser Variable das Zeichen „/“ zugewiesen. Der NDMP-Server setzt diese Variable vor dem Start einer Bandsicherung.

TYP

dump Oder smtape

dump

Gibt den Typ der unterstützten Sicherung an, der die Sicherung und Wiederherstellung von Bandmedien durchführen soll.

VERBOSE

Y Oder N

N

Erhöht die Protokollmeldungen bei einer Bandsicherung oder -Wiederherstellung.

Umgebungsvariablen werden für Dump unterstützt

Umgebungsvariable Gültige Werte Standard Beschreibung

ACL_START

return_only

none

Die Variable ACL_START wird durch den Backup-Vorgang erstellt und ist ein Offset-Wert, der von einer Wiederherstellung durch direkten Zugriff oder einer erneuerbaren NDMP-Sicherungsoperation verwendet wird.

Der Offset-Wert ist der Byte-Offset in der Dump-Datei, in der die ACL-Daten (Pass V) beginnen und am Ende einer Sicherung zurückgegeben werden. Für eine Wiederherstellung der gesicherten Daten durch direkten Zugriff muss der ACL_START-Wert beim Start an den Wiederherstellungsvorgang übergeben werden. Ein neu startbarer NDMP-Backup-Vorgang verwendet den ACL_START-Wert, um mit der Backup-Applikation zu kommunizieren, wo der Einwegteil des Backup-Streams beginnt.

BASE_DATE

0, -1 Oder DUMP_DATE Wert

-1

Gibt das Startdatum für inkrementelle Backups an.

Wenn auf festgelegt -1, ist der inkrementelle Spezifikator BASE_DATE deaktiviert. Wenn Sie auf 0 ein Backup der Ebene 0 setzen, werden inkrementelle Backups aktiviert. Nach der ersten Sicherung wird der Wert der DUMP_DATE-Variable aus dem vorherigen inkrementellen Backup der VARIABLE BASE_DATE zugewiesen.

Diese Variablen sind eine Alternative zu DEN LEVEL-/UPDATE-basierten inkrementellen Backups.

DIREKT

Y Oder N

N

Gibt an, dass ein Restore schnell direkt an den Speicherort auf dem Band weiterleiten soll, in dem sich die Dateidaten befinden, anstatt das gesamte Tape zu scannen.

Damit die direkte Wiederherstellung des Zugriffs funktioniert, muss die Backup-Anwendung Informationen zur Positionierung bereitstellen. Wenn diese Variable auf eingestellt Y ist, gibt die Backup-Anwendung die Datei- oder Verzeichnisnamen und die Positionierungsinformationen an.

DMP_NAME

string

none

Gibt den Namen für eine Sicherung mehrerer Unterstrukturen an.

Diese Variable ist für mehrere Unterbaumsicherungen obligatorisch.

DUMP_DATE

return_value

none

Diese Variable wird nicht direkt geändert. Sie wird durch das Backup erzeugt, wenn die Variable BASE_DATE auf einen anderen Wert als gesetzt ist -1.

Die DUMP_DATE-Variable wird abgeleitet, indem der 32-Bit-Wert auf einen 32-Bit-Zeitwert vorsteht, der von der Dump-Software berechnet wird. Der Level wird von dem letzten Level-Wert erhöht, der in DIE VARIABLE BASE_DATE übergeben wurde. Der resultierende Wert wird als BASIS_DATE-Wert für ein nachfolgender inkrementeller Backup verwendet.

ENHANCED_DAR_ENABLED

Y Oder N

N

Gibt an, ob die erweiterte DAR-Funktion aktiviert ist. Die verbesserte DAR-Funktion unterstützt das Verzeichnis DAR und DAS DATEN von Dateien mit NT-Streams. Sie bietet Performance-Verbesserungen.

Verbessertes DAR während der Wiederherstellung ist nur möglich, wenn die folgenden Bedingungen erfüllt sind:

  • ONTAP unterstützt erweiterte DAR-Funktionen.

  • Der Dateiverlauf ist während der Sicherung aktiviert (HIST=Y).

  • Die ndmpd.offset_map.enable Option ist auf eingestellt on.

  • DIE Variable ENHANCED_DAR_ENABLED wird Y während der Wiederherstellung auf festgelegt.

AUSSCHLIESSEN

pattern_string

none

Gibt Dateien oder Verzeichnisse an, die beim Sichern von Daten ausgeschlossen sind.

Die Ausschlussliste ist eine kommagetrennte Liste von Datei- oder Verzeichnisnamen. Wenn der Name einer Datei oder eines Verzeichnisses mit einer der Namen in der Liste übereinstimmt, wird sie von der Sicherung ausgeschlossen.

Beim Angeben von Namen in der Ausschlussliste gelten die folgenden Regeln:

  • Der genaue Name der Datei oder des Verzeichnisses muss verwendet werden.

  • Das Sternchen (*), ein Platzhalterzeichen, muss entweder das erste oder das letzte Zeichen des Strings sein.

    Jeder String kann bis zu zwei Sternchen haben.

  • Einem Komma in einem Datei- oder Verzeichnisnamen muss ein umgekehrter Schrägstrich vorangestellt werden.

  • Die Ausschlussliste kann bis zu 32 Namen enthalten.

Hinweis

Dateien oder Verzeichnisse, die für die Sicherung ausgeschlossen werden sollen, werden nicht ausgeschlossen, wenn Sie NON_QUOTA_TREE auf Y gleichzeitig setzen.

EXTRAHIEREN

Y, N Oder E

N

Gibt an, dass Substrukturen eines gesicherten Datensatzes wiederhergestellt werden sollen.

Die Backup-Anwendung gibt die Namen der zu extrahierenden Unterstrukturen an. Wenn eine angegebene Datei einem Verzeichnis entspricht, dessen Inhalt gesichert wurde, wird das Verzeichnis rekursiv extrahiert.

Um eine Datei, ein Verzeichnis oder einen qtree während der Wiederherstellung ohne Verwendung von DAR umzubenennen, müssen Sie die Umgebungsvariable EXTRAHIEREN auf einstellen E.

EXTRAHIEREN_ACL

Y Oder N

Y

Gibt an, dass ACLs aus der gesicherten Datei bei einem Wiederherstellungsvorgang wiederhergestellt werden.

Standardmäßig werden ACLs beim Wiederherstellen von Daten wiederhergestellt, mit Ausnahme von DARS (DIRECT=Y).

ERZWINGEN

Y Oder N

N

Legt fest, ob der Wiederherstellungsvorgang auf Volume-Speicherplatz und Inode-Verfügbarkeit auf dem Ziel-Volume überprüfen muss.

Wenn diese Variable auf gesetzt Y wird, überspringt der Wiederherstellungsvorgang Prüfungen für den Volume-Speicherplatz und die Inodes-Verfügbarkeit auf dem Zielpfad.

Wenn auf dem Ziel-Volume nicht genügend Volume-Speicherplatz oder Inodes verfügbar sind, stellt der Wiederherstellungsvorgang so viele Daten wieder her, wie von dem Ziel-Volume-Speicherplatz und der Inode-Verfügbarkeit zulässig. Der Wiederherstellungsvorgang wird beendet, wenn kein Volume-Speicherplatz oder -Inodes verfügbar sind.

HIST

Y Oder N

N

Gibt an, dass Informationen zum Dateiverlauf an die Backup-Anwendung gesendet werden.

Die meisten kommerziellen Backup-Anwendungen setzen die Variable HIST auf Y. Wenn Sie die Geschwindigkeit eines Backup-Vorgangs erhöhen möchten oder ein Problem mit der Dateihistorie-Sammlung beheben möchten, können Sie diese Variable auf einstellen N.

Hinweis

Sie sollten die Variable HIST nicht auf einstellen Y, wenn die Backup-Anwendung den Dateiverlauf nicht unterstützt.

IGNORIEREN_CTIME

Y Oder N

N

Gibt an, dass eine Datei nicht inkrementell gesichert wird, wenn sich der Ctime-Wert seit dem letzten inkrementellen Backup geändert hat.

Bei einigen Anwendungen, wie z. B. bei der Virenscan-Software, wird der Ctime-Wert einer Datei innerhalb des Inode geändert, obwohl sich die Datei oder ihre Attribute nicht geändert haben. Aus diesem Grund sichert ein inkrementeller Backup Dateien, die sich nicht geändert haben. Die IGNORE_CTIME Variable sollte nur angegeben werden, wenn inkrementelle Backups eine nicht akzeptable Zeit- oder Speicherplatzmenge erfordern, da der ctime-Wert geändert wurde.

Hinweis

Der NDMP dump Befehl wird IGNORE_CTIME false standardmäßig auf festgelegt. Die Einstellung auf true kann zu folgendem Datenverlust führen:

  1. Wenn IGNORE_CTIME bei einem inkrementellen Volume-Level auf „true ndmpcopy“ gesetzt ist, führt dies zum Löschen von Dateien, die über qtrees an der Quelle verschoben werden.

  2. Wenn IGNORE_CTIME während eines inkrementellen dumps auf Volume-Ebene auf „true“ gesetzt ist, führt dies zum Löschen von Dateien, die während der inkrementellen Wiederherstellung in qtrees über die Quelle verschoben werden.

Um dieses Problem zu vermeiden, IGNORE_CTIME muss während der Lautstärke auf false NDMP dumps oder gesetzt werden ndmpcopy.

IGNORE_QTREES

Y Oder N

N

Gibt an, dass der Wiederherstellungsvorgang keine qtree-Informationen aus gesicherten qtrees wiederherstellt.

EBENE

0-31

0

Gibt die Sicherungsebene an.

Ebene 0 kopiert den gesamten Datensatz. Inkrementelle Backup-Level, angegeben durch Werte über 0, kopieren Sie alle Dateien (neu oder geändert) seit der letzten inkrementellen Sicherung. Ein Level 1 sichert zum Beispiel neue oder geänderte Dateien seit der Sicherung von Ebene 0, sichert ein Level 2 neue oder geänderte Dateien seit der Sicherung der Ebene 1 usw.

LISTE

Y Oder N

N

Listet die gesicherten Dateinamen und Inode-Nummern auf, ohne die Daten wiederherstellen zu müssen.

LIST_QTREES

Y Oder N

N

Listet die gesicherten qtrees auf, ohne die Daten wiederherstellen zu müssen.

MULTI_SUBTREE_ NAMEN

string

none

Gibt an, dass das Backup ein Backup mit mehreren Unterstrukturen ist.

In der Zeichenfolge werden mehrere Unterbäume angegeben, die eine neu getrennte, Null-terminierte Liste von Unterbaumnamen ist. Subtrees werden durch Pfadnamen relativ zu ihrem gemeinsamen Stammverzeichnis angegeben, das als letztes Element der Liste angegeben werden muss.

Wenn Sie diese Variable verwenden, müssen Sie auch die DMP_NAME-Variable verwenden.

NDMP_UNICODE_ FH

Y Oder N

N

Gibt an, dass zusätzlich zum NFS-Namen der Datei in den Dateiverlaufs-Informationen ein Unicode-Name enthalten ist.

Diese Option wird von den meisten Backup-Anwendungen nicht verwendet und sollte erst dann eingestellt werden, wenn die Backup-Anwendung diese zusätzlichen Dateinamen erhalten soll. Die HIST-Variable muss ebenfalls eingestellt werden.

NEIN_ACLS

Y Oder N

N

Gibt an, dass ACLs beim Sichern von Daten nicht kopiert werden dürfen.

NICHT_QUOTA_TREE

Y Oder N

N

Gibt an, dass Dateien und Verzeichnisse in qtrees beim Daten-Backup ignoriert werden müssen.

Wenn auf festgelegt Y, werden Elemente in qtrees im von der DATEISYSTEMVARIABLE angegebenen Datensatz nicht gesichert. Diese Variable hat nur dann Wirkung, wenn die DATEISYSTEMVARIABLE ein ganzes Volume angibt. DIE Variable NON_QUOTA_TREE funktioniert nur bei Backups der Ebene 0 und funktioniert nicht, wenn DIE Variable MULTI_SUBTREE_NAMES angegeben wird.

Hinweis

Dateien oder Verzeichnisse, die für die Sicherung ausgeschlossen werden sollen, werden nicht ausgeschlossen, wenn Sie NON_QUOTA_TREE auf Y gleichzeitig setzen.

NOWRITE

Y Oder N

N

Gibt an, dass der Wiederherstellungsvorgang keine Daten auf die Festplatte schreiben darf.

Diese Variable wird zum Debuggen verwendet.

REKURSIV

Y Oder N

Y

Gibt an, dass Verzeichniseinträge während einer DAR-Wiederherstellung erweitert werden.

Die DIREKTEN und ERWEITERTEN_DAR_ENABLED Umgebungsvariablen müssen Y ebenfalls aktiviert sein (gesetzt auf). Wenn die REKURSIVE Variable deaktiviert ist (gesetzt auf N), werden nur die Berechtigungen und ACLs für alle Verzeichnisse im ursprünglichen Quellpfad vom Band wiederhergestellt, nicht der Inhalt der Verzeichnisse. Wenn die REKURSIVE Variable auf gesetzt ist N oder die Variable RECOVER_FULL_PATHS auf gesetzt Y ist, muss der Wiederherstellungspfad mit dem ursprünglichen Pfad enden.

Hinweis

Wenn die REKURSIVE Variable deaktiviert ist und es mehr als einen Wiederherstellungspfad gibt, müssen alle Wiederherstellungspfade innerhalb der längsten der Wiederherstellungspfade enthalten sein. Andernfalls wird eine Fehlermeldung angezeigt.

Zum Beispiel sind die folgenden gültigen Wiederherstellungspfade, da sich alle Wiederherstellungspfade befinden foo/dir1/deepdir/myfile:

  • /foo

  • /foo/dir

  • /foo/dir1/deepdir

  • /foo/dir1/deepdir/myfile

Die folgenden sind ungültige Recovery-Pfade:

  • /foo

  • /foo/dir

  • /foo/dir1/myfile

  • /foo/dir2

  • /foo/dir2/myfile

WIEDERHERSTELLUNG_FULL_PATHS

Y Oder N

N

Gibt an, dass der vollständige Recovery-Pfad ihre Berechtigungen und ACLs nach DEM DAR wiederhergestellt hat.

DIRECT und ENHANCED_DAR_ENABLED müssen Y ebenfalls aktiviert sein (gesetzt auf). Wenn RECOVER_FULL_PATHS auf gesetzt Y ist, muss der Wiederherstellungspfad mit dem ursprünglichen Pfad enden. Sind Verzeichnisse bereits auf dem Ziel-Volume vorhanden, werden ihre Berechtigungen und ACLs nicht vom Band wiederhergestellt.

AKTUALISIERUNG

Y Oder N

Y

Aktualisiert die Metadateninformationen, um EIN LEVEL-basiertes, inkrementelles Backup zu ermöglichen.

Für SMTape unterstützte Umgebungsvariablen

Umgebungsvariable Gültige Werte Standard Beschreibung

BASE_DATE

DUMP_DATE

-1

Gibt das Startdatum für inkrementelle Backups an.

`BASE_DATE` Ist eine String-Darstellung der Referenz-Snapshot-IDs. Mithilfe der `BASE_DATE` Zeichenfolge sucht SMTape die Snapshot Referenzkopie.
`BASE_DATE` Ist bei Basis-Backups nicht erforderlich. Für ein inkrementelles Backup `DUMP_DATE` wird der Wert der Variable aus der vorherigen Basislinie oder dem inkrementellen Backup der `BASE_DATE` Variablen zugewiesen.

Die Backup-Applikation weist den DUMP_DATE Wert einer früheren SMTape Baseline oder eines inkrementellen Backups zu.

DUMP_DATE

return_value

none

AM Ende eines SMTape Backups enthält DUMP_DATE eine String-Kennung, die die für das Backup verwendete Snapshot Kopie identifiziert. Diese Snapshot Kopie kann als Referenz-Snapshot für ein nachfolgender, inkrementeller Backup verwendet werden.

Der resultierende Wert von DUMP_DATE wird als BASE_DATE-Wert für nachfolgende inkrementelle Backups verwendet.

SMTAPE_BACKUP_SET_ID

string

none

Identifiziert die Reihenfolge der inkrementellen Backups, die mit dem Basistransfer verbunden sind.

Die Backup-Set-ID ist eine eindeutige 128-Bit-ID, die während eines Basissicherung generiert wird. Die Backup-Anwendung weist diese ID der SMTAPE_BACKUP_SET_ID Variablen während einer inkrementellen Sicherung als Eingabe zu.

SMTAPE_SNAPSHOT_NAME

Alle gültigen Snapshot Kopien, die im Volume verfügbar sind

Invalid

Wenn die Variable SMTAPE_SNAPSHOT_NAME auf eine Snapshot Kopie festgelegt ist, werden diese Snapshot Kopie und ihre älteren Snapshot Kopien auf Tape gesichert.

Für inkrementelle Backups legt diese Variable die inkrementelle Snapshot Kopie fest. Die Variable „BASE_DATE“ stellt die Basis-Snapshot Kopie bereit.

SMTAPE_DELETE_SNAPSHOT

Y Oder N

N

Wenn für eine automatisch von SMTape erstellte Snapshot Kopie die Variable SMTAPE_DELETE_SNAPSHOT auf festgelegt ist Y, löscht SMTape nach Abschluss des Backup-Vorgangs diese Snapshot Kopie. Eine von der Backup-Applikation erstellte Snapshot Kopie wird jedoch nicht gelöscht.

SMTAPE_BREAK_MIRROR

Y Oder N

N

Wenn die Variable SMTAPE_BREAK_MIRROR auf gesetzt Y ist, DP wird das Volume des Typs RW nach einer erfolgreichen Wiederherstellung in ein Volume geändert.