Building ServiceMix From Source
ServiceMix uses Maven as its build and management tool. We have tested the build with Maven 2.0.8 and it works fine, but Maven 2.0.9 is known to cause some issues that prevent a successful build for ServiceMix 3.2.1 and previous versions. This has been fixed for 3.2.2 and 3.3. Be sure to read the FAQ
ServiceMix 4.x requires to use Maven 2.2.1 or better.
Getting started
- Download and install Maven.
- Get the latest code from SVN
- Build the code with the following command
Code Block |
---|
mvn -Dmaven.test.skip=true -Pstep1 install mvn -Dmaven.test.skip=true -Pstep2 install |
Tip | ||
---|---|---|
| ||
|
Warning | ||
---|---|---|
| ||
There is an issue in building if you use the system property style of declaring the profiles (i.e., -Dprofile=step2) as the XFire Maven plugin thinks step2 is a profile name it should use. This is fixed in the ServiceMix trunk (3.3 or greater). To work around this issue, try the following items below:
|
Next time you build, you can just run
Code Block |
---|
mvn -Dmaven.test.skip=true install |
Tip | ||
---|---|---|
| ||
If an out of memory error is encountered when building 3.1.1, MAVEN_OPTS=-Xmx768m |
Tip | ||
---|---|---|
| ||
Note that this only works for versions from 3.0-M3. mvn -N install |
Code Conventions
Checkstyle and PMD rules are used to scour the ServiceMix source code when performing a build. If you are hacking code and it does not follow these conventions, the build will fail. To make things easier on folks who are using Eclipse, there is an Eclipse code convention profile that matches the Checkstyle conventions, making things a bit easier in this regard. Import this profile into Eclipse under Preferences->Java->Code Style->Formatter->Import.
Using an IDE
Using Eclipse
For Eclipse, a detailed description is given at Importing ServiceMix into Eclipse. In addition, this page also describes how to start ServiceMix inside Eclipse with all debugging possibilities.
Other IDEs
Any modern IDE with self respect can start a new project based on a Maven pom.xml file.
Note that you may need to build the whole ServiceMix project once using maven.
Please refer to the plugin reference for more details on using them.