Versions Compared

Old Version 21

changes.mady.by.user Guillaume Nodet

Saved on

compared with

New Version 22

changes.mady.by.user Guillaume Nodet

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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 3. Installation #Starting ServiceMix section of this document.
  6. Following start-up, go to the #Testing the 3. 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 [SM30UG:servicemix_install_dir]
    Wiki Markup
     where {{\[SM30UG: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
    [SM30UG:servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating.zip
  7. Proceed to the 3. Installation #Starting ServiceMix section of this document.
  8. Following start-up, go to the 3. #Testing the Installation section of this document.

...

  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 snapshot was downloaded proceed to the 3. Installation #Starting ServiceMix section of this document.
    If a source snapshot was downloaded perform step 5 (building) and step 6 (unzipping) of the 3. #Windows Source Installation procedure and proceed to the 3. Installation #Starting ServiceMix section of this document.
  7. Following start-up, proceed to the #Testing the 3. Installation section.

Installation Procedure For Unix

...

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

Unix Source Installation

...

  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.0.4 or greater and Java 5:
    Code Block
    The preferred method of building ServiceMix is the following:
cd [SM30UG:servicemix_install_dir]
 where [SM30UG: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 [SM30UG: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 3. Installation #Starting ServiceMix section of this document.
  9. Following start-up, go to the #Testing the 3. Installation section.

Unix Developers' Release

...

  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-servicemix-x.x.x-src.tar.gz
 tar xvf apache-servicemix-x.x.x-src.tar
    Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.
  6. For a binary snapshot, proceed to the 3. Installation #Starting ServiceMix section of this document.
    If a source snapshot was downloaded perform steps 6 - 8 (building, uncompressing, starting) of the 3. #Unix Source Installation procedure.
  7. Proceed to the #Testing the 3. Installation section.

Starting ServiceMix

...

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

Code Block
cd [SM30UG:servicemix_install_dir]

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

Code Block
cd [SM30UG:servicemix_install_dir]\apache-servicemix\target\apache-servicemix-3.0-incubating-SNAPSHOT

...

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

Code Block
cd [SM30UG:servicemix_install_dir]

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

Code Block
cd [SM30UG:servicemix_install_dir]/apache-servicemix/target/apache-servicemix-3.0-incubating

...

Starting ServiceMix with old examples, CIMERO-generated xml configuration files or custom code may cause errors due to missing libraries. Usually, the missing class is displayed at the very end of the output. Here, some examples are shown and explained.

...

Wiki Markup
Obviously (bold typed text), a class inside the quartz package cannot be found. A quick search for "quartz" in the Maven repository reveals _\[SM30UG:user_home\]\.m2\repository\quartz\quartz\1.5.2\quartz-1.5.2.jar_ (or newer version) which has to be copied to _\[SM30UG:ServiceMix_home\]\lib\quartz-1.5.2.jar_ \- the error shall be resolved now. Of course, adding the directory containing the jar to the classpath is another possibility.

...

Wiki Markup
indicating that the whole servicemix-common package cannot be found. In the Maven repository, _servicemix-components-3.0-incubating.jar_ (or newer version) can be found and copied to ServiceMix' lib directory. *Note:* As this is a ServiceMix' sub-project, the jar is available at _\[SM30UG:ServiceMix_home\]\components_ as well.

...

Wiki Markup
A short www search leads to [SM30UG:Unrecognized xbean namespace mapping]. With this information, one can infer that _\[SM30UG:user_home\]\.m2\repository\org\apache\servicemix\servicemix-eip\3.0-incubating\servicemix-eip-3.0-incubating.jar_ (or newer version) has to be copied to _\[SM30UG:ServiceMix_home\]\lib\servicemix-eip-3.0-incubating.jar_ so ServiceMix can find the classes.

...

Code Block
ps -ef | grep servicemix
kill [SM30UG:PID]
 where [SM30UG:PID] is the process id of the servicemix process.

...

After the installation, ServiceMix is running with a basic configuration, but no components. For details on configuring options, please see refer to the Configuration section.

3. Installation#top

Wiki Markup
{scrollbar}