Introduction
This document describes how to install and configure ServiceMix 1.x.
Pre-Installation Requirements
Hardware:
- 36 MB of disk space for the ServiceMix 1.x binary download.
- 13 MB of disk space for the ServiceMix 1.x source download.
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
- The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g.
c:\Program Files\jsdk.1.4.2-09
. - Maven 1.0.2 or greater (needed when installing source or developer's releases).
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 #Starting ServiceMix 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.
- Change into the ServiceMix directory and build it.
The preferred method of building ServiceMix is the following: cd \[servicemix_install_dir] where [servicemix_install_dir] is the directory in which ServiceMix was installed. maven clean test If the above build fails on some tests, do this: cd \[servicemix_install_dir] maven m:clean maven -Dmaven.test.skip=true
- Start servicemix from the target directory:
cd \[servicemix_install_dir]\target\servicemix-1.0\bin\servicemix-1.0\bin servicemix
- Proceed to #Testing the Installation section.
Developer's Releases:
This procedure explains how to download and install the latest developer's snapshot.
- In a browser, go to www.servicemix.org.
- Click on the Download link in the left pane.
- From this page, click on the "Development releases can be found here" link.
- Select the version of ServiceMix to download.
- Extract the files from the zip file into a directory of your choice.
- If a binary snapshot was downloaded proceed to the #Starting ServiceMix section of this document. If a source snapshot was downloaded proceed to #building source. Following that test the installation.
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 \[servicemix_install_dir]\bin
where servicemix_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 \[servicemix_install_dir]/bin
where servicemix_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 console or shell in which ServiceMix was started as that will terminate ServiceMix (unless ServiceMix was started in the background).
Testing the Installation
The console window/command shell will display something similar to 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 window run netstat and look for port 1099.
Windows Installation:
From a Windows console, type:
netstat -an|find "1099"
Unix Installation:
From a Unix command shell, type:
netstat -an|grep 1099
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.