单机版：
./stor lun { L | lun } { -n | --name } LUN_NAME { -t | --target } TARGET_NAME --uuid UUID [ { -w | --write-policy } WRITE_POLICY ] [ { -P | --path } PATH ] [ --cloud-provider CLOUD_PROVIDER ] { -m | --mode } STORAGE_MODE { -B | --bucket } BUCKET_NAME [ { -X | --prefix } PREFIX ] { -A | --ak } ACCESS_KEY { -S | --sk } SECRET_KEY { -E | --endpoint } ENDPOINT [ --sign-version VERSION ] [ --region REGION ] [ { -C | --cloud-storage-class } CLOUD_STORAGE_CLASS ] [ { -M | --cloud-compression } CLOUD_COMPRESSION ]
集群版：
./stor recover { L | lun } { -n | --name } LUN_NAME { -t | --target } TARGET_NAME [ --pool POOL ] [ --cache-pool CACHE_POOL ] --uuid UUID [ { -a | --ha } HIGH_AVAILABILITY ] [ { -c | --local-storage-class } LOCAL_STORAGE_CLASS ] [ --min-replica MIN_REPLICA ] [ --ec-fragment-size EC_FRAGEMENT_SIZE ] [ --redundancy-overlap REDUNDANCY_OVERLAP ] [ { -w | --write-policy } WRITE_POLICY ] { -m | --mode } STORAGE_MODE [ --cloud-provider CLOUD_PROVIDER ] { -B | --bucket } BUCKET_NAME [ { -X | --prefix } PREFIX ] { -A | --ak } ACCESS_KEY { -S | --sk } SECRET_KEY [ { -C | --cloud-storage-class } CLOUD_STORAGE_CLASS ] { -E | --endpoint } ENDPOINT [ --sign-version VERSION ] [ --region REGION ] [ { -M | --cloud-compression } CLOUD_COMPRESSION ]
此命令用来还原HBlock上云卷。
说明
以下场景适合还原卷功能：
- 原HBlock中存在上云卷，并且将数据上传到了云端。如果此时HBlock发生故障无法启动，可以通过还原卷的功能，在另一个HBlock中将该卷重新生成，并且从云端进行数据恢复。
- 原上云卷被删除，但云上数据保留，可以通过还原卷功能恢复卷数据。
注意
- 在执行还原操作的时候，请确保原HBlock和云上的连接已经断开，不再向该卷写入新的数据。
- 待还原的卷名称在当前HBlock中不存在。
- 待还原的卷必须在指定的Bucket/prefix中找到，且数据完整。
- 还原操作异步执行，请通过查询卷的功能查看还原进度。
参数
| 参数 | 描述 |
|---|---|
| -n LUN_NAME 或 --name LUN_NAME | 源卷名称。 |
| -t TARGET_NAME 或 --target TARGET_NAME | 指定还原卷的iSCSI Target名称。 取值：字符串形式，长度范围1~16，只能由小写字母、数字、句点(.)和短横线(-)组成，且仅支持以字母或数字开头。 说明 还原卷时，如果指定的iSCSI Target名称不存在，那么同时创建iSCSI Target。 |
| --pool POOL | 指定存储池（仅集群版支持），表示最终存储池，卷数据最终落在该存储池内。默认使用集群的基础存储池。 |
| --cache-pool CACHE_POOL | 指定缓存存储池（仅集群版支持）。如果指定了缓存存储池，卷数据首先写入缓存存储池，然后再存入存储池。 注意 存储池与缓存存储池不能是同一个存储池。 |
| --uuid UUID | 源卷的唯一标识码。 |
| -a HIGH_AVAILABILITY 或 --ha HIGH_AVAILABILITY | 指定还原卷的高可用类型（仅集群版支持）： 取值：
默认值为源卷的高可用类型。 |
| -c LOCAL_STORAGE_CLASS 或 --local-storage-class LOCAL_STORAGE_CLASS | 设置还原卷的冗余模式（仅集群版支持）。 取值：
默认值为源卷的冗余模式。 说明 以下场景均为集群可用的前提下：
|
| --min-replica MIN_REPLICA | 设置还原卷的最小副本数（仅集群版支持）。 对于副本模式的卷，假设卷副本数为X，最小副本数为Y（Y必须≤X），该卷每次写入时，至少Y份数据写入成功，才视为本次写入成功。对于EC N+M模式的卷，假设该卷最小副本数设置为Y（必须满足N≤Y≤N+M），必须满足总和至少为Y的数据块和校验块写入成功，才视为本次写入成功。 取值：整数。对于副本卷，取值范围是[1, N]，N为副本模式卷的副本数，默认值为源卷的最小副本数。对于EC卷，取值范围是[N, N+M]，默认值为源卷的最小副本数。 |
| --ec-fragment-size EC_FRAGEMENT_SIZE | 设置还原卷的纠删码模式分片大小。卷冗余模式为EC模式时，此设置才生效，否则忽略。 取值：1、2、4、8、16、32、64、128、256、512、1024、2048、4096，单位是KiB。默认值为源卷的纠删码模式分片大小。 |
| --redundancy-overlap REDUNDANCY_OVERLAP | 指定还原卷的折叠副本数（仅集群版支持）。在数据冗余模式下，同一份数据的不同副本/分片默认分布在不同的故障域，当故障域损坏时，允许根据卷的冗余折叠原则，将多份数据副本放在同一个故障域中，但是分布在不同的path上。 注意 如果存储池故障域级别为path，此参数不生效。如果指定了还原卷的折叠副本数，必须指定还原卷的冗余模式。 取值：对副本模式，取值范围是[1，副本数]；对于EC模式，取值范围是[1，M+N]。如果未设置还原卷的折叠副本数，默认值为源卷的折叠副本数。 |
| -w WRITE_POLICY 或 --write-policy WRITE_POLICY | 设置还原卷的写策略：
默认值为源卷的写策略。 |
| -P PATH 或 --path PATH | 指定还原卷存储数据的数据目录（仅单机版支持）。 如果还原卷时不指定数据目录，使用服务器设置的默认数据目录。 |
| -m STORAGE_MODE 或 --mode STORAGE_MODE | 设置还原卷的存储类型：
存储类型默认为源卷的存储类型。 |
--cloud-provider CLOUD_PROVIDER | 指定还原卷的对象存储服务名称：
默认值为OOS。 说明 源卷和还原卷必须使用相同的对象存储服务。 |
-B BUCKET_NAME 或 --bucket BUCKET_NAME | 源卷所在存储桶的名称。 注意 请勿开启Bucket的生命周期设定和合规保留。 |
-X PREFIX 或 --prefix PREFIX | 源卷的前缀名称。如果源卷未指定前缀，则此处不设置。 取值：字符串形式，长度范围是1~256。 |
-A ACCESS_KEY 或 --ak ACCESS_KEY | 源卷的AccessKeyID。 |
-S SECRET_KEY 或 --sk SECRET_KEY | 源卷的SecretAccessKey。 |
| -C CLOUD_STORAGE_CLASS 或 --cloud-storage-class CLOUD_STORAGE_CLASS | 设置还原卷上传数据至对象存储的存储类型：
默认为源卷上传数据至对象存储的存储类型。 |
| -E ENDPOINT 或 --endpoint ENDPOINT | 源卷的Endpoint。 |
| --sign-version VERSION | 指定还原卷上云签名认证的类型：
默认值为v2。 |
| --region REGION | 还原卷的region，即Endpoint资源池所在区域。具体region详见OOS Endpoint和区域。 V4签名时，此项必填。 |
-M CLOUD_COMPRESSION 或 --cloud-compression CLOUD_COMPRESSION
| 设置还原卷是否压缩数据上传至对象存储：
默认值为源卷的设置。 |
示例
还原卷lun01a。
[root@songt-0004 CTYUN_HBlock_Plus_3.8.0_x64]# ./stor lun recover -n lun01a -t target01 --uuid lun-uuid-38c7678c-33fd-4abe-b80f-0f5cd3ec6b18 --pool pool1 -B hblocktest3 -A 8f129a5529f202811fd0 -S ****************** -E oos-cn.ctyunapi.cn
Confirm the information you set. If correct, enter Yes(Y). If not, enter No(N).
UUID: lun-uuid-38c7678c-33fd-4abe-b80f-0f5cd3ec6b18
LUN Name: lun01a
Local Storage Class: EC 2+1+16KiB
Minimum Replica Number: 2
Redundancy Overlap:1
Capacity: 202 GiB
iSCSI Target: target01
Local Sector Size: 4096 bytes
High Availability: ActiveStandby
Write Policy: WriteBack
Object Storage Info:
+-------------------+----------------------------+
| Provider | OOS |
| Bucket Name | hblocktest3 |
| Endpoint | https://oos-cn.ctyunapi.cn |
| Signature Version | v2 |
| Region | |
| Storage Class | STANDARD |
| Access Key | 8f129a5529f202811fd0 |
| Object Size | 1024 KiB |
| Compression | Enabled |
+-------------------+----------------------------+
Y
Start to recover LUN lun01a.
You can list lun to check whether the recovery is completed.
