

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 passerelle de fichiers S3 existante par une nouvelle instance
<a name="migrate-data"></a>

Vous pouvez remplacer une passerelle de fichiers S3  existante par une nouvelle instance à mesure que vos besoins en données et en performances augmentent, ou si vous recevez une AWS notification vous demandant de migrer votre passerelle. Cela peut être nécessaire si vous souhaitez déplacer votre passerelle vers une meilleure plate-forme hôte ou des instances Amazon EC2 plus récentes, ou pour actualiser le matériel du serveur sous-jacent.

Il existe deux méthodes pour remplacer une passerelle de fichiers S3  existante. Le tableau suivant décrit les avantages et les inconvénients de chaque méthode. À l'aide de ces informations, sélectionnez la méthode la mieux adaptée à votre environnement de passerelle, puis reportez-vous aux étapes de procédure décrites dans la section correspondante ci-dessous.

**Note**  
Si vous devez vous [connecter à votre nouvelle console locale Storage Gateway pour utiliser](LocalConsole-login-fgw.md) l'une ou l'autre méthode, le nom d'utilisateur initial est *admin* et le mot de passe temporaire est *password*.

**Important**  
Utilisez ces instructions uniquement pour la migration des dispositifs de passerelle exécutant la version 1.x. Vous ne pouvez pas les utiliser pour migrer des dispositifs de passerelle exécutant des versions inférieures.


|  | **Méthode 1 : migrer le disque cache et l'ID de passerelle vers l'instance de remplacement\*** | **Méthode 2 : instance de remplacement avec un disque de cache vide et un nouvel ID de passerelle** | 
| --- | --- | --- | 
| **Données du disque cache** | Les données du disque cache sont préservées. Cette méthode est utile si votre passerelle dispose d'un disque cache volumineux ou si vos applications sont sensibles au retard causé par les opérations de out-of-cache lecture. | Les données en cache sont téléchargées depuis le AWS cloud. Cette méthode est optimale pour les charges de travail exigeantes en écriture, si vos applications peuvent tolérer le retard causé par les lectures. out-of-cache | 
| **Temps d'arrêt** | Votre passerelle sera hors ligne pendant 1 à 2 heures pendant le processus de migration. | Les partages de fichiers sont toujours disponibles, mais les clients seront confrontés à des temps d'arrêt courts lorsqu'ils passeront d'un partage de fichiers à un autre pendant la transition vers la nouvelle instance. L'écriture simultanée dans un compartiment Amazon S3 à partir de deux partages de fichiers *n'est pas prise en charge*. Tous les clients doivent donc être remappés d'un partage à l'autre simultanément, plutôt que progressivement.  | 
| **ID de passerelle** | La nouvelle passerelle hérite de l'ID de passerelle de la passerelle qu'elle remplace. | La passerelle existante et la passerelle de remplacement ont une passerelle distincte et unique IDs. | 
| **Incidence en termes** | La conservation des données en cache élimine le besoin de retélécharger, ce qui n'entraîne aucun coût supplémentaire pour S3. | Cette méthode peut entraîner des coûts supplémentaires, en particulier si la récupération de données depuis S3 est nécessaire. Cette approche peut également entraîner d'importantes dépenses de récupération des données S3 si les partages de fichiers sauvegardés par des compartiments S3 utilisent des classes de stockage telles que S3 Intelligent-Tiering, S3 Standard-IA, S3 One Zone-IA ou des objets transférés vers GLACIER par le biais des politiques de cycle de vie S3.<br />Dans le cas des partages de fichiers SMB, si l'ACL racine est configurée sur le partage de fichiers, elle doit être réappliquée à la passerelle migrée. Cette action appliquera le paramètre de manière récursive à tous les objets du partage de fichiers, ce qui aura des répercussions financières. | 

**Note**  
La migration ne peut être effectuée qu'entre des passerelles du même type. Par exemple, vous ne pouvez pas migrer des paramètres ou des données d'une passerelle de FSx fichiers vers une passerelle de fichiers S3.

## Méthode 1 : migrer le disque de cache et l'ID de passerelle vers l'instance de remplacement
<a name="migrate-data-file-gateway"></a>

**Pour migrer le disque de cache et l'ID de S3 vers une instance de remplacement :**

1. Arrêtez toutes les applications qui écrivent sur la passerelle de fichiers S3  existante.

1. Procédez comme suit pour mettre à jour la passerelle vers la dernière version

   1. Ouvrez la console Storage Gateway à la [https://console.aws.amazon.com/storagegateway/maison](https://console.aws.amazon.com/storagegateway/).

   1. Dans le volet de navigation, choisissez **Gateways**, puis choisissez l'ancienne passerelle de fichiers S3 que vous souhaitez migrer.

   1. Cliquez sur **Mettre à jour maintenant** si disponible. Si ce n'est pas le cas, votre passerelle utilise déjà la dernière version.

1. Vérifiez que la `CachePercentDirty` métrique de l'onglet **Monitoring** pour la passerelle de fichiers S3  existante est`0`.

1. Arrêtez la passerelle de fichiers S3  existante en éteignant la machine virtuelle (VM) hôte à l'aide de ses commandes d'hyperviseur.

   Pour plus d'informations sur l'arrêt d'une instance Amazon EC2, [consultez Arrêter et démarrer votre](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/Stop_Start.html) instance dans le guide de l'utilisateur *Amazon EC2*.

   Pour plus d'informations sur l'arrêt d'une machine virtuelle KVM ou Hyper-V VMware, consultez la documentation de votre hyperviseur.

1. Détachez tous les disques, y compris le disque racine et les disques de cache, de l'ancienne machine virtuelle de passerelle.
**Note**  
Notez l’ID de volume du disque racine, ainsi que l’ID de passerelle associé à ce disque racine. Vous devrez détacher ce disque du nouvel hyperviseur Storage Gateway ultérieurement.

   *Si vous utilisez une instance Amazon EC2 comme machine virtuelle pour votre passerelle de fichiers S3 , consultez la section [Détacher un volume Amazon EBS d'une instance Windows ou Détacher un volume Amazon EBS d'une instance](https://docs.aws.amazon.com//AWSEC2/latest/WindowsGuide/ebs-detaching-volume.html) [Linux dans le guide de l'utilisateur](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ebs-detaching-volume.html) Amazon EC2.*

   Pour plus d'informations sur le détachement de disques d'une machine virtuelle KVM ou Hyper-V, consultez la documentation de votre hyperviseur. VMware 

1. Créez une nouvelle instance de machine virtuelle d' AWS Storage Gateway hyperviseur, mais ne l'activez pas en tant que passerelle. Dans une étape ultérieure, cette nouvelle machine virtuelle prendra l'identité de l'ancienne passerelle.

   Pour plus d'informations sur la création d'une nouvelle machine virtuelle de l'hyperviseur Storage Gateway, consultez les sections [Choix d'une plate-forme hôte et téléchargement de la machine virtuelle](https://docs.aws.amazon.com/filegateway/latest/files3/create-gateway-file.html#hosting-options-file).
**Note**  
N'ajoutez pas de disques de cache pour la nouvelle machine virtuelle. Cette machine virtuelle utilisera les mêmes disques de cache que ceux utilisés par l'ancienne machine virtuelle.
**Note**  
Après avoir téléchargé la machine virtuelle, fermez l'assistant de console. Ne procédez pas à l'activation à ce stade.

1. Configurez votre nouvelle machine virtuelle Storage Gateway pour utiliser les mêmes paramètres réseau que l'ancienne machine virtuelle.

   La configuration du réseau par défaut de la passerelle est le protocole de DHCP (Dynamic Host Configuration Protocol). Avec le protocole DHCP, votre passerelle reçoit automatiquement une adresse IP.

   Si vous devez configurer manuellement une adresse IP statique pour votre machine virtuelle de passerelle, consultez la [section Configuration des paramètres réseau](https://docs.aws.amazon.com//filegateway/latest/files3/appliance-configure-ip.html).

   Si votre machine virtuelle de passerelle doit utiliser un proxy Socket Secure version 5 (SOCKS5) pour se connecter à Internet, consultez la section [Routage de votre passerelle déployée sur EC2 via un proxy HTTP](https://docs.aws.amazon.com//filegateway/latest/files3/ec2-local-console-fwg.html#EC2_MaintenanceRoutingProxy-fgw).
**Note**  
Vous pouvez réutiliser la même adresse IP statique ou le même nom d'hôte que ceux de l'ancienne machine virtuelle de passerelle pour éviter de reconfigurer les clients NFS ou SMB.

1. Démarrez la nouvelle machine virtuelle Storage Gateway.

1. Connectez les disques que vous avez détachés de l'ancienne machine virtuelle de passerelle à la nouvelle machine virtuelle de passerelle. Ne détachez pas le disque racine existant de la nouvelle machine virtuelle de passerelle.
**Note**  
Pour que la migration soit réussie, tous les disques doivent rester inchangés. La modification de la taille du disque ou d'autres valeurs entraîne des incohérences dans les métadonnées qui empêchent la réussite de la migration.

1. Lancez le processus de migration de passerelle en vous connectant à la console locale de la nouvelle machine virtuelle de passerelle ou en envoyant des requêtes Web à l'adresse IP de la nouvelle machine virtuelle de passerelle (décrite ci-dessous).

   1. Pour utiliser la console locale, sélectionnez l'option **Migrate Gateway** et fournissez votre ID de passerelle existant lorsque vous y êtes invité. Vous serez invité à copier les paramètres précédemment appliqués sur l'ancienne passerelle vers la nouvelle passerelle. Vous pouvez choisir de les appliquer ou de les configurer manuellement ultérieurement. Reportez-vous [à la section Accès à la console locale de Gateway](https://docs.aws.amazon.com/filegateway/latest/files3/accessing-local-console.html).

   1. Vous pouvez également lancer le processus de migration de la passerelle en vous connectant à la nouvelle machine virtuelle à l'aide d'une URL au format suivant.

      ```
      http://{{your-VM-IP-address}}/migrate?gatewayId={{your-gateway-ID}}
      ```

      Vous pouvez réutiliser la même adresse IP pour la nouvelle machine virtuelle de passerelle que celle que vous avez utilisée pour l’ancienne machine virtuelle de passerelle. Votre URL doit être similaire à l’exemple suivant.

      ```
      http://198.51.100.123/migrate?gatewayId=sgw-12345678
      ```

      Utilisez cette URL depuis un navigateur ou depuis la ligne de commande à l’aide de `curl`, pour lancer le processus de migration.

      Lorsque le processus de migration de la passerelle est terminé avec succès, vous verrez un message confirmant la réussite de la migration.

1. Attendez que l'état de la passerelle s'affiche comme étant en **cours d'exécution** dans la AWS Storage Gateway console. Selon la bande passante disponible, cela peut prendre jusqu'à 10 minutes.

1. Arrêtez la nouvelle machine virtuelle Storage Gateway.

1. Détachez le disque racine de l'ancienne passerelle, dont vous avez noté l'ID de volume précédemment, de la nouvelle passerelle.

1. Démarrez la nouvelle machine virtuelle Storage Gateway.

1. Si votre passerelle a été jointe à un domaine Active Directory, rejoignez le domaine. Pour obtenir des instructions, consultez la section [Utilisation d'Active Directory pour authentifier les utilisateurs.](https://docs.aws.amazon.com//filegateway/latest/files3/enable-ad-settings.html)
**Note**  
Vous devez effectuer cette étape même si le statut de la passerelle de fichiers S3  apparaît comme **Joint**.

1. Si votre passerelle utilisait la méthode d'authentification SMB Guest Access, le mot de passe devra être saisi à nouveau. Pour obtenir des instructions, voir [Fournir un accès invité à votre partage de fichiers](https://docs.aws.amazon.com/filegateway/latest/files3/guest-access.html).

1. Vérifiez que vos partages sont disponibles à l'adresse IP de la nouvelle machine virtuelle de passerelle, puis supprimez l'ancienne machine virtuelle de passerelle. 
**Avertissement**  
Lorsqu’une passerelle est supprimée, il n’y a plus aucun moyen de la récupérer.

   Pour plus d'informations sur la suppression d'une instance Amazon EC2, consultez [Résilier votre instance](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/terminating-instances.html) dans le guide de l'utilisateur *Amazon EC2*. Pour plus d'informations sur la suppression d'une machine virtuelle KVM ou Hyper-V, consultez la documentation de votre hyperviseur. VMware

## Méthode 2 : instance de remplacement avec un disque de cache vide et un nouvel ID de passerelle
<a name="replace-instance-file-gateway"></a>

**Pour configurer une instance de passerelle de fichiers S3 de remplacement avec un disque cache vide et un nouvel ID de passerelle :**

1. Arrêtez toutes les applications qui écrivent sur la passerelle de fichiers S3  existante. Vérifiez que la `CachePercentDirty` métrique de l'onglet **Surveillance** est correcte `0` avant de configurer les partages de fichiers sur la nouvelle passerelle.

1. Utilisez le AWS Command Line Interface (AWS CLI) pour recueillir et enregistrer les informations de configuration relatives à votre passerelle de fichiers S3  et à vos partages de fichiers existants en procédant comme suit :

   1. Enregistrez les informations de configuration de la passerelle de fichiers S3 .

      ```
      aws storagegateway describe-gateway-information --gateway-arn "arn:aws:storagegateway:{{us-east-2}}:{{123456789012}}:gateway/sgw-12A3456B"
      ```

      Cette commande génère un bloc JSON contenant des métadonnées relatives à la passerelle, telles que son nom, ses interfaces réseau, son fuseau horaire configuré et son état (si la passerelle est en cours d'exécution).

   1. Enregistrez les paramètres SMB (Server Message Block) de la passerelle de fichiers S3 .

      ```
      aws storagegateway describe-smb-settings --gateway-arn "arn:aws:storagegateway:{{us-east-2}}:{{123456789012}}:gateway/{{sgw-12A3456B}}"
      ```

      Cette commande génère un bloc JSON qui contient des métadonnées relatives au partage de fichiers SMB, telles que son nom de domaine, le statut de Microsoft Active Directory, si le mot de passe invité est défini et le type de stratégie de sécurité.

   1. Enregistrez les informations de partage de fichiers pour chaque partage de fichiers SMB et NFS (Network File System) de la passerelle de fichiers S3 Gateway :
      + Utilisez la commande suivante pour les partages de fichiers SMB.

        ```
        aws storagegateway describe-smb-file-shares --file-share-arn-list "arn:aws:storagegateway:{{us-east-2}}:{{123456789012}}:share/{{share-987A654B}}"
        ```

        Cette commande génère un bloc JSON contenant des métadonnées relatives au partage de fichiers SMB, telles que son nom, sa classe de stockage, son statut, son rôle IAM (Amazon Resource Name (ARN), une liste de clients autorisés à accéder à la passerelle de fichiers S3  et le chemin utilisé par le client SMB pour identifier le point de montage.
      + Utilisez la commande suivante pour les partages de fichiers NFS.

        ```
        aws storagegateway  describe-nfs-file-shares --file-share-arn-list "arn:aws:storagegateway:{{us-east-2}}:{{123456789012}}:share/{{share-321A978B}}"
        ```

        Cette commande génère un bloc JSON contenant des métadonnées relatives au partage de fichiers NFS, telles que son nom, sa classe de stockage, son statut, l'ARN du rôle IAM, la liste des clients autorisés à accéder à la passerelle de fichiers S3  et le chemin utilisé par le client NFS pour identifier le point de montage.

1. Créez une nouvelle passerelle de fichiers S3  avec les mêmes paramètres et la même configuration que l'ancienne passerelle. Si nécessaire, reportez-vous aux informations que vous avez enregistrées à l'étape 2.

1. Créez de nouveaux partages de fichiers pour la nouvelle passerelle avec les mêmes paramètres et configurations que les partages de fichiers configurés sur l'ancienne passerelle. Si nécessaire, reportez-vous aux informations que vous avez enregistrées à l'étape 2.

1. Vérifiez que votre nouvelle passerelle fonctionne correctement, puis remappez/découpez vos clients des anciens partages de fichiers vers les nouveaux partages de fichiers de la manière la mieux adaptée à votre environnement.

1. Vérifiez que votre nouvelle passerelle fonctionne correctement, puis supprimez l'ancienne passerelle de la console Storage Gateway.
**Important**  
Avant de supprimer une passerelle de fichiers S3 , assurez-vous qu'aucune application n'écrit actuellement dans le cache de cette passerelle. Si vous supprimez une passerelle alors qu’elle est en cours d’utilisation, une perte de données peut se produire.
**Avertissement**  
Lorsqu’une passerelle est supprimée, il n’y a plus aucun moyen de la récupérer.

1. Supprimez l'ancienne machine virtuelle de passerelle ou l'ancienne instance Amazon EC2.