Page History

...

This article contains the following sections:

• #Pre-Installation Requirements
• #Installation Procedure for Windows
  • #Windows Binary Installation
  • #Windows Source Installation
  • #Windows Developers' Release
• #Installation Procedure for Unix
  • #Unix Binary Installation
  • #Unix Source Installation
  • #Unix Developers' Release
• #Starting ServiceMix
• #Testing the Installation
• #Stopping ServiceMix
• #Configuring ServiceMix

Pre-Installation Requirements

...

This section of the Getting Started guide explains how to install binary and source distributions of ServiceMix on a Windows system.

Windows Binary Installation

This procedure explains how to download and install the binary distribution on a Windows system.

1. From a browser, navigate to http://incubator.apache.org/servicemix/download.html.
2. Click the "ServiceMix 3.0.x Release" link under the "Latest Releases" section. This brings up a new page.
3. Under the "Download Here" section, select the desired distribution (you may have to scroll down to see the "Download Here" section).
   For a binary distribution, the filename will be similar to: apache-servicemix-3.0.x.zip.
4. Extract the files from the ZIP file into a directory of your choice.
5. Proceed to the #Starting ServiceMix section of this document.
6. Following start-up, go to the #Testing the Installation section of this document.

Windows Source Installation

This procedure explains how to download and install the source distribution on a Windows system. NOTE: ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.

...

Warning: If you are building Servicemix 3.x under Windows using Cygwin there is a path name length limitation. If the length is exceeded you may see build errors. To fix this, move the ServiceMix source directory higher in the file system tree, e.g., /cygdrive/c/d/sm.

Windows Developers' Release

This procedure explains how to download and install the latest developers' snapshot. NOTE: ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.

...

Installation Procedure For Unix

Anchor
Unix Binary Installation Unix Binary Installation

Unix Binary Installation

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

...

1. Extract the files from the gzip file into a directory of your choice. For example:

   Code Block
   gunzip servicemix-x.x.x.tar.gz tar xvf servicemix-x.x.x.tar

2. If the servicemix start-up script is not executable, change its permisssions. The servicemix script is located in the bin directory. For example:

   Code Block
   cd [servicemix_install_dir]/bin where [servicemix_install_dir] is the directory in which ServiceMix was installed. chmod 755 servicemix

3. Proceed to the #Starting ServiceMix section of this document.
4. Following start-up, go to the #Testing the Installation section.

Unix Source Installation

This procedure explains how to download and install the source distribution on a Unix system. This procedure assumes the Unix machine has a browser. Please see the previous #Unix Binary Installation section for ideas on how to install ServiceMix without a browser. NOTE: ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.

1. From a browser, navigate to www.servicemix.org.
2. Click the "Download" link in the navigation pane (the left pane).
3. Click the "ServiceMix 3.x Release" link under the "Latest Releases" section. This brings up a new page.
4. Under the "Download Here" section, select the desired distribution (if necessary, scroll down to see the "Download Here" section).
   For a source distribution, the filename will be similar to: servicemix-x.x-src.tar.gz.
5. Extract the files from the ZIP file into a directory of your choice. For example:

   Code Block
   gunzip servicemix.x.x-src.tar.gz tar xvf servicemix.x.x-src.tar

6. Build ServiceMix using Maven 1.0.2 or greater and Java 5:

   Code Block
   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 the following: cd [servicemix_install_dir] maven m:clean maven \-Dmaven.test.skip=true

7. If the servicemix start-up script is not executable, change its permissions. For example:

   Code Block
   cd [servicemix_install_dir]/servicemix-assembly/target/servicemix-3.x/bin/servicemix-3.x/bin chmod 755 servicemix

8. Start ServiceMix from the target directory, for example:

   Code Block
   cd [servicemix_install_dir]/servicemix-assembly/target/servicemix-3.x/bin/servicemix-3.x bin/servicemix

   Note: working directories get created relative to the current directory. For the working directories to be created in the proper place, ServiceMix must be launched from its home/installation directory.
9. Proceed to #Testing the Installation section.

Unix Developers' Release

This procedure explains how to download and install the latest developers' snapshot. NOTE: ServiceMix can be run on a Java 1.4.x system, however, Java 5 is required to compile/build ServiceMix.

1. From a browser, navigate to www.servicemix.org.
2. Click the Download link in the navigation pane (the left pane).
3. Click the "Current development SNAPSHOT release" link.
4. Select the version of ServiceMix to download (you may have to scroll down to see the ServiceMix snapshots). The filename will be similar to: servicemix-x.x.x-tar.gz or servicemix-x.x.x-src.tar.gz.
5. Extract the files from the gzip file into a directory of your choice. For example:

   Code Block
   For a binary developer's snapshot: gunzip servicemix-x.x-x.tar.gz tar xvf servicemix-x.x.x.tar For a source developer's snapshot: gunzip servicemix-x.x.x-src.tar.gz tar xvf servicemix-x.x.x-src.tar

6. If a binary snapshot was downloaded the servicemix script may need its permissions changed to make it executable:

   Code Block
   cd [servicemix_install_dir]/bin where [servicemix_install_dir] is the directory in which ServiceMix was installed. chmod 755 servicemix

   For a binary snapshot, proceed to the #Starting ServiceMix section of this document.
   If a source snapshot was downloaded perform steps 6 - 8 of the #Unix Source Installation procedure.
7. Proceed to the #Testing the Installation section.

...

Starting ServiceMix

...

On Windows

...

From a console window, change to the installation directory and run ServiceMix:

...

Note: working directories get created relative to the current directory. For the working directories to be created in the proper place, ServiceMix must be launched from its home/installation directory.

On Unix

...

From a command shell, change to the installation directory and run ServiceMix:

...

Warning
title Warning
Do NOT close the console or shell in which ServiceMix was started, as that will terminate ServiceMix (unless ServiceMix was started with nohup).

...

Testing the Installation

If ServiceMix is up and running without problems, the Window's console window or the Unix command shell will display something similar to the following log line:

...