...
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 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 | ||||
---|---|---|---|---|
| ||||
#******************************************************************** # 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 | ||
---|---|---|
| ||
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: