Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

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/Image Removed

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.htmlImage Removed

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 extrae al archivo zip en un directorio de tu convenienvia; 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.----------------> TRADUCCION PENDIENTE

No Format
borderStylesolid
titlewrapper.conf específico para Geronimo
#********************************************************************
# Propiedades del Wrapper Properties
#********************************************************************
# Aplicación Java Application
wrapper.java.command=<java_home>\bin\java

# Java clase  Principal (Main class).  ThisEsta clase classdebe mustimplementar implementla theinterfaz WrapperListener interface
#  oró guaranteegarantizar thatque la theclase WrapperManager esta classinicializada. is initialized.Clases ayudantes (Helper)
#  classesse arete providedproporcionan topara dollevarlo thisa forcabo. you. Consulta Seela thesección Integrationde sectionIntegración
#  ofde la thedocumentación documentationpara forobtener detailsdetalles.
wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperStartStopApp

# Java Classpath (includeincluir wrapper.jar)  Add classAgrega elementos clase al path elements ascomo
#  needed starting fromsea 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 (locationubicación ofde Wrapper.DLL oró libwrapper.so )
wrapper.java.library.path.1=..\lib

# Java AdditionalParámetros ParametersAdicionales
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"

# InitialTamaño del Java Heap SizeInicial (inen MB)
#wrapper.java.initmemory=3

# MaximumTamaño Máximo del Java Heap Size (inen MB)
#wrapper.java.maxmemory=64

# ApplicationParámetros de parametersAplicación.  AddAgrega parameterslos asparámetros needednecesarios, startinginiciando fromdesde 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

# FilterConfiguración settings,del ifFiltro; yousi wantdeseas tocomportamiento haveespecial specialpara behaviourla forbitácora loggedde messagesmensajes
# uncommentdescomenta thelas followingsiguientes lineslíneas
#wrapper.filter.trigger.1=JSWRestartGeronimo
#wrapper.filter.action.1=RESTART
#wrapper.filter.trigger.2=java.lang.OutOfMemoryError
#wrapper.filter.action.2=RESTART

#********************************************************************
# Wrapper Logging PropertiesPropiedades de Bitácora de Wrapper
#********************************************************************
# FormatFormato ofde outputsaluda forpara thela consoleconsola.  (SeeConsulta docs for formatspara información de los formatos)
wrapper.console.format=PM

# Log Level for console output Nivel de bitácora para la salida a consola.  (SeeConsulta docs para forniveles logde levelsbitácoras)
wrapper.console.loglevel=INFO

# LogArchivo fileBitácora toa useusar forpara wrapperla output logging.captura de salidas del wrapper
wrapper.logfile=<geronimo_home>\var\log\jsw.log

# FormatFormato ofde outputsalida forpara theel logarchivo filebitácora.  (SeeConsulta docs for formatspara información de los formatos)
wrapper.logfile.format=LPTM

# Log Level for log file output Nivel de bitácora para lo capturado en el archivo de salida.  (SeeConsulta docs forpara logniveles de levelsbitácoras)
wrapper.logfile.loglevel=INFO

# Tamaño Maximummáximo sizepermitido thatpara theel logarchivo filebitácora willantes bede allowedque tose growle toaplique beforecambio.
#  theEl logtamaño isse rolled. Size is specified inespecifica en bytes.  El Thevalor default valuepredeterminado es 0,
#  el cual ofno 0,hace disablescambio logde rollingarchivo.  Es posible Mayabreviar con abbreviateel withsufijo
# the 'k' (kb) or
#ó  'm' (mb) suffix.  ForPor exampleejemplo: 10m = 10 megabytes.
wrapper.logfile.maxsize=0

# MaximumNúmero numbermáximo ofde rolledarchivos logde filesbitácora whichque willserán bepedmitios allowedantes beforede oldque
#  se fileseliminer arearchivos deletedviejos.  El Thevalor defaultpor valuedefecto ofde 0 impliesimplica nosin limitlímite.
wrapper.logfile.maxfiles=0

# Log Level for Nivel de bitácora para la salida sys\event log output.  (SeeConsulta docs para forniveles logde levelsbitácoras)
wrapper.syslog.loglevel=NONE

#********************************************************************
# Wrapper Windows Properties Propiedades de la ventana del Wrapper
#********************************************************************
# TitleTítulo toa useusar whencuando runningse asejecute acomo consoleconsola
wrapper.console.title=Apache Geronimo v1.1 Server

#********************************************************************
# Propiedades del Servicio Wrapper en Windows NT\2000\XP Service Properties
#********************************************************************
# WARNINGADVERTENCIA - DoNo notmodifiques modifyalguna anyde ofestas thesepropiedades propertiescuando when an applicationuna aplicación,
#  usando usinga thiseste configurationarchivo filede hasconfiguración, beenha installedsido asinstalada acomo serviceservicio.
#  Por Pleasefavor desinstala uninstallel theservicio serviceantes beforede modifyingmodificar thisesta sectionsección.  TheDespués
#  serviceel canservicio thenpuede beser reinstalledreinstalado.

# NameNombre ofdel the serviceservicio
wrapper.ntservice.name=Geronimo

# DisplayNombre namea ofdesplegar thedel serviceservicio
wrapper.ntservice.displayname=Apache Geronimo v1.1 Server

# DescriptionDescripción ofdel the serviceservicio
wrapper.ntservice.description=Apache Geronimo v1.1 Server

# ServiceDependencias del dependenciesservicio.  AddAgrega dependencieslas asdependencias needednecesarias, startinginiciando fromdesde 1
wrapper.ntservice.dependency.1=

# Modo Modeen inel whichcual thees serviceinstalado isel installedservicio.  AUTO_START oró DEMAND_START
wrapper.ntservice.starttype=AUTO_START

# AllowPermitirle theal serviceservicio toel interactinteractuar withcon theel desktopescritorio.
wrapper.ntservice.interactive=false

<---------------- TRADUCCION PENDIENTE

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

...

  • 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.

...

No Format
borderStylesolid
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.

...

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 Administración de Geronimo, mediante la siguiente URL:

http://localhost:8080/consoleImage Removed