Descripción del Paquete Delta

El Paquete Delta incluye los binarios y las bibliotecas necesarios para que Wrapper funcione en todas las plataformas compatibles*. También contiene los archivos .bat de Windows y el script de shell de Unix para iniciar el Wrapper. El uso de estos scripts facilita el inicio de Wrapper, ya que seleccionan automáticamente los binarios adecuados para la plataforma actual. En otras palabras, permiten iniciar Wrapper de forma transparente, utilizando los mismos comandos en las diferentes plataformas UNIX (Windows utiliza archivos .bat separados).

Con un solo archivo de configuración, podrá configurar el Wrapper para ejecutar su aplicación Java como aplicación de consola o como servicio de Windows/demonio de Unix en los diferentes sistemas operativos. También es posible configurarlo según la plataforma cuando sea necesario.

Crear una única distribución grande con los binarios de todas las plataformas puede facilitar mucho la primera instalación para los usuarios cuando no estén seguros de lo que necesitan. El archivo resultante es, obviamente, grande, pero se puede reducirlo para incluir solo lo que sus usuarios probablemente necesiten. También es posible ejecutar un script después de la extracción para eliminar los archivos no necesarios para la plataforma actual.

Incluso si desea distribuir su aplicación en paquetes específicos para cada plataforma, la estructura del paquete delta puede ser útil para incluir archivos nativos de 32 y 64 bits en una sola distribución. Esto, por sí solo, es muy útil para que sus usuarios no tengan que intentar averiguar qué componentes necesitan para su combinación específica de sistema operativo e instalación de Java.

El Paquete Delta está disponible en todas las ediciones a partir de la versión 3.2.0.

NOTA

* La plataforma z/OS utiliza el conjunto de caracteres EBCDIC, que no es compatible con ASCII. Si descarga la distribución z/OS y ??la visualiza en otros sistemas, todos sus archivos aparecerán dañados. Esto es normal. Por esta razón, la plataforma z/OS no se incluye intencionalmente en las distribuciones del paquete delta.

Descargar el Paquete Delta

En la página de descargas, debajo de los enlaces para las diferentes plataformas, encontrarás los enlaces para descargar el Paquete Delta.

El Paquete Delta tiene un instalador .exe para Windows y también está disponible en los formatos .tar.gz y .zip. El contenido es el mismo, pero podría preferir un formato u otro según el método que use para extraer los archivos.

Elija la edición que prefiera: Profesional, Estándar o Comunidad.

Una vez descargado el paquete, extráigalo.

Estructura

Binarios

En la carpeta lib se encuentran las bibliotecas de todas las plataformas compatibles.

También se encuentran los binarios para las diferentes plataformas y los scripts utilizados para ejecutar el Wrapper en la carpeta bin.

Para cada plataforma, se incluyen versiones de 32 y 64 bits de las bibliotecas y los binarios disponibles.

Configuración

El archivo de configuración se encuentra en la carpeta conf. Generalmente, el archivo de la clave de la licencia también se encuentra en esta carpeta.

Licencia

Para las ediciones Estándar y Profesional, el Wrapper requiere una licencia válida para funcionar. Se recomienda (aunque no es obligatorio) guardar la clave de licencia en un archivo aparte, ubicado en la misma carpeta que el archivo de configuración.

Si adquiere una licencia de Desarrollo, solo necesitará una clave de licencia, que está vinculada a su aplicación Java y le permite ejecutarse en cualquier plataforma. Este tipo de licencia, por su naturaleza, se adapta mejor al Paquete Delta.

Una clave de licencia de Servidor solo se puede usar en una sola máquina, pero es posible agrupar claves de licencia para varios servidores en un solo archivo incluyendo los nombres de host o HostIds en los nombres de las propiedades de la clave de licencia.

Ejemplo: 
# license for hostid 00123456789a
wrapper.00123456789a.license.type=NODE
wrapper.00123456789a.license.id=201804010006
wrapper.00123456789a.license.licensee=Acme, Inc.
wrapper.00123456789a.license.host_id=00123456789a
wrapper.00123456789a.license.features=pro, 64bit
wrapper.00123456789a.license.upgrade_term.begin_date=2018-04-01
wrapper.00123456789a.license.upgrade_term.end_date=2027-04-01
wrapper.00123456789a.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.00123456789a.license.key.2=007d-7e3c-5e2a-427e
wrapper.00123456789a.license.key.3=ce16-f5f0-59f4-d18a
wrapper.00123456789a.license.key.4=b6ca-c31a-6be8-323d

# license for hostid 00123456789b
wrapper.00123456789b.license.type=NODE
wrapper.00123456789b.license.id=201804010007
wrapper.00123456789b.license.licensee=Acme, Inc.
wrapper.00123456789b.license.host_id=00123456789b
wrapper.00123456789b.license.features=pro, 64bit
wrapper.00123456789b.license.upgrade_term.begin_date=2018-04-01
wrapper.00123456789b.license.upgrade_term.end_date=2027-04-01
wrapper.00123456789b.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.00123456789b.license.key.2=007d-7e3c-5e2a-427e
wrapper.00123456789b.license.key.3=ce16-f5f0-59f4-d18a
wrapper.00123456789b.license.key.4=b6ca-c31a-6be8-323d

NOTA

Es posible cambiar la parte del nombre de host en las propiedades de la clave de licencia sin regenerarla. Siempre que necesite implementar el Wrapper en una nueva plataforma, puede simplemente agregar una nueva clave a su archivo de claves de licencia sin modificar las claves existentes.

Al iniciar el Paquete Delta en un sistema Windows o Unix, el Wrapper primero comprobará a qué arquitectura está destinada su licencia (32 bits o 64 bits). Esto se debe a que es posible ejecutar el Wrapper con una licencia de 32 bits en un sistema operativo de 64 bits. En este caso, el Paquete Delta iniciará el binario de 32 bits correspondiente a la plataforma actual. Si su licencia tiene habilitadas las funciones de 32 y 64 bits, o si ejecuta la edición Comunidad, se utilizarán los binarios que coincidan con los bits de su sistema operativo.

Distribución

Selección de sus binarios

Por defecto, el Paquete Delta reúne los binarios y bibliotecas para todas las plataformas compatibles con el Wrapper (excepto z/OS).

Sin embargo, puede que desee eliminar los binarios que no necesite y volver a empaquetar los archivos necesarios utilizando su herramienta de compresión favorita. Esto puede resultar útil en las siguientes situaciones:

- Si decide distribuir su aplicación Java con el Paquete Delta por separado para sistemas Windows y UNIX.

- Si sabe que no implementará Wrapper en ciertas plataformas o arquitecturas, esto puede ser útil para que su paquete sea más ligero y, por lo tanto, más rápido de transferir.

- Si tiene una licencia de 32 bits, puede eliminar todos los binarios de 64 bits, ya que no se pueden usar. Desde la versión 3.5.37, el Wrapper puede detectar el tipo de licencia y ejecutar los binarios correctos, pero se recomienda eliminar los no necesarios para mayor claridad.

Si desea obtener más información sobre las plataformas compatibles con el Java Service Wrapper, visite la Descripción de las Plataformas Compatibles.


Desde la versión 3.5.46, la selección de binarios y bibliotecas es más sencilla gracias al Instalador del Paquete Delta en sistemas Windows.

Configuración Multiplataforma

Las propiedades de configuración de Wrapper están diseñadas para ser multiplataforma, lo que significa que, en la mayoría de los casos, solo necesitará un único archivo de configuración y un único conjunto de propiedades. Sin embargo, existen algunas buenas prácticas para gestionar esto sin problemas y para los casos en que necesite una configuración específica para cada plataforma.

Primero, si decide implementar su Paquete Delta tanto en Windows como en Linux, asegúrese de que todas las rutas incluidas en su configuración usen barras diagonales "/" y no barras invertidas "\". Las barras invertidas solo son compatibles con Windows.

Si desea localizar su aplicación, puede que tenga que usar diferentes notaciones y codificaciones locales según la plataforma. Para la propiedad wrapper.lang, se recomienda usar las notaciones UNIX (por ejemplo, "ja_JP" o "en_US") en lugar de las notaciones de Windows (por ejemplo, "English_United States", "Japanese_Japan"). Las notaciones UNIX también funcionan en Windows, pero las notaciones de Windows no funcionan en sistemas UNIX. Para las codificaciones (controladas por wrapper.lang.encoding), puede usar "UTF-8", que generalmente es compatible con todas las plataformas, incluido Windows. Si necesita usar diferentes codificaciones por plataforma, considere usar las propiedades wrapper.lang.<platform>.encoding.

Las siguientes propiedades de configuración también permiten establecer un valor por plataforma:

Otra técnica útil es recopilar toda la configuración común en el archivo de configuración raíz y escribir la configuración específica de cada plataforma en archivos de inclusión separados.

Puede usar las siguientes variables de entorno para referenciar sus archivos de inclusión desde el archivo de configuración principal: WRAPPER_OS, WRAPPER_ARCH, WRAPPER_BITS. 

@include ../conf/wrapper-%WRAPPER_OS%-%WRAPPER_ARCH%.conf

Puede usar variables de entorno en el nombre del archivo o en el nombre de la carpeta principal.

Después, deberá crear un archivo de configuración para cada plataforma donde necesite una configuración específica. Solo asegúrese de que los nombres de los archivos coincidan con los valores que las variables de entorno adoptarán en la plataforma de destino. Si no se encuentra un archivo de configuración de inclusión, se omitirá automáticamente.

Si su aplicación utiliza otras bibliotecas nativas, deberá configurar la aplicación para incluir las bibliotecas correctas para la plataforma actual. Esto se explica en la página de la propiedad wrapper.java.library.path.<n>.

Soporte

Si tiene alguna pregunta, no dude en contactarnos con una solicitud de soporte en support@tanukisoftware.com. Estaremos encantados de ayudarle. También nos interesa recibir sus comentarios sobre esta u otras funciones.