geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Joe Bohn <>
Subject README.txt for 2.1.2
Date Wed, 23 Jul 2008 16:53:46 GMT
This is the current content of the README.txt for 2.1.2 for your review. 
    Are we missing anything?


Apache Geronimo v2.1.2  (July 31, 2008)

Release Notes

  Please read the RELEASE_NOTES-2.1.2.txt for a complete list of new 
  available in this release.


  This README serves as quick introduction to Geronimo. More complete 
  can be found here:


Installing Geronimo

  To install Geronimo, simply unpack the .zip (Windows) or tar.gz (Unix) 
file containing

  Note for Windows platforms:
  The maximum path length for a directory path is 255 characters. Installing
  Geronimo into a long directory path may cause the installation or 
server start up to fail.
  It is recommended that you use a short directory name, such as "c:\g\".

Starting Geronimo

  There are three general techniques for starting Geronimo (assuming the 
current directory
  is <geronimo_home>):

  1. GShell -- "./bin/gsh geronimo/start-server"
  2. Script -- "./bin/ run" (Must first set the JRE_HOME or 
JAVA_HOME environment variable)
  3. Java   -- "java 
-Djava.ext.dirs=%JRE_HOME%/lib/ext:lib/ext -javaagent:bin/jpa.jar -jar 

Additional information on command environments can be found below.

Application Deployment

  Applications can be deployed to a Geronimo server in several ways:

  1. Administrative command scripts -- "./bin/gsh deploy/deploy 
MyApp.war MyDeploymentPlan.xml"
  2. Administrative console -- login to the admin console and click 
"Deploy New" under Applications
  3. Hot deploy -- copy your archive(s) into the 
"<geronimo-home>/deploy" directory. The
     hot deploy service will automatically deploy these artifacts.
  4. maven -- applications can be installed as part of a maven build

  When you deploy an application using an administrative command, you 
will need
  to supply an administrator's username/password. If you do not specify 
the username
  and password, you will be prompted for them.


  Commonly modified configuration parameters, such as port numbers, can 
be set by
  editing the file:


  Additional configuration attributes can be updated in the file:


  Note: The server must not be running when these files are modified.

  Once the server has started, you can access the Geronimo 
Administration Console
  at http://localhost:8080/console/ . The default user name is "system" 
and the
  default password is "manager".

Security Configuration

  The default administration user/password for the Geronimo 
Administration Console
  and command line deployment tool is system/manager.  You can change 
these defaults
  directly from the Geronimo Administration Console by accessing 
Security -> Console
  Realm and change the user name and password from the Console Realm 
Users portlet.

  As an alternative, you can make the same changes by editing the
  <geronimo_home>/var/security/ and
  <geronimo_home>/var/security/ files.

  Access to the var/security directory should be appropriately secured 
on systems where
  you install Geronimo.

  Passwords in are encrypted by the server. Passwords 
can be changed
  using the Geronimo Administration Console. They can also be changed 
using a text
  editor. While the server is stopped, simply edit the 
file. The
  password(s) will be encrypted the next time the server is started.

  To prevent potential security exposures, we strongly recommend you 
update the
  default user names and passwords on your system.


  Geronimo provides a command shell environment for executing commands, 
called GShell.

  To start a GShell environment, from the <geronimo_home> directory, 
execute "./bin/gsh" (unix)
  or "bin\gsh" (windows). This will start a GShell command environment. 
 From here,
  you can execute Geronimo administrative commands as well as general 
GShell commands.
  Alternatively, you can invoke a GShell command at the same time that 
you invoke gsh, for

    ./bin/gsh geronimo/stop-server

  A list of common gsh commands are:


  Usage information for any command can be obtained by using the --help 
option. For example:

    geronimo/start-server --help

  For more information on GShell and GShell commands, see the Geronimo 
2.1 documentation.


  Geronimo provides a number of .sh or .bat scripts that can be used to 
administer Geronimo
  servers. To use most of these scripts, you must first set either the 
  or JRE_HOME environment variable:

    export JAVA_HOME=<path-to-JDK>
    export JRE_HOME=<path-to-JRE>

  Unix scripts provided by Geronimo (there are .bat equivalents): -- used to start and stop servers; either as a 
foreground or background process. -- start a Geronimo server running as a background process -- stop a running Geronimo server -- deploy, list, and undeploy plugins and applications -- used to generate wsdl from java code or java code 
from wsdl

  For example, "./bin/ list-modules"

  The and scripts have multiple sub-commands. 
Executing the scripts without
  any arguments will generate usage information. Executing "help 
<sub-command>" will generate
  usage information for that particular command.


  Any problems with this release can be reported to the Geronimo user 
mailing list
  or Jira issue tracker.

  Mailing list archive:

  User mailing list:

  User mailing list subscription:


  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 <> for more

  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 related to cryptographic functionality is located in
    an artifcact referred to as geronimo-util.  The source code for
    this functionality can be reviewed at:

    The URL above is a reference to the Apache Geronimo Server source
    tree for all development (and released) source trees.

View raw message