El Wrapper es muy flexible y se puede configurar para que funcione con cualquier estructura de directorio. Para este ejemplo, recomendamos una estructura de directorio que es limpia y que puede reutilizarse incluso para aplicaciones bastante complicadas. Por favor recree la siguiente estructura de directorio bajo un directorio arbitrario de su elección. Lo llamaremos directorio raíz $(EXAMPLE_HOME). Este es una extensión de la estructura del directorio que se encuentra en la sección descripción de HelloWorldServer.

$(EXAMPLE_HOME)/
$(EXAMPLE_HOME)/bin/
$(EXAMPLE_HOME)/conf/
$(EXAMPLE_HOME)/lang/
$(EXAMPLE_HOME)/lib/
$(EXAMPLE_HOME)/lib/classes/
$(EXAMPLE_HOME)/logs/

Por favor descargue la última versión del Java Service Wrapper desde la página de Descargas, extraiga los archivos y guardelos en el directorio de su elección. Nosotros lo llamaremos %EXAMPLE_HOME%.

El Java Service Wrapper para UNIX consiste de cuatro componentes primarios: el Wrapper binario, un archivo jar, una librería nativa, usada por el archivo jar, y un shell script, usado para iniciar el Wrapper y realizar acciones como controlarlo como daemon. Es necesario copiar estos archivos como sigue:

cp $(WRAPPER_HOME)/bin/wrapper $(EXAMPLE_HOME)/bin/wrapper
cp $(WRAPPER_HOME)/lib/wrapper.jar $(EXAMPLE_HOME)/lib/wrapper.jar
cp $(WRAPPER_HOME)/lib/libwrapper.so $(EXAMPLE_HOME)/lib/libwrapper.so
cp $(WRAPPER_HOME)/src/bin/App.sh.in $(EXAMPLE_HOME)/bin/helloworldserver

Después, es necesario hacer que el archivo script sea ejecutable:

chmod +x helloworldserver

Clave de licencia:

Las ediciones Estándar y Profesional del Java Service Wrapper requieren una clave de licencia para que puedan ser ejecutadas. El Wrapper incluye una clave que le dará la oportunidad de ejecutar el Wrapper por 15 minutos. Por favor haga uso de esta clave por ahora. Si desea obtener un período de prueba más largo, solo presione el botón Free Trial (versión de prueba gratuita) en la parte superior de esta página.

cp $(WRAPPER_HOME)/src/conf/wrapper-license-time.conf $(EXAMPLE_HOME)/conf/wrapper-license.conf

Archivo de configuración del Wrapper:

Por fin, copiar el archivo de configuraciones del Wrapper. Editaremos el archivo en la siguiente sección.

cp $(WRAPPER_HOME)/src/conf/wrapper.conf.in $(EXAMPLE_HOME)/conf/wrapper.conf

Abra el archivo $(EXAMPLE_HOME)/conf/wrapper.conf en un editor de texto de su elección.

Es necesario localizar y modificar las siguientes propiedades.

wrapper.java.command=java
wrapper.java.command.loglevel=INFO

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
wrapper.app.parameter.1=HelloWorldServer

wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=../lib/classes

wrapper.java.library.path.1=../lib

wrapper.logfile=../logs/wrapper.log

• La propiedad wrapper.java.command se usa para especificar la ubicación del comando Java que se usará. El valor que hemos especificado será ubicado en la ruta del sistema. También es posible especificar una ruta absoluta.

• La propiedad wrapper.java.command.loglevel es opcional, pero es de gran ayuda como método de depuración para la línea de comandos Java que genere el Wrapper. Le recomendamos que incluya esta propiedad cuando inicie su aplicación. Sin embargo, puede inhabilitarla una vez que su aplicación este funcionando sin problemas.

• La propiedad wrapper.java.mainclass se usa para especificar la clase principal que se pasa a Java cuando es implementada. Este es un punto de confusión para nuevos usuarios, pero en la mayoría de los casos esta clase principal ayuda al Wrapper, en lugar de la clase principal de su aplicación. El Wrapper tiene diferentes métodos de integración, pero para este ejemplo usaremos el método más simple llamado Método de Integración #1 (WrapperSimpleApp).
  Este método usa la clase org.tanukisoftware.wrapper.WrapperSimpleApp para administrar el ciclo de vida de la máquina JVM y la comunicación externa con el Wrapper. Por ahora no se preocupe por este punto.

• La clase principal de nuestra aplicación HelloWorldServer se pasa como primer parámetro usando la propiedad wrapper.app.parameter.1. Es posible pasar parámetros adicionales a la aplicación HelloWorldServer al agregar propiedades adicionales incrementando índices, por ejemplo: wrapper.app.parameter.2=P1.

  Aunque no se muestra aquí, es posible agregar parámetros Java adicionales usando las propiedades wrapper.java.additional.<n>.

• El siguiente paso es especificar la ruta de la clase. Esto se puede hacer usando las propiedades wrapper.java.classpath.<n>. Necesitamos dos entradas de la ruta de la clase para nuestra aplicación. La primera es incluir el archivo wrapper.jar, que incluye las clases auxiliares del Wrapper. La segunda entrada incluye el directorio lib/classes, donde la clase HelloWorldServer está ublicada.

• El Wrapper usa una librería nativa, libwrapper.so, para implementar algunas de sus funciones. Librerías nativas no son usadas por muchas aplicaciones Java, y lo más probable es que aún no haya experimentado esto antes. Las propiedades wrapper.java.library.path.<n> se usan para especificar la ubicación de las librerías. Por ahora no tenemos que preocuparnos por este punto.

• La propiedad wrapper.logfile se usa para ordenarle al Wrapper donde escribir los archivos de registro de valores.

Ahora ya le decimos al Wrapper como ejecutar nuestra aplicación Java.

Algo muy importante es tener en mente que todos los valores de las propiedades son especificados con valores de rutas que son relativos a la ubicación del binario wrapper.exe.

Abra el archivo shell script $(EXAMPLE_HOME)/bin/helloworldserver en un editor de texto de su elección.

Por el comienzo del archivo, verá dos variables: APP_NAME y APP_LONG_NAME. Por favor reemplace los valores con el nombre de su aplicación.

# Application
APP_NAME="helloworldserver"
APP_LONG_NAME="Hello World Server"

Hay otras variables útiles para configurar el Wrapper como un demonio, pero las veremos un poco más adelante en este tutorial.