从主机或群集中取消映射卷

使用 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

    当前没有来自目标系统的连接。