适用场景

• 产品：HCI 旗舰版。
• 组件：通用存储。
• 版本：5.4.18 及之后版本；实际子命令以当前 zstnctl 帮助为准。
• 涉及对象：存储池、数据盘、离线磁盘记录和存储主机。
• 触发条件：按已确认的退役、缩容或清理方案，需要使用命令行完成对应资源操作。

本文不适用于高性能存储的存储池、zone 或节点资源处理，也不用于未完成数据处置、迁移或容量评估的场景。

问题现象

• 需要删除不再使用的存储池。
• 需要从存储池移除数据盘，或下线目标数据盘。
• 管理界面存在已经离线的磁盘记录，需要清理。
• 需要按退役方案删除目标存储主机。

常规操作被拒绝时，应先检查资源占用、关联关系和状态，不能仅因命令失败就直接使用强制删除。

判断方法

在管理界面记录目标资源的名称、UUID、所属主机和关联对象，再选择对应操作：

数据盘 UUID 与磁盘 UUID 不同，也不是 osd.3 这类数字标识或 /dev/sdb 这类设备路径。应按管理界面对应资源的 UUID 填写。

原因说明

存储池、数据盘、离线磁盘记录和主机处于不同资源层级，适用的命令、标识格式和批量规则不同。资源下线可能触发数据恢复、重分布或主机关联资源清理；因此，命令成功不代表数据处置和业务影响已自动完成。

解决方案

1. 执行前准备

1. 确认目标资源、所属节点、ZStone VIP、数据保留要求和现有依赖关系。
2. 涉及退役或缩容时，先按现场方案完成迁移、数据保护、容量和副本检查。
3. 保留操作前的资源关系、状态截图和相关日志。
4. 查看本次实际使用子命令的帮助，确认当前工具版本提供所需功能：

   /opt/zstone/bin/zstnctl version
   /opt/zstone/bin/zstnctl pool delete --help
   /opt/zstone/bin/zstnctl pool reduce --help
   /opt/zstone/bin/zstnctl osd remove --help
   /opt/zstone/bin/zstnctl disk remove --help
   /opt/zstone/bin/zstnctl host delete --help

以下示例中的 --password 为平台登录密码，不是数据库密码。尖括号内容均需替换为已核实的实际值。

2. 删除单个存储池

/opt/zstone/bin/zstnctl pool delete '<存储池UUID>' \
  --password '<平台登录密码>' \
  -v '<ZStone VIP>'

一次只处理一个存储池。命令完成后，在管理界面确认目标存储池已按计划移除；若操作被拒绝，保留错误并检查关联资源，不直接追加 --force。

3. 从存储池移除同一节点的数据盘

/opt/zstone/bin/zstnctl pool reduce \
  --poolname '<存储池名称>' \
  --osd-uuid '<数据盘UUID-1>,<数据盘UUID-2>' \
  --password '<平台登录密码>' \
  -v '<ZStone VIP>'

多个数据盘必须属于同一节点，UUID 用英文逗号分隔。出现数据恢复或重分布任务时，等待其完成后再评估后续变更。

4. 下线同一节点的数据盘

/opt/zstone/bin/zstnctl osd remove \
  '<数据盘UUID-1>' '<数据盘UUID-2>' \
  -v '<ZStone VIP>'

此处 UUID 使用英文空格分隔，与 pool reduce --osd-uuid 的逗号格式不同。操作完成后，核对存储池状态及未操作数据盘的状态。

5. 清理离线磁盘记录

先在管理界面确认目标磁盘已经处于离线状态，再执行：

/opt/zstone/bin/zstnctl disk remove '<磁盘UUID>' \
  -v '<ZStone VIP>'

不要为清理记录而直接拔出仍在使用的磁盘。命令完成后，在管理界面确认目标离线磁盘记录已删除。

6. 删除单台主机

/opt/zstone/bin/zstnctl host delete '<主机UUID>' \
  --password '<平台登录密码>' \
  -v '<ZStone VIP>'

一次只删除一台主机。操作完成后，确认目标主机已按退役方案移除，未操作节点与存储业务正常。

验证方法

• 操作结果：检查命令输出和任务结果，确认删除或下线对象与变更计划一致。
• 资源状态：在管理界面核对存储池、数据盘、磁盘和主机的关系与状态，不只以命令返回成功作为判断依据。
• 集群恢复：存在数据恢复或重分布任务时，等待任务完成后再验收。
• 业务影响：确认未操作节点、未操作资源和相关业务访问正常。

风险与回滚

• 删除或下线错误的资源可能导致数据丢失、业务中断或资源关联异常。执行前必须完成数据处置和影响确认。
• --force 可能绕过常规保护，并可能造成不可预期的数据影响或主机关联资源被级联删除；本文不提供强制删除命令。确需强制处理时，请联系官方技术支持确认具体方案。
• 原始素材未提供通用回滚命令。发生异常时，停止后续资源操作，保留当前资源状态、命令输出和日志，并依据变更前备份及现场恢复方案处理。