Descripción general: propiedades de inicio de recursos compartidos

Las propiedades wrapper.share<n>.startup.* definen básicamente cómo el Wrapper gestionará los fallos de los recursos compartidos montados.

Componente <n>:

El componente "<n>" del nombre de la propiedad es un número entero que cuenta a partir de "1". Por defecto, la numeración debe ser secuencial, sin huecos. La propiedad wrapper.ignore_sequence_gaps se puede establecer opcionalmente para permitir huecos en la secuencia.

wrapper.share.<n>.startup.failure

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad define el comportamiento del Wrapper si se produce cualquier error general. Excepto el error de premapeo (véase más abajo).

El usuario puede especificar que el Wrapper deba:

  • SHUTDOWN a sí mismo si no se pudo montar la unidad de red
  • BACKGROUND (Desde ver. 3.5.52) su proceso e iniciar la JVM, pero continuar intentando montar en segundo plano
  • o CONTINUE su proceso e iniciar la JVM, pero dejar de intentar montar.

El valor predeterminado es BACKGROUND.

Ejemplo:
wrapper.share.1.startup.failure=CONTINUE

NOTA

Antes de la versión 3.5.52, el valor predeterminado era CONTINUE.

NOTA

Puede producirse un error "The network path was not found. (0x35)" cuando la máquina distante que aloja el recurso compartido está conectada, pero el punto de montaje solicitado no existe. Sin embargo, el mismo error también puede producirse cuando el sistema se está iniciando y aún no está listo para la resolución de nombres. No es posible distinguir entre estos 2 problemas, por lo que el Wrapper tratará este error como un problema temporal durante el inicio, y como un problema permanente después de entrar en la segunda fase, que intenta montar el recurso compartido en segundo plano.

wrapper.share.<n>.startup.premapped

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

ADVERTENCIA

Antes de la versión 3.5.52, el valor predeterminado era CONTINUE. El valor predeterminado se cambió a SHUTDOWN. Consulte los detalles a continuación.

Esta propiedad especifica lo que hará el Wrapper si no se pudo montar un recurso compartido porque el recurso de red ya existía.

Tenga en cuenta que el comportamiento del Wrapper para este error no está cubierto en las propiedades wrapper.share.<n>.startup.failure. Esto se hizo a propósito para proporcionar una forma de ejecutar el Wrapper como consola y como servicio con el mismo archivo de configuración.

Desde la versión 3.5.52, si el destino en la máquina local ya existe y está mapeado a la misma ubicación especificada con wrapper.share.<n>.location, el Wrapper considerará el montaje realizado y continuará independientemente del valor de wrapper.share.<n>.startup.premapped.

Por el contrario, si el destino es el mismo, pero la ubicación de red es diferente, es probable que el recurso compartido se haya mapeado a un recurso de red diferente (a menos que la ubicación utilizara un alias). En tales casos, suele ser más prudente apagar, ya que esto podría dar lugar a situaciones en las que la aplicación podría leer o escribir en una ubicación incorrecta. Junto con este cambio, se decidió por tanto cambiar el valor predeterminado a SHUTDOWN.

El usuario puede especificar que el Wrapper:

  • SHUTDOWN a sí mismo si la unidad de red ya existe
  • o CONTINUE su proceso e inicie la JVM.

El valor predeterminado es SHUTDOWN.

Ejemplo:
wrapper.share.1.startup.premapped=CONTINUE

wrapper.share.<n>.startup.max_retries

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad define cuántas veces el Wrapper debe intentar montar una unidad de red si se ha producido un error basado en la red.

Si el Wrapper no pudo montar la unidad de red en el número máximo de reintentos, la propiedad wrapper.share.<n>.startup.failure especificará cómo procederá el Wrapper.

El valor predeterminado es "5 veces". El Wrapper intentará 5 veces montar una unidad de red antes de abandonar.

Ejemplo: (5 veces)
wrapper.share.1.startup.max_retries=5

wrapper.share.<n>.startup.retry_interval

Compatibilidad :3.5.0
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad especifica el intervalo en segundos que el Wrapper esperará hasta reintentar montar una unidad de red.

El valor predeterminado es "10 segundos". El Wrapper esperará 10 segundos hasta reintentar el montaje.

Ejemplo: (10 segundos)
wrapper.share.1.startup.retry_interval=10

wrapper.share.<n>.background.retry_interval

Compatibilidad :3.5.52
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad especifica el intervalo en segundos que el Wrapper esperará hasta reintentar montar una unidad de red en segundo plano después del inicio. Este es el intervalo con el que el Wrapper seguirá intentándolo incluso después de que la aplicación se haya iniciado. Seguirá intentándolo hasta que se mapee correctamente o se detecte un fallo permanente.

A veces el servidor que aloja el recurso compartido no es accesible cuando se inicia el servicio. Continuar intentando montar en segundo plano puede ser útil si el recurso compartido no es crítico para la aplicación.

El valor predeterminado es "60 segundos". El Wrapper esperará 60 segundos hasta reintentar el montaje.

Ejemplo: (60 segundos)
wrapper.share.1.background.retry_interval=60

wrapper.share.<n>.background.success.action

Compatibilidad :3.5.52
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad permite especificar una determinada acción que se realizará cada vez que un recurso compartido se monte correctamente después del inicio de la aplicación.

Esto puede ser útil para desencadenar un reinicio de la JVM, por ejemplo, cuando la aplicación necesita reinicializarse ahora que el recurso compartido está disponible.

La acción predeterminada se especifica como NONE para no hacer nada.

Ejemplo:
wrapper.share.1.background.success.action=RESTART

La lista completa de acciones se puede consultar en esta página, pero las más utilizadas son las siguientes:

  • DEBUG:

    hará que se registre un mensaje de depuración. Esto solo es realmente útil para ayudar a comprender cuándo se dispara la acción.

  • RESTART:

    detendrá la JVM actual y a continuación reiniciará una nueva invocación.

  • USER_<n> (Edición Professional):

    hará que se dispare un evento definido por el usuario. Esto puede ser el envío de un correo electrónico, o la ejecución de un comando externo del sistema. El comando podría ser cualquier cosa, desde realizar operaciones de limpieza hasta generar una trampa SNMP.

  • NONE:

    no hará nada (ninguna acción adicional una vez que el recurso compartido se haya montado correctamente).

wrapper.share.<n>.background.failure.action

Compatibilidad :3.5.52
Ediciones :Edición ProfesionaEdición EstándarEdición de la Comunidad (No Compatible)
Plataformas :WindowsMac OSX (No Compatible)Linux (No Compatible)Alpine Linux (No Compatible)FreeBSD (No Compatible)Solaris (No Compatible)IBM z/Linux (No Compatible)

Esta propiedad permite especificar una determinada acción que se realizará cada vez que un recurso compartido no se pueda montar de forma permanente después del inicio de la aplicación. Esto incluye credenciales o puntos de montaje incorrectos. Los problemas temporales, como un fallo al resolver el nombre de host o al conectar con el servidor, se seguirán reintentando en segundo plano.

La propiedad controla lo que ocurre cuando se produce un fallo en modo de segundo plano. En este punto, la aplicación ya se ha iniciado a pesar de que el recurso compartido no se pudo mapear durante el inicio. Por lo tanto, generalmente no es una buena idea hacer SHUTDOWN o tomar alguna otra acción fatal en este punto. Esta propiedad puede ser útil para ejecutar acciones USER_<n> o registrar un mensaje.

La acción predeterminada se especifica como NONE para no hacer nada.

Ejemplo:
wrapper.share.1.background.failure.action=USER_1

La lista completa de acciones se puede consultar en esta página, pero las más utilizadas son las siguientes:

  • DEBUG:

    hará que se registre un mensaje de depuración. Esto solo es realmente útil para ayudar a comprender cuándo se dispara la acción.

  • SHUTDOWN:

    detendrá la JVM así como el Wrapper. Tenga cuidado al usar este valor, ya que un fallo al montar un recurso compartido en segundo plano puede ocurrir en cualquier momento mientras la aplicación ya se está ejecutando. Si esto ocurriera, provocaría que su aplicación y el Wrapper se detuvieran.

  • USER_<n>:

    hará que se dispare un evento definido por el usuario. Esto puede ser el envío de un correo electrónico, o la ejecución de un comando externo del sistema. El comando podría ser cualquier cosa, desde realizar operaciones de limpieza hasta generar una trampa SNMP.

  • NONE:

    no hará nada (el fallo no irá seguido de ninguna acción, y el Wrapper continuará).

Poniéndolo todo junto