3.2. Installation Procedure

3.2. Installation Procedure
	Chapter 3. Installing Geronimo [DRAFT (1.1)]

The most expedient way to install a milestone release of Geronimo is to download and unpack the .zip or .tar.gz file. No additional steps are necessary, and you will get a default, working configuration out of the box.

3.2.1. Windows Installation

On Windows platforms, use a tool like WinZip to open the .zip file and extract the Geronimo files. This will create a new geronimo-1.1/ subdirectory containing all the Geronimo files.

Warning

	Warning
Geronimo includes files with long paths and names, and Windows limits all files to a total path length of 255 characters. This means it's safest to install Geronimo into a directory with a very short path name. For example, it would be best to use a path like `C:\geronimo-1.1` instead of a longer path (like `C:\Program Files\Application Servers\Geronimo 1.1`). If there are errors while unzipping the Geronimo distribution, try installing it to a directory with a shorter path name.

Geronimo includes files with long paths and names, and Windows limits all files to a total path length of 255 characters. This means it's safest to install Geronimo into a directory with a very short path name. For example, it would be best to use a path like C:\geronimo-1.1 instead of a longer path (like C:\Program Files\Application Servers\Geronimo 1.1). If there are errors while unzipping the Geronimo distribution, try installing it to a directory with a shorter path name.

3.2.2. Mac/Linux/UNIX Installation

On these platforms, use the UNIX tar tool to open the .tar.gz file and extract the Geronimo files. This will create a new geronimo-1.1/ subdirectory containing all the Geronimo files. For example:

> tar -xzvf geronimo-jetty-j2ee-1.1.tar.gz

geronimo-1.1/
geronimo-1.1/bin/
geronimo-1.1/docs/
geronimo-1.1/lib/
...


Chapter 3. Installing Geronimo [DRAFT (1.1)]		3.3. Installation Results