Personalización del supervisor de errores de Servidor Oracle 9i RAC

Personalizar el supervisor de errores de Servidor Oracle 9i RAC permite modificar el comportamiento del supervisor de errores del servidor del modo siguiente:

• Anular la acción preestablecida debida a un error

• Especificar una acción para un error para el que no hay ninguna acción preestablecida

---

Precaución - Antes de personalizar el supervisor de errores de Servidor Oracle 9i RAC, tenga en cuenta los posibles efectos de la personalización, en especial si cambia una acción de reiniciar o conmutar a omitir o detener la supervisión. Si los errores siguen sin corregirse durante un periodo prolongado, podrían ocasionar problemas a la base de datos. Si tiene problemas con la base de datos tras personalizar el supervisor de errores de Servidor Oracle 9i RAC, vuelva a utilizar las acciones preestablecidas. Volver a utilizar las acciones preestablecidas permite determinar si las personalizaciones realizadas son la causa del problema.

---

La personalización del supervisor de errores de Servidor Oracle 9i RAC implica las acciones siguientes:

1. Defining custom behavior for errors

2. Propagating a custom action file to all nodes in a cluster

3. Specifying the custom action file that a server fault monitor should use

Definición del comportamiento personalizado de los errores

El supervisor de errores de Servidor Oracle 9i RAC detecta los siguientes tipos de errores:

• Los errores de DBMS habidos durante un sondeo de la base de datos hecho con el supervisor de errores del servidor.

• Las alertas que Oracle registra en el archivo de registro de alertas.

• Finalización de tiempos de espera por un error al recibir una respuesta en el tiempo establecido por la propiedad de extensión Probe_timeout.

Para definir el comportamiento personalizado de estos tipos de errores, cree un archivo de acción personalizada. Esta sección contiene la siguiente información sobre los archivos de acción personalizadas:

• Formato de archivo de acción personalizada

• Cambio de la respuesta a un error de DBMS

• Cambio de la respuesta a las alertas registradas

• Cambio del número máximo de sondeos consecutivos con tiempo de espera finalizado

Formato de archivo de acción personalizada

Un archivo de acción personalizada es un archivo de texto sin formato. El archivo contiene una o más entradas que definen el comportamiento personalizado del supervisor de errores de Servidor Oracle 9i RAC. Cada entrada define el comportamiento personalizado de un solo error de DBMS, un solo error de tiempo de espera o varias alertas registradas. En un archivo de acción personalizada se permiten un máximo de 1.024 entradas.

Una entrada de un archivo de acción personalizada se compone de una secuencia de pares de palabra clave y valor separados por puntos y coma. Cada entrada está incluida entre corchetes.

El formato de una entrada en un archivo de acción personalizada es el siguiente:

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

Puede utilizarse un espacio en blanco entre los pares de palabra clave y valor separados y entre las entradas para dar formato al archivo.

El significado y los valores permitidos de las palabras clave de un archivo de acción personalizada son:

ERROR_TYPE

Indica el tipo de error que ha detectado el supervisor de errores del servidor. Se permiten los siguientes valores para esta palabra clave:

DBMS_ERROR

Indica que el error es un error de DBMS.

SCAN_LOG

Especifica que el error es una alerta que se registra en el archivo de registro de alertas.

TIMEOUT_ERROR

Indica que el error es un tiempo de espera.

La palabra clave ERROR_TYPE es opcional. Si la omite, se da por sentado que el error es un error de DBMS.

ERROR

Identifica el error. El tipo de datos y el significado de error-spec los establece el valor de la palabra clave ERROR_TYPE, como se muestra en la tabla siguiente.

ERROR_TYPE Tipo de datos Significado DBMS_ERROR Entero Número de error de DBMS que genera Oracle SCAN_LOG Expresión regular citada Cadena de un mensaje de error que ha registrado Oracle en el archivo de registro de alertas de Oracle TIMEOUT_ERROR Entero Número de sondeos de tiempo de espera finalizado consecutivos desde que el supervisor de errores del servidor se inició o se reinició por última vez

Debe especificar la palabra clave ERROR. Si omite esta palabra clave, se omite la entrada en el archivo de acción personalizada.

ACTION

Especifica la acción que debe realizar el supervisor de errores del servidor como respuesta al error. Se permiten los siguientes valores para esta palabra clave:

NONE

Indica que el supervisor de errores del servidor omite el error.

STOP

Especifica que el supervisor de errores del servidor se detiene.

RESTART

Especifica que el supervisor de errores del servidor detiene y reinicia el recurso de servidor Oracle 9i RAC.

La palabra clave ACTION es opcional. Si omite esta palabra clave, el supervisor de errores del servidor omite el error.

CONNECTION_STATE

Especifica el estado necesario de la conexión entre la base de datos y el supervisor de errores del servidor cuando se detecta el error. La entrada sólo se aplica si la conexión se encuentra en el estado requerido cuando se detecta el error. Se permiten los siguientes valores para esta palabra clave:

*

Indica que la entrada siempre se aplica, sea cual sea el estado de la conexión.

co

Especifica que la entrada se aplica únicamente si el supervisor de errores del servidor intenta conectarse a la base de datos.

on

Especifica que la entrada sólo se aplica si el supervisor de errores del servidor está en línea. El supervisor de errores del servidor está en línea si está conectado a la base de datos.

di

Especifica que la entrada sólo se aplica si el supervisor de errores del servidor se desconecta de la base de datos.

La palabra clave CONNECTION_STATE es opcional. Si omite esta palabra clave, la entrada siempre se aplica, sea cual sea el estado de la conexión.

NEW_STATE

Especifica el estado de la conexión entre la base de datos y el supervisor de errores del servidor que debe alcanzar el supervisor tras detectarse el error. Se permiten los siguientes valores para esta palabra clave:

*

Especifica que el estado de la conexión permanezca sin modificar.

co

Especifica que el supervisor de errores del servidor debe desconectarse de la base de datos y volver a conectarse de inmediato a la base de datos.

di

Especifica que el supervisor de errores del servidor debe desconectarse de la base de datos. El supervisor de errores del servidor se vuelve a conectar la próxima vez que sondea la base de datos.

La palabra clave NEW_STATE es opcional. Si omite esta palabra clave, el estado de la conexión de la base de datos permanece sin cambios después de que se detecte el error.

MESSAGE

Especifica un mensaje adicional que se imprime en el archivo de registro del recurso cuando se detecta este error. El mensaje debe incluirse entre comillas dobles. Este mensaje es adicional al mensaje estándar definido para el error.

La palabra clave MESSAGE es opcional. Si omite esta palabra clave, no se imprimirá ningún mensaje adicional en el archivo de registro del recurso cuando se detecta este error.

Cambio de la respuesta a un error de DBMS

La acción que el supervisor de errores del servidor lleva a cabo como respuesta a cada error de DBMS está preestablecida en la Tabla B-1. Para determinar si necesita cambiar la respuesta a un error de DBMS, considere el efecto de los errores de DBMS en la base de datos para determinar si las acciones preestablecidas son apropiadas. Para ver ejemplos, consulte las subsecciones siguientes:

• Respuesta a un error con efectos importantes

• Omisión de un error con efectos poco importantes

Para cambiar la respuesta a un error de DBMS, cree una entrada en un archivo de acción personalizada en el que se establecen las siguientes palabras clave:

• ERROR_TYPE se configura como DBMS_ERROR.

• ERROR se configura con el número de error de DBMS.

• ACTION se configura con la acción que se necesita.

Respuesta a un error con efectos importantes

Si un error que omite el supervisor de errores del servidor afecta a más de una sesión, es posible que el supervisor tenga que realizar alguna acción para evitar una pérdida de datos.

Por ejemplo, no se ha preestablecido ninguna acción para el error de Oracle 4031: unable to allocate num-bytes bytes of shared memory. No obstante, este error de Oracle indica que el área global compartida (SGA) no tiene suficiente memoria, está fragmentado incorrectamente, o ambas cosas. Si este error sólo afecta a una sesión, podría resultar apropiado omitirlo. En cambio, si este error afecta a más de una sesión, considere la posibilidad de que el supervisor de errores del servidor reinicie la base de datos.

El siguiente ejemplo muestra una entrada en un archivo de acción personalizada para cambiar la respuesta a un error de DBMS por un reinicio.

Ejemplo 5-4 Cambio de la respuesta a un error de DBMS por un reinicio

{
ERROR_TYPE=DBMS_ERROR;
ERROR=4031; 
ACTION=restart;
CONNECTION_STATE=*; 
NEW_STATE=*;
MESSAGE="Insufficient memory in shared pool.";
}

Este ejemplo muestra una entrada de un archivo de acción personalizada que anula la acción preestablecida para el error de DBMS 4031. Esta entrada especifica el siguiente comportamiento:

• En respuesta al error de DBMS 4031, la acción que lleva a cabo el supervisor de errores del servidor es un reinicio.

• Esta entrada se aplica independientemente del estado de conexión entre la base de datos y el supervisor de errores del servidor cuando se detecta el error.

• El estado de conexión entre la base de datos y el supervisor de errores del servidor debe permanecer sin cambios tras detectarse el error.

• Cuando se detecta este error, se imprime el siguiente mensaje en el archivo de registro del recurso:

  Insufficient memory in shared pool.

Omisión de un error con efectos poco importantes

Si los efectos de un error al que responde el supervisor de errores del servidor son poco importantes, omitir el error puede causar menos interrupciones que responder al error.

Por ejemplo, la acción preestablecida para el error de Oracle 4030: out of process memory when trying to allocate num-bytes bytes es reiniciar. Este error de Oracle indica que el supervisor de errores del servidor no ha podido asignar memoria en montón privada. Una posible causa de este error es que no hay suficiente memoria disponible en el sistema operativo. Si el error afecta a más de una sesión, podría resultar adecuado reiniciar la base de datos. No obstante, es posible que este error no afecte a otras sesiones porque no requieren memoria privada adicional. En este caso, considere la posibilidad de especificar que el supervisor de errores del servidor omita el error.

El ejemplo siguiente muestra una entrada en un archivo de acción personalizada para omitir un error de DBMS.

Ejemplo 5-5 Omisión de un error de DBMS

{
ERROR_TYPE=DBMS_ERROR;
ERROR=4030;
ACTION=none;
CONNECTION_STATE=*;
NEW_STATE=*;
MESSAGE="";
}

Este ejemplo muestra una entrada de un archivo de acción personalizada que anula la acción preestablecida para el error de DBMS 4030. Esta entrada especifica el siguiente comportamiento:

• El supervisor de errores del servidor omite el error de DBMS 4030.

• Esta entrada se aplica independientemente del estado de conexión entre la base de datos y el supervisor de errores del servidor cuando se detecta el error.

• El estado de conexión entre la base de datos y el supervisor de errores del servidor debe permanecer sin cambios tras detectarse el error.

• No se imprime ningún mensaje adicional en el archivo de registro del recurso cuando se detecta este error.

Cambio de la respuesta a las alertas registradas

El software Oracle registra alertas en un archivo identificado por la propiedad de extensión alert_log_file. El supervisor de errores del servidor examina este archivo y efectúa las acciones de respuesta a las alertas para las que se ha definido una acción.

La Tabla B-2 enumera las alertas registradas para las que se ha preestablecido una acción. Cambie la respuesta a las alertas registradas para modificar la acción preestablecida o para definir nuevas alertas a las que responda el supervisor de errores del servidor.

Para cambiar la respuesta a las alertas registradas, cree una entrada en un archivo de acción personalizada en el que se establecen las siguientes palabras clave:

• ERROR_TYPE se configura como SCAN_LOG.

• ERROR se configura como una expresión regular citada que identifica una cadena en un mensaje de error que ha registrado Oracle en el archivo de registro de alertas de Oracle.

• ACTION se configura con la acción que se necesita.

El supervisor de errores del servidor procesa las entradas de un archivo de acción personalizada en el orden en que se producen las entradas. Sólo se procesa la primera entrada que coincide con una alerta registrada. El resto de las entradas que coinciden se omiten. Si utiliza expresiones regulares con el fin de especificar acciones para varias alertas registradas, compruebe que las entradas más específicas aparezcan antes que las entradas más generales. Las acciones específicas que tengan lugar después de las acciones generales podrían omitirse.

Por ejemplo, un archivo de acción personalizada puede definir acciones diferentes para los errores que se identifican mediante las expresiones regulares ORA-65 y ORA-6. Para asegurarse de que no se omita la entrada que contiene la expresión regular ORA-65, compruebe si la entrada aparece antes de la entrada que contenga la expresión regular ORA-6.

En el ejemplo siguiente, se muestra una entrada de un archivo de acción personalizada para cambiar la respuesta a una alerta registrada.

Ejemplo 5-6 Cambio de la respuesta a una alerta registrada

{
ERROR_TYPE=SCAN_LOG;
ERROR="ORA-00600: internal error";
ACTION=RESTART;
}

En este ejemplo, se muestra una entrada de un archivo de acción personalizada que anula la acción preestablecida para las alertas registradas sobre errores internos. Esta entrada especifica el siguiente comportamiento:

• Como respuesta a las alertas registradas que contienen el texto ORA-00600: internal error, se reinicia la acción que realiza el supervisor de errores del servidor.

• Esta entrada se aplica independientemente del estado de conexión entre la base de datos y el supervisor de errores del servidor cuando se detecta el error.

• El estado de conexión entre la base de datos y el supervisor de errores del servidor debe permanecer sin cambios tras detectarse el error.

• No se imprime ningún mensaje adicional en el archivo de registro del recurso cuando se detecta este error.

Cambio del número máximo de sondeos consecutivos con tiempo de espera finalizado

De forma predeterminada, el supervisor de errores del servidor reinicia la base de datos tras el segundo sondeo con tiempo de espera finalizado. Si la base de datos está poco cargada, dos sondeos de tiempo de espera consecutivos finalizados deberían bastar para indicar que la base de datos está bloqueada. Sin embargo, si la carga es elevada, un sondeo del supervisor de errores del servidor puede finalizar el tiempo de espera aunque la base de datos funcione correctamente. Para impedir que el supervisor de errores del servidor reinicie la base de datos de forma innecesaria, aumente el número máximo de sondeos consecutivos con tiempo de espera finalizado.

---

Precaución - Al aumentar el número máximo de sondeos consecutivos con tiempo de espera finalizado, se aumenta la cantidad de tiempo necesaria para detectar que la base de datos está bloqueada.

---

Para cambiar el número máximo permitido de sondeos consecutivos con tiempo de espera finalizado, cree una entrada en un archivo de acción personalizada para cada sondeo consecutivo con tiempo de espera finalizado permitido, excepto para el primer sondeo con tiempo de espera finalizado.

Para el último sondeo permitido con tiempo de espera finalizado, cree una entrada en que las palabras clave estén definidas como se indica a continuación:

• ERROR_TYPE se configura como TIMEOUT_ERROR.

• ERROR se configura en el número máximo de sondeos consecutivos con tiempo de espera finalizado permitidos.

• ACTION se configura como RESTART.

Para cada uno de los demás sondeos con tiempo de espera finalizado, excepto el primer sondeo con tiempo de espera finalizado, cree una entrada en que las palabras clave estén definidas como se indica a continuación:

• ERROR_TYPE se configura como TIMEOUT_ERROR.

• ERROR se configura en el número de secuencia del sondeo con tiempo de espera finalizado. Por ejemplo, para el segundo sondeo consecutivo con tiempo de espera finalizado, defínala en 2. Para el tercer sondeo consecutivo con tiempo de espera finalizado, defínala en 3.

• ACTION se configura como NONE.

En el ejemplo siguiente, se muestran las entradas de un archivo de acción personalizada para aumentar a cinco el número máximo de sondeos consecutivos con tiempo de espera finalizado.

Ejemplo 5-7 Cambio del número máximo de sondeos consecutivos con tiempo de espera finalizado

{
ERROR_TYPE=TIMEOUT;
ERROR=2;
ACTION=NONE;
CONNECTION_STATE=*;
NEW_STATE=*;
MESSAGE="Timeout #2 has occurred.";
}

{
ERROR_TYPE=TIMEOUT;
ERROR=3;
ACTION=NONE;
CONNECTION_STATE=*;
NEW_STATE=*;
MESSAGE="Timeout #3 has occurred.";
}

{
ERROR_TYPE=TIMEOUT;
ERROR=4;
ACTION=NONE;
CONNECTION_STATE=*;
NEW_STATE=*;
MESSAGE="Timeout #4 has occurred.";
}

{
ERROR_TYPE=TIMEOUT;
ERROR=5;
ACTION=RESTART;
CONNECTION_STATE=*;
NEW_STATE=*;
MESSAGE="Timeout #5 has occurred. Restarting.";
}

En este ejemplo, se muestran las entradas de un archivo de acción personalizada para aumentar a cinco el número máximo de sondeos consecutivos con tiempo de espera finalizado. Estas entradas especifican el comportamiento siguiente:

• El supervisor de errores del servidor omite el segundo sondeo consecutivo con tiempo de espera finalizado a través del cuarto sondeo consecutivo con tiempo de espera finalizado.

• Como respuesta al quinto sondeo consecutivo con tiempo de espera finalizado, se reinicia la acción que realiza el supervisor de errores del servidor.

• Las entradas se aplican sea cual sea el estado de la conexión entre la base de datos y el supervisor de errores del servidor al finalizar el tiempo de espera.

• El estado de conexión entre la base de datos y el supervisor de errores del servidor debe permanecer sin cambios tras finalizar el tiempo de espera.

• Cuando tiene lugar el segundo sondeo consecutivo con tiempo de espera finalizado a través del cuarto sondeo consecutivo con tiempo de espera finalizado, se escribe un mensaje con el formato siguiente en el archivo de registro del recurso:

  Timeout #number has occurred.

• Cuando se da el quinto sondeo consecutivo con tiempo de espera finalizado, se escribe el mensaje siguiente en el archivo de registro del recurso:

  Timeout #5 has occurred. Restarting.

Propagación de un archivo de acción personalizada a todos los nodos de un clúster

Un supervisor de errores del servidor debe comportarse de forma coherente en todos los nodos de un clúster. Por consiguiente, el archivo de acción personalizada que utiliza el supervisor de errores del servidor debe ser idéntico en todos los nodos del clúster. Después de crear o modificar un archivo de acción personalizada, compruebe que el archivo sea idéntico en todos los nodos del clúster propagando el archivo a todos los nodos de dicho clúster. Para propagar el archivo a todos los nodos del clúster, utilice el método que resulte más adecuado para la configuración del clúster:

• Localizar el archivo en un sistema de archivos que comparten todos los nodos.

• Localizar el archivo en un sistema de archivos local de alta disponibilidad.

• Copiar el archivo al sistema de archivos local de cada uno de los nodos del clúster mediante comandos del sistema operativo, por ejemplo los comandos rcp(1) o rdist(1).

Especificación del archivo de acción personalizada que debe utilizar un supervisor de errores del servidor

Para aplicar acciones personalizadas a un supervisor de errores del servidor, debe especificar el archivo de acción personalizada que debe utilizar el supervisor de errores. Las acciones personalizadas se aplican a un supervisor de errores del servidor cuando este último lee un archivo de acción personalizada. Un supervisor de errores del servidor lee un archivo de acción personalizada cuando se especifica.

Al especificar un archivo de acción personalizada, también se valida el archivo. Si el archivo contiene errores de sintaxis, aparece un mensaje de error. Por lo tanto, después de modificar un archivo de acción personalizada, vuelva a especificar el archivo para validarlo.

---

Precaución - Si se detectan errores de sintaxis en un archivo de acción personalizada modificado, corrija los errores antes de reiniciarse el supervisor de errores. Si al reiniciarse el supervisor de errores no se han corregido los errores de sintaxis, el supervisor de errores lee el archivo erróneo y omite las entradas que aparezcan tras el primer error de sintaxis.

---

Cómo especificar el archivo de acción personalizada que debe utilizar un supervisor de errores del servidor

1. En un nodo del clúster, conviértase en superusuario o asuma una función que proporcione la autorización RBAC (control de acceso basado en funciones) solaris.cluster.modify.
2. Defina la propiedad de extensión Custom_action_file del recurso SUNW.scalable_rac_server.

   Defina esta propiedad en la ruta absoluta del archivo de acción personalizada.

   # clresource set -p custom_action_file=filepath server-resource

   -p custom_action_file=ruta_archivo

   Especifica la ruta absoluta del archivo de acción personalizada.

   recurso_servidor

   Especifica el recurso SUNW.scalable_rac_server.