HowTo: ¿Cómo puedo actualizar el Java Service Wrapper?

Cuando se liberan nuevas versiones del Java Service Wrapper, Tanuki Software siempre toma las precauciones necesarias para asegurar que los archivos de configuración actuales y las llamadas de API sean compatibles con las nuevas versiones del Wrapper.

En algunos casos cuando sea necesario modificar la funcionalidad de algo que no sea compatible, siempre habrá una nota hecha en las Notas de la Versión y de forma individual en la documentación de la propiedad.

Los pasos de actualización son simples:

• Ubique la versión del Java Service Wrapper que desea usar y descargue la distribución para la plataforma deseada.

• Detenga la ejecución del Java Service Wrapper para poder hacer la actualización.

• En Windows: Copie los archivos bin\wrapper.exe, lib\wrapper.dll, y lib\wrapper.jar, reemplazando los archivos antiguos con los mismos nombres.

  En UNIX: Copie los archivos bin/wrapper, lib/libwrapper.so y lib/wrapper.jar, reemplazando los archivos antiguos con los mismos nombres.

• Si quiere actualizar desde una versión anterior a la versión 3.5.0 del Wrapper , abra su archivo conf\wrapper.conf y agregue una codificación de archivo a la primera línea del archivo de configuración.:

  @encoding=UTF-8

  Puede encontrar un ejemplo de archivo de configuración aquí.

  Si su configuración hace uso de archivos de inclusión (estilo en cascada), cada archivo de configuración debe comenzar con una línea de codificación.

  El archivo de configuración anterior debería funcionar tal como está, pero se recomienda revisar el archivo de plantilla src\conf\wrapper.conf.in de la nueva versión del Wrapper para ver si hay alguna acutalización que pueda ser de su interés.

• En la mayoría de los casos, los archivos por lotes y los scripts de shell funcionarán con versiones nuevas del Wrapper, pero especialmente para las plataformas UNIX, se recomienda que dichos archivos también se actualicen.

  En Windows: Los nuevos archivos batch se encuentran en el directorio src\bin\. Generalmente, estos archivos se pueden copiar y simplemente renombrar para que coincidan con el nombre de su aplicación.

  En UNIX: El nuevo script de shell se encuentra en src/bin/App.sh.in (en versiones anteriores del Wrapper, este archivo se llamaba 'sh.script.in'). Si desea personalizar el script de shell actual, asegúrese de agregar?los cambios también en el nuevo script de shell. Tenga en mente que el contenido después de la sección de configuraciones no debe modificarse.

  Desde la versión 3.5.37, el script de shell de UNIX intenta cargar un archivo fuente opcional que puede contener toda la configuración personalizada. Esto hace que el script de shell se mantenga en su estado original y simplifica actualizaciones futuras. Este archivo fuente personalizado se ejecuta después de configurar las variables en el inicio del script, y cualquier variable establecida en en dicho archivo anulará la configuración predeterminada del script de shell. Para que esto funcione, el archivo fuente debe tener el mismo nombre base que el script y debe tener el sufijo con una extensión '.shconf'.

• (Ediciones Estándar y Profesional)

  Para las Ediciones Estándar o Profesional del Wrapper, asegúrese que el Término de Actualización en el archivo de su Clave de Licencia wrapper-license.conf le permite actualizar a una versión nueva. Cada versión tiene una fecha en la que fue liberada y la clave de la licencia del Wrapper permitirá ejecutar cualquier versión que haya sido liberada antes del Término de Actualización upgrade_term.end_date.

  Licencia para Servidor: Si el Término de Actualización no le permite usar una versión nueva, tendrá que renovar el Término de Actualización. Cuando se haya renovado el Término de Actualización, necesitará actualizar también el archivo de la clave de la licencia wrapper-license.conf para poder ejecutar una nueva versión.

  Licencia de Desarrollo: Si ha renovado el Mantenimiento y Servicio Anual (TSIMS), necesitará actualizar el archivo wrapper-license.conf para poder ejecutar una nueva versión.

  Es posible verificar que una licencia autorizará una versión nueva del Wrapper comparando el Término de Actualización con las fechas de la página de versiones liberadas del Wrapper.

• Visite la página Notas de la Versión para ver qué mejoras se han realizado en cada una de las versiones del Wrapper.

• Una vez que se haya guardado/reemplazado la Clave de la Licencia en el archivo wrapper-license.conf, se recomienda reiniciar inmediatamente el Wrapper y cerciorarse que no haya problemas. El Wrapper no requiere este procedimiento, pero si el nuevo archivo tiene cualquier problema, el Wrapper no iniciará la próxima vez que el se inicie el sistema.