本文介绍使用 FSX 客户端过程中遇到的常见问题。 ## 基本原则如果您在使用 FSX 过程中出现异常情况，建议您先运行 `/opt/fsx/tools/sysinfo_collector.sh` 脚本。该脚本会自动收集系统基本信息、挂载点信息、系统日志等内容，并默认会在脚本所在目录生成一个 `system_info_****_****.tar.gz` 压缩文件。您可以[提交工单](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000245)将该压缩文件发送给我们，我们将协助您解决问题。需要注意的是，请勿在挂载目录运行 `/opt/fsx/tools/sysinfo_collector.sh` 脚本。 :::warning 请勿在挂载目录运行 `/opt/fsx/tools/sysinfo_collector.sh` 脚本。异常情况下，在挂载目录使用脚本收集信息可能会失败。 ::: ## 权限问题 ### 挂载存储桶时报错 ”error: Auth Failed“ 问题原因：挂载存储桶使用的 Access Key ID 和 Secret Access Key 填写有误或权限不足。解决方案： * 检查挂载时填写的 Access Key ID 和 Secret Access Key 是否正确。 * 确保挂载时使用的 Access Key ID 和 Secret Access Key 所属账号具有挂载存储桶的最小权限，详细介绍，请参见[挂载存储桶所需要的权限](/docs/6349/1404641#795d5449)。 ### 存储桶挂载成功后，读取文件时报错 “Permission denied” 问题原因： * 读取的是未恢复的归档存储、冷归档和深度冷归档类型的文件。 * 挂载时使用的 Access Key ID 和 Secret Access Key 权限不足。解决方案： * 检查读取的文件类型，如果是归档存储、冷归档和深度冷归档类型的文件，需要恢复后才可以读取。 * 确保挂载时使用的 Access Key ID 和 Secret Access Key 所属账号具有读取文件（GetObject ）的权限，详细介绍，请参见[挂载存储桶所需要的权限](/docs/6349/1404641#795d5449)。 ## 挂载问题 ### 挂载时报错 “Vduse Operation Failed” 问题原因：挂载存储桶前，未创建指定的挂载目录。解决方案：创建指定的挂载目录后，再执行挂载操作。具体操作，请参见 [FSX 配置与挂载](/docs/6349/1404641)。 ### 使用 FSX 工具挂载存储桶后，通过 reboot \-t 命令重启 Linux 系统，重启卡住了问题原因：重启系统前，没有卸载挂载点。由于没有卸载挂载点， reboot 命令会先关闭所有用户进程（包括 FSX 进程），再去执行 umount 命令。FSX 工具支持崩溃恢复， umount 命令不会立即返回失败，会阻塞（等待 FSX 进程恢复），从而阻塞 reboot 命令。解决方案：建议您强制重启系统，或者等待一段时间，系统会自动恢复重启。 ## 磁盘内存问题 ### 在 FSX 客户端读写过程中，为什么会写满磁盘空间？问题原因： * FSX 客户端写入数据时，默认会在 `/tmp/` 下写入临时文件，如果写入文件超过磁盘空间大小，可能会写满磁盘空间。 * 在读缓存场景下，配置的读缓存空间大小超过磁盘空间，可能会写满磁盘空间。解决方案： * 写数据的临时文件目录空间至少需要保证 10240\*分段数据的大小，在默认分段数据大小为 8M 的场景下，临时文件目录空间需要 80GiB 的空间，对应，需要确保磁盘空间大于 80GiB。 * 在读缓存场景下，请确保配置的 `max_read_cache_size`（读缓存占用最大空间）小于磁盘空间。 * 在开启读缓存和写缓存时，建议至少为 FSX 客户端预留 120GiB 的磁盘空间。为避免跟系统其他应用争抢磁盘空间，推荐为这部分磁盘空间划分独立分区，详细介绍，请参见[FSX 挂载参数说明](/docs/6349/1404640)。 ### **为什么执行 df 命令后显示磁盘空间大小为** 8.0EB？通过 `df` 命令查询的磁盘空间只是展示值，不代表存储桶的实际空间。其中，`Size`（磁盘空间总大小）和 `Avail`（磁盘空间剩余可用大小）固定为 8EB，`Used`（已使用磁盘空间大小）固定为 0 。 ## 卸载问题 ### **卸载时报错 "** target is busy\*\*"\*\* 问题原因：当存在进程访问挂载目录时，无法执行卸载操作。解决方案：以下以挂载目录 `/mnt/point` 为例，介绍卸载时报错的解决方案： 1. 使用 `lsof | grep "/mnt/point"` 命令找到访问挂载目录的进程。 2. 强制关闭访问挂载目录的进程。 3. 重新执行 `umount /mnt/point` 命令，卸载存储桶。 ## 读写问题 ### 在 FNS 桶追加写场景中，为什么会出现对即将追加的数据进行拷贝的情况？ FSX 工具追加写操作在不同类型的存储桶，实现原理不同，具体实现原理如下： * 追加写 FNS 桶中的对象时，云端的历史数据会使用 UploadPartCopy 接口对 TOS 中的数据进行复制，追加的新数据则使用 UploadPart 或 PutObject 接口进行上传。该场景下，一次 open 操作仅支持一次 flush 操作。 * 追加写 HNS 桶中的对象时，TOS 会使用 AppendObject 接口进行数据的追加写操作。该场景下，支持对追加写的对象执行多次 flush 操作。如果您不希望出现请求次数放大的情况，推荐使用 HNS 桶。 ### 挂载存储桶后，访问目录失败问题原因：通过 FSX 挂载存储桶后，系统会将 `/` 结尾的对象识别为目录。如果您创建了同名的目录和文件（例如 test/ 和 test），由于名字相同，系统无法区分，导致访问目录失败。解决方案：如果系统中存在同名的目录和文件，建议您重命名文件和目录，确保文件和目录的名称不重复。后续请勿创建同名的目录和文件，以防命名冲突。

对象存储