Storage-System: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
/RESTORE-FROM-SNAP rekonstruiert die Original-Unit eines Snap-Paares von der Snap-Unit. Bei der Ausführung des Kommandos werden die Daten immer von der Snap-Unit zur Original-Unit kopiert.
Beim Operanden UNIT werden immer die Original-Units der Snap-Paare angegeben.
Bei der Auswahl der Original-Units über ein Pubset (UNIT=*BY-PUBSET) muss es zu allen Units des Pubsets Snap-Units geben.
Für die Rekonstruktion können die Snap-Units explizit (z.B. über die Katalogkennung des umbenannten Pubsets) oder implizit nach ihrem relativen Alter (z.B. *FROM-SHOW-OUTPUT(*LAST)) ausgewählt werden.
Die Original-Unit kann gleichzeitig auch die Source-Unit eines Remote-Copy-Paares sein. Auch die Target-Unit kann Original-Unit eines Snap-Paares sein. In diesem Fall wird beim Operanden UNIT die Source-Unit angegeben und mit dem Operanden SELECT=*TARGET-UNIT das Snap-Paar an der Target-Unit ausgewählt.
Vor der Ausführung dieses Kommandos überprüft SHC-OSD die globalen und Task-spezifischen Sicherheitseinstellungen (siehe "Sicherheitseinstellungen von SHC-OSD"). Die aktuellen Sicherheitseinstellungen können mit /SHOW-SHC-PROCESSING angezeigt werden (siehe "SHOW-SHC-PROCESSING Einstellungen von SHC-OSD anzeigen"). Sie können in der SHC-OSD-Parameterdatei (siehe "Konfiguration von SHC-OSD") für den nächsten Start von SHC-OSD oder mit /MODIFY-SHC-PROCESSING für den laufenden Betrieb geändert werden (siehe "MODIFY-SHC-PROCESSING Einstellungen von SHC-OSD ändern").
Für SnapOPC+ auf ETERNUS DX/AF
Es werden die auf der Snap-Unit gesicherten Daten auf die Original-Unit kopiert. Auf die Original-Unit darf nach der Rekonstruktion wieder zugegriffen werden.
Wenn mehrere Snap-Units der gleichen Original-Unit zugeordnet sind, dann sind die anderen Snap-Sessions von der Rekonstruktion nicht betroffen. Mehrfache Rekonstruktionen sind nacheinander möglich. Es darf sich jedoch keine Snap-Session in einer Rekonstruktion befinden.
Die Snap-Session bleibt im Status COPY-ON-WRITE. Es wird auch keine Statusänderung protokolliert. Nach Ausführung des Kommandos wird die Snap-Session auf Basis der rekonstruierten Daten fortgesetzt.
Wenn die Original-Unit gleichzeitig auch die Clone-Unit eines Clone-Paares oder die Target-Unit eines Remote-Copy-Paares ist, dann ist /RESTORE-FROM-SNAP nicht möglich.
Ab ETERNUS AF und ETERNUS DX S3/S4 ist eine asynchrone Rekonstruktion nach der Kommandoausführung oder eine synchrone Rekonstruktion während der Kommandoausführung möglich (Operand WAIT). Während der synchronen Rekonstruktion ist das Snap-Paar im Status REST-IN-PROG. Dabei kann der Wartezustand im Dialog-Betrieb mit der K2-Taste abgebrochen werden.
Die Kommandos /STOP-SNAP-SESSION und /START-SNAP-SESSION werden während der Ausführung der Rekonstruktion mir Returncode NDE1820 abgewiesen. Sie können erst nach Abschluss der Rekonstruktion erfolgreich ausgeführt werden.
Für TimeFinder/Snap auf Symmetrix
Mit WAIT=*UNTIL-RESTORED / *NO wird eingestellt, ob das Kommando auf die Beendigung der Rekonstruktion wartet (synchrone Kommandoausführung) oder nicht (asynchrone Kommandoausführung).
Auf Original- und Snap-Unit darf kein anderer Zugriff erfolgen. Die Snap-Session muss im Status COPY-ON-WRITE sein.
Nach der Ausführung des Kommandos ist die Snap-Session im Status RESTORED und kann nicht weiter genutzt werden. Nur das Kommando /STOP-SNAP-SESSION ist möglich.
Wenn mehrere Snap-Units der gleichen Original-Unit zugeordnet sind, so darf keine Snap-Session im Status CREATED oder RESTORED sein. Wenn die Original-Unit gleichzeitig auch Clone-Units besitzt, so wird das Kommando abgewiesen.
Wenn die Original-Unit auch gleichzeitig die Target-Unit eines Remote-Copy-Paares ist, muss der Remote-Copy-Status IN-HOLD oder ERROR sein und TARGET-ACCESS muss DIRECT sein.
Für TimeFinder SnapVX auf VMAX3
Es gilt stets WAIT=*UNTIL-RESTORED, d.h. das Kommando wartet auf die Beendigung der Rekonstruktion (synchrone Kommandoausführung).
Auf Original- und Snap-Unit darf kein anderer Zugriff erfolgen. Die Snap-Session muss im Status COPY-ON-WRITE sein.
Zur Rekonstruktion wird eine temporäre Snap-Session zwischen Snap-Unit und Original-Unit aufgebaut. Danach enthält die Original-Unit den Stand der rekonstruierten Snap-Unit, also den Stand zum Zeitpunkt der Erstellung des Snapshots und alle seither auf der Snap-Unit durchgeführten Änderungen. Alle Snapshots der Original-Units bestehen unverändert fort. Das Snap-Paar ist während der Rekonstruktion temporär im Status REST-IN-PROG. Es ist nach Abschluss der Rekonstruktion wieder im Status COPY-ON-WRITE und kann auf Basis der rekonstruierten Daten weiter genutzt werden. Die Rekonstruktion kann mehrfach mit beliebigen Snap-Unit-Ständen einer Original-Unit wiederholt werden.
Wenn mehrere Snap-Units der gleichen Original-Unit zugeordnet sind, dann sind die anderen Snap-Sessions von der Rekonstruktion nicht betroffen.
Mehrfache Rekonstruktionen nacheinander sind möglich. Parallele Rekonstruktionen mehrerer Snap-Sessions sind nicht möglich.
Wenn die Original-Unit auch gleichzeitig die Target-Unit eines Remote-Copy-Paares ist, muss der Remote-Copy-Status IN-HOLD oder ERROR sein und TARGET-ACCESS muss DIRECT sein.
RESTORE-FROM-SNAP | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Auswahl der Units über eine bestimmte Archivnummer (*BY-VOLUME), eine bestimmte Katalogkennung (*BY-PUBSET), über die Seriennummer und die interne Nummer des logischen Volumes im Storage-System (*BY-SYMMETRIX/*BY-STORAGE) oder direkt über den mnemotechnischen Gerätenamen des logischen Volumes.
UNIT = *BY-VOLUME(...)
Auswahl der Units über eine bestimmte Archivnummer.
VOLUME = <vsn 1..6>
Angabe der Archivnummer des Volumes.
UNIT = *BY-PUBSET(...)
Auswahl der Units über eine Pubset-ID oder Volume-Set-ID. Der Pubset wird während der Kommandobearbeitung gegen Rekonfiguration gesperrt.
PUBSET = <cat-id 1..4>
Angabe der Pubset-ID oder Volume-Set-ID.
ACHTUNG!
Bei der Rekonstruktion eines Pubsets von den Snap-Units mit UNIT=*BY-PUBSET(...) darf der Pubset zwischenzeitlich nicht rekonfiguriert und insbesondere nicht verkleinert worden sein. Die ausgewählten Snap-Units müssen ein konsistentes Pubset enthalten.
RENAME-PUBSET =
Angabe der Pubset-ID oder Volume-Set-ID des rekonstruierten Pubsets.
RENAME-PUBSET = *NO
Es erfolgt keine Umbenennung des rekonstruierten Pubsets. Die Pubset-ID des Snap-Pubsets wird implizit übernommen.
RENAME-PUBSET = *SAME
Der rekonstruierte Pubset wird auf die Pubset-ID oder Volume-Set-ID des Original-Pubsets umbenannt.
RENAME-PUBSET = <cat-id 1..4>
Der rekonstruierte Pubset wird auf die angegebene Pubset-ID oder Volume-Set-ID umbenannt.
UNIT = *BY-SYMMETRIX(...)
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Units über die Seriennummer des Storage-Systems und die interne Nummer des logischen Volumes im Storage-System.
SERIAL-NUMBER = <alphanum-name 3..12>
Angabe der Seriennummer des Storage-Systems (Eindeutigkeit beachten!).
LOGICAL-VOLUME = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.
UNIT = *BY-STORAGE(...)
Nur für ETERNUS DX/AF relevant.
Auswahl der Unit über die interne Nummer des logischen Volumes im Storage-System.
SERIAL-NUMBER = <alphanum-name 3..14>
Angabe der Seriennummer des Storage-Systems (Eindeutigkeit beachten!).
LOGICAL-VOLUME = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.
UNIT = <alphanum-name 2..2> / <x-text 4..4>
Auswahl einer Unit über den mnemotechnischen Gerätenamen des logischen Volumes.
SNAP-UNIT =
Auswahl der Snap-Units. Wenn es zu einer Unit mehrere Snap-Units gibt, muss eine bestimmte Snap-Unit ausgewählt werden.
SNAP-UNIT = *FIRST-POSSIBLE
Auswahl der ersten für das Kommando möglichen zugeordneten Snap-Unit.
SNAP-UNIT = *FROM-SHOW-OUTPUT(...)
Auswahl der Snap-Unit über die Position in der Ausgabeliste von /SHOW-SNAP-SESSION-STATUS.
POSITION = <integer 1..127>
Angabe der Position der Snap-Unit.
POSITION = *LAST
Auswahl der letzten Snap-Unit in der Ausgabeliste.
SNAP-UNIT = *BY-PUBSET(...)
Auswahl der Snap-Units über die Pubset-ID des aktivierten und umbenannten Pubsets.
SNAP-PUBSET = <cat-id 1..4>
Angabe der Pubset-ID.
SNAP-UNIT = *BY-SYMMETRIX(...)
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Snap-Unit über die interne Nummer des logischen Volumes im Storage-System.
SNAP-LOGICAL-VOLUME = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.
SNAP-UNIT = *BY-STORAGE(...)
Nur für ETERNUS DX/AF relevant.
Auswahl der Snap-Unit über die interne Nummer des logischen Volumes im Storage-System.
SNAP-LOGICAL-VOLUME = <x-text 1..4>
Angabe der internen Nummer des logischen Volumes im Storage-System.
SNAP-UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Angabe des mnemotechnischen Gerätenamens der Snap-Units.
WAIT =
Für VMAX3 gilt stets WAIT=*UNTIL-RESTORED.
Bestimmt, ob das Kommando auf die Beendigung der Rekonstruktion wartet oder nicht.
WAIT = *NO
Das Kommando wartet nicht auf die Beendigung der Rekonstruktion (asynchrone Kommandoausführung).
WAIT = *UNTIL-RESTORED
Das Kommando wartet auf die Beendigung der Rekonstruktion (synchrone Kommandoausführung).
Dies vereinfacht die Programmierung von Testprozeduren für die Recovery-Verfahren, weil aufwändige Abfragen bezüglich des Fortschritts der Wiederherstellung für die Snap-Paare entfallen.
Der Wartevorgang kann im Dialog-Betrieb mit der K2-Taste abgebrochen werden.
SELECT =
Auswahl der Snap-Paare.
SELECT = *STD
Auswahl der Snap-Paare, die mit dem Operanden UNIT festgelegt wurden.
SELECT = *TARGET-UNIT(...)
Auswahl der Snap-Paare, die der Target-Unit eines Remote-Copy-Paares zugeordnet sind. Beim Operanden UNIT wird die entsprechende Source-Unit angegeben.
RA-GROUP =
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Target-Unit über die RA-Gruppe bei Concurrent Target-Units.
RA-GROUP = *UNIQUE
Die einzige existierende Target-Unit wird ausgewählt.
RA-GROUP = <integer 1..250>
Angabe der RA-Gruppe zur Auswahl der Target-Unit.
FORCE =
Nur für Symmetrix relevant.FORCE steuert die Rekonstruktion einer Unit, die gleichzeitig eine SRDF-Source-Unit im Status ACTIVE ist.
FORCE = *NO
Die Rekonstruktion wird abgewiesen.
FORCE = *YES
Die Rekonstruktion wird ausgeführt.
Kommando-Verarbeitung
Folgende Meldungen werden pro Director nach SYSOUT ausgegeben und über Routing-Code 0 verteilt, d.h. sie werden nur in der CONSLOG-Datei protokolliert. Detaillierte Informationen zur CONSLOG-Datei (Protokolldatei) finden Sie im Handbuch „Systembetreuung“ [5].
Für erfolgreiche Bearbeitung:
NDE1073Für nicht-erfolgreiche Bearbeitung:
NDE2007
Beispiele
/RESTORE-FROM-SNAP UNIT=*BY-PUBSET(PUBSET=TFS),
SNAP-UNIT=*FROM-SHOW-OUTPUT(POSITION=*LAST)
/RESTORE-FROM-SNAP UNIT=*BY-VOLUME(VOLUME=TFS.00)
Kommando-Returncode
(SC2) | SC1 | Maincode | Bedeutung |
0 | CMD0001 | Kommando erfolgreich ausgeführt | |
1 | 0 | NDE2003 | Kommando erfolgreich ausgeführt, keine Bearbeitung notwendig |
2 | 0 | NDE2004 | Kommando erfolgreich ausgeführt, aber noch nicht beendet |
1 | CMD0202 | Syntax-Fehler | |
32 | NDE2002 | Interner Fehler | |
64 | CMD0087 | Funktion im aktuellen Eingabe-Modus oder mit den aktuellen Task-Privilegien nicht erlaubt | |
64 | CMD0216 | Erforderliches Privileg nicht vorhanden | |
64 | NDE1000 | Gerät nicht gefunden oder nicht im Storage-System | |
64 | NDE1001 | Gerät nicht zugeschaltet | |
64 | NDE1003 | Datenträger nicht online oder nicht eindeutig | |
64 | NDE1004 | Pubset nicht gefunden oder falscher Pubset-Typ | |
64 | NDE1005 | Pubset nicht homogen | |
64 | NDE1006 | Pubset/Volume ist allokiert | |
64 | NDE1008 | Volume kann nicht allokiert werden | |
64 | NDE1010 | Enginuity-Stand wird nicht unterstützt (zu niedrig) | |
64 | NDE1015 | Gerät in BS2000 nicht bekannt | |
64 | NDE1043 | Pubset-Typ nicht unterstützt | |
64 | NDE1100 | Ungültiger Pubset-Status | |
64 | NDE1102 | Nicht alle Volumes konnten belegt werden | |
64 | NDE1103 | Kein Pubset-Rekonfigurations-Lock | |
64 | NDE1105 | Inkonsistenter Pubset | |
64 | NDE1108 |
| |
64 | NDE1109 |
| |
64 | NDE1114 | Seriennummer nicht gefunden | |
64 | NDE1115 | Seriennummer nicht eindeutig | |
64 | NDE1116 | Logical Volume im Storage-System nicht gefunden | |
64 | NDE1153 | Symmetrix Device-Lock gesetzt | |
64 | NDE1154 | Platte gehört zu einer Meta-Platte | |
64 | NDE1171 | RA-Gruppe nicht eindeutig | |
64 | NDE1172 | RA-Gruppe für die angegebene Unit ungültig | |
64 | NDE1430 | Keine Snap-Funktion für Gerät | |
64 | NDE1431 | Unterschiedliche Anzahl von Geräten für Units und Snap-Units | |
64 | NDE1434 | Virtuelle Snap-Unit wird bereits in anderem Paar benutzt | |
64 | NDE1435 | Gerät ist eine virtuelle Unit | |
64 | NDE1440 | Falscher Status der Unit (eines Snap-Paares) | |
64 | NDE1441 | Falscher Status der Snap-Unit | |
64 | NDE1442 | Unit ist SRDF-Target-Unit und Unit ist nicht im Zustand | |
64 | NDE1449 | Keine Snap-Unit zugeordnet für Snap-Unit Selektion | |
64 | NDE1453 | Gerät ist keine Snap-Unit | |
64 | NDE1454 | Gerät ist ungenutzte Snap-Unit | |
64 | NDE1702 | Verbindung zu SYMAPI-Server abgebrochen | |
64 | NDE1800 | Gerät nicht gefunden oder nicht im Storage-System | |
64 | NDE1802 | Kommunikationsfehler zum StorMan-Server | |
64 | NDE1803 | Management Instance nicht verfügbar | |
64 | NDE1810 | Betriebssystem-Version des Storage-Systems nicht unterstützt | |
64 | NDE1811 | Funktion für Storage-System nicht unterstützt | |
64 | NDE1812 | StorMan-Server per Kommando abgeschaltet | |
64 | NDE1814 | Seriennummer des Storage-Systems nicht gefunden | |
64 | NDE1815 | Seriennummer des Storage-Systems nicht eindeutig | |
64 | NDE1816 | Logical Volume des Storage-Systems nicht gefunden | |
64 | NDE1833 | kein passender StorMan-Server gefunden | |
64 | NDE1853 | Storage-Unit gesperrt | |
64 | NDE2009 | Kommandobearbeitung mit K2-Taste abgebrochen | |
64 | NDE2011 | Keine Symmetrix-Lizenz eingetragen | |
64 | NDE2013 | SYMAPI-Fehler in Kommando | |
64 | NDE2014 | StorMan-Fehler in Kommando | |
64 | NDE2017 | Kommando im aktuellen Status der Replikation nicht möglich | |
64 | NDE2018 | Fehler im SYMAPI-Server während der aktuellen Bearbeitung | |
64 | NDE2020 | Keine Lizenz für lokale Replikation (ETERNUS DX/AF) | |
130 | NDE1082 | Speicherengpass während der Bearbeitung des Kommandos | |
130 | NDE2005 | Kommando kann momentan nicht ausgeführt werden |