从主机或群集中取消映射卷
使用 unmap_vol 命令从主机或群集中取消映射卷。
unmap_vol <host=HostName | cluster=ClusterName> vol=VolName [ idle_seconds=IdleSeconds ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| host | 对象名 | 主机名。 | N | 不适用 |
| cluster | 对象名 | 集群名。 | N | 不适用 |
| vol | 对象名 | 卷名。 | Y | 不适用 |
| idle_seconds | 整数 | 在取消映射之前卷需要处于空闲状态多少秒? | N | -1 |
| force | 布尔值 | 强制完成取消映射操作,即使代理卷上存在尚未完成的 I/O 操作也是如此。 | N | no |
从集群取消映射的命令将从该集群中包含的所有主机取消映射该卷。
如果指定的主机包含在集群中,该命令将失败。 在这种情况下,必须通过集群才能取消映射主机。
如果卷未映射到主机/集群,该命令不会失败。
将此命令与 unmap_vol_set_default_idle_time 一起使用:在运行 unmap_volume 命令之前,可以设置 idle_seconds 参数的缺省值。
处理该命令需要一些时间:如果该命令失败且显示 VOLUME_NOT_IDLE(请参阅下面的完成代码表),请等待一分钟,以允许主机完成后台写入,然后重试该命令。
访问控制
| 用户类别 | 许可权 | 条件 |
|---|---|---|
| 存储管理员 | 已允许 | 不适用 |
| 存储集成管理员 | 已允许 | 不适用 |
| 应用程序管理员 | 特定条件下才能获得允许 | 该卷是一种快照,其主卷映射到与用户相关的主机或集群,并且快照是由应用程序管理员创建。 |
| 安全性管理员 | 已禁止 | 不适用 |
| 只读用户 | 已禁止 | 不适用 |
| 技术人员 | 已禁止 | 不适用 |
警告
- HA_SLAVE_NOT_CONNECTED
此 HyperSwap 关系中的辅助卷未连接到主卷。确定要取消映射该卷吗?
故障诊断:如果关系仍在使用中,那么不建议从辅助卷取消映射卷。
返回码
- HOST_BAD_NAME
主机名不存在。
- HOST_BELONGS_TO_CLUSTER
此主机已属于某集群。
- CLUSTER_BAD_NAME
集群名称不存在。
- VOLUME_BAD_NAME
卷名称不存在。
- SNAPSHOT_IS_INTERNAL
无法映射、修改或删除内部快照。
- VOLUME_IS_NON_PROXY_OLVM_DESTINATION
卷处于 IBM Hyper-Scale Mobility 迁移状态。
- OPERATION_DENIED_OBJECT_MANAGED
这是一个受管对象。 只有管理软件和 xiv_maintenance/xiv_development 才可以对此对象执行此操作。
- OLVM_LINK_IS_NOT_UP
IBM Hyper-Scale Mobility 链路未启动。无法更新映射列表。
- ISCSI_HOST_ILLEGAL_PORT_NAME
iSCSI 主机的端口名称非法。
故障诊断:iSCSI 主机的端口名必须只包含可打印字符。
- MAX_PORTS_REACHED
已达到系统中定义的最大端口数。
- HOST_PORT_EXISTS
已定义具有该端口标识的主机。
- VOLUME_NOT_IDLE
卷在取消映射之前未处于空闲状态。请检查已连接的主机和空闲超时。
- MAPPING_IS_NOT_DEFINED
未定义请求的映射。
- REMOTE_MAX_VIRTUAL_HOSTS_REACHED
已达到定义的远程虚拟主机的最大数目。
- TARGET_NOT_CONNECTED
当前没有到目标系统的连接。
- REMOTE_TARGET_NOT_CONNECTED
当前没有来自目标系统的连接。