Chapter 3. Installing Geronimo [DRAFT (M4)]

Table of Contents

3.1. Platforms & Prerequisites
3.2. Quick Start Installation Procedure
3.3. Custom Installation Procedure
3.4. Automated Installation Procedure
3.5. Installation Results
3.6. Starting the Server
3.6.1. Startup Options
3.6.2. Troubleshooting Startup Problems
3.7. Stopping the Server
3.8. Running Geronimo as a Windows or UNIX Service

There are three methods for installing Geronimo. The quick start approach is fast and easy, but does not give you the opportunity to customize the installation. The install package is a traditional wizard-style installer, and it gives you more customization options during the install, at the cost of a somewhat more involved process. Finally, the automated install can be used to repeat an identical installation on a different machine, with no interaction required. Any of these approaches will result in a working server, so it's mainly a matter of whether you find the default network ports to be suitable and whether the automated install would be beneficial.


This chapter assumes you have downloaded a milestone release of Geronimo. If not, please see Chapter 2, Acquiring Geronimo & Quick Start [DRAFT (1.0)].

3.1. Platforms & Prerequisites

Geronimo is a pure-Java product, and should therefore run on any platform with the appropriate Java Virtual Machine.

As Geronimo implements J2EE 1.4, and J2EE 1.4 requires J2SE 1.4, Geronimo will run under Java 1.4 or higher. However, the CORBA features currently used by Geronimo require a Sun 1.4.x JVM. That means the best option for Geronimo is currently the Sun 1.4.2 JVM. Broader compatibility with other JVM vendors and versions is a goal for future releases.

As far as operating systems go, Geronimo has been successfully run on:

  • Windows 2000, XP, and 2003

  • Linux x86 (Debian, Red Hat, SuSE, Mandrake, and Gentoo)

  • Linux x86_64 (SuSE)

  • Mac OS X

  • Solaris 8

  • HP-UX 11.0

Geronimo requires a Java compiler in order to handle JSP compilation. That means that in most cases a full Java Development Kit is required, though in special circumstances (with pre-compiled JSPs, no JSPs at all, or a third-party compiler) it can be run on a Java Runtime Environment instead. The next milestone release should eliminate this requirement by switching to a bundled compiler.


Geronimo itself can run on a headless machine (that is, a server with no windowing system or GUI available, such as some UNIX machines). In many cases, even applications dealing with printing and graphics can be run by starting Geronimo with the -Djava.awt.headless=true option. However, certain rare applications may require a working X-Windows environment to run (or at least a simulated environment such as can be provided by xvfb).