You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 57 Next »

Introduction

This document describes how to install and configure ServiceMix 1.x.

Pre-Installation Requirements

Hardware:

  • 36 MB of disk space for the ServiceMix 1.x binary download.
  • 13 MB of disk space for the ServiceMix 1.x source download.

Operating Systems:

  • Windows: Windows XP, Windows NT.
  • Unix: AIX, HP-UX, Solaris, Linux, any platform that supports Java.

Environment:

  • Java Developer Kit (JDK) of 1.4.x or greater
  • The JAVA_HOME environment variable must be set to the directory where the JDK is installed, e.g. c:\Program Files\jsdk.1.4.2-09.
  • Maven 1.0.2 or greater (needed when installing source or developer's releases).

Installation Procedure For Windows

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

  1. In a browser, go to www.servicemix.org.
  2. Click on the Download link in the left pane.
  3. From this page, click on link in the "Latest Releases" section.
  4. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
    servicemix-x.x.x.zip.
  5. Extract the files from the zip file into a directory of your choice.
  6. Proceed to the #Starting ServiceMix section of this document.

Source Installation:
This procedure explains how to download and install the source distribution on a Windows system.

  1. In a browser, go to www.servicemix.org.
  2. Click on the Download link in the left pane.
  3. From this page, click on link in the "Latest Releases" section.
  4. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
    servicemix-x.x.x-src.zip.
  5. Extract the files from the zip file into a directory of your choice.
  6. Change into the ServiceMix directory and build it.
    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 this:
    cd \[servicemix_install_dir]
    maven m:clean
    maven -Dmaven.test.skip=true
    
    
  7. Start servicemix from the target directory:
    cd [servicemix_install_dir\target\servicemix-1.0\bin\servicemix-1.0\bin
    servicemix
    
  8. Proceed to #Testing the Installation section.

Developer's Releases:

Installation Procedure For Unix

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

  1. In a browser, go to www.servicemix.org
  2. Click on the Download link in the left pane.
  3. From this page, click on link in the "Latest Releases" section.
  4. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
    servicemix-x.x.x.zip.
  5. Extract the files from the zip file into a directory of your choice.

Source Installation:
This procedure explains how to download and install the source distribution on a Windows system.

  1. In a browser, go to www.servicemix.org
  2. Click on the Download link in the left pane.
  3. From this page, click on link in the "Latest Releases" section.
  4. Scroll down to select the version to download. For a binary distribution the filename will be similar to:
    servicemix-x.x.x-src.zip.
  5. Extract the files from the zip file into a directory of your choice.
  6. cd blah and maven something, ????

Starting ServiceMix

On Windows:
From a console window, change to the installation directory and run the servicemix program:

       
cd [install_dir]\bin

where install_dir is the directory in which ServiceMix was installed, e.g., c:\Program Files\servicemix-1.x.
Then type:

servicemix

On Unix:
From a command shell, change to the installation directory and run the servicemix program:

       
cd [install_dir]/bin

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

servicemix or servicemix & 

Warning

Do NOT close the Window's console or Unix command shell (unless servicemix was started in the background) in which ServiceMix was started as that will terminate ServiceMix.

Stopping ServiceMix

To terminate ServiceMix type "CTRL-C" in the command shell in which it is running and answer "y" to the "Terminate batch job (y/n)?" question.

Testing the Installation

The console window will display the following log line if ServiceMix is up and running without any problems:

[INFO] JBIContainer -- ServiceMix JBI Container 
<http://servicemix.org/> name: defaultJBI running version: null

ServiceMix's default port is 1099. From another console window run netstat and look for port 1099.

Windows Installation:
From a windows console type:

       
netstat -an|more

Unix Installation:
From a Unix command shelltype:

netstat -an|grep 1099

Configuring ServiceMix

Configuration

Related Documentation

  • No labels