Getting Started Guide

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 SP2, Windows 2000
• Unix: AIX, HP-UX, Solaris, Ubuntu Linux, Powerdog Linux, MacOS, 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.

1. In a browser, go to www.servicemix.org.
2. Click on the Download link in the left pane.
3. From this page, click on link in the "Latest Releases" section.
4. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
   servicemix-x.x.x.zip.
5. Extract the files from the zip file into a directory of your choice.
6. Proceed to the #Starting ServiceMix section of this document.
7. Following start-up, go to #Testing the Installation.

Source Installation:
This procedure explains how to download and install the source distribution on a Windows system.

1. In a browser, go to www.servicemix.org.
2. Click on the Download link in the left pane.
3. From this page, click on link in the "Latest Releases" section.
4. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
   servicemix-x.x.x-src.zip.
5. Extract the files from the zip file into a directory of your choice.
6. 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
   
   

7. Start servicemix from the target directory:

   cd \[servicemix_install_dir]\target\servicemix-1.0\bin\servicemix-1.0\bin
   servicemix
   

8. Proceed to #Testing the Installation section.

Developer's Releases:
This procedure explains how to download and install the latest developer's snapshot.

1. In a browser, go to www.servicemix.org.
2. Click on the Download link in the left pane.
3. From this page, click on the "Development releases can be found here" link.
4. Select the version of ServiceMix to download.
5. Extract the files from the zip file into a directory of your choice.
6. 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 (Step 6).
7. Following the build, proceed to #Testing the Installation section.
   .

Installation Procedure For Unix

Binary Installation:
This procedure explains how to download and install the binary distribution on a Unix system.

1. Download the ServiceMix zip file, either using a browser (see step 2) or using a tool, such as, wget.
   wget ...
2. If a browser is available, go to www.servicemix.org
3. Click on the Download link in the left pane.
4. From this page, click on link in the "Latest Releases" section.
5. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
   servicemix-x.x.x.zip.
6. Extract the files from the zip file into a directory of your choice.
   unzip servicemix-x.x.x.zip
7. 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 (Step 6).
8. Following the build, proceed to #Testing the Installation section.

This procedure explains how to download and install the binary distribution on a Unix system withoug a browser.

Source Installation:
This procedure explains how to download and install the source distribution on a Windows system.

1. In a browser, go to www.servicemix.org
2. Click on the Download link in the left pane.
3. From this page, click on link in the "Latest Releases" section.
4. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
   servicemix-x.x.x-src.zip.
5. Extract the files from the zip file into a directory of your choice.
6. 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 & 

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 or console in which it is running.

Configuring ServiceMix

Configuration

Related Documentation