The starter calculator applications are the recommended way to get familiar with Fabric3. To build and deploy the calculator applications, do the following:
Build the starter modules.
In the directory where you extracted the samples distribution, go to the /starter
project folder and execute: mvn clean install
JARs containing the application artifacts will be created in the /target output directories for each application.
Note internet access is required the first time the project is built so Maven can download the required project dependencies. Remote access can be turned off for subsequent builds by executing:
mvn -o clean install
Build the Fabric3 server distribution.
Download the Fabric3 runtime by executing the Maven build script from the servers/vm
directory: mvn -o clean install
.
This will create a server image for use with the samples in the /target/image directory. Note the server is configured to run as a single instance. The /servers/cluster
directory contains modules which will configure a multi-cluster Fabric3 installation. The starter applications can be deployed to either topology.
Start the server.
To launch a Fabric3 server in single-VM mode, execute the following from the servers/vm/target/image/bin
directory:
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
It may be necessary to run Fabric3 with larger heap settings than the JVM defaults. To do so, use the standard JVM command line parameters, e.g.:
java -Xmx1024M -XX:MaxPermSize=1024M -jar server.jar
It may be necessary to configure some JVMs (e.g. OS X) to use IPv4 over IPv6. To do so, use the standard JVM command line parameters, e.g.:
java -Djava.net.preferIPv4Stack=true -jar server.jar
Deploy the application
After the server has booted, deploy a calculator application archive by copying it to the Fabric3 runtime /deploy
directory. The runtime will write a message to the console after the archive has been deployed. Depending on the application deployed, one of the following endpoints will be available:
- The web calculator UI can be accessed at http://localhost:8181/calculator/entry.html.
- The REST calculator resource can be accessed using a GET with the formula to calculate included in the URI as in: http://localhost:8181/calculator/1+1.
- The web services calculator can be accessed at http://localhost:8181/calculator and its WSDL from http://localhost:8181/calculator?wsdl.
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. To run the WSCalcClient via the commandline change to the /samples/wscalc-client
folder and type:
mvn exec:java