SolrCloud is the set of Solr features that take Solr's distributed search to the next level, enabling and simplifying the creation and use of Solr clusters. SolrCloud is still under active development, but already supports the following features:

• Central configuration for the entire cluster

• Automatic load balancing and fail-over for queries

• Zookeeper integration for cluster coordination and configuration

Solr Cloud Examples

Solr Cloud is currently an expert level API in development, and the current state is documented on the SolrCloud wiki page. The documentation for the specific SolrCloud version included with this version of LucidWorks Enterprise is here.

LucidWorks Enterprise command line start and stop is a bit different than the example server included in Apache Solr. Some changes are needed to follow along with the Solr examples.

• Instead of java -jar start.jar, use ./start.sh and set JAVA_OPTS to the additional command line options you want to pass to the JVM.

• It is recommended to only install LWE using the installer application; copying the LucidWorksEnterprise directory to another directory to create another server may cause conflicts with ports.

• The Solr config directory in LucidWorks Enterprise is ./solr/cores/collection1/conf as opposed to ./solr/conf

• Queries should include an additional query parameter &distrib=true to submit the search to multiple shards.

Here is how one would set up the SolrCloud Example A: Simple two shard cluster.

Since we'll need two servers for this example, let's make two installations of LucidWorks Enterprise, one in example and the other in example2 . The installation in example should use port 8983 for LWE Core (selected in the installer). The installation in example2 should use the default port (8888) for LWE Core. If enabling other components, be sure to run them on different ports in each install as well.

The original Apache Solr instructions look like this:

cd example
java -Dbootstrap_confdir=./solr/conf -Dcollection.configName=myconf -DzkRun -jar start.jar

Equivalent LucidWorks Enterprise instructions:

cd example
JAVA_OPTS="-Dbootstrap_confdir=./solr/cores/collection1/conf -Dcollection.configName=myconf -DzkRun" bin/start.sh
cd ../example2
JAVA_OPTS="-DhostPort=8888 -Dcollection.configName=myconf -DzkHost=localhost:9983" bin/start.sh

Browse to http://localhost:8983/solr/collection1/admin/zookeeper.jsp to see the state of the cluster (the zookeeper distributed filesystem).