OBSUtil工具 FAQ

         1.       如何检查 obsutil 配置是否准确，是否能正常访问 OBS？

obsutil 配置完成后，通过列举桶命令来验证配置及网络连通性，命令(Linux)：

   根据命令回显结果，检查配置结果：

·       如果返回结果中包含“Bucket number is:”，表明配置正确。

·       如果返回结果中包含“Http status [403]”，表明访问密钥配置有误。

·       如果返回结果中包含“A connection attempt failed”，表明无法连接OBS服务，

 请检查网络环境是否正常。

2.       在华为云 ECS 中使用 obsutil，如何通过内网访问OBS？

通过配置ECS的DNS服务器地址为内网DNS，来实现内网访问OBS。

方法1：修改VPC子网DNS地址

确定ECS所在VPC，并修改VPC子网的DNS服务器地址为内网DNS地址后，可以使整个VPC内的ECS都通过内网DNS进行解析，从而访问在华为云内网的OBS服务。

方法2：修改本地DNS配置

以CentOS 6.x 64bit弹性云服务器为例：

具体步骤可参考：https://support.huaweicloud.com/bestpractice-obs/obs_05_0430.html

3.       在华为云 ECS 中如何判断使用内网访问 OBS？

在华为云 ECS 中 ping OBS 的终端节点（endpoint）域名，如果响应的IP地址为100网段，则说明通过内网访问OBS。如在Linux ECS上：

4.       obsutil 如何高效地实现桶间对象传输？

通过对象复制命令，将源桶中对象复制到目标通中（暂不支持文件语义桶到对象桶的对象复制），支持单个对象或批量对象的复制。

简单命令(Linux)：

注意：1.复制时需要有被复制对象的读权限和目标桶的写权限；

   2.如果没有开启跨区域复制模式，复制的源桶和目标桶必须在同一个区域;

5.       obsutil 的默认配置文件、结果清单及日志文件在哪里？

a)       默认配置文件

当对obsutil进行初始化配置后，会在用户目录（macOS/Linux操作系统的“~”目录；Windows操作系统的“C:\Users\<username>”目录）生成一个名为.obsutilconfig的配置文件。

b)      结果清单

批量任务执行完成后，会生成结果清单文件，默认情况下结果清单文件保存在用户目录的子文件夹.obsutil_output下，包含三种类型：成功结果清单、失败结果清单和警告结果清单，命名规则为：操作_{succeed | failed | warning}_report_时间_TaskId.txt。

c)       日志文件

默认情况下日志文件保存在用户目录的子文件夹.obsutil_log下，包含工具日志(obsutil.log)和SDK日志(obssdk.log)，分别记录工具在运行期间产生的日志信息和工具调用OBS服务端接口期间产生的日志信息。

6.       对于部分失败批量上传、下载或复制任务，如何恢复任务？

首先根据任务返回的Task id，将对应的结果清单日志找出，排查任务失败原因，如网络中断、磁盘异常，权限等问题，将问题排除后，利用obsutil的恢复命令重新执行任务，此时只会重新执行对应失败对象的上传、下载或复制。

简单命令(Linux)：./obsutil cp -recover={task id} -f

如：obsutil cp -recover=3066a4b0-4d21-4929-bb84-4829c32cbd0f -f

7.       obsutil 执行对象复制命令时，报错“Error: The max jobs for copy is 10”，如何解决？

当前执行对象(单个/批量)复制操作时，允许的批量操作最大并发数(默认为配置文件中defaultJobs)和单个分段任务的最大并发数(默认为配置文件中defaultParallels)均为10。当这两个参数超过10时会出现这种报错，解决办法是修改配置文件或在当前命令中增加-j=10和-p=10附加参数，将对应的参数最高调整为10。

8.       使用 obsutil 上传下载速度慢？

采用 obsutil 进行文件上传下载，依赖于本地的网络带宽、磁盘IO、服务端的响应等条件，obsutil 不会对客户数据传输进行限流。

a)       检查网络，如 ping obs.cn-north-1.myhuaweicloud.com，检查网络时延、丢包率等；

b)      在华为 ECS 中访问OBS，检查是否通过内网访问 OBS；

c)       对于大量小文件的上传、下载主要参考 TPS 值(单位时间内处理文件个数)，而非带宽；

d)      在批量上传可以增加 -j -p 等参数，并将参数数据调高，观察传输速度是否提高，参考性能调优最佳实践：https://support.huaweicloud.com/utiltg-obs/obs_11_0052.html

9.       obsutil cp 命令在上传/下载/复制时开启增量上传下载？

在执行cp命令进行上传/下载时，通过增加 -u 参数开启增量功能，该参数的含义为：上传/下载/复制每个对象时都会对比源路径和目标路径，仅在目标对象不存在，或者对象大小不一致，或者目标对象的最后修改时间早于源对象的最后修改时间时进行上传/下载/复制。