HomeApache Geronimo v2.0 > Documentation > RELEASE-NOTES-2.0-M1.TXT
Release Notes -- Apache Geronimo -- Version 2.0 - Milestone 1

Geronimo URLs
-------------
Home Page:     http://geronimo.apache.org/
Downloads:     http://geronimo.apache.org/downloads.html
Documentation: http://geronimo.apache.org/documentation.html
Mailing Lists: http://geronimo.apache.org/mailing.html
Source Code:   http://geronimo.apache.org/svn.html
Bug Tracking:  http://issues.apache.org/jira/browse/GERONIMO
Wiki:          http://cwiki.apache.org/geronimo


IMPORTANT
---------
This is a Milestone release, that means that is not the final version of
Apache Geronimo v2.0 Take a look at "Known Issues and Limitations" section for
furhter details.


System Requirements
-------------------
You need a platform that supports the Sun JDK 5.0+ (J2SE 1.5.0+).

Most testing has been done on Linux, Mac OS X, and Windows.


Significant Changes in the 2.0 Release
--------------------------------------
Apache Geronimo v2.0 includes the following features:

- Full Sun JDK 5.0+ (J2SE 1.5.0+)
- Servlet 2.5 (Tomcat)
- JSP 2.1 (Tomcat)
- JSP Debug 1.0 (Tomcat)
- Servlet 2.5 (Jetty)
- JSP 2.1 (Jetty - via Jasper)
- JSP Debug 1.0 (Jetty)
- JSF 1.2
- JSTL 1.2
- Common Annotations 1.0
- JAF 1.1
- JavaMail 1.4
- EJB 3.0 (JPA only)
- JTA 1.1
- JMS 1.1
- JACC 1.1


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

If you wish to modify the default ports that Geronimo will use, edit the file 
<geronimo_home>/var/config/config.xml

Geronimo comes with batch and script files to control server start and stop 
functions.  To see usage examples simply type geronimo.bat or geronimo.sh 
command as appropriate for your platform.  It is necessary to set JAVA_HOME to 
the copy of your Sun 5 JDK/JRE prior to executing the command.  

Here is an example to set JAVA_HOME:

export JAVA_HOME=<JDK/JRE_home>

To see the available command options type:

<geronimo_home>/bin/geronimo.sh
or
<geronimo_home>/bin/geronimo.bat

The command will display help text instructing you as to how to start and stop 
the Geronimo server.

If you prefer to start the server without a script file you can simply type: 

java -jar <geronimo_home>/bin/server.jar

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".


Administration Console Security Configuration
---------------------------------------------
The default administration user/password for the Geronimo Administration Console 
and 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/users.properties and 
<geronimo_home>/var/security/groups.properties files.


Deploying Applications
----------------------
Geronimo comes with deploy scripts and batch files to deploy J2EE modules or 
applications. You can use the scripts or simply invoke the executable jar by 
running the following command (note that you need to start Geronimo first):

<geronimo_home>/bin/java -jar deployer.jar deploy my-web-app.war [deploy plan]

You will need to use the username "system" and password "manager" unless you 
customized those during the install process.  The deployment plan argument is 
optional -- you can pack a deployment plan into the application module, provide
it on the command line, or in some cases omit it entirely.

You can also use the "Login" command once and avoid to enter user name and 
password every time you use the deploy tool

For more information on the commands and options supported by the deploy tool,
run from within the Geronimo directory <geronimo_home>/bin:

java -jar deployer.jar help [command]

You can also graphically deploy applications and resources via the Geronimo 
Administration Console available at http://localhost:8080/console/


Other Deployment Options
------------------------
As an alternative to the command-line deployer, you can copy application 
modules into the <geronimo_home>/deploy/ directory and the
hot deployer service will deploy them automatically.  The command-line deployer
has some advantages, as it will output any
deployment errors to its own console rather than just the server log.

Additionally, Geronimo provides a Maven plugin that can deploy applications to 
Geronimo as part of a Maven build.


Configuration
-------------
Most configuration attributes can be updated in the 
<geronimo_home>/var/config/config.xml file.  The attributes most likely to be 
changed are already included in the supplied config.xml file, while others may
need to be added manually.


Certification Status
--------------------
Apache Geronimo v2.0-M1, being a MILESTONE release is not a certified yet certified.


Known Issues and Limitations
----------------------------

<!-- open Bugs for 1.2 + 2.*  -->

     * GERONIMO-2657	Persistence-* builders need improvements
     * GERONIMO-2644	Fix leaking ClassLoaders
     * GERONIMO-2643	Stack trace (due to amq) while shutting down Geronimo
     * GERONIMO-2642	welcome app not included in the jetty assembly.
     * GERONIMO-2622	Implement PolicyContextHandlerSOAPMessage
     * GERONIMO-2605	NPE if exporting plugin for module having dependency on module with no groupId
     * GERONIMO-2598	Deploy tool prints useless message if configuration start fails
     * GERONIMO-2551	Plugin hits NPE if maven-metadata listed artifact doesn't exist or JAR artifact maven-metadata doesn't exist
     * GERONIMO-2534	Security realms portlet should validate the realm-name for duplicate name
     * GERONIMO-2491	Hibernate passes connections between servlets which we don't support
     * GERONIMO-2481	WebServers portlet: Create/Edit Tomcat Connectors should support editing of all supported connector attributes
     * GERONIMO-2480	Plugin installer status sticks on "Searching for X at Y" while downloading
     * GERONIMO-2416	ProxyMethodInterceptor should work with classes that have start,stop methods
     * GERONIMO-2290	Percent complete goes over 100% when installing configurations
     * GERONIMO-2289	GeronimoAsMavenServlet.java generates wrong default-repository element
     * GERONIMO-2288	Abstract/Maven repositories install modules incorrectly
     * GERONIMO-2286	app client plan still uses Strings for dependency Module IDs
     * GERONIMO-2283	Common libs portlet guesses wrong group ID, gives no usage advice
     * GERONIMO-2246	Why resource-env-ref:admin-object-module?
     * GERONIMO-2082	[m2] stax dependencies are all wrong
     * GERONIMO-2028	Plugin export errors don't stop process, but cause it to fail much later
     * GERONIMO-2025	Undeploy and redeploy with no version leaves dangling entries in config.xml
     * GERONIMO-1917	repository doesn't deal well with case insensitive file systems
     * GERONIMO-1786	JMS Listeners for protocols activeio, peer and openwire fail to start
     * GERONIMO-1761	Change geronimo-util module to geronimo-crypto, give credit where credit is due
     * GERONIMO-1631	NoSuchConfigException when restarting app after undeploying
     * GERONIMO-1285	Deployer does not list all modules that have been stopped
     * GERONIMO-603	IllegalArgumentException when deploying WebApp containing a url-pattern of /* in security-constraint
     * GERONIMO-268	Connection Error handling problems
     * GERONIMO-250	Connector tries to commit after connection error


Specific Issues, Features and Improvements fixed in Version 2.0-M1
------------------------------------------------------------------
Release Notes - Geronimo - Version 2.0-M1

<!-- closed JIRAs  for 2.*  -->

** Bug
     * GERONIMO-2592	TSSLink doStart() method is not getting called.
     * GERONIMO-2630	sun j2ee schemas are being redistributed in jsp and servlet specs
     * GERONIMO-1135	Keystore password in System.properties
     * GERONIMO-2522	Hot deployer makes app hangs
     * GERONIMO-2402	Redeployment fails after third iteration.
     * GERONIMO-2646	WAR without a geronimo-web.xml deploys to the wrong context
     * GERONIMO-2560	Realm added using SecurityRealm portlet does not work
     * GERONIMO-1657	CommandSupport doesn't bubble up the exception. Prints stacktrace.
     * GERONIMO-2236	keystore portlet - providing a null or incorrect password on edit unlock can only be recovered with server recycle
     * GERONIMO-2350	CertificateChainCallbackHandler willfully conceals causes of failure
     * GERONIMO-2363	Console: create new pool using wizard, cannot use "show plan" button for any XA database, even derby
     * GERONIMO-2458	MapEditor does not work
     * GERONIMO-2459	Connector deployer needs to add dependency to j2ee-server for J2EEServer gbean reference
     * GERONIMO-2479	j2ee remote ejb clients should look for "localhost" not 0.0.0.0 by default
     * GERONIMO-2533	Password setup forms should use a confirmation field
     * GERONIMO-2548	GBeanInfo should exclude attributes and operations of java.lang.Object class
     * GERONIMO-2549	NullPointerException: CommandListConfigurations
     * GERONIMO-2559	cannot stop activemq via kernel shutdown
     * GERONIMO-2566	Creating new listeners for ActiveMQ from JMS Server portlet fails
     * GERONIMO-2580	CorbaRefBuilder inserts ref for java:comp/CORBA that fails when corba gbean is not present.
     * GERONIMO-2584	Hot deploy module/server restart, throws IllegalArgumentException if application deployed using hotdeployment
     * GERONIMO-2585	KeystorePortlet: Lock keystore throws NullPointerException
     * GERONIMO-2586	KeystorePortlet: Unlock keystore for availability shows key aliases only when keystore is unlocked for edit
     * GERONIMO-2587	FileKeystoreInstance.loadKeystoreData() results in inconsistent state if wrong password is supplied
     * GERONIMO-2588	KeyStorePortlet: Locking and unlocking could use some error and info messages
     * GERONIMO-2591	Database Pools portlet: Create new pool dependency jar selection problems
     * GERONIMO-2602	default compile scope is overloaded with 2 meanings in PlanProcessorMojo
     * GERONIMO-2603	Building 1.2 if there are 2.0 artifacts in the repo results in mostly 2.0 artifacts in the server.
     * GERONIMO-2611	Configuration should not have duplicates in allServiceParents
     * GERONIMO-2615	Not enough info when a gbean ref can't be verified during deployment
     * GERONIMO-2623	Infinite loop in the SMTPTransport code when a socket factory class is used.
     * GERONIMO-2624	Offline deployer busted
     * GERONIMO-2625	Geronimo Console: login page prevents using username, password longer than 25 characters for login
     * GERONIMO-2627	jsr88 classpath is all messed up
     * GERONIMO-2631	jetty5 builder needs to parameterize the jsp servlet class
     * GERONIMO-2632	Connection errors can result in infinite loop
     * GERONIMO-2456	NOTICE.txt is missing some notices added during 1.1.1 development
     * GERONIMO-2377	deploying a new datasource with the same name does not indicate any problem in the console
     * GERONIMO-2652	XmlBeans is having trouble validating some xml from substitution groups
     * GERONIMO-2555	Windows scripts don't work when used from different drive
     * GERONIMO-2656	for jetty, in servlet-mapping, url patterns must be trimmed.
     * GERONIMO-2437	Empty dirs and config.xml entries left behind after undeploy
     * GERONIMO-2599	deploying RAR leads to message that Geronimo can't find web.xml
     * GERONIMO-2619	Javamail 1.4 spec needs to be using the JAF 1.1 version.
     * GERONIMO-1982	server try to deploy the modules in hot deployment directory again during server startup
     * GERONIMO-1519	ResourceException.toString() can return null
     * GERONIMO-646	Servlet calling HttpServletRequest.isUserInRole(null) causes NPE using Jetty container

** Improvement
     * GERONIMO-931	Rename administrative security realm
     * GERONIMO-1396	Provide consistent look and feel for table views in the web console across all portlets
     * GERONIMO-1880	To Allow configurable password digests during REALM Deployment.
     * GERONIMO-2392	Too hard to tell why a gbean doesn't start
     * GERONIMO-2499	Generalize NamingBuilder so it can handle more than just jndi building
     * GERONIMO-2589	Generate explicit-versions.properties transitvily
     * GERONIMO-2597	Make web service builder optional
     * GERONIMO-2604	Create a specs pom
     * GERONIMO-2608	JACC 1.1 support (jsr-115 MR4)
     * GERONIMO-2634	Switch to activemq 4.1.0-incubator: include apache incubator repo in our repo list.
     * GERONIMO-2616	Move jee5 work from sandbox to trunk

** New Feature
     * GERONIMO-2460	JPA container managed persistence support
     * GERONIMO-2636	Update Jetty 6 assembly to use Jasper 6 for JSP 2.1 support
     * GERONIMO-2536	Support Java EE 5 JavaServerPages Standard Tag Library in Geronimo (JSTL, JSR 52)
     * GERONIMO-2535	Support Java EE 5 Common Annotation Spec in Geronimo (JSR 250)

** Task
     * GERONIMO-2537	All Geronimo source files must be brought in line with the new ASF source header and copyright notice policy
     * GERONIMO-2601	Remove the "Old Keystore" portlet
     * GERONIMO-2639	Upgrade dojo to 0.4.1

** Sub Task
     * GERONIMO-1722	"GERONIMO-851 Module migration to Maven 2: activemq-embedded-rar"

** Test
     * GERONIMO-2620	Need to create javamail 1.4 versions of the provider and mail jars