tosutil 工具常见问题--对象存储-火山引擎

文档中心

导航

对象存储

tosutil 工具常见问题

最近更新时间：2024.10.15 14:06:44首次发布时间：2023.07.10 15:09:02

本文介绍使用 tosutil 工具过程中遇到的常见问题。

在 Windows 10 系统的 CMD 命令窗口执行 tosutil 命令，单击或滚动鼠标后，进度条卡顿怎么办？

以上问题是因为 Windows 10 系统的 CMD 命令窗口默认开启快速编辑模式，单击鼠标等行为会触发系统进入快速编辑模式，导致标准输出卡顿，进而出现 tosutil 命令进度条卡顿的情况。
建议您关闭快速编辑模式，操作如下：
在 CMD 命令窗口左上角，右键单击命令提示符，单击默认值，在编辑选项区域，去除勾选快速编辑模式，单击确定。

在 Windows 系统下使用 tosutil 工具下载文件时文件名超出操作系统限制，如何解决？

Windows 系统文件名上限较小，如果文件的后缀较长，可能会超出使用限制，您可以通过以下方式指定下载的临时目录解决该问题：

在配置文件中指定 defaultTempFileDir=xxx。
执行 cp 命令时，指定参数 -tempFileDir=xxx。

tosutil 工具报错 server returned an invalid body 怎么办？

以上报错通常是因为 TOS 服务的域名（Endpoint）配置错误，TOS SDK 当前仅支持使用 TOS 协议域名（例如北京地域域名为 tos-cn-beijing.volces.com），不支持使用 S3 协议域名（例如北京 tos-s3-cn-beijing.volces.com）。
您需要将域名配置为 TOS 支持的域名信息，关于 TOS 支持的域名信息，请参见地域和访问域名。

tosutil 工具上传或下载大文件时，出现进度条回退或归零的情况怎么办？

以上报错通常是因为客户端网络较慢或网络不稳定，导致 tosutil 工具执行重试导致，重试时会重新计算进度。
建议您优先排查网络问题，如果暂时无法解决网络问题，您可以尝试执行命令时指定较小的分片大小，例如设置 -ps=5mb。
如果以上操作仍无法解决您的问题，请提交工单联系技术支持。

tosutil 工具上传报错 use of closed network connection 怎么办？

以上报错通常是因为客户端到 TOS 服务端的网络不稳定或者客户端请求超带宽（客户端带宽跑满）导致，您可以尝试以下操作：

排查网络问题。
调整 tosutil 工具的配置和执行参数，将 -p 和 -j 参数设置为较低的数值，不要设置过高的并发度。配置参数示例如下：
```
# .tosutilconfig 文件

# 调高重试次数
maxRetryCount=10
# 调高超时时间
socketTimeout=300
```

如果以上操作仍无法解决您的问题，请提交工单联系技术支持。

如何更新 tosutil 工具的密钥？

您需要对 tosutil 工具执行初始化配置操作，即可更新密钥，具体操作，请参见步骤一：初始化配置。

使用 tosutil cp 命令上传文件时，部分文件上传失败怎么办?

建议您在 /root/.tosutil_log/tosutil.log 路径下查看对应日志，根据日志提示的失败信息定位和解决问题。

说明

日志的默认路径为 /root/.tosutil_log/tosutil.log。在 tosutil 配置文件中可以修改日志路径，也可以在配置文件中获取日志路径。

如何限制 tosutil 日志文件大小、文件个数？

您可以在 tosutil 配置文件中通过 utilMaxLogSize 、utilLogBackups 参数指定日志文件大小、日志文件个数。详细介绍，请参见配置文件说明。