Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Remplacement de votre AWS DataSync agent
Pour remplacer un AWS DataSync agent, vous devez créer un nouvel agent et mettre à jour tous les sites de transfert utilisant l'ancien agent.
## Création d'un nouvel agent
Pour créer votre nouvel DataSync agent, suivez le même processus que lorsque vous avez créé votre ancien agent :
1. [Déployez un agent](deploy-agents.md) dans votre environnement de stockage.
1. [Choisissez un point de terminaison de service](choose-service-endpoint.md) avec lequel l'agent communique AWS.
1. [Configurez votre réseau](datasync-network.md) afin que l'agent puisse communiquer avec votre système de stockage et AWS.
1. [Activez votre agent](activate-agent.md).
1. Une fois activé, notez le nom de ressource Amazon (ARN) de l'agent.
Vous avez besoin de cet ARN lorsque vous mettez à jour votre DataSync position pour utiliser le nouvel agent.
## Mettre à jour votre position avec le nouvel agent
Une fois que vous avez créé un nouvel agent, vous pouvez mettre à jour un DataSync emplacement existant pour utiliser cet agent. Dans la plupart des cas, vous devez également saisir à nouveau les informations d'accès pour mettre à jour l'emplacement. Cela est dû au fait que DataSync les informations de localisation sont stockées de manière à ce que seul votre agent puisse les utiliser.
### Utilisation de la DataSync console
Les instructions suivantes décrivent comment mettre à jour les emplacements avec un nouvel agent à l'aide de la DataSync console.
------
#### [ NFS ]
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Locations**.
1. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez **Modifier**.
1. Pour les **agents**, choisissez votre nouvel agent.
Vous pouvez choisir plusieurs agents si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) par point de vente.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ SMB ]
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Locations**.
1. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez **Modifier**.
1. Pour les **agents**, choisissez votre nouvel agent.
Vous pouvez choisir plusieurs agents si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) par point de vente.
1. Dans **Mot de passe**, entrez le mot de passe de l'utilisateur qui peut monter votre serveur de fichiers SMB et qui est autorisé à accéder aux fichiers et dossiers concernés par votre transfert.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ HDFS ]
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Locations**.
1. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez **Modifier**.
1. Pour les **agents**, choisissez votre nouvel agent.
Vous pouvez choisir plusieurs agents si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) par point de vente.
1. Si vous utilisez l'authentification Kerberos, téléchargez votre fichier **Keytab et votre fichier** de configuration **Kerberos**.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Object storage ]
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Locations**.
1. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez **Modifier**.
1. Pour les **agents**, choisissez votre nouvel agent.
Vous pouvez choisir plusieurs agents si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) par point de vente.
1. Si votre emplacement nécessite des informations d'identification, entrez la **clé secrète** qui permet d'accéder DataSync à votre compartiment de stockage d'objets.
1. Sélectionnez **Enregistrer les modifications**.
------
#### [ Azure Blob Storage ]
Procédez comme suit pour mettre à jour votre Microsoft Azure Blob Storage lieu :
1. Ouvrez la AWS DataSync console à l'adresse [https://console.aws.amazon.com/datasync/](https://console.aws.amazon.com/datasync/).
1. Dans le volet de navigation de gauche, développez **Transfert de données**, puis choisissez **Locations**.
1. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez **Modifier**.
1. Pour les **agents**, choisissez votre nouvel agent.
Vous pouvez choisir plusieurs agents si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) par point de vente.
1. Pour le **jeton SAS**, entrez le [jeton de signature d'accès partagé (SAS)](creating-azure-blob-location.md#azure-blob-sas-tokens) qui permet DataSync d'accéder à votre stockage blob.
1. Sélectionnez **Enregistrer les modifications**.
------
### En utilisant le AWS CLI
Les instructions suivantes décrivent comment mettre à jour les emplacements avec un nouvel agent à l'aide du AWS CLI. (Vous pouvez également le faire en utilisant l'[DataSync API](https://docs.aws.amazon.com/datasync/latest/userguide/API_Operations.html).)
------
#### [ NFS ]
1. Copiez la [update-location-nfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-nfs.html)commande suivante :
```
aws datasync update-location-nfs \
--location-arn datasync-nfs-location-arn \
--on-prem-config AgentArns=new-datasync-agent-arn
```
1. Pour le `--location-arn` paramètre, spécifiez l'ARN de l'emplacement NFS que vous mettez à jour.
1. Pour l'`AgentArns`option du `--on-prem-config` paramètre, spécifiez l'ARN de votre nouvel agent.
Vous pouvez spécifier plusieurs ARN si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) pour un même emplacement.
1. Exécutez la `update-location-nfs` commande pour mettre à jour l'emplacement.
------
#### [ SMB ]
1. Copiez la [update-location-smb](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-smb.html)commande suivante :
```
aws datasync update-location-smb \
--location-arn datasync-smb-location-arn \
--agent-arns new-datasync-agent-arn \
--password smb-file-server-password
```
1. Pour le `--location-arn` paramètre, spécifiez l'ARN de l'emplacement SMB que vous mettez à jour.
1. Pour le `--agent-arns` paramètre, spécifiez l'ARN de votre nouvel agent.
Vous pouvez spécifier plusieurs ARN si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) pour un même emplacement.
1. Pour le `--password` paramètre, spécifiez le mot de passe de l'utilisateur qui peut monter votre serveur de fichiers SMB et qui est autorisé à accéder aux fichiers et dossiers concernés par votre transfert.
1. Exécutez la `update-location-smb` commande pour mettre à jour l'emplacement.
------
#### [ HDFS ]
1. Copiez la [update-location-hdfs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-hdfs.html)commande suivante :
```
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. Pour le `--location-arn` paramètre, spécifiez l'ARN de l'emplacement HDFS que vous mettez à jour.
1. Pour le `--agent-arns` paramètre, spécifiez l'ARN de votre nouvel agent.
Vous pouvez spécifier plusieurs ARN si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) pour un même emplacement.
1. Si vous utilisez l'authentification Kerberos, incluez les paramètres `--kerberos-keytab` et `--kerberos-krb5-conf` :
+ Pour le `--kerberos-keytab` paramètre, spécifiez la table des clés Kerberos (keytab) qui contient les mappages entre les clés principales Kerberos définies et les clés chiffrées.
Vous pouvez spécifier le fichier keytab en fournissant l'adresse du fichier.
+ Pour le `--kerberos-krb5-conf` paramètre, spécifiez le fichier contenant la configuration de votre domaine Kerberos.
Vous pouvez spécifier le `krb5.conf` fichier en fournissant son adresse.
Si vous utilisez l'authentification simple, il n'est pas nécessaire d'inclure ces paramètres liés à Kerberos dans votre commande.
1. Exécutez la `update-location-hdfs` commande pour mettre à jour l'emplacement.
------
#### [ Object storage ]
1. Copiez la [update-location-object-storage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-object-storage.html)commande suivante :
```
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. Pour le `--location-arn` paramètre, spécifiez l'ARN de l'emplacement de stockage d'objets que vous mettez à jour.
1. Pour le `--agent-arns` paramètre, spécifiez l'ARN de votre nouvel agent.
Vous pouvez spécifier plusieurs ARN si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) pour un même emplacement.
1. Procédez comme suit selon que votre emplacement de stockage d'objets nécessite des informations d'identification d'accès :
+ **Si votre emplacement nécessite des informations d'identification** : pour le `--secret-key` paramètre, spécifiez la clé secrète qui permet d'accéder DataSync à votre bucket de stockage d'objets.
+ **Si votre position nécessite des informations d'identification**, spécifiez des chaînes vides pour les `--secret-key` paramètres `--access-key` et. Voici un exemple de commande :
```
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. Exécutez la `update-location-object-storage` commande pour mettre à jour l'emplacement.
------
#### [ Azure Blob Storage ]
1. Copiez la [update-location-azure-blob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/datasync/update-location-azure-blob.html)commande suivante :
```
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. Pour le `--location-arn` paramètre, spécifiez l'ARN du Azure Blob Storage emplacement que vous êtes en train de mettre à jour.
1. Pour le `--agent-arns` paramètre, spécifiez l'ARN de votre nouvel agent.
Vous pouvez spécifier plusieurs ARN si vous remplacez [plusieurs agents](do-i-need-datasync-agent.md#multiple-agents) pour un même emplacement.
1. Pour l'`Token`option du `--sas-configuration` paramètre, spécifiez le [jeton SAS](creating-azure-blob-location.md#azure-blob-sas-tokens) qui permet d'accéder DataSync à votre stockage blob.
1. Exécutez la `update-location-azure-blob` commande pour mettre à jour l'emplacement.
------
## Étapes suivantes
1. [Supprimez votre ancien agent](clean-up.md#deleting-agent). Si vous avez des DataSync tâches en cours d'exécution à l'aide de cet agent, attendez qu'elles soient terminées avant de les supprimer.
1. Si vous devez remplacer les agents de plusieurs sites, répétez les étapes précédentes.
1. Lorsque vous avez terminé, vous pouvez reprendre l'[exécution de vos tâches](run-task.md).
**Note**
**Remplacement d'agents par des tâches planifiées** : si vous remplacez un agent pour une [tâche planifiée](task-scheduling.md), vous devez démarrer cette tâche manuellement si le nouvel agent utilise un type de point de [terminaison de service](choose-service-endpoint.md) différent de celui de votre ancien agent. Si vous n'exécutez pas la tâche manuellement avant sa prochaine exécution planifiée, elle échoue.
Par exemple, si votre ancien agent utilisait un point de terminaison de service public, mais que le nouvel agent utilise un point de terminaison VPC, lancez cette tâche manuellement à l'aide de la console ou `StartTaskExecution` de l'opération. Ensuite, votre tâche reprendra son exécution selon son calendrier.