排查文件共享问题 - AWSStorage Gateway

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

排查文件共享问题

您可以在下面找到有关您遇到文件共享意外问题时要采取的措施的信息。

您的文件共享卡在创建状态

当您创建文件共享时,状态为 CREATING。创建文件共享之后,状态变为 AVAILABLE。如果文件共享陷入 CREATING 状态,请执行以下操作:

  1. 通过以下网址打开 Amazon S3 控制台:https://console.aws.amazon.com/s3/

  2. 确保文件共享映射的 S3 存储桶存在。如果此存储桶不存在,则创建存储桶。创建存储桶之后,文件共享状态变为 AVAILABLE。有关如何创建 S3 存储桶的信息,请参阅创建存储桶中的Amazon Simple Storage Service 用户指南.

  3. 确保您的存储桶名称符合 Amazon S3 中的存储桶命名规则。有关更多信息,请参阅 Amazon Simple Storage Service 用户指南中的存储桶命名规则

  4. 确保用于访问 S3 存储桶的 IAM 角色具有正确的权限,并验证 S3 存储桶是否在 IAM 策略中被列为资源。有关更多信息,请参阅授予对 Amazon S3 存储桶的访问权限

您无法创建文件共享

  1. 如果由于文件共享陷入 CREATING 状态而无法创建文件共享,请验证文件共享映射的 S3 存储桶是否存在。有关如何执行此操作的信息,请参阅上述的 您的文件共享卡在创建状态

  2. 如果 S3 存储桶存在,请验证AWS Security Token Service在创建文件共享的区域中启用。如果安全令牌未启用,则应启用安全令牌。有关如何使用以下方式启用令牌的信息。AWS Security Token Service,请参阅激活和停用AWS在 STSAWS区域中的IAM 用户指南.

SMB 文件共享不允许多种不同的访问方法。

SMB 文件共享具有以下限制:

  1. 当同一客户端尝试安装 Active Directory 和来宾访问 SMB 文件共享时,将显示以下错误消息:Multiple connections to a server or shared resource by the same user, using more than one user name, are not allowed. Disconnect all previous connections to the server or shared resource and try again.

  2. 一个 Windows 用户不能保持与两个来宾访问 SMB 文件共享的连接,并且在新的来宾访问连接建立后可能会断开连接。

  3. Windows 客户端无法同时安装由同一网关导出的来宾访问和 Active Directory SMB 文件共享。

多个文件共享无法写入映射的 S3 存储桶

我们不建议将 S3 存储桶配置为允许多个文件共享写入到一个 S3 存储桶。此方法可能导致无法预测的结果。

相反,我们建议您只允许一个文件共享写入到每个 S3 存储桶。您可以创建存储桶策略,仅允许与文件共享相关联的角色写入到存储桶。有关更多信息,请参阅文件共享最佳实践

无法将文件上传到 S3 存储桶

如果无法将文件上传到 S3 存储桶,请执行以下操作:

  1. 确保您已为 Amazon S3 文件网关授予必要的访问权限,以将文件上传到 S3 存储桶。有关更多信息,请参阅授予对 Amazon S3 存储桶的访问权限

  2. 确保创建存储桶的角色有权写入到 S3 存储桶。有关更多信息,请参阅文件共享最佳实践

  3. 如果您的文件网关使用 SSE-KMS 进行加密,请确保与文件共享关联的 IAM 角色包括kms:Encryptkms:DecryptKMS:重新加密kms:GenerateDataKey, 和kms:DescribeKey权限。有关更多信息,请参阅 。为 Storage Gateway 使用基于身份的策略(IAM 策略).

无法更改默认加密以使用 SSE-KMS 加密存储在我的 S3 存储桶中存储的对象

如果更改默认加密并使用 SSE-KMS (服务器端加密)AWS KMS— 托管密钥)S3 存储桶的默认值,Amazon S3 文件网关存储在存储桶中存储的对象不会使用 SSE-KMS 加密。默认情况下,S3 文件网关在将数据写入 S3 存储桶时会使用 Amazon S3 (SSE-S3) 托管的服务器端加密。更改默认值不会自动更改您的加密。

要将加密更改为将 SSE-KMS 与您自己的 AWS KMS 密钥结合使用,则必须启用 SSE-KMS 加密。为此,您需要在创建文件共享时提供 KMS 密钥的 Amazon 资源名称 (ARN)。您也可以通过使用 UpdateNFSFileShareUpdateSMBFileShare API 操作来更新文件共享的 KMS 设置。更新后,此更新应用于存储在 S3 存储桶中的对象。有关更多信息,请参阅使用数据加密AWS KMS

在启用对象版本控制的 S3 存储桶中直接进行的更改可能会影响您在文件共享中看到的内容

如果 S3 存储桶具有由其他客户端写入它的对象,则由于 S3 存储桶对象版本控制,S3 存储桶的视图可能不是最新的。您应始终先刷新缓存,然后再查看感兴趣的文件。

对象版本控制 是一项可选的 S3 存储桶功能,通过存储同名对象的多个副本来帮助保护数据。例如,每个副本都有单独的 ID 值,file1.jpgID="xxx"file1.jpgID="yyy". 同名对象数及其生命周期由 Amazon S3 生命周期策略控制。有关 Amazon S3 概念的更多详细信息,请参阅使用版本控制对象生命周期管理中的Amazon S3 开发人员指南。

在删除受版本控制的对象时,会使用删除标记来标记该对象,但保留该对象。只有 S3 存储桶拥有者才能永久删除启用了版本控制的对象。

在 S3 File Gateway 中,所显示的文件是获取对象或刷新缓存时 S3 存储桶中的对象的最新版本。S3 文件网关会忽略任何较旧版本或标记为删除的任何对象。在读取文件时,您从最新版本读取数据。在您编写文件共享中的文件时,S3 File Gateway 将创建具有您所做更改的命名对象的新版本,并且该版本将成为最新版本。

如果新版本添加到了您的应用程序之外的 S3 存储桶中,则您的 S3 文件网关将继续从较早版本读取,并且您所做的更新将基于较早版本。要读取对象的最新版本,请使用 RefreshCache API 操作或从控制台刷新,如刷新您的 Amazon S3 存储桶中的对象中所述。

重要

我们不建议对象或文件从文件共享之外写入 S3 File Gateway S3 存储桶中。

当写入启用对象版本控制的 S3 存储桶时,Amazon S3 文件网关可能会创建一个 S3 对象的多个版本

启用对象版本控制后,您可能会在每次从 NFS 或 SMB 客户端更新文件时在 Amazon S3 中创建对象的多个版本。以下是可能导致 S3 存储桶中创建对象的多个版本的情况:

  • 当文件上传到 Amazon S3 后,NFS 或 SMB 客户端在 Amazon S3 文件网关中进行修改时,S3 文件网关会上传新的或修改的数据,而不是上传整个文件。修改文件会导致创建新版本的 Amazon S3 对象。

  • 当 NFS 或 SMB 客户端将文件写入 S3 文件网关时,S3 文件网关会将文件的数据上传到 Amazon S3,然后是其元数据(所有权、时间戳等)。上传文件数据将创建 Amazon S3 对象,上传文件的元数据将更新 Amazon S3 对象的元数据。此过程将创建对象的另一个版本,从而生成对象的两个版本。

  • S3 File Gateway 上传较大的文件时,可能需要在客户端完成写入文件网关之前上传较小的文件块。造成这种情况的一些原因包括释放缓存空间或高写入文件的速率。这可能会导致 S3 存储桶中的对象的多个版本。

在设置生命周期策略将对象移动到不同的存储类之前,您应监控 S3 存储桶以确定存在多少版本的对象。您应该为之前的版本配置生命周期过期,以尽量减少 S3 存储桶中对象的版本数。在 S3 存储桶之间使用同区复制 (SRR) 或跨区域复制 (CRR) 将增加使用的存储空间。有关复制的更多信息,请参阅复制.

重要

在您了解启用对象版本控制时使用了多少存储空间之前,不要配置 S3 存储桶之间的复制。

使用受版本控制的 S3 存储桶会大大增加 Amazon S3 中的存储量,因为对文件进行的每个修改都会创建 S3 对象的新版本。默认情况下,Amazon S3 将继续存储所有这些版本,除非您专门创建策略来覆盖此行为并限制保留的版本数。如果您注意到启用对象版本控制后存储使用量异常大,请检查您是否正确设置了存储策略。浏览器请求的 HTTP 503-slow down 响应数的增加也可能是由于对象版本控制问题。

如果您在安装 S3 文件网关后启用了对象版本控制,则将保留所有唯一对象 (ID=”NULL”)您可以在文件系统中看到它们。将为对象的新版本分配唯一 ID(保留较旧版本)。基于对象的时间戳,仅最新版本的对象可在 NFS 文件系统中查看。

在您启用对象版本控制后,您的 S3 存储桶将无法返回到不受版本控制的状态。但是,您可以暂停版本控制。在暂停版本控制时,会为新对象分配一个 ID。如果存在具有 ID=”NULL” 值的同名对象,则将覆盖较旧版本。但是,将保留包含非 NULL ID 的任何版本。时间戳将新对象标识为最新对象,并且这是显示在 NFS 文件系统中的对象。

对 S3 存储桶的更改不会反映在 Storage Gateway 中

当您使用文件共享本地将文件写入缓存时,Storage Gateway 会自动更新文件共享缓存。但是,当您将文件直接上传到 Amazon S3 时,Storage Gateway 不会自动更新缓存。当您执行此操作时,您必须执行RefreshCache操作以查看文件共享的更改。如果您有多个文件共享,那么您必须运行RefreshCache对每个文件共享进行操作。

您可以使用 Storage Gateway 控制台和AWS Command Line Interface(AWS CLI):

  • 要使用 Storage Gateway 控制台刷新缓存,请参阅刷新 Amazon S3 存储桶中的对象。

  • 使用刷新缓存AWS CLI:

    1. 运行命令aws storagegateway list-file-shares

    2. 将文件共享的 Amazon 资源编号 (ARN) 复制到您要刷新的缓存中。

    3. 运行refresh-cache以您的 ARN 作为值的命令--file-share-arn

      aws storagegateway refresh-cache --file-share-arn arn:aws:storagegateway:eu-west-1:12345678910:share/share-FFDEE12

要自动化RefreshCache操作,请参阅如何在 Storage Gateway 上自动执行 ReRefreshCache 操作?

ACL 权限不符合预期

如果访问控制列表 (ACL) 权限未按预期与 SMB 文件共享一起运行,则您可以执行测试。

为此,请首先测试 Microsoft Windows 文件服务器或本地 Windows 文件共享上的权限。然后,将行为与您网关的文件共享进行比较。

执行递归操作后,网关性能下降

在某些情况下,您可能会执行递归操作(例如重命名目录或启用 ACL 的继承),并强制沿树向下执行递归操作。如果您执行此操作,S3 文件网关会递归地将该操作应用于文件共享中的所有对象。

例如,假设您将继承应用于 S3 存储桶中的现有对象。您的 S3 文件网关以递归方式将继承应用于存储桶中的所有对象。此类操作可能会导致网关性能下降。