单机版:
./stor lun { L | lun } { -n | --name } LUN_NAME { -t | --target } TARGET_NAME --uuid UUID [ { -w | --write-policy } WRITE_POLICY ] [ { -P | --path } PATH ] { -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 ] [ { -w | --write-policy } WRITE_POLICY ] { -m | --mode } STORAGE_MODE { -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
指定还原卷的高可用类型(仅集群版支持):
取值:
ActiveStandby(as):启用主备,该卷关联对应Target下的所有IQN。
Disabled(off):不启用主备,该卷关联对应Target下的1个IQN。客户端连接该类型的卷的方法可以参见Windows 客户端 – 单机版、Linux 客户端 – 单机版。
默认值为源卷的高可用类型。
-c LOCAL_STORAGE_CLASS 或 --local-storage-class LOCAL_STORAGE_CLASS 设置还原卷的冗余模式(仅集群版支持)。
取值:
single-copy:单副本。
2-copy:两副本。
3-copy:三副本。
EC N+M:纠删码模式。其中N、M为正整数,N>M,且N+M≤128。表示将数据分割成N个片段,并生成M个校验数据。
默认值为源卷的冗余模式。
说明以下场景均为集群可用的前提下:
还原EC N+M的卷后:
卷所在存储池可用故障域数量大于等于卷的最小副本数时,可以向卷中写数据。卷所在存储池可用故障域数量小于最小副本数时,不能向卷写数据,且系统会产生告警。
卷所在存储池可用故障域数量大于等于N+M,卷数据正常,不会产生降级。卷所在存储池可用故障域数量处于[N, N+M),卷数据将处于降级状态,建议尽快添加或修复故障域。卷所在存储池可用故障域数量小于N时,已写入的数据发生损毁。
还原副本模式的卷后:
卷所在存储池可用故障域数量大于等于卷的最小副本数时,可以向卷中写数据。卷所在存储池可用故障域数量小于最小副本数时,不能向卷写数据,且系统会产生告警。
卷所在存储池可用故障域数量大于等于副本数,卷数据正常,不会产生降级。对于两副本、三副本卷,卷存储池所在故障域大于等于1,但小于副本数时,卷数据将处于降级状态,建议尽快添加或修复存储池故障域。卷所在存储池无可用故障域时,已写入的数据发生损毁。
--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。默认值为源卷的纠删码模式分片大小。
-w WRITE_POLICY 或 --write-policy WRITE_POLICY 设置还原卷的写策略:
WriteBack(wb):回写,指数据写入到内存后即返回客户端成功,之后再异步写入磁盘。适用于对性能要求较高,稳定性要求不高的场景。
WriteThrough(wt):透写,指数据同时写入内存和磁盘,并在都写成功后再返回客户端成功。适用于稳定性要求较高,写性能要求不高,且最近写入的数据会较快被读取的场景。
WriteAround(wa):绕写,指数据直接写到磁盘,不写入内存。适用于稳定性要求较高,性能要求不高,且写多读少的场景。
默认值为源卷的写策略。
-P PATH 或 --path PATH 指定还原卷存储数据的数据目录(仅单机版支持)。
如果还原卷时不指定数据目录,使用服务器设置的默认数据目录。
-m STORAGE_MODE 或 --mode STORAGE_MODE 设置还原卷的存储类型:
Cache:缓存模式,本地保留部分热数据,全部数据异步存储到OOS中。
Storage:存储模式,本地保留全部数据,并异步存储到OOS中。
存储类型默认为源卷的存储类型。
-B BUCKET_NAME 或 --bucket BUCKET_NAME 源卷所在OOS存储桶的名称。
注意请勿开启Bucket的生命周期设定和合规保留。
-X PREFIX 或 --prefix PREFIX 源卷的前缀名称。如果源卷未指定前缀,则此处不设置。
取值:字符串形式,长度范围是1~256。
-A ACCESS_KEY 或 --ak ACCESS_KEY 源卷的OOS AccessKeyID。 -S SECRET_KEY 或 --sk SECRET_KEY 源卷的OOS SecretAccessKey。 -C CLOUD_STORAGE_CLASS 或 --cloud-storage-class CLOUD_STORAGE_CLASS
设置还原卷上传数据至OOS的存储类型:
STANDARD:标准存储。
STANDARD_IA:低频访问存储。
默认为源卷上传数据至OOS的存储类型。
-E ENDPOINT 或 --endpoint ENDPOINT 源卷的OOS Endpoint。 --sign-version VERSION 指定还原卷上云签名认证的类型:
v2:V2签名认证。
v4:V4签名认证。
默认值为v2。
--region REGION 还原卷的region,即Endpoint资源池所在区域。具体region详见OOS Endpoint和区域。
V4签名时,此项必填。
-M CLOUD_COMPRESSION 或 --cloud-compression CLOUD_COMPRESSION
设置还原卷是否压缩数据上传至OOS:
Enabled(on):压缩数据上传至OOS。
Disabled(off):不压缩数据上传至OOS。
默认值为源卷的设置。
示例
还原卷luna4。
[root@hblockserver CTYUN_HBlock_Plus_3.7.0_x64]# ./stor recover lun -n luna4 -t targeta --uuid lun-uuid-45c5c571-7e8c-44ff-b078-6ba509c58b7b -B hblocktest3 -X hblock -A cb22b08b1f9229f85874 -S ************ -E oos-cn.ctyunapi.cn
Start to recover LUN luna4.
You can list lun to check whether the recovery is completed.