Este artÃculo te mostrarÃ¡ como configurar Apache Geronimo v1.1 para ejecutarse como un servicio de MS Windows. Se requerirÃ¡ Java Service Wrapper (JSW) como software adicional para lograr dicha configuraciÃ³n. Usando JSW te proporciona un "control" adicional en el servicio que configures, como la habilidad de aplicar ping al servicio y asÃ ayudar a la respuesta si el servicio no esta en ejecuciÃ³n.

En este artÃculo revisaremos los diversos parÃ¡metros de configuraciÃ³n del JSW que controla el comportamiento del servicio y al wrapper mismo.

Pre-requisitos de Software

Para preparar a Apache Geronimo v1.1 como servicio de MS Windows, necesitarÃ¡s Java Service Wrapper. Para este ejemplo, usamos Java Service Wrapper 3.2.0, disponible para su descarga en la siguiente URL:

http://sourceforge.net/projects/wrapper/

Para este ejemplo, tambiÃ©n estamos usando Apache Geronimo v1.1 bajo Windows XP. Puedes descargar los binarios de Apache Geronimo de la siguiente URL:

http://geronimo.apache.org/downloads.html

Instalando Apache Geronimo

La instalaciÃ³n de Geronimo a partir de los binarios es muy simple. SÃ³lo extrae al archivo zip en un directorio de tu conveniencia; a partir de ahora, este artÃculo se referirÃ¡ a ese directorio como <geronimo_home>.

Instalando Java Service Wrapper

La instalaciÃ³n del wrapper es tan simple como la de Apache Geronimo. Ya que hayas obtenido la versiÃ³n correcta de tu ambiente, puedes extraer al archivo zip en un directorio de tu conveniencia; a partir de ahora, este artÃculo se referirÃ¡ a ese directorio como <jsw_home>.

Configurando al wrapper

Java Service Wrapper viene con un archivo de configuraciÃ³n ejemplo, wrapper.conf, el cual pre-configura la ejecuciÃ³n de un script prueba (tambiÃ©n proporcionado). En esta secciÃ³n, para tu conveniencia, proporcionamos un archivo wrapper.conf especÃfico para Geronimo.

El archivo wrapper de configuraciÃ³n se encuentra en el directorio <jsw_home>\conf. Respalda al archivo original y crea un nuevo archivo wrapper.conf, con el contenido del siguiente ejemplo.

wrapper.conf especÃfico para Geronimo

#********************************************************************
# Propiedades del Wrapper
#********************************************************************
# AplicaciÃ³n Java
wrapper.java.command=<java_home>\bin\java

# Java clase  Principal (Main).  Esta clase debe implementar la interfaz WrapperListener
#  Ã³ garantizar que la clase WrapperManager esta inicializada.  Clases ayudantes (Helper)
#  se te proporcionan para llevarlo a cabo.  Consulta la secciÃ³n de IntegraciÃ³n
#  de la documentaciÃ³n para obtener detalles.
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperStartStopApp

# Java Classpath (incluir wrapper.jar)  Agrega elementos clase al path como
#  sea necesario, iniciando de 1
wrapper.java.classpath.1=<jsw_home>\lib\wrapper.jar
wrapper.java.classpath.2=<geronimo_home>\lib\cglib-nodep-2.1_3.jar
wrapper.java.classpath.3=<geronimo_home>\lib\commons-cli-1.0.jar
wrapper.java.classpath.4=<geronimo_home>\lib\commons-logging-1.0.4.jar
wrapper.java.classpath.5=<geronimo_home>\lib\geronimo-common-1.1.jar
wrapper.java.classpath.6=<geronimo_home>\lib\geronimo-deploy-jsr88-1.1.jar
wrapper.java.classpath.7=<geronimo_home>\lib\geronimo-deploy-tool-1.1.jar
wrapper.java.classpath.8=<geronimo_home>\lib\geronimo-deployment-1.1.jar
wrapper.java.classpath.9=<geronimo_home>\lib\geronimo-j2ee-deployment_1.1_spec-1.0.1.jar
wrapper.java.classpath.10=<geronimo_home>\lib\geronimo-kernel-1.1.jar
wrapper.java.classpath.11=<geronimo_home>\lib\geronimo-qname_1.1_spec-1.0.1.jar
wrapper.java.classpath.12=<geronimo_home>\lib\geronimo-system-1.1.jar
wrapper.java.classpath.13=<geronimo_home>\lib\geronimo-util-1.1.jar
wrapper.java.classpath.14=<geronimo_home>\lib\log4j-1.2.8.jar
wrapper.java.classpath.15=<geronimo_home>\lib\mx4j-3.0.1.jar
wrapper.java.classpath.16=<geronimo_home>\lib\mx4j-remote-3.0.1.jar
wrapper.java.classpath.17=<geronimo_home>\bin\server.jar
wrapper.java.classpath.18=<geronimo_home>\bin\shutdown.jar

# Java Library Path (ubicaciÃ³n de Wrapper.DLL Ã³ libwrapper.so )
wrapper.java.library.path.1=..\lib

# Java ParÃ¡metros Adicionales
wrapper.java.additional.1=-Dorg.apache.geronimo.base.dir=<geronimo_home>
wrapper.java.additional.2=-Djava.io.tmpdir=<geronimo_home>\var\temp
wrapper.java.additional.3=-Djava.endorsed.dirs="<geronimo_home>\lib\endorsed"
wrapper.java.additional.4=-Djava.extension.dirs="<geronimo_home>\lib\ext"

# TamaÃ±o del Java Heap Inicial (en MB)
#wrapper.java.initmemory=3

# TamaÃ±o MÃ¡ximo del Java Heap (en MB)
#wrapper.java.maxmemory=64

# ParÃ¡metros de AplicaciÃ³n.  Agrega los parÃ¡metros necesarios, iniciando desde 1
wrapper.app.parameter.1=org.apache.geronimo.system.main.Daemon
wrapper.app.parameter.2=0
wrapper.app.parameter.3=org.apache.geronimo.deployment.cli.StopServer
wrapper.app.parameter.4=false
wrapper.app.parameter.5=4
wrapper.app.parameter.6=--user
wrapper.app.parameter.7=system
wrapper.app.parameter.8=--password
wrapper.app.parameter.9=manager

# ConfiguraciÃ³n del Filtro; si deseas comportamiento especial para la bitÃ¡cora de mensajes
# descomenta las siguientes lÃneas
#wrapper.filter.trigger.1=JSWRestartGeronimo
#wrapper.filter.action.1=RESTART
#wrapper.filter.trigger.2=java.lang.OutOfMemoryError
#wrapper.filter.action.2=RESTART

#********************************************************************
# Propiedades de BitÃ¡cora de Wrapper
#********************************************************************
# Formato de saluda para la consola.  (Consulta docs para informaciÃ³n de los formatos)
wrapper.console.format=PM

# Nivel de bitÃ¡cora para la salida a consola.  (Consulta docs para niveles de bitÃ¡coras)
wrapper.console.loglevel=INFO

# Archivo BitÃ¡cora a usar para la captura de salidas del wrapper
wrapper.logfile=<geronimo_home>\var\log\jsw.log

# Formato de salida para el archivo bitÃ¡cora.  (Consulta docs para informaciÃ³n de los formatos)
wrapper.logfile.format=LPTM

# Nivel de bitÃ¡cora para lo capturado en el archivo de salida.  (Consulta docs para niveles de bitÃ¡coras)
wrapper.logfile.loglevel=INFO

# TamaÃ±o mÃ¡ximo permitido para el archivo bitÃ¡cora antes de que se le aplique cambio.
#  El tamaÃ±o se especifica en bytes.  El valor predeterminado es 0,
#  el cual no hace cambio de archivo.  Es posible abreviar con el sufijo
#  'k' (kb) Ã³ 'm' (mb).  Por ejemplo: 10m = 10 megabytes.
wrapper.logfile.maxsize=0

# NÃºmero mÃ¡ximo de archivos de bitÃ¡cora que serÃ¡n pedmitios antes de que
#  se eliminer archivos viejos.  El valor por defecto de 0 implica sin lÃmite.
wrapper.logfile.maxfiles=0

# Nivel de bitÃ¡cora para la salida sys\event.  (Consulta docs para niveles de bitÃ¡coras)
wrapper.syslog.loglevel=NONE

#********************************************************************
# Propiedades de la ventana del Wrapper
#********************************************************************
# TÃtulo a usar cuando se ejecute como consola
wrapper.console.title=Apache Geronimo v1.1 Server

#********************************************************************
# Propiedades del Servicio Wrapper en Windows NT\2000\XP
#********************************************************************
# ADVERTENCIA - No modifiques alguna de estas propiedades cuando una aplicaciÃ³n,
#  usando a este archivo de configuraciÃ³n, ha sido instalada como servicio.
#  Por favor desinstala el servicio antes de modificar esta secciÃ³n.  DespuÃ©s
#  el servicio puede ser reinstalado.

# Nombre del servicio
wrapper.ntservice.name=Geronimo

# Nombre a desplegar del servicio
wrapper.ntservice.displayname=Apache Geronimo v1.1 Server

# DescripciÃ³n del servicio
wrapper.ntservice.description=Apache Geronimo v1.1 Server

# Dependencias del servicio.  Agrega las dependencias necesarias, iniciando desde 1
wrapper.ntservice.dependency.1=

# Modo en el cual es instalado el servicio.  AUTO_START Ã³ DEMAND_START
wrapper.ntservice.starttype=AUTO_START

# Permitirle al servicio el interactuar con el escritorio.
wrapper.ntservice.interactive=false

Aplica una bÃºsqueda con reemplazo, cambiando las etiquetas <java_home>, <geronimo_home> y <jsw_home>, por los valores de tu ambiente.

Hagamos una revisiÃ³n de nivel general, a lo que hace el archivo de configuraciÃ³n:

Al inicio de la configuraciÃ³n, estableces la ubicaciÃ³n del ejecutable JAVA, asÃ³ como el classpath JAVA a los jars Geronimo.
DespuÃ©s especificas los valores inicial y mÃ¡ximo del tamaÃ±o de heap para la JVM y proporcionas algunos valores de inicio, como el usuario y contraseÃ±a para iniciar el servicio.
A continuaciÃ³n, proporcionas la configuraciÃ³n de bitÃ¡cora; este archivo de configuraciÃ³n crearÃ¡ una bitÃ¡cora para la instalaciÃ³n, inicio, fin t desinstalaciÃ³n de este servicio Geronimo en el directorio <geronimo_home>\var\log.
Finalmente, proporcionas el nombre del servicio y estableces el tipo de inicio.

Agregando el servicio

Junto con el wrapper, existen dos scripts para instalar y desinstalar el servicio. Ya que estamos usando el mismo nombre del archivo wrapper de configuraciÃ³n, wrapper.conf, no hay necesidad de alterar alguno de esos dos scripts.

Para agregar Apache Geronimo como un servicio MS Windows, ejecuta el siguiente comando:

<jsw_home>\bin\InstallTestWrapper-NT.bat

Para eliminar el servicio de Apache Geronimo, ejecuta el siguiente comando:

<jsw_home>\bin\UninstallTestWrapper-NT.bat

Recuerda que por simplicidad, estamos reusando los scripts proporcionados por la instalaciÃ³n de Java Service Wrapper; el nombre de los scripts no es relevante, ya que ambos apuntan al archivo wrapper de configuraciÃ³n que hemos modificado.

Puedes revisar los resultados de la instalaciÃ³n en el archivo bitÃ¡cora <geronimo_home>\var\log\jsw.log. DeberÃas ver algo similar a:

STATUS | wrapper  | 2006/03/24 15:39:18 | Apache Geronimo v1.1 Server installed.

Ejecutando el servicio de Apache Geronimo v1.1

Para ejecutar al servicio puedes emplear la interfaz de MS Windows Ã³ puedes emplear la opciÃ³n de lÃnea de comandos. Para el siguiente ejemplo, la opciÃ³n elegida es el uso de la lÃnea de comandos.

Desde una lÃnea de comandos de Windows, ejecuta el comando:

net start Geronimo

DeberÃas ver un mensaje de confirmaciÃ³n similar al siguiente:

E:\JavaServiceWrapper\bin>net start Geronimo
El servicio de Apache Geronimo v1.1 Server estÃ¡ iniciÃ¡ndose...
El servicio de Apache Geronimo v1.1 Server se ha iniciado con Ã©xito.

Nota que Apache Geronimo puede tomar algunos instantes adicionales para iniciar: incluso cuando recibas el mensaje de que el servicio ha sido iniciado exitosamente, Geronimo podrÃa aÃºn estar cargÃ¡ndose.

Verifica <geronimo_home>\var\log\jsw.log para comprobar que Geronimo ha iniciado completamente: la Ãºltima lÃnea de la bitÃ¡cora deberÃa ser similar a:

INFO   | jvm 1    | 2006/06/28 13:06:39 | Geronimo Application Server started

Como alternativa, si instalaste al comando tail de Windows, podrÃas ejecutar al siguiente comando para monitorear el estado.

tail -f <geronimo_home>\var\log\jsw.log

Una vez que veas en la bitÃ¡cora el mensaje Geronimo Application Server started indica que todo estÃ¡ preparado. Con ello puedes abrir un explorador Web y solicitar acceso a la Consola de AdministraciÃ³n de Geronimo, mediante la siguiente URL:

http://localhost:8080/console