Page History

...

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. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
5. Proceed to the #Starting ServiceMix section of this document.
6. Following start-up, go to the #Testing the Installation section of this document.

...

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 another page.
3. 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: apache-servicemix-3.0.x-src.zip.
4. Extract ServiceMix from the ZIP file into a directory of your choice. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.

5. Anchor
   Windows Source Installation Windows Source Installation

   Build ServiceMix using Maven 2.0.4 or greater and Java 5.
   The recommended method of building ServiceMix is the following:

   Code Block
   cd [servicemix_install_dir]

   Wiki Markup
   where {{\[servicemix_install_dir\]}} is the directory in which ServiceMix was installed.

   Code Block
   mvn -Dprofile=step1 mvn -Dprofile=step2

   Both steps take around 10 to 15 minutes.
6. Unzip the distribution using your favorite zip tool. The windows distribution is available at

   Code Block
   [servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating.zip

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

   Code Block
   cd [servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating-SNAPSHOT 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.
8. Proceed to the #Testing the Installation section.
9. Proceed to the #Starting ServiceMix section of this document.
10. Following start-up, go to the #Testing the Installation section of this document.

Warning: If you are building Servicemix 3.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.

...

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 (if necessary, scroll down to see the ServiceMix snapshots).
5. Extract the files from the ZIP file into a directory of your choice. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
6. If a binary If a binary snapshot was downloaded proceed to the #Starting ServiceMix section of this document.
   If a source snapshot was downloaded perform step 6 5 (building) and step 7 6 (unzipping) of the #Windows Source Installation procedure and proceed to the #Starting ServiceMix section of this document.
7. Following start-up, proceed to the #Testing the Installation section.

...

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

   Code Block
   gunzip apache-servicemix-x.x.x.tar.gz tar xvf apache-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

1. Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
2. Proceed to the #Starting ServiceMix section of this document.
3. 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 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 apache-servicemix.x.x-src.tar.gz tar xvf apache-servicemix.x.x-src.tar

   Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
6. Build ServiceMix using Maven 2.Build ServiceMix using Maven 2.0.4 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. mvn -Dprofile=step1 mvn -Dprofile=step2

   Both steps take around 10 to 15 minutes.
7. Uncompress the distribution that has just been created

   Code Block
   cd [servicemix_install_dir]/apache-servicemix/target gunzip apache-servicemix-3.0-incubating.tar.gz tar xvf apache-servicemix-3.0-incubating.tar

8. Proceed to the #Starting ServiceMix section of this document.
9. Following start-servicemix-3.0-incubating.tar
10. If the servicemix start-up script is not executable, change its permissions. For example:

    Code Block
    cd [servicemix_install_dir]/apache-servicemix/target/apache-servicemix-3.0-incubating/bin chmod 755 servicemix

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

    Code Block
    cd [servicemix_install_dir]/apache-servicemix/target/apache-servicemix-3.0-incubating 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.
12. 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. up, go to the #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 apache-servicemix-x.x-x.tar.gz tar xvf apache-servicemix-x.x.x.tar For a source developer's snapshot: gunzip apache-

6. From a browser, navigate to www.servicemix.org.
7. Click the Download link in the navigation pane (the left pane).
8. Click the "Current development SNAPSHOT release" link.
9. 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-src.tar.gz

   or servicemix-x.x.x-src.tar.gz.
10. Extract the files from the gzip file into a directory of your choice. For example:

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

11. 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.
12. Proceed to the #Testing the Installation section.

Starting ServiceMix

On Windows

1. tar xvf apache-servicemix-x.x.x-src.tar

   Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
2. For a binary snapshot, proceed to the #Starting ServiceMix section of this document.
   If a source snapshot was downloaded perform steps 6 - 8 (building, uncompressing, starting) of the #Unix Source Installation procedure.
3. Proceed to the #Testing the Installation section.

Starting ServiceMix

On Windows

From a console window, change to the installation directory and run ServiceMix. For the binary distribution, go to

cd [servicemix_install_dir]

and for the source distribution go to the target directory, for example:

cd [servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating-SNAPSHOT

where servicemix_install_dir is the directory in which ServiceMix was installed, e.g., c:\Program Files\servicemix-3.x.

Then type:

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.

In case you get a

Exception in thread "main" java.lang.IllegalArgumentException

you may have some illegal characters in the path, e.g. !, % etc.

On Unix

From a command shellFrom a console window, change to the installation directory and run ServiceMix. For the binary distribution, go to

cd [servicemix_install_dir]

and for the source distribution go to the target directory, for example:

cd [servicemix_install_dir]/apache-servicemix/target/apache-servicemix-3.0-incubating

where servicemix_install_dir is the directory in which ServiceMix was installed, e.g., c:\Program Files\/usr/local/servicemix-3.x.

Then type:

bin\/servicemix

OR

nohup bin/servicemix > /tmp/smlog  2>&1 &

Note: /tmp/smlog may be changed to another file name.

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:

cd [servicemix_install_dir]

where servicemix_install_dir is the directory in which ServiceMix was installed, e.g., /usr/local/servicemix-3.x.
Then type:

bin/servicemix

OR

nohup bin/servicemix > /tmp/smlog  2>&1 &
Note: /tmp/smlog may be changed to another file name.

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.

...

...

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

chmod 755 bin/servicemix

In case you get a

Exception in thread "main" java.lang.IllegalArgumentException

you may have some illegal characters in the path, e.g. !, % etc.

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:

...