Oracle Solaris Cluster 参考手册

退出打印视图

更新时间: 2015 年 9 月
 
 

ORCL.gds_proxy (5)

名称

ORCL.gds_proxy, gds_proxy - 反映其他群集框架中资源的状态或者同一或其他群集内应用程序状态的代理资源类型

描述

通用数据服务 (Generic Data Service, GDS) 版本 2 这一机制允许您代理其他群集框架(例如,Oracle Grid Infrastructure)中应用程序或资源的状态。您还可以代理同一个或其他群集内应用程序的状态。

GDSv2 包含一个全功能的 Oracle Solaris Cluster 资源类型,通过回调方法 (rt_callbacks(1HA)) 和资源类型注册 (Resource Type Registration, RTR) 文件 (rt_reg(4)) 完成。

标准属性

Boot_timeout (integer)

指定 boot 命令的超时值(秒)。

类别

可选

最小值

60 秒

默认值

300 秒

可调

随时

Failover_mode (enum)

修改资源无法成功启动或停止并进而请求重新启动或故障转移时 RGM 执行的恢复操作。

有关 failover_mode 属性的更多信息,请参见 r_properties(5) 手册页。

类别

可选

默认值

SOFT

可调

随时

Fini_timeout (integer)

指定 fini 命令的超时值(秒)。

类别

可选

最小值

60 秒

默认值

300 秒

可调

随时

Init_timeout (integer)

指定 init 命令的超时值(秒)。

类别

可选

最小值

60 秒

默认值

300 秒

可调

随时

Postnet_stop_timeout (integer)

指定 postnet_stop 命令的超时值(秒)。

类别

可选

最小值

60 秒

默认值

300 秒

可调

随时

Prenet_start_timeout (integer)

指定 prenet_start 命令的超时值(秒)。

类别

可选

最小值

60 秒

默认值

300 秒

可调

随时

Scalable (boolean)

指示资源是否可伸缩,即,资源是否使用 Oracle Solaris Cluster 软件的网络负载平衡功能。

如果 scalable 属性设置为 TRUE,将使用其他属性(例如 load_balancing_policyload_balancing_weights)来配置负载平衡行为。

有关 scalableload_balancing_policyload_balancing_weights 属性的更多信息,请参见 r_properties(5) 手册页。

类别

可选

默认值

FALSE

可调

创建时

Validate_timeout (integer)

指定 validate 命令的超时值(秒)。

类别

可选

最小值

60 秒

默认值

300 秒

可调

随时

扩展属性

Boot_command (string)

指定当节点或区域引导或重新引导时运行的命令。该命令必须是可以直接传递给 Shell 的完整命令行。该命令通常执行与 init_command 相同的初始化。您必须确保该命令是幂等的-即使该命令在上一次执行中已初始化了资源,对该命令的后续调用也必须成功退出。

类别

可选

默认值

Null

可调

禁用时

Child_mon_level (integer)

提供对通过进程监视工具 (Process Monitor Facility, PMF) 监视的进程的控制。该属性表示分支子进程受监视的级别。省略此属性或将该属性设置为默认值与省略 pmfadm(1M)–C 选项的结果相同:监视所有子进程(及其后代)。

类别

可选

默认值

-1

可调

创建时

Debug_gds (boolean)

Debug_gds 通常由 Oracle Solaris Cluster 部署和支持使用。不过,它对于了解在 GDSv2 内发生的各种调用和序列可能非常有用。

如果设置了 debug_gds=FALSE,则不会将 GDSv2 内部调试消息发送到系统日志。

如果设置了 debug_gds=TRUE,则会将所有 GDSv2 内部调试消息发送到系统日志。

类别

可选

默认值

TRUE

可调

禁用时

Debug_level (string)

指定用于设置跟踪和调试消息的命令。提高 debug_level 允许将更多的消息写入到系统日志中。您可以通过为一个节点设置 debug_level 或者为每个节点设置不同的值,将其设置为一个每节点扩展属性。

类别

可选

每节点

True

数据类型

整数

最小值

0

最大值

3

默认值

0

可调

随时

Fini_command (string)

指定当资源不再由 RGM 管理时运行的命令。该命令必须是可以直接传递给 Shell 的完整命令行。该命令通常执行一些清理工作或者撤消由 init_command 执行的任何初始化。发生以下情况时,此命令在资源变得不受管理的节点或区域上运行:

  • 包含资源的资源组切换为不受管理状态。在这种情况下,RGM 执行 GDSv2 fini 方法,该方法在节点列表中的所有节点和区域上执行 fini_command

  • 资源被从受管理资源组中删除。在这种情况下,RGM 执行 GDSv2 fini 方法,该方法在节点列表中的所有节点和区域上执行 fini_command

  • 节点或区域被从包含资源的资源组的节点列表中删除。在这种情况下,RGM 执行 GDSv2 fini 方法,该方法在节点列表中的所有节点和区域上执行 fini_command

类别

可选

默认值

Null

可调

禁用时

Init_command (string)

指定因为发生下列情况之一而导致资源变得受 RGM 管理时运行的命令。该命令必须是可以直接传递给 Shell 的完整命令行。

  • 资源所在的资源组从不受管理状态切换为受管理状态。

  • 在已受管理的资源组中创建了资源。

类别

可选

默认值

Null

可调

禁用时

Interpose_logical_hostname (string)

指定每当执行系统调用来检索主机名时要插入的逻辑主机名。只要执行了以下操作,就会插入逻辑主机名:

  • clreslogicalhostname(1CL) 命令为逻辑主机名创建了一个资源。

  • 如果逻辑主机与您的资源位于不同的资源组中,则您的资源对逻辑主机资源具有依赖关系。

  • /usr/lib/secure/libschost.so.1 必须以符号链接方式链接到 /usr/cluster/lib/libschost.so.1

  • /usr/lib/secure/64/libschost.so.1 必须以符号链接方式链接到 /usr/cluster/lib/[amd64|sparcv9]/libschost.so.1

类别

可选

每节点

TRUE

默认值

Null

可调

禁用时

Postnet_stop_command (string)

指定用于停止 prenet_start_command 代理守护进程的命令。该命令必须是完整的命令行,以便可以直接传递给 Shell 来启动代理守护进程。

如果省略了 postnet_stop_command,则会向在 PMF 标记下运行的代理守护进程发送 stop_signal 扩展属性值。

类别

可选

默认值

Null

可调

禁用时

Prenet_start_command (string)

指定用于启动代理守护进程的命令。该命令必须是完整的命令行,以便可以直接传递给 Shell 来启动代理守护进程。

prenet_start_command(或其分支子进程之一)应该是长期运行的守护进程。prenet_start_command 进程树由 PMF 监视,如 child_mon_level 扩展属性部分中所述。

类别

必需

最小值

1

默认值

无默认值

可调

禁用时

Proxy_interval (integer)

指定资源的 prenet_start_command 代理守护进程两次调用之间的秒数。此扩展属性可以由 prenet_start_command 代理守护进程使用。

类别

可选

最小值

2 秒

默认值

30 秒

可调

随时

Stop_signal (integer)

指定当应用程序无法使用 postnet_stop_command 停止时用于停止应用程序的信号。该属性的值与 signal(3HEAD) 手册页中定义的那些值相同。

类别

可选

最小值

1

最大值

37

默认值

15

可调

禁用时

Validate_command (string)

指定用于验证应用程序的命令的绝对路径。如果未提供绝对路径,则不会验证应用程序。

validate 命令的退出状态用于确定是否应当允许创建或更新 GDSv2 资源。在创建或更新资源之前,指定的 validate 命令将在该资源所属资源组的节点列表中的每个节点上执行。如果 validate 命令以非零状态退出,则不允许创建或更新请求的资源。validate 命令写入到 stdoutstderr 的任何输出将传递回发出管理命令以创建或更新该资源的用户。可根据这些输出解释资源验证失败的原因。

在执行 scha_control 命令的 GIVEOVER 选项来将资源组重定位到新节点之前也会执行 validate 命令。如果该命令以非零状态退出,则会阻止 GIVEOVER,该资源组在其当前节点上仍受管理。

类别

可选

默认值

Null

可调

禁用时

示例

配置演示应用程序

以下示例使用所提供的演示脚本来代理 Solaris 服务管理工具 (Service Management Facility, SMF) 系统日志的状态。有关 GDSv2 演示应用程序的更多信息,请参见Oracle Solaris Cluster Generic Data Service (GDS) Guide

# clresourcegroup create -p pathprefix=/opt/ORCLscgds/demo -S mysrg
# clresource create -g mysrg -t ORCL.gds_proxy \
# -p Prenet_start_command="%RG_PATHPREFIX/demo_proxy_prenet_start -R %RS_NAME -G %RG_NAME -T %RT_NAME" \
# -p Postnet_stop_command="%RG_PATHPREFIX/demo_proxy_postnet_stop -R %RS_NAME -G %RG_NAME -T %RT_NAME" \
# -p Validate_command="%RG_PATHPREFIX/demo_validate -R %RS_NAME -G %RG_NAME \
# -T %RT_NAME" -d mysrs
# clresourcegroup online -eM mysrg
# clresource status mysrs

属性

有关下列属性的说明,请参见 attributes(5)

属性类型
属性值
可用性
ha-cluster/ha-service/gds2

另请参见

ORCL.gds(5)clreslogicalhostname(1CL )clresource(1CL)clresourcegroup(1CL)clresourcetype(1CL)clressharedaddress(1CL)rt_callbacks(1HA)scdsbuilder(1HA)scha_control(1HA)scha_resource_get(1HA)hatimerun(1M)pmfadm(1M)signal(3HEAD)rt_reg(4)attributes(5)r_properties(5)scalable_service(5)