======================================================
Apache Geronimo v2.0.1 (Agosto, 2007)
http://geronimo.apache.org/
------------------------------------------------------
______________________
Documentación
======================
Este LEEME sirve como un resumen general de cinco minutos de Geronimo, pero mejor
documentación se puede encontrar en:
- http://geronimo.apache.org/documentation.html
______________________
Notas del Lanzamiento
======================
Por favor lea la NOTAS DE LANZAMIENTO para una lista completa de características que son
disponibles en este lanzamiento, así como mejoras y soluciones a bugs.
______________________
Intalación
======================
Si ha descargado y expandido una distribución binaria de Geronimo,
entonces ha finalizado la instalación.
Si desea modificar los puertos predefinidos que usará Geronimo, edita al archivo
<geronimo_home>/var/config/config-substitutions.properties
Nota para plataforma Windows:
============================
Usuarios Windows, recuerden el límite de 255 caracteres para la longitud del path de directorio.
Instalación por defecto a directorios predefinidos como "Mis Documentos" ó
"Archivos de Programas" pueden causar que la instalación ó inicio del servidor falle. Mejor
emplee un directorio <geronimo_home> a nivel de raíz.
______________________
Iniciando y Deteniendo
======================
Geronimo viene con archivos batch y script para controlar las funciones de inicio
y fin del servidor. Para ver ejemplos de uso, simplemente teclee el comando
geronimo.bat ó geronimo.sh que corresponda a su plataforma. Es necesario establecer
JAVA_HOME a la copia de su Sun 5 JDK/JRE antes de ejecutar el comando.
Para consultar las opciones disponibles del comando, teclee:
<geronimo_home>/bin/geronimo.sh
ó
<geronimo_home>\bin\geronimo.bat
El comando desplegará texto ayuda instruyéndole a cómo iniciar y detener al
servidor Geronimo.
Si prefiere iniciar el servidor sin un archivo script, puede simplemente teclear
el siguiente comando desde el directorio <geronimo_home>:
java -Djava.endorsed.dirs=lib/endorsed -javaagent:bin/jpa.jar -jar bin/server.jar
Al haber iniciado el servidor, puede tener acceso a la aplicación de bienvenida
dirigiendo su explorador web a:
http://localhost:8080/
Para accesar la Consola de Administración Geronimo, dirija su explorador web a:
http://localhost:8080/console/
El nombre de usuario predefinido es "system" y su contraseña predefina es "manager".
______________________
Activando (Deploying)
======================
Geronimo incluye scripts de activación y archivos batch para activar módulos JEE
ó aplicaciones. Puede emplear los scripts ó simplemente invocar al jar ejecutable
mediante el siguiente comando:
<geronimo_home>/bin/java -jar deployer.jar deploy mi-web-app.war [plan de activación]
Si usa el script proporcionado, entonces el comando debería ser como se indica:
<geronimo_home>/bin/deploy deploy mi-web-app.war [plan de activación]
Requerirá usar el nombre de usuario "system" y contraseña "manager" a menos que los
haya modificado.
El plan de activación es opcional -- puede empacarlo en el módulo de la aplicación,
proporcionarlo desde la línea de comandos, ó en algunos casos omitirlo completamente.
Para mayor información en los comandos y opciones soportadas por la herramienta de
activación (deploy tool), ejecute desde el directorio Geronimo <geronimo_home>/bin:
For more information on the commands and options supported by the deploy tool,
java -jar deployer.jar help [comando]
Como alternativa a la activación mediante línea de comandos, puede copiar
módulos de aplicación al directorio <geronimo_home>/deploy/ y el servicio de
activación de Geronimo, le iniciará de forma automática.
El activador de línea de comandos tiene algunas ventajas, ya que depliega
cualquier error de activación en su propia consola, en lugar de sólo la
bitácora del servidor.
Además, puede activar aplicaciones y recursos desde modo gráfico mediante
la Consola de Administración de Geronimo, disponible en:
http://localhost:8080/console/
______________________
Soporte
======================
Cualquier problema con este lanzamiento puede ser reportado en
la lista de correo Geronimo ó en la lista Jira de pendientes.
Lista de correo:
http://mail-archives.apache.org/mod_mbox/geronimo-user/
Suscripción a la lista de correo:
user-subscribe@geronimo.apache.org
Jira:
http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10220
---------------------------------------
Notice Regarding Cryptographic Software
=======================================
This distribution includes cryptographic software. The country in
which you currently reside may have restrictions on the import,
possession, use, and/or re-export to another country, of
encryption software. BEFORE using any encryption software, please
check your country's laws, regulations and policies concerning the
import, possession, or use, and re-export of encryption software, to
see if this is permitted. See <http://www.wassenaar.org/> for more
information.
The U.S. Government Department of Commerce, Bureau of Industry and
Security (BIS), has classified this software as Export Commodity
Control Number (ECCN) 5D002.C.1, which includes information security
software using or performing cryptographic functions with asymmetric
algorithms. The form and manner of this Apache Software Foundation
distribution makes it eligible for export under the License Exception
ENC Technology Software Unrestricted (TSU) exception (see the BIS
Export Administration Regulations, Section 740.13) for both object
code and source code.
The following provides more details on the included cryptographic
software:
Software related to cryptographic functionality is located in
an artifcact referred to as geronimo-util. The source code for
this functionality can be reviewed at:
http://svn.apache.org/repos/asf/geronimo/server/
The URL above is a reference to the Apache Geronimo Server source
tree for all development (and released) source trees.