全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

常见问题与注意事项

最近更新时间:2024-07-15 19:08:22

1. 如何验证KS3 Import是否迁移成功?

方式一:迁移结束后,会显示共需迁移的文件数量(totalNum)、成功迁移的文件数量(okNum)以及迁移失败的文件数量(failNum)。迁移成功的文件会显示上传成功(upload ok),迁移失败的文件会显示上传失败(upload fail)。

方式二:通过以下命令查看迁移状态:

java -jar KS3-import-x.x.x.jar -c xxx.conf stat
  • 上传成功示例

[1mtask started...[22m
[Fail:0 /Success:1 /Total:1]dstKey=aaa2/----->[skip]
[Fail:0 /Success:2 /Total:2]dstKey=aaa2/1----->[upload ok]
[Fail:0 /Success:3 /Total:3]dstKey=aaa2/1KB - 副本 - 副本 - 副本 - 副本----->[upload ok]
[Fail:0 /Success:4 /Total:4]dstKey=aaa2/1KB - 副本 - 副本 - 副本----->[upload ok]
[----------------task begin------------------]
Task Name: hanguptool
Task Migration Method: normal
Task Method: start
Task Is Running: false
Task Scan Finished: true
Task Scan Progress: totalNum=4, totalSize=3072
Task Migrate Progress: okNum=4, okSize=3072, failNum=0, failSize=0
[-----------------task end------------------]
  • 上传失败示例

task started...
[Fail:0 /Success:1 /Total:1]dstKey=aaa2/----->[skip]
[Fail:0 /Success:2 /Total:2]dstKey=aaa2/1----->[upload ok]
[Fail:0 /Success:3 /Total:3]dstKey=aaa2/1KB - 副本 - 副本 - 副本 - 副本----->[upload ok]
[Fail:1 /Success:3 /Total:4]dstKey=aaa2/1KB - 副本 - 副本 - 副本----->[upload fail]
[----------------task begin------------------]
Task Name: hanguptool
Task Migration Method: normal
Task Method: start
Task Is Running: false
Task Scan Finished: true
Task Scan Progress: totalNum=4, totalSize=3072
Task Migrate Progress: okNum=3, okSize=2048, failNum=1, failSize=1024
[-----------------task end------------------]

2. 迁移失败问题排查

当迁移文件失败时,建议先查看迁移失败日志,确认失败的原因。解决这些问题后可以使用retry命令进行重试。迁移失败后默认会在${work_dir}下创建logs目录,logs目录下的error.log文件即为迁移失败日志

常见的失败原因汇总
  1. 检查目标空间是否存在,dstDomain设置和目标空间对应关系是否正确。

  2. 检查dstAccessKey和dstSecretKey是否正确。

  3. 在windows环境下,srcPrefix目录分隔符用"/“或”\\",不能用""。

  4. 上传时设置 filterEnable=true fileNameExclude=$ 可满足不上传前缀为$的文件,排除其他格式前缀文件同理。

  5. 每启动一个Import任务,都会在工具所在目录下生成一个后缀为.db的文件,记录上传信息。

  6. 客户端时间以北京时间为准,否则会导致权限错误。

  7. 并发数值(threadsNum * uploadPartPoolSize)初次不建议设置过高,否则如果客户端网络差、带宽小或CPU资源有限,并发过大会出现超时错误。建议运行过程中从小到大逐渐尝试调整并发数值。数据迁移过程中修改配置文件后即可生效,无需重新执行命令。大文件迁移并发受客户端带宽或网络影响较大,小文件迁移并发受客户端CPU资源影响较大,建议根据客户端实际情况适当调整并发数值。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈