Instructions for installing the Logisticx Demo 1.1

This page provides instructions for installing and running the Logisticx demo application.

Downloading the Demo

You can download the Logisticx demo from the Product Demo section of the FUSE downloads page.

If you simply want to see FUSE ESB in action, you can download the binary. However, if you want to follow the use cases in our FUSE Cookbook, you will need the source code. 

You will want to make sure that the FUSE ESB and service assemblies are running and deployed prior to starting and deploying the web application.

Expand the archive into a directory on your hard drive. The expanded archive contains five archives for deploying to FUSE ESB and three WAR files for deploying to a web server or servlet container:

logisticx-demo-1.1/deployables/derby-sa-1.1.zip
logisticx-demo-1.1/deployables/order-sa-1.1.zip
logisticx-demo-1.1/deployables/order-processor-sa-1.1.zip 
logisticx-demo-1.1/deployables/order-route-sa-1.1.zip
logisticx-demo-1.1/deployables/stock-processor-sa-1.1.zip  

logisticx-demo-1.1/deployables/logisticx-web-gwt.war
logisticx-demo-1.1/deployables/warehouse.war  
logisticx-demo-1.1/deployables/warehouse-soapjms.war

Deploying the Logisticx Demo Server-Side Applications

To deploy the server-side applications to FUSE ESB:

  1. Download FUSE ESB v3.3.1.x or v4.0.x from the FUSE downloads page.
  2. Install FUSE ESB on your computer.
  3. Copy derby-sa-1.1.zip, order-sa-1.1.zip, order-processor-1.1.zip, order-route-1.1.zip and stock-processor-1.1.zip from the logisticx-demo-1.1/deployables directory into the FUSE ESB hotdeploy directory for ServiceMix 3 and deploy directory for ServiceMix 4.

To start the FUSE ESB

  1. Open a command prompt or terminal on your computer.
  2. Change directory to the FUSE ESB installation directory
  3. Start FUSE ESB using the following command for the given operating system:

    UNIX:

    /opt/fuse-esb $ ./bin/servicemix
    

    Windows:

    C:\fuse-esb\> bin\servicemix
    

For ServiceMix 3 - You will see some output to the terminal. When the output stops, FUSE ESB has been started and is ready for use.

For ServiceMix 4 you will get the Servicemix Shell  - it will continue to deploy the Service Assemblies in the background. This may take a few minutes. You can check if the services are up and running with the jbi list command.



 
You may also look at the Servicemix log file in the data directory for more information.

Installing the Logisticx Demo Web Application

The web application is distributed as three WAR files that can be deployed to any Java web application server or servlet container such as Tomcat or Jetty.

To deploy the web application to a Tomcat server:

1. Download Tomcat 6.0.x from http://tomcat.apache.org/download-60.cgi

2. Unzip the Tomcat distribution to any directory.

3. From the logisticx-demo-1.1 archive, copy from deployables logisticx-web-gwt.war, warehouse.war and warehouse-soapjms.war to the Tomcat-6.0.x/webapps directory.

4. From the Tomcat-6.0.x directory, run the tomcat binary :   

UNIX:

/opt/tomcat6.0/ $ ./bin/tomcat6.sh start

Windows:

C:\tomcat6.0\> bin\tomcat6.exe start

5. This will start Tomcat and load the logisticx web application and the Warehouse Services.

6. Point your web browser to the following URL:

http://localhost:8080/logisticx-web-gwt/

To deploy the web application to a Jetty server:

  1. Download Jetty 6.1.x.
  2. Unzip the Jetty container to any directory.
  3. From the logisticx-demo-1.1 deployables directory copy logisticx-web-gwt.war, warehouse.war and warehouse-soapjms.war to the e.g jetty-6.1.14/webapps directory.
  4. From the jetty-6.1.14 directory, run the following command:

    UNIX:

    /opt/jetty-6.1.14 $ java -jar start.jar etc/jetty.xml
    

    Windows:

    C:\jetty-6.1.14\> java -jar start.jar etc/jetty.xml
    

    Jetty starts up and loads the Logisticx web application.

5. Now point your web browser to the following URL:

http://localhost:8080/logisticx-web-gwt/
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.