====================================================== Apache Geronimo milestone build M4 (August 10, 2005) http://geronimo.apache.org/ ------------------------------------------------------ ___________________ Documentation =================== This README serves as five minute overview of Geronimo, but better documentation can be found here: - http://geronimo.apache.org/documentation.html ___________________ Release Notes =================== Please read the RELEASE_NOTES for a complete list of things that are not yet functional. We wrote those up to save you time trying to get things to work we know are not implemented. ___________________ Installation =================== If you've downloaded and unpacked a binary distribution of Geronimo, then you are finished with installation. You can also use the installer JAR to customize things like network ports and the administrative login during installation. ___________________ Geronimo Home =================== The GERONIMO_HOME directory, is the directory where the Geronimo binary was unpacked or the it is the 'target' directory created by Maven from a source distribution. If you unpacked the binary into the directory C:\geronimo, for example, than this directory is your GERONIMO_HOME directory. The GERONIMO_HOME directory is referred to in various parts of the documentation, so it's good to remember where it is. ___________________ Starting =================== The main server class is also packed in an executable jar, bin/server.jar, and can be ran in a way similar to the deploy tool. C:\geronimo> java -jar bin\server.jar Once the server has started, you can access the welcome page by pointing your browser to: http://localhost:8080/ You can also visit the web management console at: http://localhost:8080/console/ To access the console, use the administrative account, which is username "system" and password "manager" by default. ___________________ Deploying =================== The Geronimo deployment tool is packaged in the executable jar bin/deployer.jar under the GERONIMO_HOME and can be executed like this (assuming the server is already running): C:\geronimo> java -jar bin\deployer.jar deploy myDataSource.rar C:\geronimo> java -jar bin\deployer.jar deploy myEJB.jar C:\geronimo> java -jar bin\deployer.jar deploy myWebapp.war C:\geronimo> java -jar bin\deployer.jar deploy myApp.ear Notice that the deployer.jar is capable of handling a number of different archive types; rar, war, ejb jar, and EAR. The deployer will prompt you for a username and password; the default administrative account has username "system" and password "manager". ___________________ Support =================== Any problems with this release can be reported to the Geronimo mailing list or Jira issue tracker. Mailing list archive: http://mail-archives.apache.org/mod_mbox/geronimo-user/ Mailing list subscription: user-subscribe@geronimo.apache.org Jira: http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10220