swapnode
使用 swapnode 命令可通过在热备用节点上使用虚拟化目标端口来促进维护可用性而不中断的维护操作。 此命令在硬件更换过程中使用，或者用作将节点置于服务状态的替代方法。
语法
参数
- -service | -failover | -failback | -replace
- (必需) 指定正在所选节点上执行的服务操作的类型。 值为：
- -service: 在系统触发将 N_Port 标识虚拟化 (NPIV) 端口故障转移到 I/O 组中的伙伴节点后，将活动联机节点置于服务状态。 无论备用保护是否可用，此命令都可以成功。
- -failover: 会将集群节点故障转移到备用备用节点，即使该集群节点处于联机状态也是如此。 指定节点进入服务状态，备用备用节点变为online_备件。 该命令可以成功使用或不使用可选的 -spare 参数。 与 -spare 参数一起使用时，它定义要使用的备用备用节点; 否则，将选择最佳适合的备用备用节点。
- -failback: 将online_备件故障恢复到备用备件，并且它保护的节点退出服务方式并返回到集群。 必须为此命令指定online_备件的节点对象标识或名称。
- -replace: 将逻辑上处于脱机状态或处于服务状态的指定节点替换为其 WWNN 与指定节点匹配的候选节点。注: 在硬件升级过程中使用此 -replace 参数，或者在 IBM 支持人员的指导下使用此参数，以恢复在错误代码 578 (丢失固化数据) 中报告的节点。
- -force
- （可选）指定移除节点，即使可能会因此导致主机系统 I/O 中断。要点: 指定 -force 可能会导致失去访问权。 仅当产品支持信息指示时使用该参数
- -spare node_id | node_name
- (可选) 指定要作为临时备用节点联机的备用备用节点的标识或名称。 此参数只能与 -failover 参数一起使用。注: 标识的值必须大于
1，因为备件绝不是集群系统中的第一个节点。 - node_id | node_name
- （必需）指定正在交换或维护的节点标识或名称。
描述
使用 swapnode 命令可通过将指定节点故障转移到热备用节点并在其虚拟化目标端口上保持可用性而不中断，将联机备用节点故障回退到备用备用节点，以及将原始节点返回到集群来促进维护操作。 在硬件更换过程中，也可以使用此命令来完成需要 rmnode 和 addnode 命令的任务，或者作为将节点置于服务状态的替代方法。
-replace 参数可简化替换受online_备件保护的脱机节点或服务节点所需的过程 (命令)。 它使用与脱机节点关联的 I/O 组和站点值作为替换的配置参数。 替换节点必须是与脱机节点具有相同 WWNN 值的候选节点。
注: 当新替换候选节点的 WWNN 处于物理电源关闭状态并与系统断开连接时，必须仅将其更改为逻辑脱机节点或处于服务状态的节点的 WWNN。
重要信息: NVMe 虚拟化目标端口在某些光纤通道适配器上不受支持。 在使用 CLI 之前，请检查备用节点配置。 允许用户下载云使用历史记录。
调用示例
以下示例列出了将节点置于服务方式的步骤。
- 使用 lsnode 命令可列出系统中的所有节点。 在以下 lsnode 输出示例中，标识为 2 的节点 "node2" 处于联机状态。
lsnode结果输出：
id name UPS_serial_number WWNN status IO_group_id IO_group_name config_node UPS_unique_id hardware iscsi_name iscsi_alias panel_name enclosure_id canister_id enclosure_serial_number site_id site_name 1 node1 500507680C000128 online 0 io_grp0 yes SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node1 G71H00P 1 2 node2 500507680C000130 online 0 io_grp0 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node2 G71H00M 1 3 spare1 500507680C000138 online_spare 1 io_grp1 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node3 G71H00X 1 - 发出带有节点标识或名称的 swapnode -service 命令。 以下示例将标识为 2 的节点更改为服务方式。
swapnode -service 2生成的详细输出：
No feedback - 使用 lsnode 命令来验证节点是否处于服务状态。 以下示例显示标识为 2 的节点 "节点 2" 处于服务状态。
lsnode结果输出：
id name UPS_serial_number WWNN status IO_group_id IO_group_name config_node UPS_unique_id hardware iscsi_name iscsi_alias panel_name enclosure_id canister_id enclosure_serial_number site_id site_name 1 node1 500507680C000128 online 0 io_grp0 yes SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node1 G71H00P 1 2 node2 500507680C000130 service 0 io_grp0 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node2 G71H00M 1 3 spare1 500507680C000138 online_spare 1 io_grp1 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node3 G71H00X 1
调用示例
以下示例列出了将集群节点故障转移到备用备用节点 (即使集群节点处于联机状态) 的步骤。
- 使用 lsnode 命令可列出系统中的所有节点。 在以下 lsnode 输出示例中，标识为 12 的 "node2" 处于联机状态，标识为 ID14 的 "spare1" 处于备用状态。
lsnode结果输出：
id name UPS_serial_number WWNN status IO_group_id IO_group_name config_node UPS_unique_id hardware iscsi_name iscsi_alias panel_name enclosure_id canister_id enclosure_serial_number site_id site_name 1 node1 500507680C000128 online 0 io_grp0 yes SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node1 G71H00P 1 12 node2 500507680C000130 online 0 io_grp0 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node2 G71H00M 1 14 spare1 500507680C000138 spare 1 io_grp1 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node3 G71H00X 1 - 发出带有备用节点和集群节点的标识或名称的 swapnode -failover 命令。 以下示例将标识为 12 的节点故障转移到标识为 14 的备用节点。
swapnode -failover -spare 14 12生成的详细输出：
No feedback - 使用 lsnode 命令来验证集群节点是否处于服务状态以及备用节点是否处于online_备用状态。 以下示例显示标识为 12 的 "node2" 处于联机状态，而标识为 ID15 的 "spare1" 处于备用状态。注: Online_备用节点标识将递增到下一个可用的 node_id。
lsnode结果输出：
id name UPS_serial_number WWNN status IO_group_id IO_group_name config_node UPS_unique_id hardware iscsi_name iscsi_alias panel_name enclosure_id canister_id enclosure_serial_number site_id site_name 1 node1 500507680C000128 online 0 io_grp0 yes SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node1 G71H00P 1 12 node2 500507680C000130 service 0 io_grp0 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node2 G71H00M 1 15 spare1 500507680C000138 online_spare 1 io_grp1 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node3 G71H00X 1
调用示例
以下示例列出了将联机备用节点故障恢复到其原始集群节点的步骤。
- 使用 lsnode 命令可列出系统中的所有节点。 在以下 lsnode 输出示例中，标识为 12 的 "node2" 处于服务状态，标识为 ID15 的 "spare1" 处于online_备件状态。
lsnode结果输出：
id name UPS_serial_number WWNN status IO_group_id IO_group_name config_node UPS_unique_id hardware iscsi_name iscsi_alias panel_name enclosure_id canister_id enclosure_serial_number site_id site_name 1 node1 500507680C000128 online 0 io_grp0 yes SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node1 G71H00P 1 12 node2 500507680C000130 service 0 io_grp0 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node2 G71H00M 1 15 spare1 500507680C000138 online_spare 1 io_grp1 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node3 G71H00X 1 - 发出带有备用节点标识或名称的 swapnode -failback 命令。 以下示例将标识为 15 的备用节点故障恢复到标识为 12 的集群节点。
swapnode -failback 15生成的详细输出：
No feedback - 使用 lsnode 命令来验证集群节点是否处于联机状态以及备用节点是否处于备用状态。 以下示例显示标识为 12 的 "node2" 处于联机状态，而标识为 ID15 的 "spare1" 处于备用状态。注: Online_备用节点标识将递增到下一个可用的 node_id。
lsnode结果输出：
id name UPS_serial_number WWNN status IO_group_id IO_group_name config_node UPS_unique_id hardware iscsi_name iscsi_alias panel_name enclosure_id canister_id enclosure_serial_number site_id site_name 1 node1 500507680C000128 online 0 io_grp0 yes SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node1 G71H00P 1 12 node2 500507680C000130 online 0 io_grp0 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node2 G71H00M 1 15 spare1 500507680C000138 spare 1 io_grp1 no SV1 iqn.1986-03.com.ibm:2145.mcr-cay-cluster-23.node3 G71H00X 1
用于将脱机节点或服务节点替换为候选节点的调用示例
swapnode -replace 2生成的详细输出：
No feedback