This is the installation guide for setting up the order fulfillment processor application that acts as the case study for course Introduction to Integration with Apache Camel. The case study is a custom implementation of a mediator. You will be able to follow along with the course using this case study project as the base for demonstrations. The case study was developed using the following:
..* Implemented on Windows 8.1, 64-bit ..* Eclipse ..* JDK 1.7.0_45 ..* Maven 3 ..* Spring 4 ..* PostgreSQL 9.3 ..* Apache Tomcat 7.0.54 ..* Apache ActiveMQ 5.10.0 ..* Apache Camel 2.13.2 ..* Hawt.io 1.4.14
Below are the instructions on a per-component basis. The installation assumes Windows, so you will need to follow the instructions that pertain to your OS if you are not using Windows.
The case study depends on Java. The course makes use of Java SDK 1.7.0_45. The SDK can be downloaded here:
http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
Following installation, you will need to configure your environment variables based on your OS
My preference for an integrated development environment is Eclipse. I am currently developing using Eclipse Kepler. You can find the download for Eclipse here:
http://www.eclipse.org/kepler/
I use Apache Maven for build and dependency management. You can download Maven here:
http://maven.apache.org/download.cgi
After installation, you will need to configure your environment variables based on your OS. You can also skip installation of Maven and use the Eclipse Maven plug-in if you are developing with Eclipse as your IDE.
I chose to use PostgreSQL for the project's database. PostgreSQL is a free, open-source database. PostgreSQL can be downloaded from the following URL:
http://www.postgresql.org/download/windows/
The installation should include PGAdmin III, which is a graphical editor for PostgreSQL.
The scripts to create the database for the case study project can be found in the project directory:
order-fulfillment-processor\src\main\sql\postgresql\ddl
Scripts include:
..* create-orders-db.sql = Creates the login, database and schema for the project. ..* create-orders.sql = Drops and re-creates the database table schema ..* drop-orders-db.sql = Drops the orders database
The script to load initial data can be found in the project directory:
order-fulfillment-processor\src\main\sql\postgresql\dml\load-orders.sql
To initially create the database:
- Log in to PGAdmin III and connect using the postgres user
- Create the login for orders using the create statement found in create-orders-db.sql
- Create the database for orders using the create statement found in create-orders-db.sql
- Disconnect from the server, then right click the database, select properties and enter the user name as orders.
- Connect to the server using the orders user name.
- Open the query tool and run the create-orders.sql file, then run the load-orders.sql file.
To re-load the database:
- Log in to PGAdmin III and connect using the orders user
- Open the query tool and run the create-orders.sql file, then run the load-orders.sql file.
I used Apache Tomcat 7.0.54 as a server runtime in Eclipse. Below are instructions for adding the runtime in Eclipse:
- Download Tomcat 7 from http://tomcat.apache.org/
- Unzip the file to a directory on your hard drive
- In Eclipse, click the Window -> Preference menu and then select Server -> Runtime Environments from the Preferences popup
- Click the Add button.
- Select Tomcat 7 and click next
- Enter the installation directory you unzipped Tomcat to and click Finish
I used Apache ActiveMQ 5.10.0 for messaging. Below are instructions for installation:
- Download ActiveMQ 5.10 from http://activemq.apache.org/
- Unzip the file to a directory on your hard drivev
- Open a command prompt and navigate to the bin directory of the activemq installation you unzipped
- Run the command activemq.bat start
- Verify the broker started by navigating to http://localhost:8161/ and logging in with admin/admin
I used Hawt.io version 1.4.14. Below are instructions for installation:
- Downloaded Hawt.io 1.4.14 WAR file from http://hawt.io/
- In Eclipse, I selected the File -> import menu, then selected Web -> WAR
- I selected the hawt.io WAR file I downloaded and then selected next
- I kept all the selections unchecked and clicked finish to import the WAR.
- I added the project to Tomcat in Eclipse
- You can then verify the installation from http://localhost:8080/hawtio-default-1.4.14
Below are instructions for getting the Order Fulfillment Processor running in Eclipse:
- In Eclipse, select File -> Import and select Maven -> Existing Maven Projects
- Enter the root directory of the project then make sure the pom.xml file is checked. Click Next and then click Finish
- Make sure the project is faceted as a Maven project
- Right click the project and select Properties
- Click Project Facets in the pop-up and then click the convert to faceted project link if not already in faceted form.
- Make sure Dynamic Web Module 3.0 is checked
- Make sure Java 1.7 is checked
- Click OK to close the properties popup, then right-click the project and select Properties again.
- There should now be a Deployment Assembly selection, which you should select.
- Make sure that /src/main/java/ and /src/main/resources are deployed to WEB-INF/classes
- Remove the /WebContent to / entry
- Add the java build path entry Maven Dependencies and make sure it deploys to WEB-INF/lib
- Add the /src/main/webapp folder and make sure it deploys to /
- Click OK to close the properties window
- Add the project to the Tomcat 7 server and start the server.
- Once the server is started, open a browser to http://localhost:8080/order-fulfillment-processor/orderHome
If you want to run order processing, click Orders -> Process Orders
If you want to reset the orders back to new status, click Orders -> Reset Orders