cloudstore-memoizeit

Introduction

CloudStore is an open-source sample e-commerce web application developed following the functional requirements defined by the TPC-W standard, and it's goal is to be used for the analysis of cloud characteristics of systems, such as capacity, scalability, elasticity and efficiency. It was developed as a Showcase application to validate the CloudScale tools that were developed during that EU funded project.

The application was developed in Java using the Spring framework and running on a Tomcat web application server, while using a MySQL database. Make sure you have installed all three before attempting to run CloudStore. For compiling it you will also need Maven.

It is necessary to populate the online shop with entries. The needed static files and images can be generated with the ImgGen tool or by other means, and the database can be automatically populated with a provided Java class. For convenience, a default database dump, static images and load generation scripts are available already prepared, in order to allow you to start testing a deployment in a very short time.

Different IaaS, PaaS, Storages and Architectures can be tested with little one little changes to the code or configuration, but such test are not described in this document.

Prerequisites

Note that CloudStore requires the following software installed system where it will be running:

• Java
• Maven
• Tomcat
• MySQL

Deployment

To deploy CloudStore on public or private cloud you can use our deployment scripts. We have also developed the distributed JMeter scripts in order to load test the CloudStore.

Otherwise, you can hand-install CloudStore in your computer or virtual machines, and generate load with Gatling, or manually by connecting your browser to the deployed site.

Compiling

CloudStore is a Maven project so you will have to install the Maven tool.

When you installed Maven you can compile CloudStore into a war archive by executing the following command:

$ mvn clean install

from the directory where the pom.xml file is located.

Database

CloudStore uses a MySQL database, which can be generated by running Generate.java file:

$ cd src/main/java/eu/cloudscale/showcase/generate/
$ javac Generate.java
$ java Generate mysql

But first make sure you have the Spring Framework already installed.

This process can take a long time. Another option is to import a previously prepared SQL dump into your MySQL database.

Running

For running CloudStore on your computer you will need Tomcat, Spring and MySQL database installed. You can also import and run CloudStore from the Eclipse IDE. Before you can run CloudStore on Tomcat you will need to compile it into a .war archive. but before compiling the CloudStore you need to edit some configuration files.

Configs

With the configuration files you can tell CloudStore where it can find the images, and how to connect to database.

src/main/resources/app.properties

In this file set the url for CSS, JavaScript and image files:

eu.cloudscale.files.url.css - URL or path to folder with CSS files

eu.cloudscale.files.url.img - URL or path to folder with image files

eu.cloudscale.files.url.js - URL or path to folder with JavaScript files

src/main/resources/database/database.aws.hibernate.properties

In this file configure the MySQL database:

jdbc.driverClassName - Set to com.mysql.jdbc.ReplicationDriver if you want to use master-slave MySQL setup. Otherwise set it to com.mysql.jdbc.Driver value.

jdbc.url - Connection URL to the host and database. Format is jdbc:mysql://<host>/<database_name>.

Note: If you want to use a master-slave MySQL setup, use jdbc:mysql:replication:// format, otherwise jdbc:mysql://.

jdbc.username - Username to connect to database

jdbc.password - Password for the user to connect to database

jdbc.hibernate.dialect - Hibernate dialect

Installing

Copy compiled WAR target/showcase-1.0.0-BUILD-SNAPSHOT.war to Tomcat webapps/ directory and restart Tomcat.

Development

1. Download ZIP archive from GitHub
2. Extract ZIP archive somewhere on your filesystem
3. Open Eclipse
4. Choose File -> Import -> General -> Existing Projects into Workspace
5. Click Browser near Select root directory
6. Click Finish