oc_loadtester 0.8.3

Description

The oc_loadtester tool allows customized Gatling simulations to generate load on a single or multiple ownCloud servers. This tool was tested on Ubuntu 14.04, Gatling 2.1.6, PostgreSQL 9.3.6, Java 7 and the following ownCloud versions: 5.0.18, 7.0.4, 8.0.3 and 8.1.0.

A example for simulation scenario are provided here.

The script for multiple ownCloud servers (see here) modifies the original script provided at the Gatling GitHub repository.

Scripts to try (see section 3) a full enviroment using Docker are provided here.

For data analysis (gnuplot) see here

1 How to use for a single ownCloud server

The oc_loadtester is executed in the same host where ownCloud and Gatling are installed.

1.1 Create a new user in ownCloud server (in the examples below, the user testuser was used). This user will be used by oc_loadtester.

1.2 Install Gatling, eg.:

# wget https://repo1.maven.org/maven2/io/gatling/highcharts/gatling-charts-highcharts-bundle/2.1.6/gatling-charts-highcharts-bundle-2.1.6-bundle.zip

# unzip gatling-charts-highcharts-bundle-2.1.6-bundle.zip

1.3 Install the oc_loadtester, eg.:

# wget https://github.com/Malinoski/oc_loadtester/archive/master.zip

# unzip master.zip

1.4 Put the scala code folder in Gatling simulation folder, eg.:

# cp -r oc_loadtester-master/gatling gatling-charts-highcharts-bundle-2.1.6/user-files/simulations

1.5 Run the oc_loadtester from the ownCloud server host, eg.:

# cd gatling-charts-highcharts-bundle-2.1.6

# ./bin/gatling.sh -s MySimulation

2 How to use for multiple ownCloud servers

The oc_loadtester is executed from a local host and the ownCloud servers are installed in remote hosts. Gatling is installed in the local and remote hosts. When the oc_loadtester is executed, the script (ScalingOut.sh) sends the simulation (all scala code) to each Gatling in remote hosts and executes the simulations remotely. The script waits for the simulations to finish, gets the results and generates the final results through Gatling.

2.1 Assuming all hosts have the same user name (if not change the script!)

2.2 Public keys were exchanged in order for ssh to work with no password prompt (ssh-copy-id on all remote hosts)

2.3 Gatling installation (GATLING_HOME and variable) is the same on all hosts

2.4 Check read/write permissions on all folders declared in this script

2.5 Assuming all ownCloud servers share the same database and storage server

2.6 Create a new user in ownCloud server (in the examples below, the user testuser was used). This user will be used by oc_loadtester.

2.7 Install Gatling in each remote host

2.7 In the local host:

• Install Gatling (see section 1.2)

• Install oc_loadtester (see section 1.3)

• Put the Scala code folder in Gatling simulation folder (see section 1.4)

• Configure the required variables in the ScalingOut.sh script: HOSTS, USER_NAME, USER_NAME and SIMULATION_NAME

2.8 Run the oc_loadtester from local host, eg.:

# ./oc_loadtester-master/scripts/ScalingOut.sh

3 How to try in Docker environment

The environment is one Docker container, with everything needed to run oc_loadtester (Apache, PHP, PostgreSQL, Java, ownCloud, Gatling and oc_loadtester).

3.1 In docker host, prepare the work dir, eg.:

# mkdir owncloud-all-in-one

# cd owncloud-all-in-one

# wget https://raw.githubusercontent.com/Malinoski/oc_loadtester/master/docker/Dockerfile

# wget https://raw.githubusercontent.com/Malinoski/oc_loadtester/master/docker/start.sh

3.2 Build the image, eg.:

# docker build -t owncloud-all-in-one:v1 .

3.3 Run a container from the image, eg.:

docker run -tid -p 82:80 --name="owncloud-aio" owncloud-all-in-one:v1

3.4 Configure the ownCloud server

Access http://localhost:82/owncloud and configure as:

Admin user: admin
Admin password: admin
Data folder: /var/www/html/owncloud/data
Database user: admin
Database password: admin
Database name: owncloud
Database host: localhost

3.5 Execute the simulation

Enter the container: # docker exec -it owncloud-aio bash

Execute the simulation: /var/www/html/gatling-charts-highcharts-bundle-2.1.6/bin/gatling.sh -s MySimulation -rf /var/www/html/

See the results (change [ID] for the id generated): http://localhost/mysimulation-[ID]/index.html

Acknowledgements

This development has been funded by FINEP, the Brazilian Innovation Agency.