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.
# Ihren AWS DataSync Agenten ersetzen
Um einen AWS DataSync Agenten zu ersetzen, müssen Sie einen neuen Agenten erstellen und alle Übertragungsorte aktualisieren, die den alten Agenten verwenden.
## Einen neuen Agenten erstellen
Um Ihren neuen DataSync Agenten zu erstellen, gehen Sie genauso vor, wie Sie Ihren alten Agenten erstellt haben:
1. [Stellen Sie einen Agenten](deploy-agents.md) in Ihrer Speicherumgebung bereit.
1. [Wählen Sie einen Service-Endpunkt](choose-service-endpoint.md), mit dem der Agent kommuniziert AWS.
1. [Konfigurieren Sie Ihr Netzwerk](datasync-network.md) so, dass der Agent mit Ihrem Speicher kommunizieren kann und AWS.
1. [Aktivieren Sie Ihren Agenten](activate-agent.md).
1. Notieren Sie sich nach der Aktivierung den Amazon-Ressourcennamen (ARN) des Agenten.
Sie benötigen diesen ARN, wenn Sie Ihren DataSync Standort aktualisieren, um den neuen Agenten verwenden zu können.
## Aktualisierung Ihres Standorts mit dem neuen Agenten
Sobald Sie einen neuen Agenten erstellt haben, können Sie einen vorhandenen DataSync Standort aktualisieren, um diesen Agenten zu verwenden. In den meisten Fällen müssen Sie auch die Zugangsdaten erneut eingeben, um den Standort zu aktualisieren. Dies liegt daran, dass die Anmeldeinformationen für den Standort so DataSync gespeichert werden, dass nur Ihr Agent sie verwenden kann.
### Verwenden der DataSync Konsole
In den folgenden Anweisungen wird beschrieben, wie Sie Standorte mithilfe der DataSync Konsole mit einem neuen Agenten aktualisieren.
------
#### [ NFS ]
1. Öffnen Sie die AWS DataSync Konsole unter [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Erweitern Sie im linken Navigationsbereich die Option **Datenübertragung** und wählen Sie dann **Standorte** aus.
1. Wählen Sie den Standort aus, den Sie aktualisieren möchten, und klicken Sie dann auf **Bearbeiten**.
1. Wählen Sie für **Agenten** Ihren neuen Agenten aus.
Sie können mehr als einen Agenten auswählen, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen möchten.
1. Wählen Sie **Änderungen speichern**.
------
#### [ SMB ]
1. Öffnen Sie die AWS DataSync Konsole unter [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Erweitern Sie im linken Navigationsbereich die Option **Datenübertragung** und wählen Sie dann **Standorte** aus.
1. Wählen Sie den Standort aus, den Sie aktualisieren möchten, und klicken Sie dann auf **Bearbeiten**.
1. Wählen Sie für **Agenten** Ihren neuen Agenten aus.
Sie können mehr als einen Agenten auswählen, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen möchten.
1. Geben Sie **unter Passwort** das Passwort des Benutzers ein, der Ihren SMB-Dateiserver bereitstellen kann und über Zugriffsrechte auf die Dateien und Ordner verfügt, die an Ihrer Übertragung beteiligt sind.
1. Wählen Sie **Änderungen speichern**.
------
#### [ HDFS ]
1. Öffnen Sie die AWS DataSync Konsole unter. [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/)
1. Erweitern Sie im linken Navigationsbereich die Option **Datenübertragung** und wählen Sie dann **Standorte** aus.
1. Wählen Sie den Standort aus, den Sie aktualisieren möchten, und klicken Sie dann auf **Bearbeiten**.
1. Wählen Sie für **Agenten** Ihren neuen Agenten aus.
Sie können mehr als einen Agenten auswählen, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen möchten.
1. Wenn Sie die Kerberos-Authentifizierung verwenden, laden Sie Ihre **Keytab-Datei und die **Kerberos-Konfigurationsdatei**** hoch.
1. Wählen Sie **Änderungen speichern**.
------
#### [ Object storage ]
1. Öffnen Sie die Konsole unter. AWS DataSync [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/)
1. Erweitern Sie im linken Navigationsbereich die Option **Datenübertragung** und wählen Sie dann **Standorte** aus.
1. Wählen Sie den Standort aus, den Sie aktualisieren möchten, und klicken Sie dann auf **Bearbeiten**.
1. Wählen Sie für **Agenten** Ihren neuen Agenten aus.
Sie können mehr als einen Agenten auswählen, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen möchten.
1. Wenn für Ihren Standort Anmeldeinformationen erforderlich sind, geben Sie den **geheimen Schlüssel** ein, der den DataSync Zugriff auf Ihren Objektspeicher-Bucket ermöglicht.
1. Wählen Sie **Änderungen speichern**.
------
#### [ Azure Blob Storage ]
Gehen Sie wie folgt vor, um Ihre zu aktualisieren Microsoft Azure Blob Storage Standort:
1. Öffnen Sie die AWS DataSync Konsole unter [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Erweitern Sie im linken Navigationsbereich die Option **Datenübertragung** und wählen Sie dann **Standorte** aus.
1. Wählen Sie den Standort aus, den Sie aktualisieren möchten, und klicken Sie dann auf **Bearbeiten**.
1. Wählen Sie für **Agenten** Ihren neuen Agenten aus.
Sie können mehr als einen Agenten auswählen, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen möchten.
1. Geben Sie **als SAS-Token** das [Shared Access Signature (SAS) -Token](creating-azure-blob-location.md#azure-blob-sas-tokens) ein, das DataSync den Zugriff auf Ihren Blob-Speicher ermöglicht.
1. Wählen Sie **Änderungen speichern**.
------
### Verwenden Sie den AWS CLI
Die folgenden Anweisungen beschreiben, wie Sie Standorte mit einem neuen Agenten aktualisieren, indem Sie den verwenden AWS CLI. (Sie können dies auch mithilfe der [DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html) tun.)
------
#### [ NFS ]
1. Kopieren Sie den folgenden [update-location-nfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html)Befehl:
```
aws datasync update-location-nfs \
--location-arn datasync-nfs-location-arn \
--on-prem-config AgentArns=new-datasync-agent-arn
```
1. Geben Sie für den `--location-arn` Parameter den ARN des NFS-Speicherorts an, den Sie aktualisieren.
1. Geben Sie für die `AgentArns` Option des `--on-prem-config` Parameters den ARN Ihres neuen Agenten an.
Sie können mehr als einen ARN angeben, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen.
1. Führen Sie den `update-location-nfs` Befehl aus, um den Standort zu aktualisieren.
------
#### [ SMB ]
1. Kopieren Sie den folgenden [update-location-smb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html)Befehl:
```
aws datasync update-location-smb \
--location-arn datasync-smb-location-arn \
--agent-arns new-datasync-agent-arn \
--password smb-file-server-password
```
1. Geben Sie für den `--location-arn` Parameter den ARN des SMB-Standorts an, den Sie aktualisieren.
1. Geben Sie für den `--agent-arns` Parameter den ARN Ihres neuen Agenten an.
Sie können mehr als einen ARN angeben, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen.
1. Geben Sie für den `--password` Parameter das Passwort des Benutzers an, der Ihren SMB-Dateiserver bereitstellen kann und berechtigt ist, auf die Dateien und Ordner zuzugreifen, die an Ihrer Übertragung beteiligt sind.
1. Führen Sie den `update-location-smb` Befehl aus, um den Speicherort zu aktualisieren.
------
#### [ HDFS ]
1. Kopieren Sie den folgenden [update-location-hdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html)Befehl:
```
aws datasync update-location-hdfs \
--location-arn datasync-hdfs-location-arn \
--agent-arns new-datasync-agent-arn \
--kerberos-keytab keytab-file \
--kerberos-krb5-conf krb5-conf-file
```
1. Geben Sie für den `--location-arn` Parameter den ARN des HDFS-Speicherorts an, den Sie aktualisieren.
1. Geben Sie für den `--agent-arns` Parameter den ARN Ihres neuen Agenten an.
Sie können mehr als einen ARN angeben, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen.
1. Wenn Sie die Kerberos-Authentifizierung verwenden, geben Sie die Parameter `--kerberos-keytab` und `--kerberos-krb5-conf` an:
+ Geben Sie für den `--kerberos-keytab` Parameter die Kerberos-Schlüsseltabelle (Keytab) an, die Zuordnungen zwischen dem definierten Kerberos-Prinzipal und den verschlüsselten Schlüsseln enthält.
Sie können die Keytab-Datei angeben, indem Sie die Adresse der Datei angeben.
+ Geben Sie für den `--kerberos-krb5-conf` Parameter die Datei an, die die Konfiguration für Ihren Kerberos-Bereich enthält.
Sie können die `krb5.conf` Datei angeben, indem Sie die Adresse der Datei angeben.
Wenn Sie die einfache Authentifizierung verwenden, müssen Sie diese Kerberos-bezogenen Parameter nicht in Ihren Befehl aufnehmen.
1. Führen Sie den `update-location-hdfs` Befehl aus, um den Speicherort zu aktualisieren.
------
#### [ Object storage ]
1. Kopieren Sie den folgenden [update-location-object-storage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html)Befehl:
```
aws datasync update-location-object-storage \
--location-arn datasync-object-storage-location-arn \
--agent-arns new-datasync-agent-arn \
--secret-key bucket-secret-key
```
1. Geben Sie für den `--location-arn` Parameter den ARN des Objektspeichers an, den Sie aktualisieren.
1. Geben Sie für den `--agent-arns` Parameter den ARN Ihres neuen Agenten an.
Sie können mehr als einen ARN angeben, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen.
1. Gehen Sie wie folgt vor, je nachdem, ob Ihr Objektspeicherort Zugangsdaten erfordert:
+ **Wenn für Ihren Standort Anmeldeinformationen erforderlich sind** — Geben Sie für den `--secret-key` Parameter den geheimen Schlüssel an, der den DataSync Zugriff auf Ihren Objektspeicher-Bucket ermöglicht.
+ **Wenn für Ihren Standort Anmeldeinformationen erforderlich sind** — Geben Sie leere Zeichenfolgen für die `--secret-key` Parameter `--access-key` und an. Hier ist ein Beispielbefehl:
```
aws datasync update-location-object-storage \
--location-arn arn:aws:datasync:us-east-2:111122223333:location/loc-abcdef01234567890 \
--agent-arns arn:aws:datasync:us-east-2:111122223333:agent/agent-1234567890abcdef0 \
--access-key "" \
--secret-key ""
```
1. Führen Sie den `update-location-object-storage` Befehl aus, um den Standort zu aktualisieren.
------
#### [ Azure Blob Storage ]
1. Kopieren Sie den folgenden [update-location-azure-blob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html)Befehl:
```
aws datasync update-location-azure-blob \
--location-arn datasync-azure-blob-storage-location-arn \
--agent-arns new-datasync-agent-arn \
--sas-configuration '{
"Token": "sas-token-for-azure-blob-storage"
}'
```
1. Geben Sie für den `--location-arn` Parameter den ARN des Azure Blob Storage Standort, den Sie aktualisieren.
1. Geben Sie für den `--agent-arns` Parameter den ARN Ihres neuen Agenten an.
Sie können mehr als einen ARN angeben, wenn Sie [mehrere Agenten](do-i-need-datasync-agent.md#multiple-agents) für einen Standort ersetzen.
1. Geben Sie für die `Token` Option des `--sas-configuration` Parameters das [SAS-Token](creating-azure-blob-location.md#azure-blob-sas-tokens) an, das den DataSync Zugriff auf Ihren Blob-Speicher ermöglicht.
1. Führen Sie den `update-location-azure-blob` Befehl aus, um den Speicherort zu aktualisieren.
------
## Nächste Schritte
1. [Löschen Sie Ihren alten Agenten](clean-up.md#deleting-agent). Wenn Sie DataSync Aufgaben ausführen, die diesen Agenten verwenden, warten Sie, bis diese Aufgaben abgeschlossen sind, bevor Sie ihn löschen.
1. Wenn Sie Agenten für mehrere Standorte ersetzen müssen, wiederholen Sie die vorherigen Schritte.
1. Wenn Sie fertig sind, können Sie [Ihre Aufgaben wieder ausführen](run-task.md).
**Anmerkung**
**Agenten für geplante Aufgaben** ersetzen — Wenn Sie einen Agenten für eine [geplante Aufgabe](task-scheduling.md) ersetzen, müssen Sie diese Aufgabe manuell starten, wenn der neue Agent einen anderen Typ von [Service-Endpunkt](choose-service-endpoint.md) verwendet als Ihr alter Agent. Wenn Sie die Aufgabe vor der nächsten geplanten Ausführung nicht manuell ausführen, schlägt die Aufgabe fehl.
Wenn Ihr alter Agent beispielsweise einen öffentlichen Dienstendpunkt verwendet hat, der neue Agent jedoch einen VPC-Endpunkt verwendet, starten Sie diese Aufgabe manuell über die Konsole oder den `StartTaskExecution` Vorgang. Danach wird Ihre Aufgabe wieder wie geplant ausgeführt.