README for VoltDB stored value card application

This application performs high velocity transaction processing for stored value cards. These transactions include:

• Pre-Authorizations, where the available balance is checked if sufficient and then modified, but the purchase is not completed.
• Purchase, where the previously-authorized purchase is completed
• Transfer, where a balance transfer is made between two cards.

The code is divided into two projects. Under the "db" directory is the database project, which contains the schema, stored procedures and other configurations that are compiled into a catalog and run in a VoltDB database. Under the "client" directory is a java client that loads a set of cards and then generates random card transactions a high velocity to simulate card activity.

See below for instructions on running these applications. For any questions, please contact fieldengineering@voltdb.com.

Database application

The database application must be started first. It can be run from the command line or the catalog file can be deployed using VoltDB Enterprise Manager which is provided with VoltDB Enterprise Edition.

To build and run the database application:

cd db
./run.sh

Optionally, you can just compile or build the catalog with the following commands

./run.sh srccompile
./run.sh catalog

You can remove the compiled code with:

./run.sh clean

To configure for more than 1 node, edit the deployment.xml file. Basic instructions are in Using VoltDB, Section 6.1, and all the options for the deploymen file are described in Appendix D.

Client application

To build and run the database application:

cd client
./run.sh

Optionally, you can just compile with the following commands

./run.sh srccompile

You can run the benchmark with:

./run.sh benchmark

You may want to edit the parameters for the benchmark. To do this, edit the run.sh file, under the section "function benchmark()".

You can remove the compiled code with:

./run.sh clean