geohb(1M)
引用名 | 概览 | 说明 | 子命令 | 选项 | 操作对象 | 详细说明 | 退出状态 | 示例 | 属性 | 另请参见
引用名
- geohb– 配置并管理心跳机制
概览
-
/usr/cluster/bin/geohb -?
/usr/cluster/bin/geohb -V
/usr/cluster/bin/geohb add-plugin pluginname heartbeatname-p property[-p...]
/usr/cluster/bin/geohb create heartbeatname -r clusterlist [-p property] [-p...]
/usr/cluster/bin/geohb delete heartbeatname
/usr/cluster/bin/geohb list heartbeatname ...
/usr/cluster/bin/geohb modify-plugin -p property [-p...] pluginname heartbeatname
/usr/cluster/bin/geohb remove-plugin pluginname heartbeatname
/usr/cluster/bin/geohb set-prop [-p property] [-p...] heartbeatname ...
说明
-
在参与伙伴关系的两个群集之间配置心跳。配置心跳包括了对相关联插件的配置。
-
创建或删除心跳属性。
-
添加、修改和删除与心跳属性相关联的插件。
-
获取心跳及其相关插件的当前配置。
-
基本 Solaris 用户。通过运行诸如 geopg list、geohb list 或 geops list 等命令，您可以读取有关 Sun Cluster Geographic Edition 实体的信息。
-
Geo 管理。您可以执行具基本 Solaris 用户访问权限的用户可执行的所有读取操作。您还可执行管理和配置任务，例如：geohb create、geopg switchover、geoadm start 和 geoadm stop。
geohb 命令可用于配置和管理心跳机制。
心跳是一种监视器，它位于两个群集（请求群集和响应群集）之间。创建伙伴关系后可建立两个心跳，每个方向一个。例如，主群集 cluster-paris 和辅助群集 cluster-newyork 之间的伙伴关系包含两个心跳。一个心跳将群集 cluster-paris 作为请求方，将群集 cluster-newyork 作为响应方；另一个心跳将群集 cluster-newyork 作为请求方，将群集 cluster-paris 作为响应方。
Sun Cluster Geographic Edition 软件提供了一个默认心跳机制，该机制基于 TCP/UDP 插件（作为主源）和 ping 插件（作为备用）。geohb 命令可用于配置和维护心跳。您可以执行以下任务：
在已为伙伴关系启用的群集上运行 geohb 命令。
要运行 geohb 命令配置并管理心跳机制，您必须拥有适当的基于角色的访问控制 (RBAC) 权限配置文件。
您如果具有超级用户访问权限，则有权执行任何操作。如果您不具有超级用户访问权限，则以下 RBAC 权限适用：
有关详细信息，请参阅 rbac(5) 手册页和《Sun Cluster Geographic Edition 系统管理指南》中的“Sun Cluster Geographic Edition 软件和 RBAC”。
该命令的一般格式如下所示：
geohb [subcommand] [options] [operands]
只有在 options 指定了选项 -?、-o、- V 或 -v 时，subcommand 才可以省略。
该命令的每个选项都有长短两种格式。每个选项的两种格式都会在此手册页的 OPTIONS 部分加以说明。
子命令
- add-plugin
-
将心跳与插件关联。如果指定一个自定义插件，您还必须使用 Query_cmd 属性指定自定义插件命令的路径。
- create
-
创建心跳。您可以通过运行 geoadm(1M) 命令来监视心跳状态。您必须配置远程群集以使心跳可以运行。
- delete
-
删除心跳。
- list
-
显示现有配置信息。
- modify-plugin
-
修改心跳插件属性。
- remove-plugin
-
删除心跳插件。
- set-prop
-
修改心跳属性。
可支持的子命令如下：
选项
-
-?
--help -
显示帮助信息。如果使用了该选项，系统不会执行其他处理。
指定该选项时，既可带有子命令也可不带子命令。
如果指定该选项时不带子命令，则显示该命令的所有子命令的列表。
如果带有子命令，则显示该子命令的使用选项。
一些 shell 可能会将问号理解为特殊字符。请使用引号 (-"?") 或者转义符以避免模式匹配。
-
-p property
--property property -
指定心跳或心跳插件的属性。
使用名称=语句对，来指定心跳属性值。可通过使用多个语句实现一次设置多个属性。
这些属性的值是在创建心跳时指定的，并且在心跳运行时可调整。
有关当前定义的属性的信息，请参阅 EXTENDED DESCRIPTION 部分。
-
-r clusterlist
--remote-cluster clusterlist -
指定本地群集要与之建立心跳监视的远程群集的名称。
-
-V
--version -
显示命令的版本信息。
请不要在指定该选项时带有子命令、操作对象或其他选项。因为子命令、操作对象或其他选项会被忽略。-V 选项仅显示命令的版本信息，系统不执行其他操作。
指令支持以下选项：
操作对象
- heartbeatname
-
指定本地群集上的心跳属性标识符。如果您正在尝试创建新的心跳，且指定的标识符已存在，则 geohb create 命令将失败。
- pluginname
-
指定心跳插件的名称。
以下操作对象是受支持的：
详细说明
- Query_interval
-
指定心跳状态请求之间的延迟时间（以秒为单位）。如果经过三个 Query_interval 时间间隔后仍无响应，插件将进入紧急模式。如果再经过一个 Query_interval 时间间隔后仍无响应，插件将超时并进入错误模式。
可选属性。
类型：整数。
调整建议：该属性的值是在创建心跳时指定的，并且可在心跳运行时调整。
默认值：120 秒。
- Plugin_properties
-
指定特定于该插件的属性字符串。
可选属性。
类型：字符串。
调整建议：该属性的值是在心跳创建时指定的，并且可在心跳运行时调整。
默认值：无，但使用默认心跳插件（tcp_udp_plugin 和 ping-plugin）的心跳除外。
对于 tcp_udp_plugin 插件，该字符串的格式已预先定义为 remote_IP_address/UDP/2084[[/ipsec]], remote_IP_address/TCP/2084[[/ipsec]]。remote_IP_address 参数指定了伙伴群集的 IP 地址。可选的 /ipsec 字符串表明插件使用 IPsec。
对于 ping-plugin，该字符串的格式已预先定义为 remote_IP_address，其中 remote_IP_address 指定了伙伴群集的 IP 地址。
- Query_cmd
-
指定心跳状态请求命令的路径。
如果插件没有指定预定义的插件，该属性为必需属性。
类型：字符串。
调整建议：该属性的值是在创建心跳时指定的，并且可在心跳运行时调整。
默认值：无。
- Requester_agent
-
指定请求程序代理的绝对路径。
可选属性。
类型：字符串。
调整建议：除非为了测试目的，否则不应调整默认插件的该属性值。
默认值：无。
- Responder_agent
-
指定响应程序代理的绝对路径。
可选属性。
类型：字符串。
调整建议：除非为了测试目的，否则不应调整默认插件的该属性值。
默认值：无。
- Type
-
指定插件的类型。设置为 Primary 或 Backup。
必需属性。
类型：枚举。
调整建议：该属性的值是在创建心跳时指定的，并且可在心跳运行时调整。
默认值：无，但默认心跳名称为 ping_plugin 的心跳除外。这种情况下，默认值为Backup（备份）。
以下部分列出了心跳和心跳插件属性。
心跳属性
您可以指定以下心跳属性：
心跳插件属性
心跳插件属性决定心跳如何工作。
退出状态
示例
实例 1 创建心跳
以下 geohb 命令创建了一个名为 paris-to-newyork 的心跳，用于在本地群集和群集 cluster-newyork 之间通信。
# geohb create paris-to-newyork -r cluster-newyork |
实例 2 创建心跳插件
以下 geohb 命令为心跳 paris-to-newyork 创建了一个名为 command1 的心跳插件。
# geohb add-plugin command1 paris-to-newyork -p Query_cmd=/usr/bin/hb/ |
实例 3 修改心跳
以下 geohb 命令修改了 cluster-paris 和 cluster-newyork 之间的默认心跳的属性。
# geohb set-prop -p Query_interval=60 hb_cluster-paris~cluster-newyork |
实例 4 修改心跳插件
以下 geohb 命令修改了默认 TCP/UDP 插件 tcp_udp_plugin 的属性，从而只使用 TCP。
# geohb modify-plugin -p Plugin_properties=paris-cluster/TCP/2084 \ tcp_udp_plugin hb_cluster-paris~cluster-newyork |
实例 5 从心跳中删除插件
以下 geohb 命令从名为 paris-to-newyork 的心跳中删除名为 command1 的插件。
# geohb remove-plugin command1 paris-to-newyork |
属性
有关下列属性的说明，请参见 attributes(5)。
|
属性类型 |
属性值 |
|---|---|
|
体系结构 |
SPARC |
|
可用性 |
SUNWscgctl |
|
接口稳定性 |
Evolving |
另请参见
Sun Cluster Geographic Edition 3.1 8/05 最后修订 2005 年 8 月 29 日引用名 | 概览 | 说明 | 子命令 | 选项 | 操作对象 | 详细说明 | 退出状态 | 示例 | 属性 | 另请参见
- © 2010, Oracle Corporation and/or its affiliates