Introduction
This document describes how to install and configure ServiceMix 1.x.
Pre-Installation Requirements
Hardware:
- 13 MB of disk space for the ServiceMix 1.x downloadable bundle.
Operating Systems:
- Windows: Windows XP, Windows NT.
- Unix: AIX, HP-UX, Solaris, Linux, any platform that supports Java.
Environment:
- Java Developer Kit (JDK) of 1.4.x or greater
- Maven XX (needed when installing source or developer's releases).
- The JAVA_HOME environment variable must be set.
Installation Procedure For Windows
Binary Installation:
This procedure explains how to download and install the binary distribution on a Windows system.
- In a browser, go to www.servicemix.org
- Click on the Download link in the left pane.
- From this page, click on link in the "Latest Releases" section.
- Scroll down to select the version to download. For a binary distribution the filename will be similar to:
servicemix-x.x.x.zip
. - Extract the files from the zip file into a directory of your choice.
- Proceed to the Getting Started#starting section of this document.
Source Installation:
This procedure explains how to download and install the source distribution on a Windows system.
- In a browser, go to www.servicemix.org
- Click on the Download link in the left pane.
- From this page, click on link in the "Latest Releases" section.
- Scroll down to select the version to download. For a binary distribution the filename will be similar to:
servicemix-x.x.x-src.zip
. - Extract the files from the zip file into a directory of your choice.
- cd blah and maven something, ????
- Proceed to the "Starting ServiceMix" section of this document.
Developer's Releases:
Installation Procedure For Unix
Binary Installation:
This procedure explains how to download and install the binary distribution on a Windows system.
- In a browser, go to www.servicemix.org
- Click on the Download link in the left pane.
- From this page, click on link in the "Latest Releases" section.
- Scroll down to select the version to download. For a binary distribution the filename will be similar to:
servicemix-x.x.x.zip
. - Extract the files from the zip file into a directory of your choice.
Source Installation:
This procedure explains how to download and install the source distribution on a Windows system.
- In a browser, go to www.servicemix.org
- Click on the Download link in the left pane.
- From this page, click on link in the "Latest Releases" section.
- Scroll down to select the version to download. For a binary distribution the filename will be similar to:
servicemix-x.x.x-src.zip
. - Extract the files from the zip file into a directory of your choice.
- cd blah and maven something, ????
Starting ServiceMix
On Windows:
From a console window, change to the installation directory and run the servicemix
program:
cd [install_dir]\bin
where install_dir
is the directory in which ServiceMix was installed, e.g., c:\Program Files\servicemix-1.x
.
Then type:
servicemix
On Unix:
From a command shell, change to the installation directory and run the servicemix
program:
cd [install_dir]/bin
where install_dir
is the directory in which ServiceMix was installed, e.g., /usr/local/servicemix-1.x
.
Then type:
servicemix or servicemix &
Warning
Do NOT close the Window's console or Unix command shell (unless servicemix was started in the background) in which ServiceMix was started as that will terminate ServiceMix.
Stopping ServiceMix
To terminate ServiceMix type "CTRL-C" in the command shell in which it is running and answer "y" to the "Terminate batch job (y/n)?" question.
Testing the Installation
The console window will display the following log line if ServiceMix is up and running without any problems:
[INFO] JBIContainer -- ServiceMix JBI Container <http://servicemix.org/> name: defaultJBI running version: null
ServiceMix's default port is 1099. From another console window run netstat and look for port 1099.
Windows Installation:
From a windows console type:
netstat -an|more
Unix Installation:
From a Unix command shelltype:
netstat -an|grep 1099