Skip to content

Latest commit

 

History

History
117 lines (100 loc) · 3.87 KB

README.md

File metadata and controls

117 lines (100 loc) · 3.87 KB
Raw

imembench

Various in-memory storage systems exist today that offer similar functionality but with different features (some more performant, others more reliable). Each of the systems usually has its own APIs, making the benchmark results of them often incomparable. The goal of imembench is to extract and create a common wrapper of the interfaces exposed by these systems, and then drive these systems with almost-the-same workloads by exercising this common interface.

Implementation-wise, we need to use a common language that can talk to these systems in the form of either the source language or bindings.

checkout repository:

after clone the main repository, run git submodule update --init --recursive to pull the git submodules for building.

build instructions:

  • Build dependencies:

    • RAMCloud: at project root, cd bindings/ramcloud/c++ && make
      • if the generated objects are in bindings/ramcloud/c++/obj, rename the obj directory to obj.master
    • Redis: at project root, cd bindings/redis/c++/hiredis && make
    • Tachyon: at project root, cd bindings/tachyon/c++ && make

  • Build imembench:

    • cd loadgenerator && make

use benchmark

First, source env.sh

Then, copy the samplebench.ini (in loadgenerator directory) to imembench.ini and modify the configurations accordingly.

Usage: ./imembench [OPTIONS] [tachyon|ramcloud|redis|all]

  OPTION
        -l, --list                   list available benchmarks and supported targets
        -c, --config_file            configuration file (default imembench.ini) for the benchmark
        -w, --workload_file          workload trace file to use instead of the default benchmark
        -b, --benchmark              comma-separated list of benchmarks to run on the target systems
        -t, --target                 comma-separated list of target system to evaluate

  EXAMPLE
        ./imembench -c imembench.ini redis   # care, run all benchmarks, very slow
        ./imembench -c imembench.ini --benchmark uniformRandomRW redis
        ./imembench -c imembench.ini --workload_file trace.ycsb --benchmark ycsbReplay --target redis,ramcloud

supported targets and benchmarks

Supported targets:

  • ramcloud
  • tachyon
  • redis

Supported benchmarks:

  • ycsbReplay
  • uniformRandomRW
  • zipfRandomRW
  • uniformRandomReadMost
  • zipfRandomReadMost
  • uniformRandomWriteMost
  • zipfRandomWriteMost
  • uniformRandomRWSmallObj
  • zipfRandomRWSmallObj
  • uniformRandomReadMostSmallObj
  • zipfRandomReadMostSmallObj
  • uniformRandomWriteMostSmallObj
  • zipfRandomWriteMostSmallObj
  • uniformRandomRWLargeObj
  • zipfRandomRWLargeObj
  • uniformRandomReadMostLargeObj
  • zipfRandomReadMostLargeObj
  • uniformRandomWriteMostLargeObj
  • zipfRandomWriteMostLargeObj

existing interfaces:

  • RAMCloud:

    • createTable(name)
    • dropTable(name)
    • getTableId(name)
    • read(tableId, key, keyLength, value, rejectRules, ...)
    • write(tableId, key, keyLength, buf, length, ...)
    • increment(tableId, key, keyLength, incrementValue, ...)
    • remove(tableId, key, keyLength, ...)

  • Tachyon (http://tachyon-project.org/api/java/index.html):

    • int read()
    • int read(byte[] b)
    • int read(byte[] b, int off, int len)
    • void seek(long pos)
    • skip(long n)
    • write(byte[] b)
    • write(byte[] b, int off, int len)
    • write(int b)
    • flush()
    • mkdir(TachyonURI path)
    • rename(TachyonURI srcPath, TachyonURI dstPath)

  • Redis:

existing languages:

  • RAMCloud:

    • Source: C/C++
    • Bindings: Python, Java

  • Tachyon:

    • Source: Java
    • Bindings: TBA

  • Redis:

    • Source: C/C++
    • Bindings: C, C#, C++, Clojure, Common List, D, Dart, Elixir, emacs lisp, Erlang, Fancy, GNU Prolog, Go, Haskell, haXe, Io, Java, Lua, Matlab, Nimrod, Node.js, Objective-C, OCaml, Perl, PHP, Pure Data, Python, Rebol, Ruby, Rust, Scala, Scheme, Smalltalk, Tcl, VCL. (http://redis.io/clients)