Public Repository

Last pushed: a year ago
Short Description
Customized COSBench with improved object randomization for NexentaEdge scale ability testing.
Full Description


COSBench is a distributed benchmark tool to test cloud object storage systems. Cosbench is a benchmark for object storage services, written and maintained by Intel.

This branch of COSBench enhances object randomization such that de-duplication and compression have no effect on generated object payloads.

COSbench consists of two key components:

Driver (also referred to as COSBench Driver or Load Generator):

Responsible for workload generation, issuing operations to target cloud object storage, and collecting performance statistics.
Can be accessed via http://<driver-host>:18088/driver/index.html.

Controller (also referred to as COSBench Controller):

Responsible for coordinating drivers to collectively execute a workload, collecting and aggregating runtime status or benchmark results from driver instances, and accepting workload submissions.
Can be accessed via http://<controller-host>:19088/controller/index.html.


Customized application for Nexeta Edge scalability testing.

COSBench was customized to allow Nexenta Edge testing

  • The random input stream is used to generate the storage load. The stream does not include any repeated chunks. This change provides ability to generate load on the Nexenta Edge system with uncompressible data that could not be deduplicated (see -u flag below).
  • The input stream support reset functionality required by Amazon S3 driver for uploading bigger files.


  1. Install Docker onto you system
    For Docker Linux systems configuration and installation refer to DockerDocs

  2. Pull nexenta/cosbench Docker image using command:
    $ docker pull nexenta/cosbench

Run Instructions

1. Run controller and driver in one Docker container on one node.

$ docker run -p 19088:19088 -p 18088:18088 -e ip=<node ip> -e t=both -e n=1 [-e u=true] nexenta/cosbench

$ docker run -p 19088:19088 -p 18088:18088 -e ip= -e t=both -e n=1 -e u=true nexenta/cosbench

2. Distributed load drivers on multiple nodes
2.1 Run Only Driver on each node

$ docker run -p 18088:18088 -e ip=<node ip> -e t=driver [-e u=true] nexenta/cosbench

$ docker run -p 18088:18088 -e ip= -e t=driver -e u=true nexenta/cosbench

2.2 Run Controller on the node

$ docker run -p 19088:19088 -e ip=<comma separated driver node ip list> -e t=controller nexenta/cosbench
$ docker run -p 19088:19088 -e ip=, -e t=controller nexenta/cosbench

(Note: The optional -u=true flag activates uncompressible load generation.)

Example Workloads


Opening Cosbench in browser

In browser address bar type:

http://<controler IP>:19088/controller

Stop Instruction

$ docker ps
$ docker stop <Container ID>

Docker Pull Command