升级HBlock
更新时间 2026-08-17 09:47:39
最近更新时间: 2026-08-17 09:47:39
本节主要介绍升级HBlock命令。
./stor upgrade { --filename | -f } file [ --archfile PACKAGE &<1-n> ] [ --key VALUE ]
此命令用来升级HBlock。对于集群，只需要在一台服务器上执行升级即可。
说明
免费版仅支持2年内升级。
注意
升级期间建议仅执行查询操作，避免其他操作，以免引起服务异常。
升级过程中系统会做检查，如果不符合升级条件，可能会导致升级失败，升级失败的原因可以在执行升级操作的服务器上查看日志upgrade.log（日志路径：HBlock安装目录/logs/ops/upgrade.log）。
建议升级之前对系统进行检查，确保满足以下条件：
服务器状态：
所有HBlock服务器连接正常，无处于删除状态的服务器。
HBlock处于working、upgrading状态。
软件许可证：
订阅模式：在有效期内。
永久许可模式：在维保期限内。
试用期：未过期。
卷状态：
集群版：如果卷是高可用类型，至少保证卷的主备连接正常。
无处于失败或者任务进行中状态的卷。
数据冗余度：
系统整体数据冗余度不降级，正常数据百分比为100%。
可用故障域数量和健康数量大于所有卷的写入需求。
服务状态：
升级监听服务（stor:ua）正常。
协议解析服务（stor:ps）正常。
集群版：数据服务（stor:ds-x）正常。
集群版：基础服务正常：元数据管理服务（stor:mdm）、日志服务（stor:ls）、协调服务（stor:cs）。
注意
执行升级HBlock前，确保每个服务器的HBlock安装路径对应的文件系统，存在至少1 GiB的可用空间。
参数
| 参数 | 描述 |
|---|---|
| --filename file或-f file | 当前服务器升级的目标版本HBlock安装包具体路径和具体文件名称。 说明 当前服务器升级使用的安装包，必须保证与该服务器使用的安装包类型匹配。 注意 安装包的具体路径不要含有 -、--及空格。 |
| --archfile PACKAGE | 需升级的集群中其他不同架构服务器的安装包路径及文件名（仅集群版支持）。如果有多种不同类型服务器，应添加多个安装包，使用英文逗号隔开。 注意 当集群内存在与执行升级服务器架构不同的服务器时，才需指定此参数，用于指定相应架构服务器的HBlock安装包。 |
| --key VALUE | 升级至HBlock目标版本时，若该版本需导入参数，则须设置此项。具体参数设置应依据目标版本而定。若目标版本需多个参数，可多次按“--key VALUE”格式添加，其中“key”为参数名，“VALUE”为参数值。 说明 目前支持的key值为ds-concurrent-count（仅集群版支持），表示单个故障域内可并发升级的数据服务最大数量。Value取值范围是[1, 2147483647]，默认值为1。 |
升级
升级HBlock服务：从HBlock 4.0.0升级至HBlock 4.1.0。
[root@hblockserver CTYUN_HBlock_Plus_4.0.0_x64]# ./stor upgrade -f /mnt/storage01/CTYUN_HBlock_Plus_4.1.0_x64.zip
Starting upgrade, the current version is 4.0.0, the target version is 4.1.0
Start time: 2026-07-27 13:39:54
Server info:
hblock_1, 192.168.0.65, hblockserver
hblock_2, 192.168.0.64, k8s-master
hblock_3, 192.168.0.67, songt-0006
2026-07-27 13:39:54 CST+0800 [Step 1/5] Checking for system status...
2026-07-27 13:39:54 CST+0800 Checking system info
2026-07-27 13:39:54 CST+0800 Checking data status
2026-07-27 13:39:54 CST+0800 [Step 2/5] Uploading update files...
2026-07-27 13:39:58 CST+0800 Upload [100%] for hblock_1 ###[server 1/3]
2026-07-27 13:40:00 CST+0800 Upload [100%] for hblock_2 ###[server 2/3]
2026-07-27 13:40:02 CST+0800 Upload [100%] for hblock_3 ###[server 3/3]
2026-07-27 13:40:02 CST+0800 [Step 3/5] Upgrade preparing...
2026-07-27 13:40:28 CST+0800 [Step 4/5] Installing updates...
2026-07-27 13:40:28 CST+0800 Upgrading config - Update[√] ### [module 1/12]
2026-07-27 13:40:37 CST+0800 Upgrading cs for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [server 1/3] [module 2/12]
2026-07-27 13:41:23 CST+0800 Upgrading cs for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [server 2/3] [module 2/12]
2026-07-27 13:42:08 CST+0800 Upgrading cs for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [server 3/3] [module 2/12]
2026-07-27 13:42:52 CST+0800 Upgrading storfsBase - Update[√] ### [module 3/12]
2026-07-27 13:43:02 CST+0800 Upgrading ls for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [server 1/3] [module 4/12]
2026-07-27 13:43:30 CST+0800 Upgrading ls for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [server 2/3] [module 4/12]
2026-07-27 13:43:48 CST+0800 Upgrading ls for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [server 3/3] [module 4/12]
2026-07-27 13:44:05 CST+0800 Upgrading mdm for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [server 1/3] [module 5/12]
2026-07-27 13:44:27 CST+0800 Upgrading mdm for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [server 2/3] [module 5/12]
2026-07-27 13:44:44 CST+0800 Upgrading mdm for hblock_3 - Update[√] ### [server 3/3] [module 5/12]
2026-07-27 13:44:48 CST+0800 Upgrading ds-1 for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [service 1/1] [server 1/3] [module 6/12]
2026-07-27 13:45:04 CST+0800 Upgrading ds-1 for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [service 1/2] [server 2/3] [module 6/12]
2026-07-27 13:45:13 CST+0800 Upgrading ds-2 for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [service 2/2] [server 2/3] [module 6/12]
2026-07-27 13:45:24 CST+0800 Upgrading ds-1 for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [service 1/1] [server 3/3] [module 6/12]
2026-07-27 13:45:35 CST+0800 Upgrading rb for hblock_1 - Check[√], Stop[√], Update[√] ### [server 1/3] [module 7/12]
2026-07-27 13:45:47 CST+0800 Upgrading rb for hblock_2 - Check[√], Stop[√], Update[√] ### [server 2/3] [module 7/12]
2026-07-27 13:45:58 CST+0800 Upgrading rb for hblock_3 - Check[√], Stop[√], Update[√] ### [server 3/3] [module 7/12]
2026-07-27 13:46:09 CST+0800 Upgrading ps for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [server 1/3] [module 8/12]
2026-07-27 13:46:18 CST+0800 Upgrading ps for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [server 2/3] [module 8/12]
2026-07-27 13:46:29 CST+0800 Upgrading ps for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [server 3/3] [module 8/12]
2026-07-27 13:46:41 CST+0800 Upgrading tool - Update[√] ### [module 9/12]
2026-07-27 13:46:47 CST+0800 Upgrading remote for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [server 1/3] [module 10/12]
2026-07-27 13:46:50 CST+0800 Upgrading remote for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [server 2/3] [module 10/12]
2026-07-27 13:46:53 CST+0800 Upgrading remote for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [server 3/3] [module 10/12]
2026-07-27 13:46:55 CST+0800 Upgrading monitor for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [server 1/3] [module 11/12]
2026-07-27 13:47:04 CST+0800 Upgrading monitor for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [server 2/3] [module 11/12]
2026-07-27 13:47:11 CST+0800 Upgrading monitor for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [server 3/3] [module 11/12]
2026-07-27 13:47:18 CST+0800 Upgrading ws for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [service 1/2] [server 1/3] [module 12/12]
2026-07-27 13:47:24 CST+0800 Upgrading ms for hblock_1 - Check[√], Stop[√], Update[√], Start[√] ### [service 2/2] [server 1/3] [module 12/12]
2026-07-27 13:47:36 CST+0800 Upgrading ws for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [service 1/2] [server 2/3] [module 12/12]
2026-07-27 13:47:41 CST+0800 Upgrading ms for hblock_2 - Check[√], Stop[√], Update[√], Start[√] ### [service 2/2] [server 2/3] [module 12/12]
2026-07-27 13:47:47 CST+0800 Upgrading ws for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [service 1/2] [server 3/3] [module 12/12]
2026-07-27 13:47:52 CST+0800 Upgrading ms for hblock_3 - Check[√], Stop[√], Update[√], Start[√] ### [service 2/2] [server 3/3] [module 12/12]
2026-07-27 13:48:03 CST+0800 [Step 5/5] Updating system info...
2026-07-27 13:48:06 CST+0800 [Post Upgrade] Cleaning...
2026-07-27 13:48:06 CST+0800 Cleaning hblock_1 ###[server 1/3]
2026-07-27 13:48:06 CST+0800 Cleaning hblock_3 ###[server 2/3]
2026-07-27 13:48:06 CST+0800 Cleaning hblock_2 ###[server 3/3]
2026-07-27 13:48:06 CST+0800 [Upgrade Complete] The system has been successfully upgraded to 4.1.0 version
