Verwenden Sie die Systems-Manager-Befehlsdokumente, um VSS-aktivierte Snapshots zu erstellen - Amazon Elastic Compute Cloud
Parameter für VSS-Snapshot-Dokumente von Systems ManagerVSS-Snapshot-Befehlsdokumente im Systems Manager ausführen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden Sie die Systems-Manager-Befehlsdokumente, um VSS-aktivierte Snapshots zu erstellen

Sie können AWS Systems Manager-Befehlsdokumente verwenden, um VSS-aktivierte Snapshots zu erstellen. Im Folgenden werden die verfügbaren Befehlsdokumente und die Laufzeitparameter vorgestellt, die die Dokumente zur Erstellung Ihrer Snapshots verwenden.

Bevor Sie eines der Befehlsdokumente von Systems Manager verwenden, stellen Sie sicher, dass Sie alle Anforderungen von Voraussetzungen für die Erstellung von Windows-VSS-basierten EBS-Snapshots erfüllt haben.

Parameter für VSS-Snapshot-Dokumente von Systems Manager

Die Systems-Manager-Dokumente, die VSS-Snapshots erstellen, verwenden alle die folgenden Parameter, sofern nicht anders angegeben:

AmiName (Zeichenfolge, optional)

Wenn die Option CreateAmi auf True festgelegt ist, geben Sie den Namen des AMI an, das das Backup erstellt.

description (Zeichenfolge, optional)

Geben Sie eine Beschreibung für die Snapshots oder das Image an, das dieser Prozess erstellt.

CollectDiagnosticLogs (Zeichenfolge, optional)

Um während der Schritte zur Snapshot- und AMI-Erstellung weitere Informationen zu sammeln, setzen Sie diesen Parameter auf „True“. Der Standardwert für diesen Parameter ist „False“. Konsolidierte Diagnoseprotokolle werden als .zip-Formatarchiv am folgenden Speicherort auf Ihrer Instance gespeichert:

C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip

CopyOnly (Zeichenfolge, optional)

Wenn Sie zusätzlich zu AWS VSS das native SQL-Server-Backup verwenden, verhindert das Ausführen eines Copy-only-Backups, dass AWS VSS die native differentielle Sicherungskette unterbricht. Um einen Copy-only-Backup-Vorgang durchzuführen, setzen Sie diesen Parameter auf True.

Der Standardwert für diesen Parameter ist False, was dazu führt, dass AWS VSS einen vollständigen Sicherungsvorgang durchführt.

CreateAmi (Zeichenfolge, optional)

Um ein VSS-fähiges Amazon Machine Image (AMI) zum Sichern Ihrer Instance zu erstellen, setzen Sie diesen Parameter auf True. Der Standardwert für diesen Parameter ist False, wodurch Ihre Instance stattdessen mit einem EBS-Snapshot gesichert wird.

Weitere Informationen zum Erstellen einer AMI von einer Instance finden Sie unter Ein Amazon-EBS-gestütztes AMI erstellen.

executionTimeout (Zeichenfolge, optional)

Geben Sie die maximale Zeit in Sekunden an, um den Snapshot-Erstellungsprozess auf der Instance auszuführen oder ein AMI aus der Instance zu erstellen. Wenn Sie dieses Timeout erhöhen, kann der Befehl länger warten, bis VSS mit dem Einfrieren beginnt und die Markierung der von ihm erstellten Ressourcen abgeschlossen hat. Dieses Timeout gilt nur für die Schritte zur Snapshot- oder AMI-Erstellung. Der erste Schritt zur Installation oder Aktualisierung des Pakets AwsVssComponents ist nicht im Timeout enthalten.

ExcludeBootVolume (Zeichenfolge, optional)

Mit dieser Einstellung werden Boot-Volumes aus dem Sicherungsvorgang ausgeschlossen, wenn Sie Snapshots erstellen. Um Boot-Volumes aus Ihren Snapshots auszuschließen, setzen Sie ExcludeBootVolume auf True und CreateAmi auf False.

Wenn Sie ein AMI für Ihr Backup erstellen, sollte dieser Parameter auf False gesetzt werden. Der Standardwert für diesen Parameter ist False.

NoWriters (Zeichenfolge, optional)

Um Anwendungs-VSS-Writer vom Snapshot-Vorgang auszuschließen, setzen Sie diesen Parameter auf True. Anwendungs-VSS-Writer auszuschließen kann Ihnen helfen, Konflikte mit VSS-Backup-Komponenten von Drittanbietern zu lösen. Der Standardwert für diesen Parameter ist False.

Wenn SaveVssMetadata True ist, muss dieser Parameter auf False gesetzt sein.

SaveVssMetadata (Zeichenfolge, optional)

Um VSS-Metadatendateien bei jedem Snapshot zu speichern, setzen Sie diesen Parameter auf True. Der Standardwert ist False. VSS-Metadatendateien geben Aufschluss darüber, welche Komponenten oder Writer in einen Backup-Vorgang einbezogen wurden und welche Dateien jeder Komponente zugeordnet sind.

Metadatendateien haben die zugehörige Snapshot-Set-ID im Namen. Sie finden sie an der folgenden Stelle auf Ihrer Instance:

C:\ProgramData\Amazon\AwsVss\VssMetadata\
Warnung

  • Das Speichern von VSS-Metadatendateien erfordert die AwsVssComponents-Paketversion 2.4.0 oder höher. Wenn auf Ihrer Instance eine frühere Version installiert ist, führt die Einstellung von SaveVssMetadata auf True dazu, dass die Snapshot-Erstellung fehlschlägt.

  • Die Parameter NoWriters und SaveVssMetadata schließen sich gegenseitig aus. Wenn beide auf True gesetzt sind, schlägt die Snapshot-Erstellung fehl.

tags (Zeichenfolge, optional)

Wir empfehlen Ihnen, Ihre Snapshots und Bilder mit Tags zu versehen, damit Sie Ihre Ressourcen leichter finden und verwalten können, z. B. um Volumes aus einer Liste von Snapshots wiederherzustellen. Das System fügt den Name-Schlüssel mit einem leeren Wert hinzu, in dem Sie den Namen angeben können, den Sie auf Ihre ausgegebenen Schnappschüsse oder Bilder anwenden möchten.

Wenn Sie zusätzliche Tags angeben möchten, trennen Sie die einzelnen Tags durch Semikolon. Beispiel, Key=Environment,Value=Test;Key=User,Value=TestUser1.

Anmerkung

Tag-Schlüssel und -Werte dürfen nur alphanumerische Zeichen und die folgenden Sonderzeichen enthalten: () ./\-"'@_+:={}.

Standardmäßig fügt das System die folgenden reservierten Tags für VSS-basierte Snapshots und Bilder hinzu.

  • Gerät – Bei VSS-basierten Snapshots ist dies der Gerätename des EBS-Volumes, das der Snapshot erfasst.

  • AppConsistent – Dieses Tag zeigt die erfolgreiche Erstellung eines VSS-basierten Snapshots oder AMIs an.

  • AwsVssConfig – Identifiziert Snapshots und AMIs, die mit aktiviertem VSS erstellt wurden. Das Tag enthält Metainformationen wie die AwsVssComponents-Version und die Snapshot-Set-ID.

Warnung

Die Angabe eines dieser reservierten Tags in Ihrer Parameterliste führt zu einem Fehler.

VssVersion (Zeichenfolge, optional)

Sie können nur für das AWSEC2-VssInstallAndSnapshot-Dokument den Parameter VssVersion angeben, um eine bestimmte Version des AwsVssComponents-Pakets auf Ihrer Instance zu installieren. Lassen Sie diesen Parameter leer, um die empfohlene Standardversion zu installieren.

Wenn die angegebene Version des Pakets AwsVssComponents bereits installiert ist, überspringt das Skript den Installationsschritt und fährt mit dem Backup-Schritt fort. Eine Liste der AwsVssComponents-Paketversionen und der Betriebsunterstützung finden Sie unter Versionsverlauf der AWS VSS-Lösung.

VSS-Snapshot-Befehlsdokumente im Systems Manager ausführen

VSS-fähige EBS-Snapshots mit AWS Systems Manager-Befehlsdokumenten können von Ihnen wie folgt erstellt werden.

Wenn Sie AWS Systems Manager verwenden, um das Dokument AWSEC2-VssInstallAndSnapshot auszuführen, führt das Skript die folgenden Schritte aus.

  1. Das Skript installiert oder aktualisiert zuerst das Paket AwsVssComponents auf Ihrer Instance, je nachdem, ob es bereits installiert ist.

  2. Das Skript erstellt die anwendungskonsistenten Snapshots, nachdem der erste Schritt abgeschlossen ist.

Folgen Sie den Schritten für Ihre bevorzugte Umgebung, um das Dokument AWSEC2-VssInstallAndSnapshot auszuführen.

Console
VSS-fähige EBS-Snapshots über die Konsole erstellen

  1. Öffnen Sie die AWS Systems Manager-Konsole unter https://console.aws.amazon.com/systems-manager/.

  2. Wählen Sie im Navigationsbereich Befehl ausführen. Hier wird gegebenenfalls eine Liste der Befehle angezeigt, die derzeit in Ihrem Konto ausgeführt werden.

  3. Wählen Sie Befehl ausführen aus. Dadurch wird eine Liste von Befehlsdokumenten geöffnet, auf die Sie Zugriff haben.

  4. Wählen Sie AWSEC2-VssInstallAndSnapshot aus der Liste der Befehlsdokumente aus. Um die Ergebnisse zu optimieren, können Sie den Dokumentnamen ganz oder teilweise eingeben. Sie können auch nach dem Eigentümer, nach Plattformtypen oder nach Tags filtern.

    Wenn Sie ein Befehlsdokument auswählen, werden die Details unter der Liste angezeigt.

  5. Wählen Sie Default version at runtime aus der Liste der Dokumentversionen.

  6. Konfigurieren Sie die Befehlsparameter, um zu definieren, wie AWSEC2-VssInstallAndSnapshot das Paket AwsVssComponents installieren und mit VSS-Snapshots oder einem AMI sichern soll. Einzelheiten zu den Parametern finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

  7. Geben Sie für Zielauswahl Tags an oder wählen Sie Instances manuell, um die Instances zu identifizieren, in denen Sie diesen Vorgang ausführen möchten.

    Anmerkung

    Wenn Sie entscheiden, Instances manuell auszuwählen, und eine von Ihnen erwartete Instance nicht in der Liste enthalten ist, finden Sie Tipps zur Fehlersuche unter Wo sind meine Instances?.

  8. Für zusätzliche Parameter zur Definition des Verhaltens von Systems Manager Run Command, wie z. B. die Ratensteuerung, geben Sie Werte ein, wie unter Befehle von der Konsole ausführen beschrieben.

  9. Wählen Sie Run (Ausführen) aus.

    Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach suchen AppConsistent. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die Systems Manager-Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren. Wenn der Befehl erfolgreich abgeschlossen wurde, ein bestimmtes Volume-Backup jedoch fehlgeschlagen ist, können Sie in der Liste der EBS-Volumes nach Informationen zur Problembehebung suchen.

AWS CLI

Sie können die folgenden Befehle in der AWS CLI ausführen, um VSS-basierte EBS-Snapshots zu erstellen und den Status der Snapshot-Erstellung abzurufen.

VSS-basierte Snapshots erstellen

Führen Sie den folgenden Befehl aus, um VSS-basierte EBS-Snapshots zu erstellen. Um die Snapshots zu erstellen, müssen Sie die Instances mit dem --instance-ids-Parameter identifizieren. Weitere Informationen zu andere Parameter, die Sie verwenden können, finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

aws ssm send-command \
	--document-name "AWSEC2-VssInstallAndSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'

Bei Erfolg füllt das Befehlsdokument die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach suchen AppConsistent. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren.

Abrufen des Befehlsstatus

Um den aktuellen Status der Snapshots abzurufen, führen Sie den folgenden Befehl mit der Befehls-ID aus, die von send-command zurückgegeben wurde.

aws ssm get-command-invocation
	--instance-ids "i-01234567890abcdef" \
	--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
	--plugin-name "CreateVssSnapshot"
PowerShell

Führen Sie die folgenden Befehle mit AWS Tools for Windows PowerShell aus, um VSS-basierte EBS-Snapshots zu erstellen und den aktuellen Laufzeitstatus bei der Erstellung Ihrer Ausgabe abzurufen. Geben Sie die in der vorherigen Liste beschriebenen Parameter an, um das Verhalten des Snapshot-Prozesses zu ändern.

VSS-fähige EBS-Snapshots mit PowerShell Tools für Windows erstellen

Führen Sie den folgenden Befehl aus, um VSS-basierte EBS-Snapshots oder AMIs zu erstellen.

Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
Abrufen des Befehlsstatus

Um den aktuellen Status der Snapshots abzurufen, führen Sie den folgenden Befehl mit der Befehls-ID aus, die von Send-SSMCommand zurückgegeben wurde.

Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"

Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach suchen AppConsistent. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren.

Folgen Sie den Schritten für Ihre bevorzugte Umgebung, um das Dokument AWSEC2-CreateVssSnapshot auszuführen.

Console
VSS-fähige EBS-Snapshots über die Konsole erstellen

  1. Öffnen Sie die AWS Systems Manager-Konsole unter https://console.aws.amazon.com/systems-manager/.

  2. Wählen Sie im Navigationsbereich Befehl ausführen. Hier wird gegebenenfalls eine Liste der Befehle angezeigt, die derzeit in Ihrem Konto ausgeführt werden.

  3. Wählen Sie Befehl ausführen aus. Dadurch wird eine Liste von Befehlsdokumenten geöffnet, auf die Sie Zugriff haben.

  4. Wählen Sie AWSEC2-CreateVssSnapshot aus der Liste der Befehlsdokumente aus. Um die Ergebnisse zu optimieren, können Sie den Dokumentnamen ganz oder teilweise eingeben. Sie können auch nach dem Eigentümer, nach Plattformtypen oder nach Tags filtern.

    Wenn Sie ein Befehlsdokument auswählen, werden die Details unter der Liste angezeigt.

  5. Wählen Sie Default version at runtime aus der Liste der Dokumentversionen.

  6. Konfigurieren Sie die Befehlsparameter, um zu definieren, wie AWSEC2-CreateVssSnapshot mit VSS-Snapshots oder einem AMI gesichert werden soll. Einzelheiten zu den Parametern finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

  7. Geben Sie für Zielauswahl Tags an oder wählen Sie Instances manuell, um die Instances zu identifizieren, in denen Sie diesen Vorgang ausführen möchten.

    Anmerkung

    Wenn Sie entscheiden, Instances manuell auszuwählen, und eine von Ihnen erwartete Instance nicht in der Liste enthalten ist, finden Sie Tipps zur Fehlersuche unter Wo sind meine Instances?.

  8. Für zusätzliche Parameter zur Definition des Verhaltens von Systems Manager Run Command, wie z. B. die Ratensteuerung, geben Sie Werte ein, wie unter Befehle von der Konsole ausführen beschrieben.

  9. Wählen Sie Run (Ausführen) aus.

    Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach suchen AppConsistent. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die Systems Manager-Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren. Wenn der Befehl erfolgreich abgeschlossen wurde, ein bestimmtes Volume-Backup jedoch fehlgeschlagen ist, können Sie in der Liste der EBS-Volumes nach Informationen zur Problembehebung suchen.

AWS CLI

Sie können den folgenden Befehl in der AWS CLI ausführen, um VSS-basierte EBS-Snapshots zu erstellen.

VSS-basierte Snapshots erstellen

Führen Sie den folgenden Befehl aus, um VSS-basierte EBS-Snapshots zu erstellen. Um die Snapshots zu erstellen, müssen Sie die Instances mit dem --instance-ids-Parameter identifizieren. Weitere Informationen zu andere Parameter, die Sie verwenden können, finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

aws ssm send-command \
	--document-name "AWSEC2-CreateVssSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'

Bei Erfolg füllt das Befehlsdokument die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach suchen AppConsistent. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren.

PowerShell

Führen Sie den folgenden Befehl mit AWS Tools for Windows PowerShell aus, um VSS-basierte EBS-Snapshots zu erstellen.

VSS-fähige EBS-Snapshots mit PowerShell Tools für Windows erstellen

Führen Sie den folgenden Befehl aus, um VSS-basierte EBS-Snapshots zu erstellen. Um die Snapshots zu erstellen, müssen Sie die Instances mit dem InstanceId-Parameter identifizieren. Sie können mehr als eine Instance angeben, für die Snapshots erstellt werden. Weitere Informationen zu andere Parameter, die Sie verwenden können, finden Sie unter Parameter für VSS-Snapshot-Dokumente von Systems Manager.

Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value'}

Bei Erfolg füllt der Befehl die Liste der EBS-Snapshots mit den neuen Snapshots. Sie können diese Snapshots in der Liste der EBS-Snapshots suchen, indem Sie nach den angegebenen Tags (Markierungen) oder nach suchen AppConsistent. Wenn die Befehlsausführung fehlgeschlagen ist, zeigen Sie die -Befehlsausgabe an, um nähere Informationen zum Grund hierfür zu erfahren. Wenn der Befehl erfolgreich abgeschlossen wurde, ein bestimmtes Volume-Backup jedoch fehlgeschlagen ist, können Sie in der Liste der EBS-Snapshots nach Informationen zur Problembehebung suchen.

Sie können jedes der im vorherigen Abschnitt beschriebenen Befehlszeilenverfahren verwenden, um einen VSS-basierten Snapshot zu erstellen. Das Befehlsdokument (AWSEC2-VssInstallAndSnapshot oder AWSEC2-CreateVssSnapshot) muss auf dem Primärknoten in Ihrem Cluster ausgeführt werden. Das Dokument schlägt auf den sekundären Knoten fehl, da sie keinen Zugriff auf die gemeinsam genutzten Festplatten haben. Wenn sich Ihr primärer und sekundärer Knoten dynamisch ändern, können Sie das Dokument „Befehl AWS Systems Manager ausführen“ auf mehreren Knoten ausführen, in der Erwartung, dass der Befehl auf dem primären Knoten erfolgreich ist und auf sekundären Knoten fehlschlägt.

Anmerkung

Sie können Backups automatisieren, indem Sie in AWS Systems Manager eine Wartungsfenster-Aufgabe erstellen, die das Dokument AWSEC2-VssInstallAndSnapshot verwendet. Weitere Informationen finden Sie unter Arbeiten mit Wartungsfenstern (Konsole) im Benutzerhandbuch für AWS Systems Manager.