Versions Compared

Key

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

...

  1. Download the ServiceMix gzip file to the Unix machine, either using a browser or using a tool, i.e., wget, scp, ftp, etc.
    Code Block
    Installing with a browser on the Unix machine:
    a. If a browser is available on the Unix machine, go to www.servicemix.org.
    b. Click on the Download link in the navigation pane (the left pane).
    c. Click on the "ServiceMix 1.x Release" link under the "Latest Releases" section.
    d. Under the "Download Here" section, select the desired distribution (you may have to scroll down to see the "Download Here" section). 
    For a binary Unix distribution the filename will be similar to: servicemix-x.x.x.tar.gz.
    
    OR
    
    The following gives an example of installing on a Unix machine that does not have a browser. 
    There are many alternative ways to perform this type of installation. 
    This example uses a Windows machine and the "wget" tool.
    a. If there is no browser on the Unix machine, obtain the link to the gzip file. On a Windows machine, go to www.servicemix.org.
    b. Click on the Download link in the left navigation pane.
    c. Click on the "ServiceMix 1.x Release" link under the "Latest Releases" section.
    d. Under the "Download Here" section, roll-over the desired distribution (you may have to scroll down to see the "Download Here" section). 
    For a binary Unix distribution the filename will be similar to: servicemix-x.x.x.tar.gz.
    e. Right-click on the distribution name and "Copy Shortcut."
    f. Back on the Unix machine, change into the directory in which ServiceMix is to be installed, e.g., /usr/local.
    f. To copy/download the ServiceMix distribution to the Unix machine: Using the "wget" tool as an example: type "wget" followed by the saved shortcut. For example:
    
    wget http://dist.codehaus.org/servicemix/distributions/servicemix-1.0.1.tar.gz
    
    
  2. Extract the files from the gzip file into a directory of your choice. For example:
    Code Block
    gunzip servicemix-x.x.x.tar.gz  
    tar xvf servicemix-x.x.x.tar
    # 
  3. It may be necessary to make the {{servicemix}} script servicemix startup script executable. To do this:
    Code Block
    cd [servicemix_install_dir]/bin

    # Proceed to the [#Starting ServiceMix] section of this document. # Following
    
    chmod 755 servicemix
    Code Block
    
    
  4. Proceed to the #Starting ServiceMix section of this document.
  5. Following start-up, go to [#Testing the Installation] section. h4.

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

...

section

...

Binary

...

Installation

...

for

...

ideas

...

on

...

how

...

to

...

install

...

ServiceMix

...

without

...

a

...

browser.

  1. # In a browser, go to www.servicemix.org. #
  2. Click on the Download link in the navigation pane (the left pane). #
  3. Click on the "ServiceMix 1.x Release" link under the "Latest Releases" section.
  4. # Under the "Download Here" section, select the desired distribution (you may have to scroll down to see the "Download Here" section).
    For a source distribution the filename will be similar to: {{servicemix-x.x.x-src.tar.gz}}.
  5. # Extract the files from the zip file into a directory of your choice. For example:
    Code Block
    gunzip servicemix.x.x.x-src.tar.gz

    code
    
    tar xvf servicemix.x.x-src.tar
    
    
    # 
  6. Build ServiceMix using Maven 1.0.2 or greater:
    Code Block
    The preferred method of building ServiceMix is the following:

    
    cd /[servicemix_install_dir

    where
    ] 
      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:

...

  1. 
    cd /[servicemix_install_dir

...

  1. ]
    maven m:clean

...

  1. 
    maven -Dmaven.test.skip=true

...

  1. 
    
    

...

Developer's

...

Snapshot

...

  1. In

...

  1. a

...

  1. browser,

...

  1. go

...

  1. to

...

  1. www.servicemix.org.

...

  1. Click

...

  1. on

...

  1. the

...

  1. Download

...

  1. link

...

  1. in

...

  1. the

...

  1. navigation

...

  1. pane

...

  1. (the

...

  1. left

...

  1. pane).

...

  1. Click

...

  1. on

...

  1. the

...

  1. "ServiceMix

...

  1. 1.x

...

  1. Release"

...

  1. link

...

  1. under

...

  1. the

...

  1. "Latest

...

  1. Releases"

...

  1. section.

...

  1. Under

...

  1. the

...

  1. "Download

...

  1. Here"

...

  1. section,

...

  1. select

...

  1. the

...

  1. desired

...

  1. distribution

...

  1. (you

...

  1. may

...

  1. have

...

  1. to

...

  1. scroll

...

  1. down

...

  1. to

...

  1. see

...

  1. the

...

  1. "Download

...

  1. Here"

...

  1. section).

...

  1. For

...

  1. a

...

  1. binary

...

  1. distribution

...

  1. the

...

  1. filename

...

  1. will

...

  1. be

...

  1. similar

...

  1. to:

...


  1. servicemix-x.x.x.zip

...

  1. .

Anchor
Starting ServiceMix
Starting ServiceMix
Starting ServiceMix

On Windows:

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

Code Block
       

...

cd \[servicemix_install_dir]\bin

...


where servicemix_install_dir

...

is

...

the

...

directory

...

in

...

which

...

ServiceMix

...

was

...

installed,

...

e.g.,

...

c:\Program

...

Files\servicemix-1.x

...

.
Then type:

...

servicemix

Code Block
servicemix
h4. 

On

...

Unix:

...

From

...

a

...

command

...

shell,

...

change

...

to

...

the

...

installation

...

directory

...

and

...

run

...

the

...

servicemix

...

program:

...

Code Block
       
cd /[

...

servicemix_install_dir]/bin

...


where servicemix_install_dir

...

is

...

the

...

directory

...

in

...

which

...

ServiceMix

...

was

...

installed,

...

e.g.,

...

/usr/local/servicemix-1.x

...

servicemix or servicemix & .
Then type:

Code Block

servicemix or servicemix    & 
{
:=
Warning
title
Warning
}

Do

NOT

close

the

console

or

shell

in

which

ServiceMix

was

started

as

that

will

terminate

ServiceMix

(unless

ServiceMix

was

started

in

the

background).

{warning} h2. {anchor:Testing the Installation} Testing the Installation The Window's console window or the Unix command shell will display something similar to the following log line if ServiceMix is up and running without any problems:

...

Anchor
Testing the Installation
Testing the Installation
Testing the Installation

The Window's console window or the Unix command shell will display something similar to the following log line if ServiceMix is up and running without any problems:

Code Block

[INFO] JBIContainer -- ServiceMix JBI Container 
<http://servicemix.org/

...

> name: defaultJBI running version: null

...



...

ServiceMix's

...

default

...

port

...

is

...

1099.

...

From

...

another

...

window

...

run

...

netstat

...

and

...

look

...

for

...

port

...

1099.

...

From

...

a

...

Windows

...

console,

...

type:

...

Code Block
       
netstat -an|find "1099"
Code Block


*OR*

From a Unix command shell, type:

...

OR

From a Unix command shell, type:

Code Block

netstat -an|grep 1099

...

code

Stopping ServiceMix

For both Windows and Unix installations, terminate ServiceMix by typing "CTRL-C" in the command shell or console in which it is running.

...