Getting Started Guide

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.

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.

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, ????

Developer's Releases:

Installation Procedure For Unix

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.

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 [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 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., /usr/local/servicemix-1.x.
Then type:

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.

Test 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

Configuration

Configuration

Related Documentation