用于 Oracle 的 Sun Cluster 数据服务指南(适用于 Solaris OS)

定制操作文件格式

定制操作文件是纯文本文件。 该文件包含用于定义 Sun Cluster HA for Oracle 服务器故障监视器的定制性能的一个或多个项。 每个项为一个 DBMS 错误、一个超时错误或几个日志警报定义定制性能。 在定制操作文件中最多允许有 1024 个项。


注意:

定制操作文件中的每个项可以覆盖用于错误的预设操作,也可以为没有预设操作的错误指定一个操作。 在定制操作文件中创建项适用于以下情况:要覆盖预设操作或错误没有预设操作。 对于未更改的操作,请为其创建项。


定制操作文件中的项由一系列用分号隔开的关键字值对组成。 每个项用花括号括住。

定制操作文件中项的格式如下:

{
[ERROR_TYPE=DBMS_ERROR|SCAN_LOG|TIMEOUT_ERROR;]
ERROR=error-spec; 
[ACTION=SWITCH|RESTART|STOP|NONE;]
[CONNECTION_STATE=co|di|on|*;]
[NEW_STATE=co|di|on|*;]
[MESSAGE="message-string"]
}

在分隔的关键字值对之间和项之间可能会使用空格,以设置文件的格式。

定制操作文件中关键字的含义和允许的值如下:

ERROR_TYPE

表示服务器故障监视器已检测到的错误的类型。 此关键字的允许值包括:

DBMS_ERROR

指定错误是 DBMS 错误。

SCAN_LOG

指定错误是记录在警报日志文件中的警报。

TIMEOUT_ERROR

指定错误是超时。

ERROR_TYPE 关键字是可选的。 如果忽略此关键字,错误将被假定为 DBMS 错误。

ERROR

标识错误。 error-spec 的数据类型和含义由 ERROR_TYPE 关键字的值确定,如下表所示。

ERROR_TYPE

数据类型 

含义 

DBMS_ERROR

整数 

由 Oracle 生成的 DBMS 错误的错误编号 

SCAN_LOG

被引用的正规表达式 

Oracle 已记录到 Oracle 警报日志文件中的错误消息中的字符串 

TIMEOUT_ERROR

整数 

自上次启动或重新启动服务器故障监视器以来,连续超时探测的次数 

您必须指定 ERROR 关键字。 如果忽略此关键字,定制操作文件中的项将被忽略。

ACTION

指定服务器故障监视器响应错误要执行的操作。 此关键字的允许值包括:

NONE

指定服务器故障监视器忽略错误。

STOP

指定服务器故障监视器停止。

RESTART

指定服务器故障监视器停止,并重新启动由 SUNW.oracle_server 资源的 Restart_type 扩展特性的值指定的实体。

SWITCH

指定服务器故障监视器将数据库服务器资源组切换到另一个节点。

ACTION 关键字是可选的。 如果忽略此关键字,服务器故障监视器将忽略错误。

CONNECTION_STATE

指定在检测到错误时数据库和服务器故障监视器之间的连接所需的状态。 仅当检测到错误时连接处于所需的状态,才应用此项。 此关键字的允许值包括:

*

指定始终应用此项,无论连接的状态如何。

co

指定仅当服务器故障监视器尝试连接到数据库时才应用此项。

on

指定仅当服务器故障监视器处于联机状态时才应用此项。 如果服务器故障监视器连接到数据库,它就处于联机状态。

di

指定仅当服务器故障监视器与数据库断开连接时才应用此项。

CONNECTION_STATE 关键字是可选的。 如果忽略此关键字,将始终应用此项,无论连接的状态如何。

NEW_STATE

指定在检测到错误后服务器故障监视器必须获得的数据库与服务器故障监视器的连接的状态。 此关键字的允许值包括:

*

指定连接的状态必须保留不变。

co

指定服务器故障监视器必须从数据库断开连接,并立即重新连接到数据库。

di

指定服务器故障监视器必须从数据库断开连接。 服务器故障监视器下次探测数据库时将重新连接到数据库。

NEW_STATE 关键字是可选的。 如果忽略此关键字,在检测到错误后,数据库连接的状态将保持不变。

MESSAGE

指定在检测到此错误时,资源的日志文件中显示的附加消息。 消息必须用双引号括住。 对于为错误定义的标准消息来说,此消息是附加的。

MESSAGE 关键字是可选的。 如果忽略此关键字,在检测到此错误时,资源的日志文件中不会显示附加消息。