A veces nos encontramos errores técnicos en aplicaciones, scripts, etc. y los resolvemos pero no guardamos en ningún lado la solución y los síntomas. Quise hacer una especie de repositorio de problemas/soluciones, y tener disponibles mis experiencias para todos. Espero no volver a decir "¡esto ya me había pasado, pero no me acuerdo cómo lo resolví!" [temas: Oracle DB, korn shell scripts, Oracle App Server, Oracle Collaboration Suite, Windows, Linux, ...]

lunes, mayo 28, 2007

Cómo personalizar el mensaje de error 503 del Oracle Application Server

Cuando el Oracle Application Server encuentra un problema de red, o no recibe respuesta a un request externo antes del tiempo definido en el parámetro Timeout del Apache, muestra una página con letras rojas y un mensaje de error como el siguiente:

No Response from Application Web Server

There was no response from the application web server for the page you requested. Please notify the site's webmaster and try your request again later.

Yo intenté cambiar este mensaje agregando la entrada "ErrorDocument 503" en el archivo httpd.conf del Apache. Sin embargo, después de reiniciar el HTTP Server, limpiar cache, etc., seguía recibiendo la misma página con letras rojas.

Después de buscar archivos y configuraciones por donde se me ocurrió, encontré una nota que decía que a partir de cierta versión del OAS, el mensaje del parámetro "ErrorDocument 503" del httpd.conf es ignorado. También encontré una nota en metalink (note: 199291.1) que decía que al webcache se le podía configurar cuál página llamar cuando encuentre un error 503.

El archivo html que contiene este mensaje de error, es:

$ORACLE_HOME/webcache/files/network_error.html

Se puede modificar ese archivo, o bien, crear otro y decirle al webcache donde encontrarlo. Para la segunda opción, hay que entrar al administrador del webcache (Enterprise Manager), de ahí a Sites y luego a la liga "Define" Default Error Pages que se encuentra en "Defaults and Global Settings".

Luego del cambio, hay que reiniciar el webcache.