...
| Info |
|---|
Note that it is not necessary to download the Fabric3 runtime distribution in addition to the samples as the sample build process will automatically download a distribution and configure a Fabric3 runtime cluster. |
...
The Starter Applications
The starter calculator applications are the recommended way to get familiar with Fabric3. To build and deploy the calculator applications, do the following:
...
To launch a Fabric3 server in single-VM mode, execute the following from the servers/vm/target/image/bin directory by executing: java -jar server.jar
Alternatively, the Fabric3 server can be started from another working directory by executing: java -jar <path to bin directory>server.jar
...
The samples also contain a separate client for the web services calculator. The client module is located at /samples/wscalc-client. The WSCalcClient class can be executed using the Java command line or via an IDE.
...
.
Feature Applications
Feature applications provide in-depth examples of how to use a particular Fabric3 feature, such as pub/sub eventing. As with the starter applications, a feature application can be built and deployed to one of the server configurations.
BigBank
BigBank demonstrates a complete distributed, multi-cluster loan processing application. BigBank is organized into several architectural tiers:
- A loan service tier responsible for providing a RESTful and WS-* web service that receives loan applications.
- A back-end services tier responsible for performing credit checks, rating, pricing, and managing approvals.
- A consumer web-based UI for submitting new applications and reviewing loan status.
- A backoffice web-based UI for managing loan approvals and viewing real-time business events and statistics.
- A database tier for persisting loan application data.
BigBank can be deployed to the single-VM runtime used for the starter examples or deployed to the two-cluster topology that is configured under servers/cluster. In either case, configuration remains the same. When deployed to the cluster environment, the loan service and web UIs will be deployed to the cluster zone1 while the back-end services will be deployed to the cluster zone2. Fabric3 will wire the services by transparently provisioning a number of JMS queues and topics.
Deploying to a Single VM
To build and deploy BigBank to the single-VM server, do the following:
*
Build the BigBank source.
To build BigBank, go to the bigbank project folder and execute:
mvn clean install
install
.
The build will produce two archives: bigbank-loan-1.7.jar (the server module) and bigbank-client-1.7.jar (the web service client)
*
Start the server.
Boot the Fabric3 runtime from the server/vm/image/bin directory by executing:
java -jar server.jar
jar
*
Deploy the archives.
Copy bigbank-loan-1.7.jar to the runtimes/vm/deploy directory.
* Deploy and Execute the client applications
BigBank includes a web application front-end and loan officer web application. Note both web applications currently do not support Internet Explorer. Please use FireFox, Chrome, or Safari.
Copy bigbank-web-1.7.jar and bigbank-backoffice-1.7.jar to the runtimes/vm/deploy directory.
Deploying BigBank to a Distributed Domain
The samples distribution also contains an automated build process for producing a set of clustered servers. To create the clustered servers, execute the following from the servers/cluster directory:
mvn clean install
...