Storage-System: | ETERNUS DX/AF, Symmetrix/VMAX3 |
Anwendungsbereich: | DEVICE |
Privilegierung: | TSOS |
/START-SNAP-SESSION erstellt ein oder mehrere Snap-Paar(e), indem einer Original-Unit ein virtuelles Gerät als Snap-Unit zugeordnet wird.
Beim Operanden UNIT werden immer die Original-Units der Snap-Paare angegeben.
Mit einem Kommando /START-SNAP-SESSION können Snap-Units für alle Units eines Pubsets erzeugt werden. In diesem Fall wird bei UNIT der Pubset ausgewählt. Bei SNAP-UNIT wird eine Liste von Volumes angegeben, die alle noch nicht als Snap-Units genutzt werden und deren Anzahl mit der Anzahl der Units des Pubsets übereinstimmt.
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
Die Datenkonsistenz über mehrere Volumes ist vom Aufrufer sicherzustellen. Vor Aufruf des Kommandos sollte dazu ein Konsistenzpunkt für die Daten erstellt werden, siehe Abschnitt „Konsistenzpunkt für Replikationen".
Der Server selbst kann auf die Snap-Unit sofort zugreifen.
Die Snap-Paare werden sofort aktiviert. Aus Sicht der Anwendung enthält die Snap-Unit alle Daten der Original-Unit zum Zeitpunkt der Kommando-Verarbeitung. Durch die Ausführung des Kommandos bekommt die Snap-Session den Status COPY-ON-WRITE.
Die Geräte für Original-Unit und Snap-Unit müssen in demselben Storage-System liegen und den gleichen Typ haben. Die konfigurierte Größe der Snap-Unit muss grösser oder gleich der Größe der Original-Unit sein.
Für ETERNUS DX/AF können beliebige Thin Devices oder Flex Volumes als Snap-Units verwendet werden.
Für ETERNUS DX/AF können alternativ auch noch vorkonfigurierte Snap Data Volumes (SDV) als Snap-Units verwendet werden.
Zu einer Original-Unit können maximal 256 Snap-Units eingerichtet werden.
Der Snap-Pubset auf den Snap-Units kann mit dem Operanden NEW-PUBSET direkt umbenannt werden, wenn es sich um einen SF-Pubset handelt.
Wenn für Pubsets die Datensicherung mit Snapsets genutzt wird (siehe Handbuch „Systembetreuung“ [5]), dann darf SnapOPC+ für dieses Pubset nicht genutzt werden.
Für TimeFinder/Snap auf Symmetrix
Der Server selbst kann auf die Snap-Unit nicht zugreifen.
Die Snap-Session bekommt durch die Ausführung des Kommandos den Status CREATED. Das Snap-Paar kann anschließend mit /ACTIVATE-SNAP aktiviert werden (siehe "ACTIVATE-SNAP Snap-Paar aktivieren").
Die Geräte für Original-Unit und Snap-Unit müssen in demselben Storage-System liegen, den gleichen Typ haben und in der konfigurierten Größe übereinstimmen.
Zu einer Original-Unit können derzeit im Storage-System maximal 127 Snap-Units eingerichtet werden. Diese Snap-Sessions zählen zusammen als eine Copy-Session. Für Pubsets kann sich der Maximalwert verringern, wenn die Datensicherung mit Snapsets (siehe Handbuch „Systembetreuung“ [5]) genutzt wird, weil eine bestimmte Anzahl von Sessions für Snapsets reserviert werden kann.
Wenn zur Original-Unit schon Snap- oder Clone-Sessions im Status RESTORED bestehen, so wird das Kommando /START-SNAP-SESSION abgewiesen.
Für TimeFinder SnapVX auf VMAX3
Die Datenkonsistenz über mehrere Volumes ist vom Aufrufer sicherzustellen. Vor Aufruf des Kommandos sollte dazu ein Konsistenzpunkt für die Daten erstellt werden, siehe Abschnitt „Konsistenzpunkt für Replikationen".
Der Server selbst kann auf die Snap-Unit sofort zugreifen.
Die Snap-Paare werden sofort aktiviert. Aus Sicht der Anwendung enthält die Snap-Unit alle Daten der Original-Unit zum Zeitpunkt der Kommando-Verarbeitung. Durch die Ausführung des Kommandos bekommt die Snap-Session den Status COPY-ON-WRITE.
Der Snapshot wird durch seinen Snapshot-Namen identifiziert. Der Snapshot-Name kann explizit angegeben oder von SHC-OSD automatisch gebildet werden.
Die Geräte für Original-Unit und Snap-Unit müssen in derselben VMAX3 liegen sowie den gleichen Typ haben und in der konfigurierten Größe übereinstimmen.
Der Snap-Pubset auf den Snap-Units kann mit dem Operanden NEW-PUBSET direkt umbenannt werden, wenn es sich um einen SF-Pubset handelt.
Zu einer Original-Unit können derzeit maximal 127 Snap-Units eingerichtet werden. Diese Snap-Sessions zählen zusammen als eine Copy-Session.
START-SNAP-SESSION | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UNIT =
Auswahl der Original-Units über 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-PUBSET(...)
Auswahl der Units über eine Pubset-ID oder Volume-Set-ID. Der Pubset wird während der Kommandobearbeitung gegen Rekonfiguration gesperrt.
Nur für ETERNUS DX/AF und VMAX3 relevant: Wenn ein SF-Pubset ausgewählt wird, können die Volumes des erzeugten Snap-Pubsets direkt mit NEW-PUBSET umbenannt werden.
PUBSET = <cat-id 1..4>
Angabe der Pubset-ID oder Volume-Set-ID.
Bei HOLD-IO=*UNTIL-ACTIVATED darf keine Volume-Set-ID angegeben werden.
NEW-PUBSET =
Nur für ETERNUS DX/AF und VMAX3 relevant.
Bestimmt die Katalogkennung des Snap-Pubsets der Snap-Units.
NEW-PUBSET = *SAME
Der Snap-Pubset wird nicht umbenannt, d.h. es behält den gleichen Namen.
NEW-PUBSET = *SPECIAL-VSN
Alle Volumes der Snap-Units werden automatisch umbenannt, damit eine Mehrdeutigkeit mit dem Original vermieden wird. Dazu wird in einer VSN in Punkt-Notation der Punkt in einen Doppelpunkt (z.B. AA.001 in AA:001) bzw. bei PUB-Notation die Zeichenfolge PUB in P:B geändert (z.B. PUBA01 in P:BA01).
NEW-PUBSET = <cat-id 1..4>
Der Snap-Pubset eines SF-Pubsets wird umbenannt, indem die neue Katalogkennung explizit angegeben wird. Die Katalogkennung kann auch eine unterschiedliche Länge im Vergleich zum Operanden PUBSET haben. Der neue Snap-Pubset wird ebenfalls ein SF-Pubset. Es wird ein existierender MRSCAT-Eintrag verwendet, wenn er den richtigen Typ hat. Anderenfalls wird der Eintrag gelöscht und neu erstellt. Siehe die Hinweise im Abschnitt „Umbenennen von SF-Pubsets mit SHC-OSD".
HOLD-IO =
Nur für ETERNUS DX/AF und VMAX3 relevant.
Behandlung von Ein-/Ausgaben auf das Snap-Paar während der Auftrennung (siehe „Konsistente Abtrennung eines Pubsets auch im Shared-Pubset-Verbund“, „Konsistenzpunkt für Replikationen").
HOLD-IO = *NO
Die Ein-/Ausgaben auf die Original-Units werden unverändert ausgeführt. Dies kann auf den Snap-Units zu Dateninkonsistenz führen für Anwendungen, die vor der Auftrennung nicht angehalten werden.
HOLD-IO = *UNTIL-ACTIVATED
Die Ein-/Ausgaben auf die Original-Units werden angehalten, bis alle Snap-Paare des importierten Pubsets im Zustand COPY-ON-WRITE sind. Danach werden die Ein-/Ausgaben auf die Units wieder aufgenommen. Wenn beim Anhalten oder Wiederaufnehmen der Ein-/Ausgaben ein Fehler auftritt, wird das Kommando abgebrochen. Gegebenenfalls muss die Ein-/Ausgabe-Aktivität mit /RESUME-IO wieder aufgenommen werden.
UNIT = *BY-SYMMETRIX(...)
Nur für Symmetrix/VMAX3 relevant.
Auswahl der Unit ü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 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 der Unit über den mnemotechnischen Gerätenamen des logischen Volumes.
SNAP-UNIT =
Auswahl der Snap-Units.
SNAP-UNIT = list-poss(256): <alphanum-name 2..2> / <x-text 4..4>
Angabe des mnemotechnischen Gerätenamens des Virtual Devices. Eine Liste wird nur akzeptiert, wenn beim Operanden UNIT ein Pubset angegeben wurde.
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 überdie 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 = *AUTO-SELECT
Automatische Auswahl passender Snap-Units durch SHC-OSD. Es werden nur Snap-Units mit exakt der gleichen konfigurierten Größe wie die Original-Unit ausgewählt.
Die Snap-Units werden abhängig vom Storage-System ausgewählt:
für ETERNUS DX/AF zuerst aus der Menge der vorhandenen freien und zugeschalteten BS2000-Volumes in Sondernotation, siehe Abschnitt „Automatische Auswahl von Snap-Units" (Frei wählbare Snap-Units). Danach, falls keine passenden BS2000-Volumes in Sondernotation gefunden wurden, aus der Menge der vorhandenen freien und zugeschalteten Snap Data Volumes (SDV)
für Symmetrix aus der Menge der vorhandenen freien und zugeschalteten Virtual Devices
für VMAX3 aus der Menge der vorhandenen freien und zugeschalteten BS2000-Volumes in Sondernotation, siehe Abschnitt „Automatische Auswahl von Snap-Units" (Snap-Units (VMAX3)).
SNAP-UNIT=*AUTO-SELECT ist nicht möglich für nicht generierte und nicht zugeschaltete Units.
SNAPSHOT-NAME =
Nur für VMAX3 relevant.
Angabe des Namens für den Snapshot, siehe Abschnitt „Snapshot-Name“ im „Snap-Units (VMAX3)". Der Snapshot wird mit der bei SNAP-UNIT= angegebenen Snap-Unit verbunden.
SNAPSHOT-NAME = *BY-RULE
Der Snapshot erhält den von SHC-OSD generierten Namen.
SNAPSHOT-NAME = <posix-filename_1..32>
Der Snapshot erhält den angegebenen Namen. Die Groß-/Kleinschreibung und die Eindeutigkeit innerhalb der VMAX3 müssen beachtet werden.
SAVE-POOL =
Nur für Symmetrix relevant.
Auswahl des Save Pools für die zuzuordnenden Virtual Devices.
SAVE-POOL = *BY-PRESELECTION
Es wird der Save Pool verwendet, der über die SHC-OSD-Parameterdatei oder mit dem Kommando /MODIFY-SHC-PROCESSING eingestellt wurde.
SAVE-POOL = *DEFAULT-POOL
Der Default Pool des Storage-Systems wird als Save Pool verwendet.
SAVE-POOL = <name 1..32 with-under with-low>
Angabe des Namens des Save Pools für die zuzuordnenden Virtual Devices.
Die Groß-/Kleinschreibung muss beachtet werden.
SELECT =
Festlegung, ob die beim Operanden UNIT angegebene Unit oder (beim Einsatz von remote Replikation) die Target-Unit eines Remote-Copy-Paares als Original-Unit des Snap-Paares ausgewählt wird.
SELECT = *STD
Auswahl der Unit, die mit dem Operanden UNIT festgelegt wurde.
SELECT = *TARGET-UNIT(...)
Auswahl der Target-Unit eines Remote-Copy-Paares als Original-Unit. 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.
Kommando-Verarbeitung
Die Meldung NDE1073 wird pro Gerät nach SYSOUT ausgegeben und über Routing-Code 0 verteilt, d.h. sie wird nur in der CONSLOG-Datei protokolliert. Detaillierte Informationen zur CONSLOG-Datei (Protokolldatei) finden Sie im Handbuch „Systembetreuung“ [5].
Beispiele
/START-SNAP-SESSION UNIT=5000,SNAP-UNIT=5040
/START-SNAP-SESSION UNIT=5001,SNAP-UNIT=*AUTO-SELECT
/START-SNAP-SESSION UNIT=*BY-PUBSET(PUBSET=TFS),SNAP-UNIT=(5100,5101,5102)
(Pubset TFS besteht aus 3 Units)
/START-SNAP-SESSION UNIT=*BY-PUBSET(PUBSET=A,NEW-PUBSET=C),SELECT=*TARGET-UNIT
(siehe "SnapOPC+ und REC (ETERNUS DX/AF)")
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 | 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 | NDE1044 |
| |
64 | NDE1052 | Maximum an TimeFinder Spiegeln wurde überschritten | |
64 | NDE1055 | Funktion für Storage-Systeme Symmetrix/VMAX3nicht unterstützt | |
64 | NDE1058 | Alle freien Snap-Units für Snapset reserviert | |
64 | NDE1100 | Ungültiger Pubset-Status | |
64 | NDE1101 | Mehrfach genutzter Shared Pubset | |
64 | NDE1102 | Nicht alle Volumes konnten belegt werden | |
64 | NDE1103 | Kein Pubset-Rekonfigurations-Lock | |
64 | NDE1105 | Inkonsistenter Pubset | |
64 | NDE1108 |
| |
64 | NDE1109 |
| |
64 | NDE1110 |
| |
64 | NDE1114 | Seriennummer nicht gefunden | |
64 | NDE1115 | Seriennummer nicht eindeutig | |
64 | NDE1116 | Logical Volume im Storage-System nicht gefunden | |
64 | NDE1140 | MN in MN-Liste mehrfach verwendet | |
64 | NDE1142 | Spiegelpaar existiert schon | |
64 | NDE1150 | Kein Gatekeeper-Gerät gefunden | |
64 | NDE1153 | Symmetrix Device-Lock gesetzt | |
64 | NDE1154 | Platte ist Member eines Meta-Volume | |
64 | NDE1171 | RA-Gruppe nicht eindeutig | |
64 | NDE1172 | RA-Gruppe für die angegebene Unit ungültig | |
64 | NDE1410 | Keine oder zu wenig freie Snap-Units | |
64 | NDE1411 | Keine Save-Geräte für die Snap-Units verfügbar | |
64 | NDE1412 | Angegebener Save Pool existiert nicht | |
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 | NDE1437 | MNs der Unit und Snap-Unit sind identisch | |
64 | NDE1438 | Unit und virtuelle Snap-Unit sind unterschiedlichen Typs | |
64 | NDE1439 | Unit und virtuelle Snap-Unit sind auf verschiedenen Storage-Systemen | |
64 | NDE1440 | Falscher Status der Unit (eines Snap-Paares) | |
64 | NDE1441 | Falscher Status der Snap-Unit | |
64 | NDE1458 | Unit und Snap-Unit sind Meta-Volumes mit ungleicher Stripe-Size | |
64 | NDE1470 | Typ der SNAP-UNIT darf nicht gemischt werden (SDV und Thin) | |
64 | NDE1535 | Gerät ist eine Clone-Unit | |
64 | NDE1702 | Verbindung zu SYMAPI-Server abgebrochen | |
64 | NDE1800 | Gerät nicht gefunden oder nicht in Storage-System | |
64 | NDE1810 | Betriebssystem-Version des Storage-Systems 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 | NDE1820 | Rekonstruktion im Storage-System noch nicht beendet | |
64 | NDE1833 | kein passender StorMan-Server gefunden | |
64 | NDE1840 | Unit und Snap-Unit sind auf verschiedenen Storage-Systemen | |
64 | NDE1850 | Alle Spiegelplatten der Unit für Snapset-Nutzung reserviert | |
64 | NDE1852 | Maximum an lokalen Spiegeln wurde überschritten | |
64 | NDE1853 | Storage-Unit gesperrt | |
64 | NDE1870 | Snap Paar erzeugt | |
64 | NDE1872 | Automatisches Zuschalten (Attach) von Snap-Unit(s) fehlgeschlagen | |
64 | NDE1880 | Copy-Lizenz nicht installiert (ETERNUS DX/AF) | |
64 | NDE1881 | Copy Table Size nicht eingerichtet (ETERNUS DX/AF) | |
64 | NDE1882 | Copy Table Size zu klein (ETERNUS DX/AF) | |
64 | NDE1883 | Advanced Copy Operationen für Geräte gesperrt (ETERNUS DX/AF) | |
64 | NDE2000 | Teilweise erfolgreiche Ausführung | |
64 | NDE2001 | Kommando nicht ausgeführt | |
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 | NDE2018 | Fehler im SYMAPI-Server während der aktuellen Bearbeitung | |
130 | NDE1082 | Speicherengpass während der Bearbeitung des Kommandos | |
130 | NDE2005 | Kommando kann momentan nicht ausgeführt werden |