Installing Solr client packages

Know how to install client RPMs and configure Solr client tools to connect to a Cloudera cluster.

Cloudera supports the following Search client packages for edge nodes and application hosts:

  • solr-client — general Solr client tooling, including solrctl
  • solr-crunch-client — Solr Crunch indexing tools
  • solr-mapreduce-client — MapReduceIndexerTool client dependencies
  • hbase-solr-client — HBase–Solr and Lily HBase Indexer client tooling

Install only the packages required for your workload. Package names are the same across RHEL, SLES, and Ubuntu; use yum, zypper, or apt as described in Installing the client packages.

The Java Development Kit must be installed and configured on your system.

  1. Download and configure the client RPMs for the RHEL, SUSE Linux Enterprise Server (SLES), and Ubuntu operating systems. For more information, see Downloading and configuring the client packages.
    Additionally, configure the following gpg key location for RHEL.
    gpgkey={{ baseurl }} RPM-GPG-KEY/RPM-GPG-KEY-Jenkins
    The following is an example of the baseurl.
    baseurl=http://cloudera-build-2-us-west-2.vpc.cloudera.com/s3/build/68980718/cdh_client/7.x/redhat8/yum/
  2. Install the Solr client packages you need.

    For example, on RHEL:

    yum install solr-client -y
    yum install solr-crunch-client -y
    yum install solr-mapreduce-client -y
    yum install hbase-solr-client -y

    For more information, see Installing the client packages.

  3. Copy the Solr configuration from a cluster host to the client node.

    For example, copy /etc/solr/conf from a host that runs a Solr role, including solr-env.sh and related files referenced by solrctl.

    # Example only — confirm paths with your cluster administrator
    scp -r <solr-host>:/etc/solr/conf /etc/solr/conf
  4. Verify the installation.

    Ensure SOLR_ZK_ENSEMBLE is set in /etc/solr/conf/solr-env.sh, then run a solrctl command. For example:

    solrctl collection --list

    On Kerberized clusters, run kinit and use solrctl --jaas as described in Enabling Solr clients to authenticate with a secure Solr.

    On clusters with Solr HTTPS or TLS-enabled Solr ZooKeeper, configure additional client settings as described in the Search security documentation before you run solrctl or indexer tools from the edge node.