Details
- Tag
- 0.15.0-RC1
<!-- Copyright (c) 2016 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. -->
This section describes how to run YCSB on Solr running locally.
Clone the YCSB git repository and compile:
git clone git://github.com/brianfrankcooper/YCSB.git cd YCSB mvn -pl com.yahoo.ycsb:solr-binding -am clean package
There must be a running Solr instance with a core/collection pre-defined and configured.
The conf/schema.xml configuration file present in the core/collection just created must be configured to handle the expected field names during benchmarking. Below illustrates a sample from a schema config file that matches the default field names used by the ycsb client:
<field name="id" type="string" indexed="true" stored="true" required="true" multiValued="false"/> <field name="field0" type="text_general" indexed="true" stored="true"/> <field name="field1" type="text_general" indexed="true" stored="true"/> <field name="field2" type="text_general" indexed="true" stored="true"/> <field name="field3" type="text_general" indexed="true" stored="true"/> <field name="field4" type="text_general" indexed="true" stored="true"/> <field name="field5" type="text_general" indexed="true" stored="true"/> <field name="field6" type="text_general" indexed="true" stored="true"/> <field name="field7" type="text_general" indexed="true" stored="true"/> <field name="field8" type="text_general" indexed="true" stored="true"/> <field name="field9" type="text_general" indexed="true" stored="true"/>
If running in SolrCloud mode ensure there is an external Zookeeper cluster running.
Now you are ready to run! First, load the data:
./bin/ycsb load solr -s -P workloads/workloada -p table=<core/collection name>
Then, run the workload:
./bin/ycsb run solr -s -P workloads/workloada -p table=<core/collection name>
For further configuration see below:
The default settings for the Solr node that is created is as follows:
If you wish to customize the settings used to create the Solr node you can created a new property file that contains your desired Solr node settings and pass it in via the parameter to 'bin/ycsb' script. Note that the default properties will be kept if you don't explicitly overwrite them.
Assuming that we have a properties file named "myproperties.data" that contains custom Solr node configuration you can execute the following to pass it into the Solr client:
./bin/ycsb run solr -P workloads/workloada -P myproperties.data -s
If you wish to use SolrCloud mode ensure a Solr cluster is running with an external zookeeper cluster and an appropriate collection has been created. Make sure to pass the following properties as parameters to 'bin/ycsb' script.
solr.cloud=true solr.zookeeper.hosts=<zkHost2>:<zkPort1>,...,<zkHostN>:<zkPortN>