本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 用新实例替换现有的 S3 FSx 文件网关
<a name="migrate-data"></a>

随着数据和性能需求的增长，或者收到迁移网关文件网关替换为新实例。如果您想将网关迁移到更好的主机平台或更新的 Amazon EC2 实例，或者要刷新底层服务器硬件，则可能需要这样做。

有两种方法可以替换现有的 S3 文件网关FSx 。下表说明了每种方法的优缺点。使用此信息，选择最适合您的网关环境的方法，然后参考下面相应章节中的操作步骤。

**注意**  
如果您需要[登录新的 Storage Gateway 本地控制台](LocalConsole-login-fgw.md)来完成任一方法，则初始用户名为 *admin*，临时密码为 *password*。

**重要**  
这些说明仅适用于迁移运行 1.x 版的网关设备。您不能使用它们来迁移运行较低版本的网关设备。


|  | **方法 1：将缓存磁盘和网关 ID 迁移到替换实例\*** | **方法 2：使用空缓存磁盘和新网关 ID 替换实例** | 
| --- | --- | --- | 
| **缓存磁盘数据** | 缓存磁盘上的数据会保留。如果您的网关有较大的缓存磁盘，或者您的应用程序对 out-of-cache读取操作造成的延迟很敏感，则此方法非常有用。 | 缓存中的数据是从 AWS 云端下载的。如果您的应用程序可以容忍读取造成的延迟，则此方法最适合写入密集型工作负载。 out-of-cache | 
| **停机时间** | 在迁移过程中，您的网关将离线 1-2 小时。 | 文件共享始终可用，但是在转换到新实例期间，从一个文件共享切换到另一个文件共享时，客户端会经历短暂的割接停机。 **不支持同时从两个文件共享写入一个 Amazon S3 存储桶，因此必须同时将所有客户端从一个共享重新映射到另一个共享，而不是逐渐映射。  | 
| **网关 ID** | 新网关继承其所替换的网关的网关 ID。 | 现有网关和替代网关具有单独的、唯一的网关 IDs。 | 
| **成本影响** | 通过缓存数据保存，无需重新下载，因此额外的 S3 成本为零。 | 这种方法可能会产生额外费用，尤其是在需要从 S3 检索数据的情况下。如果由 S3 存储桶支持的文件共享使用诸如 S3 智能分层、S3 标准-IA、S3 单区-IA 或通过 S3 生命周期策略过渡到 GLACIER 的对象之类的存储类别，则这种方法还可能导致大量的 S3 数据检索费用。<br />对于 SMB 文件共享，如果在文件共享上配置了根 ACL，则必须将其重新应用于迁移的网关。此操作会将该设置递归应用于文件共享中的所有对象，从而带来一些成本影响。 | 

**注意**  
只能在相同类型的网关之间执行迁移。例如，您无法将设置或数据从 FSx 文件网关迁移到 S3 文件网关。

## 方法 1：将缓存磁盘和网关 ID 迁移到替换实例
<a name="migrate-data-file-gateway"></a>

**要将 S3 文件网关FSx 文件网关 ID 迁移到替换实例，请执行以下操作：**

1. 停止任何正在写入现有 S3 文件网关网关的应用程序。

1. 使用以下步骤将网关更新到最新版本

   1. 在[https://console.aws.amazon.com/storagegateway/家](https://console.aws.amazon.com/storagegateway/)中打开 Storage Gateway 控制台。

   1. 在导航窗格中，选择**网关**，然后选择要迁移的旧 S3 文件网关。

   1. 如果可用，**请单击 “立即更新**”。否则，您的网关已经是最新版本。

1. 验证现有 S3 文件网关网关的 “**监控**” 选项卡上的`CachePercentDirty`指标是否为`0`。

1. 使用主机虚拟机 (VM) 的虚拟机管理程序控件关闭主机虚拟机 (VM) 的电源，关闭现有的 S3 FSx 文件。

   有关关闭 Amazon EC2 实例的更多信息，请参阅《Amazon EC2 用户指南》**中的[停止和启动实例](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/Stop_Start.html)。

   有关关闭 KVM 或 Hyper-V 虚拟机的更多信息 VMware，请参阅您的虚拟机管理程序文档。

1. 将所有磁盘（包括根磁盘和缓存磁盘）与旧网关虚拟机分离。
**注意**  
记下根磁盘的卷 ID 以及与该根磁盘关联的网关 ID。您将需要在稍后的步骤中将此磁盘与新的 Storage Gateway 虚拟机监控程序分离。

   *如果您使用亚马逊 EC2 实例作为 S3 文件网关网关的虚拟机，请参阅亚马逊 EC2 用户指南中的将 [Amazon EBS 卷与 Windows [实例分离或将 Amazon EBS 卷与 Linux 实例](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ebs-detaching-volume.html)分离](https://docs.aws.amazon.com//AWSEC2/latest/WindowsGuide/ebs-detaching-volume.html)。*

   有关从 KVM 或 Hyper-V VM 分离磁盘的信息，请参阅虚拟机管理程序文档。 VMware

1. 创建新的虚拟机 AWS Storage Gateway 管理程序虚拟机实例，但不要将其作为网关激活。在后面的步骤中，这个新 VM 将代入旧网关的身份。

   有关创建新的 Storage Gateway 虚拟机监控程序 VM 的更多信息，请参阅[选择主机平台和下载 VM](https://docs.aws.amazon.com/filegateway/latest/files3/create-gateway-file.html#hosting-options-file)。
**注意**  
不要向新 VM 添加缓存磁盘。此 VM 将使用与旧 VM 相同的缓存磁盘。
**注意**  
下载虚拟机后，关闭控制台向导。此时不要继续激活。

1. 将新 Storage Gateway VM 配置为使用与旧 VM 相同的网络设置。

   网关的默认网络配置是动态主机配置协议 (DHCP)。使用 DHCP 时，系统会为您的网关自动分配 IP 地址。

   如果您需要为网关 VM 手动配置静态 IP 地址，请参阅[配置网络参数](https://docs.aws.amazon.com//filegateway/latest/files3/appliance-configure-ip.html)。

   如果您的网关 VM 必须使用 Socket Secure 版本 5 (SOCKS5) 代理才能连接到互联网，请参阅[通过 HTTP 代理路由部署在 EC2 上的网关](https://docs.aws.amazon.com//filegateway/latest/files3/ec2-local-console-fwg.html#EC2_MaintenanceRoutingProxy-fgw)。
**注意**  
您可以重复使用旧网关 VM 中的相同静态 IP 地址或主机名，以避免重新配置 NFS 或 SMB 客户端。

1. 启动新 Storage Gateway VM。

1. 将从旧网关 VM 中分离的磁盘连接到新网关 VM。不要从新网关 VM 分离现有根磁盘。
**注意**  
要成功迁移，所有磁盘都必须保持不变。更改磁盘大小或其他值会导致元数据不一致，从而无法成功迁移。

1. 通过连接到新网关 VM 的本地控制台或向新网关 VM 的 IP 地址发出 Web 请求（如下所述），启动网关迁移过程。

   1. 要使用本地控制台，请选择 M **igrat** e Gateway 选项，并在出现提示时提供您现有的网关 ID。系统将提示您将以前在旧网关上应用的设置复制到新网关。您可以选择应用它们，也可以稍后手动配置它们。请参阅[访问网关本地控制台](https://docs.aws.amazon.com/filegateway/latest/files3/accessing-local-console.html)。

   1. 或者，您可以通过使用以下格式的 URL 连接到新虚拟机来启动网关迁移过程。

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

      您可以为新网关 VM 重复使用与旧网关 VM 相同的 IP 地址。您的 URL 应类似于以下示例。

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

      在浏览器中或在命令行中通过 `curl` 来使用此 URL，启动迁移过程。

      成功完成网关迁移过程后，您将看到一条确认成功迁移的消息。

1. 等待在 AWS Storage Gateway 控制台中网关状态显示为**正在运行**。这个过程耗时最长 10 分钟，具体视可用带宽而定。

1. 停止新 Storage Gateway VM。

1. 将旧网关的根磁盘（您之前记下了该磁盘的卷 ID）与新网关分离。

1. 启动新 Storage Gateway VM。

1. 如果您的网关已加入 Active Directory 域，请重新加入该域。有关说明，请参阅[使用 Active Directory 对用户进行身份验证](https://docs.aws.amazon.com//filegateway/latest/files3/enable-ad-settings.html)。
**注意**  
即使 S3 文件网关网关的状态显示为已**加入**，也必须完成此步骤。

1. 如果您的网关使用 SMB 访客访问身份验证方法，则需要重新输入密码。有关说明，请参阅[为文件共享提供访客访问权限](https://docs.aws.amazon.com/filegateway/latest/files3/guest-access.html)。

1. 确认在新网关 VM 的 IP 地址中可使用您的共享，然后删除旧网关 VM。
**警告**  
删除网关后便无法恢复。

   有关删除 Amazon EC2 实例的更多信息，请参阅《Amazon EC2 用户指南》**中的[终止实例](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/terminating-instances.html)。有关删除 KVM 或 Hyper-V 虚拟机的更多信息，请参阅虚拟机管理程序文档。 VMware

## 方法 2：使用空缓存磁盘和新网关 ID 替换实例
<a name="replace-instance-file-gateway"></a>

**要使用空的缓存磁盘和新的网关 ID 设置替换 S3 FSx 文件网关实例，请执行以下操作：**

1. 停止任何正在写入现有 S3 文件网关网关的应用程序。在新网关上设置文件共享之前，请确认**监控**选项卡上的 `CachePercentDirty` 指标为 `0`。

1. 使用 AWS Command Line Interface (AWS CLI) 通过执行以下操作来收集和保存有关现有 S3 文件网关FSx 和文件共享的配置信息：

   1. 保存 S 3 文件网关网关的网关配置信息。

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

      此命令将输出一个 JSON 数据块，其中包含有关网关的元数据，例如其名称、网络接口、已配置时区和状态（网关是否正在运行）。

   1. 保存 S 3 文件网关网关的服务器消息块 (S MB) 设置。

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

      此命令会输出一个 JSON 数据块，其中包含有关 SMB 文件共享的元数据，例如域名、Microsoft Active Directory 状态、是否设置了来宾密码以及安全策略类型。

   1. 
      + 为 SMB 文件共享使用以下命令。

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

        此命令输出一个 JSON 块，其中包含有关 SMB 文件共享的元数据，例如其名称、存储类别、状态、IAM 角色 Amazon 资源名称 (ARN)、允许访问 S3 文件FSx 网关文件的客户端列表以及 SMB 客户端用于标识挂载点的路径。
      + 为 NFS 文件共享使用以下命令。

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

        此命令输出一个 JSON 块，其中包含有关 NFS 文件共享的元数据，例如其名称、存储类别、状态、IAM 角色 ARN、允许访问 S3 文件FSx 网关文件的客户端列表以及 NFS 客户端用于标识挂载点的路径。

1. 使用与旧网关相同的设置和配置创建新 S3 网关文件网关。如有必要，请参阅在步骤 2 中保存的信息。

1. 使用与旧网关上配置的文件共享相同的设置和配置，为新网关创建新的文件共享。如有必要，请参阅在步骤 2 中保存的信息。

1. 确认您的新网关正常运行，然后以适合您环境的方式将客户端从旧文件共享重新映射/割接到新的文件共享。

1. 确认您的新网关正常运行，然后从 Storage Gateway 控制台中删除旧网关。
**重要**  
在删除 S 3 文件网关FSx 之前，请确保当前没有应用程序写入该网关的缓存。如果您在网关使用期间删除网关，则会造成数据丢失。
**警告**  
删除网关后便无法恢复。

1. 删除旧网关 VM 或 Amazon EC2 实例。