<!-- Copyright (c) 2015 YCSB contributors. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. See accompanying LICENSE file. -->
This section describes how to run YCSB on memcached.
Debian / Ubuntu:
sudo apt-get install memcached
RedHat / CentOS:
sudo yum install memcached
See step 2 in [../mongodb/README.md](../mongodb/README.md).
Git clone YCSB and compile:
git clone http://github.com/brianfrankcooper/YCSB.git cd YCSB mvn -pl com.yahoo.ycsb:memcached-binding -am clean package
Load the data:
./bin/ycsb load memcached -s -P workloads/workloada > outputLoad.txt
Run the workload test:
./bin/ycsb run memcached -s -P workloads/workloada > outputRun.txt
A sample configuration is provided in [conf/memcached.properties](conf/memcached.properties).
This is a comma-separated list of hosts providing the memcached interface. You can use IPs or hostnames. The port is optional and defaults to the memcached standard port of 11211 if not specified.
Shutdown timeout in milliseconds.
Object expiration time for memcached; defaults to Integer.MAX_VALUE.
Whether to verify the success of each operation; defaults to true.
Read buffer size, in bytes.
Operation timeout, in milliseconds.
What to do with failures; this is one of net.spy.memcached.FailureMode enum values, which are currently: Redistribute, Retry, or Cancel.
- memcached.protocol Set to 'binary' to use memcached binary protocol. Set to 'text' or omit this field to use memcached text protocol
You can set properties on the command line via -p, e.g.:
./bin/ycsb load memcached -s -P workloads/workloada \ -p "memcached.hosts=127.0.0.1" > outputLoad.txt