geronimo-scm mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ammul...@apache.org
Subject svn commit: r216087 - in /geronimo/branches/v1_0_M4-QA: BUILDING.txt NOTICE.txt PROPOSAL.txt README.txt STATUS
Date Wed, 13 Jul 2005 01:55:05 GMT
Author: ammulder
Date: Tue Jul 12 18:55:04 2005
New Revision: 216087

URL: http://svn.apache.org/viewcvs?rev=216087&view=rev
Log:
Basic documentation updates for M4

Removed:
    geronimo/branches/v1_0_M4-QA/NOTICE.txt
    geronimo/branches/v1_0_M4-QA/PROPOSAL.txt
    geronimo/branches/v1_0_M4-QA/STATUS
Modified:
    geronimo/branches/v1_0_M4-QA/BUILDING.txt
    geronimo/branches/v1_0_M4-QA/README.txt

Modified: geronimo/branches/v1_0_M4-QA/BUILDING.txt
URL: http://svn.apache.org/viewcvs/geronimo/branches/v1_0_M4-QA/BUILDING.txt?rev=216087&r1=216086&r2=216087&view=diff
==============================================================================
--- geronimo/branches/v1_0_M4-QA/BUILDING.txt (original)
+++ geronimo/branches/v1_0_M4-QA/BUILDING.txt Tue Jul 12 18:55:04 2005
@@ -1,12 +1,13 @@
 Welcome to Geronimo
 ===================
 
-To build me please install Maven from here - version 1.0.2 or later.
+To build me please install Maven (version 1.0.2 or later) from:
 
 	http://maven.apache.org/
 
 In addition you should have JDK 1.4.x installed with JAVA_HOME
-environment defined to point to this JDK.
+environment defined to point to this JDK.  The current build of
+Geronimo is known to have problems under JDK 1.5.x.
 
 In the following examples, '$>' is your prompt, so if you see 
 '$> maven', at your prompt, type in 'maven' (without the quotes) 

Modified: geronimo/branches/v1_0_M4-QA/README.txt
URL: http://svn.apache.org/viewcvs/geronimo/branches/v1_0_M4-QA/README.txt?rev=216087&r1=216086&r2=216087&view=diff
==============================================================================
--- geronimo/branches/v1_0_M4-QA/README.txt (original)
+++ geronimo/branches/v1_0_M4-QA/README.txt Tue Jul 12 18:55:04 2005
@@ -1,5 +1,5 @@
 ======================================================
-Apache Geronimo milestone build M3  (Nov 10, 2004)
+Apache Geronimo milestone build M4  (July, 2005)
 
 http://geronimo.apache.org/
 ------------------------------------------------------
@@ -22,18 +22,30 @@
  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.  Note that the source
- distribution is provided for reference purposes, but you may not
- actually be able to build a working server from it -- it refers to
- snapshot versions of some third-party libraries which might have
- changed since the time M3 was originally built.
-
+ If you've downloaded and unpacked a .zip or .tar.gz binary
+ distribution of Geronimo, then you are finished with installation.
+ These distributions are quite easy to install, but do not allow you
+ to customize the server configuration (such as by changing listen
+ ports).
+ 
+ There is also an installer package available.  This is an executable
+ JAR that you run to start the install routine.  This package lets
+ you customize ports and the default administrative login during the
+ installation process.
+ 
+___________________
+Source Code
+===================
+ 
+ Note that the source distribution is provided for reference purposes,
+ but you may not actually be able to build a working server from it --
+ it refers to snapshot versions of some third-party libraries which
+ might have changed since the time M4 was originally built.  We are
+ attempting to resolve this for future releases.
  
 ___________________
 Geronimo Home
@@ -48,7 +60,6 @@
  The GERONIMO_HOME directory is referred to in various parts of the
  documentation, so it's good to remember where it is.
 
-
 ___________________
 Deploying
 ===================
@@ -62,13 +73,12 @@
    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".
 
+ Notice that the deployer.jar is capable of handling a number of
+ different archive types; rar, war, ejb jar, and EAR.
 
 ___________________
 Starting
@@ -85,6 +95,9 @@
    c:\geronimo> java -jar bin\deployer.jar start \
                           org/apache/geronimo/DebugConsole
 
+ Again, this will prompt you for a username and password, which
+ default to "system" and "manager", respectively.
+
  Then you can access the debug console by pointing your browser to:
 
    http://localhost:8080/debug-tool/
@@ -97,19 +110,37 @@
  So, no matter what operating system you're on, the URI will always look
  similar to the one above.
 
-
+___________________
+Startup/Log Output
+===================
+ 
+ By default, the server provides a progress indicator while it starts,
+ and generally does not provide very detailed output to the console.  If
+ you'd like more detailed output, you can start the server with a
+ command like this:
+ 
+   C:\geronimo> java -jar bin\server.jar -v      (show INFO to console)
+   C:\geronimo> java -jar bin\server.jar -vv     (show DEBUG to console)
+   
+ Note that all DEBUG and higher out will be saved to the log file
+ $GERONIMO_HOME/var/log/geronimo.log in any case -- the switches above
+ just alter the console output.
+ 
+ You may also suppress the progress bar without altering the default
+ console log level (WARN) by using the -quiet flag on the command line.
+  
 ___________________
 Support
 ===================
  
  Any problems with this release can be reported to the Geronimo
- mailing list or Jira issue tracker.
+ user mailing list or Jira issue tracker.
 
  Mailing list archive:
- http://nagoya.apache.org/eyebrowse/SummarizeList?listId=140
+ http://mail-archives.apache.org/mod_mbox/geronimo-user/
 
  Mailing list subscription:
- dev-subscribe@geronimo.apache.org
+ user-subscribe@geronimo.apache.org
 
  Jira:
  http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10220 



Mime
View raw message