R7507/memcachedd4e3f60c2952master
README.md
<!-- 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
http://www.apache.org/licenses/LICENSE-2.0
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. -->
YCSB Memcached binding
This section describes how to run YCSB on memcached.
1. Install and start memcached service on the host(s)
Debian / Ubuntu:
sudo apt-get install memcached
RedHat / CentOS:
sudo yum install memcached
2. Install Java and Maven
See step 2 in [../mongodb/README.md](../mongodb/README.md).
3. Set up YCSB
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
4. Load data and run tests
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
5. memcached Connection Parameters
A sample configuration is provided in [conf/memcached.properties](conf/memcached.properties).
Required params
- memcached.hosts
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.
Optional params
- memcached.shutdownTimeoutMillis
Shutdown timeout in milliseconds.
- memcached.objectExpirationTime
Object expiration time for memcached; defaults to Integer.MAX_VALUE.
- memcached.checkOperationStatus
Whether to verify the success of each operation; defaults to true.
- memcached.readBufferSize
Read buffer size, in bytes.
- memcached.opTimeoutMillis
Operation timeout, in milliseconds.
- memcached.failureMode
What to do with failures; this is one of net.spy.memcached.FailureMode enum values, which are currently: Redistribute, Retry, or Cancel.
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