To start this tutorial, we are going to install a standalone ServiceMix instance on our machine.
Introduction
There are several ways to get ServiceMix up and running on your machine. The easiest way however is by downloading the distribution and installing it on you local machine.
Prerequisites
Although this installation path is the fastest one, still you will need to install some software before installing ServiceMix.
J2SE 1.5
ServiceMix requires a Java 5 environment to run. Refer to http://java.sun.com for details on how to download and install J2SE 1.5.
Download binaries
Depending on the platform you plan to install and run Apache ServiceMix you will select the appropriate installation image. Open a Web browser and access the following URL, there you will find the available packages for download (binaries and source code).
http://servicemix.apache.org/download.html
Select the file compression format compatible with your system (zip, tar.gz) by clicking directly on the link, download it and expand the binary to your hard drive in a new directory; for example in z:\servicemix
- from now on this directory will be referenced as <servicemix_home>. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
The installation of Apache ServiceMix is as simple as uncompressing the .zip or .tar files. The next step is to start the server.
Some conventions
For the remainder of this tutorial
- <servicemix_home> refers to the directory where you have extracted the ServiceMix distribution
- <version> refers to the version of ServiceMix you have installed (e.g. 3.1.1-INCUBATING)
Further reading
- Building ServiceMix from source.
- This page contains an overview of the directories that have been extracted.