This is the documentation for Cloudera Search 1.3.0 for CDH 4.
Documentation for other versions is available at Cloudera Documentation.

Installing Cloudera Search without Cloudera Manager

  • To install Cloudera Search 1.3 or earlier, which requires CDH 4, see Ways To Install CDH 4 for details on installing CDH 4 using packages.
  Note: This page describe how to install CDH using packages as well as how to install CDH using Cloudera Manager.

You can also elect to install Cloudera Search manually. For example, you might choose to install Cloudera Search manually if you have an existing installation to which you want to add Search.

To use Cloudera Search 1.3 with CDH 4:

Cloudera Search provides the following packages:

Package Name





Platform specific service script for starting, stopping, or restart Solr.


Cloudera Search documentation.


Tools to index documents using MapReduce.


Examples, Contrib, and Utility code and data.

Before You Begin Installing Cloudera Search Without Cloudera Manager

The installation instructions assume that the sudo command is configured on the hosts where you are installing Cloudera Search. If sudo is not configured, use the root user (superuser) to configure Cloudera Search.

  Important: Running services: When starting, stopping, and restarting CDH components, always use the service (8) command rather than running /etc/init.d scripts directly. This is important because service sets the current working directory to the root directory (/) and removes environment variables except LANG and TERM. This creates a predictable environment in which to administer the service. If you use /etc/init.d scripts directly, any environment variables continue to be applied, potentially producing unexpected results. If you install CDH from packages, service is installed as part of the Linux Standard Base (LSB).

Install Cloudera's repository: before using the instructions in this guide to install or upgrade Cloudera Search from packages, install Cloudera's yum, zypper/YaST or apt repository, and install or upgrade CDH and make sure it is functioning correctly.

Installing Solr Packages

This topic describes how to complete a new installation of Solr packages. To upgrade an existing installation, see Upgrading Cloudera Search.

To install Cloudera Search on RHEL systems:
sudo yum install solr-server
To install Cloudera Search on Ubuntu and Debian systems:
$ sudo apt-get install solr-server
To install Cloudera Search on SLES systems:
$ sudo zypper install solr-server
  Note: See also Deploying Cloudera Search.
To list the installed files on RHEL and SLES systems:
$ rpm -ql solr-server solr
To list the installed files on Ubuntu and Debian systems:
$ dpkg -L solr-server solr

You can see that the Cloudera Search packages are configured according to the Linux Filesystem Hierarchy Standard.

Next, enable the server daemons you want to use with Hadoop. You can also enable Java-based client access by adding the JAR files in /usr/lib/solr/ and /usr/lib/solr/lib/ to your Java class path.