Oracle® Solaris Cluster 参考手册

退出打印视图

更新时间: 2014 年 7 月,E51743-01
 
 

clintr(1CL)

名称

clinterconnect, clintr - 管理 Oracle Solaris Cluster 互连

用法概要

/usr/cluster/bin/clinterconnect -V
/usr/cluster/bin/clinterconnect [subcommand] -?
/usr/cluster/bin/clinterconnect subcommand [options] -v 
     [endpoint[,endpoint] …]
/usr/cluster/bin/clinterconnect add [-d] endpoint[,endpoint] …
/usr/cluster/bin/clinterconnect add -i {- | clconfigfile} [-d] 
     [-n node[,…]] {+ | endpoint[,endpoint] …}
/usr/cluster/bin/clinterconnect disable [-n node[,…]] 
     {+ | endpoint[,endpoint] …}
/usr/cluster/bin/clinterconnect enable [-n node[,…]] 
     {+ | endpoint[,endpoint] …}
/usr/cluster/bin/clinterconnect export [-o {- | configfile}] [-n 
     node[,…]] [+ | endpoint[,endpoint] …]
/usr/cluster/bin/clinterconnect remove [-l] endpoint[,endpoint] ...
/usr/cluster/bin/clinterconnect show [-n node[,…]] 
     [+ | endpoint[,endpoint] ...]
/usr/cluster/bin/clinterconnect status [-n node[,…]] 
     [+ | endpoint[,endpoint] ...]

描述

clinterconnect 命令用于管理群集互连配置以及显示配置和状态信息。clintr 命令是 clinterconnect 命令的简短格式。clinterconnect 命令和 clintr 命令是相同的。您可以使用此命令的任一种格式。

群集互连由以电缆连接的两个端点构成。端点可以是节点上的适配器或交换机,也称为结点。电缆可以连接一个适配器和一个交换机,在某些拓扑中还能连接两个适配器。群集拓扑管理器使用可用的电缆在节点之间构建端到端互连路径。提供给此命令的群集互连组件的名称应正确反映实际物理配置。如果无法做到这一点,将会阻止系统构建端到端群集互连路径。缺乏群集互连功能会导致群集节点之间无法相互通信、节点发生紧急情况及类似情况。

必须从已联机且处于群集模式的群集节点运行 clinterconnect 命令。

此命令的一般格式如下所示:

clinterconnect [subcommand] [options] [operands]

仅当 options 指定 –? 选项或 –V 选项时,才可以省略 subcommand

此命令的每个选项都有长格式和简短格式两种格式。在本手册页的“选项”部分给出了每个选项的两种格式,以及对该选项的描述。

可以在非全局区域中使用该命令的某些格式。有关有效使用该命令的更多信息,请参见各个子命令的描述。为便于管理,请在全局区域中使用此命令。

子命令

支持以下子命令:

add

添加作为命令操作数指定的新群集互连组件。

仅在全局区域中使用此子命令。

操作数的语法确定是要添加电缆、交换机还是适配器。有关更多信息,请参阅此手册页的“操作数”部分。

使用 add 子命令可配置适配器和其他节点上的适配器或互连交换机之间的互连电缆。组成电缆的适配器或交换机端点不需要已存在。也可以使用此子命令向配置添加适配器或交换机。

在将适配器或交换机添加到配置时,该命令还会启用所添加的适配器或交换机。在添加电缆时,该命令还会启用电缆的每个端点,如果这些端点尚未启用。

在双节点群集中,如果所添加的电缆在每个端点都有一个适配器,则还会创建一个虚拟交换机。

使用 –d 选项可在禁用状态下添加端点。

如果使用 –i 选项指定配置文件,则可以指定加号 (+) 作为操作数。在使用此操作数时,该命令会创建配置文件中指定的、且群集中尚不存在的所有互连组件。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关删除互连组件的信息,请参见 remove 命令的描述。

disable

禁用作为命令操作数指定的互连组件。

仅在全局区域中使用此子命令。

操作数的语法确定是要禁用电缆、交换机还是适配器。有关更多信息,请参阅此手册页的“操作数”部分。

如果尝试禁用连接到已启用的电缆的适配器或交换机,该操作会导致发生错误。在尝试禁用所连接的适配器之前,必须首先禁用电缆。

在禁用电缆时,该命令还会禁用与电缆关联的每个端点(可能是适配器也可能是交换机端口)。如果所有交换机端口都处于禁用状态,该命令还会禁用交换机。

如果尝试禁用的电缆或端点是活动群集节点的最后一条群集互连路径,该操作会导致错误。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关启用互连组件的信息,请参见 enable 子命令的描述。

enable

启用作为命令操作数指定的互连组件。

仅在全局区域中使用此子命令。

操作数的语法确定是要启用电缆、交换机还是适配器。有关更多信息,请参阅此手册页的“操作数”部分。

在启用电缆时,该命令还会启用与电缆关联的每个端点(可能是适配器也可能是交换机端口)。

有关禁用互连组件的信息,请参见 disable 子命令的描述。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

export

导出群集互连的配置信息。

仅在全局区域中使用此子命令。

如果使用 –o 选项提供一个文件名,则会将配置信息写入该新文件。如果未使用 –o 选项,则会将输出写入标准输出。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

remove

删除作为命令操作数指定的群集互连组件。

仅在全局区域中使用此子命令。

操作数的语法确定是要删除电缆、交换机还是适配器。有关更多信息,请参阅此手册页的“操作数”部分。

在删除电缆时以下行为适用:

  • 必须首先禁用电缆,然后才可以删除电缆。

  • 如果尝试删除处于启用状态的电缆,删除操作会导致错误。

  • 如果删除已禁用的电缆,则还会删除电缆的端点,以下情况除外:

    • 交换机正被其他电缆使用。

    • 您同时指定了 –l 选项。

在删除适配器或交换机端点时以下行为适用:

  • 如果删除未与电缆关联的端点,则会删除指定的端点。

  • 如果尝试删除与电缆关联的端点,删除操作会导致错误。无论电缆处于启用还是禁用状态,都是如此。

超级用户以外的用户需要具有 solaris.cluster.modify RBAC 授权才能使用该子命令。

有关添加互连组件的信息,请参见 add 子命令的描述。

show

显示作为命令操作数指定的互连组件的配置。

您可以在全局区域或区域群集中使用该子命令。

配置信息包括组件是处于启用还是禁用状态。默认情况下,会显示所有互连组件的配置。

show 子命令接受加号 (+) 作为操作数来指定所有组件。可以使用 –Z 选项查看您指定的独占 IP 区域群集的专用网络配置信息。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

status

显示互连路径的状态。默认情况下,报告会显示系统中所有互连路径的状态。可以使用 –Z 选项显示您指定的独占 IP 区域群集的专用网络配置信息的状态。

您可以在全局区域或独占 IP 区域群集中使用该子命令。

下面是互连路径的可能状况。

faulted

互连路径遇到阻止其正常工作的错误。

Path online

互连路径处于联机状态且正在提供服务。

waiting

互连路径正在向 Path online 状态过渡。

要确定互连组件是处于启用还是禁用状态,请使用 show 子命令。

超级用户以外的用户需要具有 solaris.cluster.read RBAC 授权才能使用该子命令。

选项

支持以下选项:

–?
–-help

显示帮助信息。使用该选项时,不会执行任何其他处理。

该选项可以单独使用,也可以和子命令结合使用。

  • 如果单独指定此选项,将会显示可用子命令的列表。

  • 如果使用子命令且指定此选项,将会显示该子命令的用法选项。

–d

指定在禁用状态下添加端点。

–i {- | clconfigfile}
–-input={- | clconfigfile–}
–-input {- | clconfigfile–}

指定用来添加或修改电缆的配置信息。此信息必须符合 clconfiguration(5CL) 手册页中定义的格式。此信息可包含在文件中或者通过标准输入提供。要指定标准输入,请提供减号 (-) 而不是文件名。

您在命令中指定的选项将覆盖群集配置文件中设置的任何选项。如果群集配置文件中缺少必需元素,则必须在命令行上指定这些元素。

可以随此选项使用减号 (-) 参数,以指定配置将作为标准输入提供。

–l
–-limited

指定电缆删除操作仅删除电缆而不删除其任何端点。

–l 选项仅与 remove 子命令一起使用时才有效。如果没有为 remove 子命令指定此选项,该命令将删除指定的电缆以及任何关联的适配器。此外,如果电缆删除操作删除与交换机的最后一个连接,该命令还会从配置中删除交换机。

–n node[,…]
–-node=node[,…]
–-node node[,…]

指定一个节点或一系列节点。使用此选项可将操作限制到连接到指定节点的适配器和电缆。

您可以通过节点名称或节点 ID 来指定一个节点。

–o {- | clconfigfile}
–-output={- | clconfigfile}
–-output {- | clconfigfile}

clconfiguration(5CL) 手册页所描述的格式显示互连配置。

只有 export 子命令接受 –o 选项。

如果将文件名作为参数提供给该选项,此命令将创建新的文件,配置会显示在该文件中。如果已经存在同名的文件,此命令将退出,并显示一个错误。不会对现有文件进行任何更改。

如果将减号 (-) 作为参数提供给该选项,命令会将配置信息显示到标准输出。命令的所有其他标准输出将受到抑制。

–V
–-version

显示该命令的版本。

指定此选项时,不要将其与子命令、操作数或其他选项结合使用。子命令、操作数或其他选项将被忽略。–V 选项只显示命令的版本。不会执行任何其他操作。

–v
–-verbose

将详细消息显示到标准输出。默认情况下,showstatus 命令显示详细输出。

可以将此选项与命令的任何格式一起使用。

–Z {zoneclustername}
–-zoneclustername={zoneclustername }
–-zoneclustername { zoneclustername}

指定您要执行操作的群集。

showstatus 子命令支持此选项。

如果指定此选项,还必须指定以下列表中的参数之一:

zoneclustername

指定使用此选项的命令仅对名为 zoneclustername 的区域群集起作用。

global

指定使用此选项的命令仅对全局群集起作用。

操作数

此命令接受互连端点或以逗号分隔的端点对作为操作数。端点可以是适配器或交换机。以逗号分隔的端点对表示电缆。

对于接受多个互连组件的命令格式,可以使用加号 (+) 参数指定所有可能的组件。

支持以下操作数:

node:adapter

指定适配器端点。

适配器端点具有一个节点名称和一个适配器名称。适配器名称由互连名称及紧跟其后的物理单元编号构成,例如 net0。承载适配器的节点不需要在群集中处于活动状态,这些操作也可成功执行。

以下类型的适配器可配置为群集传输适配器:

Ethernet

可以将 Ethernet 适配器连接到另一 Ethernet 适配器或 Ethernet 交换机。

InfiniBand

只能将 InfiniBand 适配器连接到 InfiniBand 交换机。

默认情况下,适配器被配置为使用 dlpi 传输类型。

要指定标记 VLAN 适配器,请使用通过物理设备名称和 VLAN 实例号得出的标记 VLAN 适配器名称。VLAN 实例号等于 VLAN ID 与 1000 相乘再加上原始物理单元号。例如,物理设备 net2 上的 VLAN ID 11 转化为带标记的 VLAN 适配器名称 net11002

switch[@port]

指定交换机端点。

每个互连交换机名称在群集的名称空间内必须唯一。可以使用字母、数字或字母数字组合。交换机名称的第一个字符必须是字母。

如果没有为交换机端点提供 port 组件,该命令会使用默认端口名称。默认端口名称等于电缆另一端所连接节点的节点 ID。

可以将以下类型的交换机配置为群集传输交换机:

Ethernet

使用 Ethernet 交换机与 Ethernet 适配器。

InfiniBand

使用 InfiniBand 交换机与 InfiniBand 适配器。

默认情况下,交换机被配置为使用 switch 类型。

node:adapter, node:adapter
node:adapter,switch [@port]

指定电缆。

电缆是以逗号分隔的适配器或交换机端点对。端点的顺序无关紧要。使用电缆操作数添加完整的群集互连。因为在添加电缆时 clinterconnect 命令会自动创建两个端点,所以无需分别创建适配器或交换机端点。

退出状态

Intro(1CL) 手册页列出了该命令集中所有命令的一整套退出状态代码。

如果命令对于所有指定的操作数均成功执行,则返回零 (CL_NOERR)。如果某个操作数出错,命令会继续处理操作数列表中的下一个操作数。返回的退出代码始终反映最先发生的错误。

此命令返回下列退出状态代码:

0 CL_NOERR

没有错误

1 CL_ENOMEM

交换空间不足

3 CL_EINVAL

参数无效

6 CL_EACCESS

权限被拒绝

35 CL_EIO

I/O 错误

36 CL_ENOENT

没有这样的对象

37CL_EOP

不允许操作

38 CL_EBUSY

对象忙

39 CL_EEXIST

对象已存在

示例

示例 1 创建直连群集互连电缆

以下示例显示了如何添加电缆连接节点 phys-schost-1 上的适配器 net0 与节点 phys-schost-2 上的适配器 net0 之间的端口。

# clinterconnect add phys-schost-1:net0,phys-schost-2:net0
示例 2 创建交换机和适配器之间的电缆

以下示例显示了如何在节点 phys-schost-1 上的适配器 net0 和交换机 ether_switch 之间添加电缆。

# clinterconnect add phys-schost-1:net0,ether_switch
示例 3 禁用电缆

以下示例显示了如何禁用节点 phys-schost-1 上的适配器 net0 和交换机 ether_switch 之间连接的电缆。

# clinterconnect disable phys-schost-1:net0,ether_switch
示例 4 删除群集互连电缆

以下示例显示了如何删除节点 phys-schost-1 上的适配器 net0 和交换机 ether_switch 之间连接的电缆。

# clinterconnect remove phys-schost-1:net0,ether_switch
示例 5 创建标记 VLAN 适配器和交换机之间的电缆

以下示例显示了如何在节点 phys-schost-1 上的标记 VLAN 适配器 net73002 和支持 VLAN 的交换机 switch1 之间添加电缆。适配器的物理名称是 net2,VLAN ID 是 73

# clinterconnect add phys-schost-1:net73002,switch1
示例 6 启用交换机

以下示例显示了如何启用交换机端点 switch1

# clinterconnect enable switch1

属性

有关以下属性的描述,请参见 attributes(5)

属性类型
属性值
可用性
ha-cluster/system/core
接口稳定性
Evolving(发展中)

另请参见

Intro(1CL)cluster(1CL)clconfiguration(5CL)rbac(5)

Oracle Solaris Cluster 4.2 Hardware Administration Manual

Oracle Solaris Cluster 软件安装指南

附注

超级用户可以运行此命令的所有格式。

任何用户都可以运行带有以下选项的此命令。

  • –?(帮助)选项

  • –V(版本)选项

要运行带有其他子命令的此命令,超级用户以外的用户需要具有 RBAC 授权。请参见下表。

子命令
RBAC 授权
add
solaris.cluster.modify
disable
solaris.cluster.modify
enable
solaris.cluster.modify
export
solaris.cluster.read
remove
solaris.cluster.modify
show
solaris.cluster.read
status
solaris.cluster.read