Remplacement de votre AWS DataSync agent - AWS DataSync
Création d'un nouvel agentMettre à jour votre position avec le nouvel agentÉtapes suivantes

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 dans votre environnement de stockage.

  2. Choisissez un point de terminaison de service avec lequel l'agent communique AWS.

  3. Configurez votre réseau afin que l'agent puisse communiquer avec votre système de stockage et AWS.

  4. Activez votre agent.

  5. 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.

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/.

  2. Dans le volet de navigation de gauche, développez Transfert de données, puis choisissez Locations.

  3. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez Modifier.

  4. Pour les agents, choisissez votre nouvel agent.

    Vous pouvez choisir plusieurs agents si vous remplacez plusieurs agents par point de vente.

  5. Sélectionnez Enregistrer les modifications.

SMB

  1. Ouvrez la AWS DataSync console à l'adresse https://console.aws.amazon.com/datasync/.

  2. Dans le volet de navigation de gauche, développez Transfert de données, puis choisissez Locations.

  3. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez Modifier.

  4. Pour les agents, choisissez votre nouvel agent.

    Vous pouvez choisir plusieurs agents si vous remplacez plusieurs agents par point de vente.

  5. 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.

  6. Sélectionnez Enregistrer les modifications.

HDFS

  1. Ouvrez la AWS DataSync console à l'adresse https://console.aws.amazon.com/datasync/.

  2. Dans le volet de navigation de gauche, développez Transfert de données, puis choisissez Locations.

  3. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez Modifier.

  4. Pour les agents, choisissez votre nouvel agent.

    Vous pouvez choisir plusieurs agents si vous remplacez plusieurs agents par point de vente.

  5. Si vous utilisez l'authentification Kerberos, téléchargez votre fichier Keytab et votre fichier de configuration Kerberos.

  6. Sélectionnez Enregistrer les modifications.

Object storage

  1. Ouvrez la AWS DataSync console à l'adresse https://console.aws.amazon.com/datasync/.

  2. Dans le volet de navigation de gauche, développez Transfert de données, puis choisissez Locations.

  3. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez Modifier.

  4. Pour les agents, choisissez votre nouvel agent.

    Vous pouvez choisir plusieurs agents si vous remplacez plusieurs agents par point de vente.

  5. 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.

  6. 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/.

  2. Dans le volet de navigation de gauche, développez Transfert de données, puis choisissez Locations.

  3. Choisissez l'emplacement que vous souhaitez mettre à jour, puis choisissez Modifier.

  4. Pour les agents, choisissez votre nouvel agent.

    Vous pouvez choisir plusieurs agents si vous remplacez plusieurs agents par point de vente.

  5. Pour le jeton SAS, entrez le jeton de signature d'accès partagé (SAS) qui permet DataSync d'accéder à votre stockage blob.

  6. Sélectionnez Enregistrer les modifications.

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.)

NFS

  1. Copiez la update-location-nfscommande suivante :

    aws datasync update-location-nfs \
  --location-arn datasync-nfs-location-arn \
  --on-prem-config AgentArns=new-datasync-agent-arn

  2. Pour le --location-arn paramètre, spécifiez l'ARN de l'emplacement NFS que vous mettez à jour.

  3. Pour l'AgentArnsoption 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 pour un même emplacement.

  4. Exécutez la update-location-nfs commande pour mettre à jour l'emplacement.

SMB

  1. Copiez la update-location-smbcommande suivante :

    aws datasync update-location-smb \
  --location-arn datasync-smb-location-arn \
  --agent-arns new-datasync-agent-arn \
  --password smb-file-server-password

  2. Pour le --location-arn paramètre, spécifiez l'ARN de l'emplacement SMB que vous mettez à jour.

  3. 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 pour un même emplacement.

  4. 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.

  5. Exécutez la update-location-smb commande pour mettre à jour l'emplacement.

HDFS

  1. Copiez la update-location-hdfscommande 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

  2. Pour le --location-arn paramètre, spécifiez l'ARN de l'emplacement HDFS que vous mettez à jour.

  3. 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 pour un même emplacement.

  4. 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.

  5. Exécutez la update-location-hdfs commande pour mettre à jour l'emplacement.

Object storage

  1. Copiez la update-location-object-storagecommande 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

  2. Pour le --location-arn paramètre, spécifiez l'ARN de l'emplacement de stockage d'objets que vous mettez à jour.

  3. 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 pour un même emplacement.

  4. 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 ""

  5. Exécutez la update-location-object-storage commande pour mettre à jour l'emplacement.

Azure Blob Storage

  1. Copiez la update-location-azure-blobcommande 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"
    }'

  2. Pour le --location-arn paramètre, spécifiez l'ARN du Azure Blob Storage emplacement que vous êtes en train de mettre à jour.

  3. 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 pour un même emplacement.

  4. Pour l'Tokenoption du --sas-configuration paramètre, spécifiez le jeton SAS qui permet d'accéder DataSync à votre stockage blob.

  5. Exécutez la update-location-azure-blob commande pour mettre à jour l'emplacement.

Étapes suivantes

  1. Supprimez votre ancien 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.

  2. Si vous devez remplacer les agents de plusieurs sites, répétez les étapes précédentes.

  3. Lorsque vous avez terminé, vous pouvez reprendre l'exécution de vos tâches.

    Note

    Remplacement d'agents par des tâches planifiées : si vous remplacez un agent pour une tâche planifiée, vous devez démarrer cette tâche manuellement si le nouvel agent utilise un type de point de terminaison de service 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.