Oracle® Solaris Cluster 参考手册

退出打印视图

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

SUNW.Event (5)

名称

SUNW.Event - 群集重新配置通知协议 (Cluster Reconfiguration Notification Protocol, CRNP) 的资源类型实现

描述

SUNW.Event 资源类型实现在 Oracle Solaris Cluster 中提供可用性高的 CRNP 服务。此实现通过将通知守护进程 (/usr/cluster/lib/sc/cl_apid) 作为资源在 Oracle Solaris Cluster 资源组管理器 (resource group manager, RGM) 中进行管理,使该守护进程具有高可用性。对于包含 SUNW.Event 资源的资源组,必须在该资源组中配置了网络资源。在一个群集中只能存在一个类型为 SUNW.Event 的资源。

只能在全局区域中运行 CRNP。

标准属性

此部分介绍用来控制实现行为的关键标准属性。可使用 clresource 命令为 SUNW.Event 资源设置这些属性。r_properties(5) 手册页更详细地介绍了这些资源属性。

Network_resources_used (string_array)

该资源依赖的逻辑主机名或共享地址网络资源的列表。该列表包含在属性 Resource_dependenciesResource_dependencies_weakResource_dependencies_restartResource_dependencies_offline_restart 中出现的所有网络地址资源。

该属性由 RGM 基于资源依赖性属性的设置自动更新。不能直接设置此属性。可使用 Resource_dependencies 属性替代。

类别

有条件的/可选

默认值

空列表

可调

禁用时

Port_list (string_array)

服务器侦听的端口号的逗号分隔列表。r_properties(5) 手册页更详细地介绍了 Port_list

类别

有条件的/必需

默认值

9444/tcp

可调

禁用时

Resource_dependencies (string array)

某个资源依赖的资源的列表。此列表包含该资源使用的所有逻辑主机名或共享地址网络资源。此属性的默认值为 null。如果应用程序需要绑定到一个或多个特定地址,则必须指定此属性。如果未指定网络资源依赖性,则应用程序将侦听所有地址。

创建事件资源之前,必须已经配置了 LogicalHostname SharedAddress 资源。

可以指定一个或多个资源名。每个网络资源可以包含一个或多个逻辑主机名。有关更多信息,请参见 clreslogicalhostname(1CL )clressharedaddress(1CL) 手册页。

可以使用 Resource_dependencies_weakResource_dependencies_restartResource_dependencies_offline_restart 属性而不是 Resource_dependencies 属性来指定其他依赖性类别。有关更多信息,请参见 r_properties(5) 手册页。

类别

可选

默认值

空列表

可调

随时

Retry_count (integer)

监视器在资源失败时尝试重新启动该资源的次数。r_properties(5) 手册页更详细地介绍了 Retry_count


注 -  如果为该属性指定一个负值,则监视器将尝试重新启动资源无限次。
类别

有条件的

默认值

2

最大值

10

可调

随时

Retry_interval (integer)

对失败资源的重新启动尝试进行计数时所基于的秒数。r_properties(5) 手册页更详细地介绍了 Retry_interval

类别

有条件的

默认值

300

最大值

3600

可调

随时

Thorough_probe_interval (integer)

对资源进行高开销故障探测的调用之间间隔的秒数。r_properties(5) 手册页更详细地介绍了 Thorough_probe_interval

类别

有条件的

默认值

60

最大值

3600

可调

随时

扩展属性

此部分介绍用于控制实现行为的关键扩展属性。

Allow_hosts (string_array)

该属性控制可以向实现注册以接收群集重新配置事件的客户机集。此属性的一般形式是 ipaddress/masklength,用于定义哪个子网中的客户机可以注册接收事件。例如,129.99.77.0/24 设置允许 129.99.77 子网中的客户机注册接收事件。另一个示例是, 192.9.84.231/32 仅允许客户机 192.9.84.231 注册接收事件。

此外,还能够识别以下特殊关键字:

  • LOCAL 表示位于与群集直接连接的子网中的所有客户机。

  • ALL 允许所有客户机注册。


    注 -  如果某个客户机既匹配 Allow_hosts 属性中的条目,也匹配 Deny_hosts 属性中的条目,将禁止该客户机向实现注册。
类别

可选

默认值

LOCAL

可调

随时

Client_retry_count (integer)

该属性控制实现在与外部客户机通信时的尝试次数。如果客户机未能在 Client_retry_count 次尝试后响应,该客户机将超时。该客户机随后将从有资格接收群集重新配置事件的已注册客户机列表中删除。要再次开始接收事件,该客户机必须重新注册。关于 Client_retry_interval 属性的部分说明了实现进行这些重试的频率。

类别

可选

默认值

3

最小值

1

可调

随时

Client_retry_interval (integer)

该属性定义实现在与无响应外部客户机通信时的重试时间间隔(秒)。在此间隔中,最多尝试联系客户机 Client_retry_count 次。

可以随时修改此属性的值。

类别

可选

默认值

1800

最小值

30

可调

随时

Client_timeout (integer)

该属性定义实现在与外部客户机通信时使用的超时值(秒)。但是,实现会继续尝试联系客户机若干次(次数可调)。关于 Client_retry_countClient_retry_interval 属性的部分介绍了调整此属性的方法。

类别

可选

默认值

60

最小值

30

可调

随时

Deny_hosts (string_array)

该属性控制被禁止注册接收群集重新配置事件的客户机集。确定访问权限时,此属性的设置优先于 Allow_hosts 列表中的设置。该属性的格式与 Allow_hosts 中定义的格式相同。

类别

可选

默认值

NULL

可调

随时

Max_clients (integer)

该属性控制可以向实现注册接收群集事件通知的最大客户机数。实现将会拒绝更多客户机的注册事件尝试。由于每个客户机注册会占用群集中的资源,因此通过调整此属性,用户可以控制外部客户机对群集中的资源用法。

类别

可选

默认值

1000

最小值

1

可调

禁用时

示例

示例 1 使用默认属性创建 SUNW.Event 资源

此示例说明如何在名为 events-rg 的现有资源组中创建一个名为 CRNPSUNW.Event 故障转移资源。events-rg 资源组包含用于标识与资源组关联的故障转移主机名的 LogicalHostnameSharedAddress 资源。

# clresourcetype register SUNW.Event
# clresource create -g events-rg -t SUNW.Event CRNP

在本例中,创建的 SUNW.Event 资源命名为 CRNP。该资源侦听端口 9444,并允许直接连接的子网中的所有客户机注册接收事件。

示例 2 使用非默认属性创建 SUNW.Event 资源

此示例说明如何在名为 events-rg 的资源组中创建名为 CRNPSUNW.Event 资源。CRNP 资源配置为侦听端口 7000 及特定网络资源 foo-1,该网络资源已经在 events-rg 资源组中配置。此 CRNP 资源允许 192.9.77.0 子网中的客户机以及直接连接的子网中的客户机注册,但是不允许 192.9.77.98 客户机使用实现。

# clresource create -g events-rg -t SUNW.Event \
-p Port_list=7000/tcp -p Network_resources_used=foo-1 \
-p Allow_hosts=LOCAL,192.9.77.0/24 \
-p Deny_hosts=192.9.77.98/32 CRNP

文件

/usr/cluster/lib/sc/cl_apid

CRNP 守护进程。

/usr/cluster/lib/sc/events/dtds

包含 CRNP 协议的数据类型定义的目录。

属性

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

属性类型
属性值
可用性
ha-cluster/system/core

另请参见

clresource(1CL)clresourcegroup(1CL)clresourcetype(1CL)scha_resource_get(1HA)attributes(5)r_properties(5)