...
- Java Developer Kit (JDK) 1.5.x or greater (http://java.sun.com/).
- The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g.,
c:\Program Files\jdk.1.5.0_06
. To accomplish that, press Windows key and Break key together, switch to "Advanced" tab and click on "Environment Variables". Here, check for the variable and, if necessary, add it. - Apache Maven 2.0.4 (http://maven.apache.org/download.html).
Info | ||
---|---|---|
| ||
While the core JBI container can be used with JDK 1.4 without any problems, the build system requires JDK 5 and some components are dependant on JDK 5 features. |
Installation Procedure for Windows
...
- From a browser, navigate to http://incubator.apache.org/servicemix/download.html.
- Click the "ServiceMix 3.0.x Release" link under the "Latest Releases" section. This brings up a new page.
- 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
. - 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.
- Proceed to the #Starting ServiceMix 3. Installation section of this document.
- Following start-up, go to the #Testing the 3. Installation section of this document.
...
- From a browser, navigate to http://incubator.apache.org/servicemix/download.html
- Click the "ServiceMix 3.0.x Release" link under the "Latest Releases" section. This brings up another page.
- 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
. - 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.
Build ServiceMix using Maven 2.0.4 or greater and Java 5.Anchor Windows Source Installation Windows Source Installation
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.
Both steps take around 10 to 15 minutes.Code Block mvn -Dprofile=step1 mvn -Dprofile=step2
- 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
- Proceed to the #Starting ServiceMix 3. Installation section of this document.
- Following start-up, go to the #Testing the 3. Installation section of this document.
...
- From a browser, navigate to www.servicemix.org.
- Click the Download link in the navigation pane (the left pane).
- Click the "Current development SNAPSHOT release" link.
- Select the version of ServiceMix to download (if necessary, scroll down to see the ServiceMix snapshots).
- 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.
- If a binary snapshot was downloaded proceed to the #Starting ServiceMix 3. Installation section of this document.
If a source snapshot was downloaded perform step 5 (building) and step 6 (unzipping) of the #Windows Source 3. Installation procedure and proceed to the #Starting ServiceMix 3. Installation section of this document. - Following start-up, proceed to the #Testing the 3. Installation section.
Installation Procedure For Unix
...
- Extract the files from the gzip file into a directory of your choice. For example:
Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.Code Block gunzip apache-servicemix-x.x.x.tar.gz tar xvf apache-servicemix-x.x.x.tar
- Proceed to the #Starting ServiceMix 3. Installation section of this document.
- Following start-up, go to the #Testing the 3. 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 3. 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.
- From a browser, navigate to www.servicemix.org.
- Click the "Download" link in the navigation pane (the left pane).
- Click the "ServiceMix 3.x Release" link under the "Latest Releases" section. This brings up a new page.
- 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
. - Extract the files from the ZIP file into a directory of your choice. For example:
Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.Code Block gunzip apache-servicemix.x.x-src.tar.gz tar xvf apache-servicemix.x.x-src.tar
- Build ServiceMix using Maven 2.0.4 or greater and Java 5:
Both steps take around 10 to 15 minutes.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
- 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
- Proceed to the #Starting ServiceMix 3. Installation section of this document.
- Following start-up, go to the #Testing the 3. Installation section.
Unix Developers' Release
...
- From a browser, navigate to www.servicemix.org.
- Click the Download link in the navigation pane (the left pane).
- Click the "Current development SNAPSHOT release" link.
- 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
orservicemix-x.x.x-src.tar.gz
. - Extract the files from the gzip file into a directory of your choice. For example:
Please remember the restrictions concerning illegal characters in Java paths, e.g. !, % etc.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
- For a binary snapshot, proceed to the #Starting ServiceMix 3. Installation section of this document.
If a source snapshot was downloaded perform steps 6 - 8 (building, uncompressing, starting) of the #Unix Source 3. Installation procedure. - 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
|
...
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 [SM: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.
Wiki Markup |
---|
{scrollbar} |