Apache Solr Search Installation
Also available as:
PDF

Chapter 3. Installing HDP Search Using Ambari

HDP Search can be installed using a Management Pack created by Lucidworks for Ambari 2.5. Complete the following steps to download and install the Management Pack.

  1. Download the Ambari management pack to the Ambari Server host.

    In this example, /tmp is a temporary directory that stores the management pack before it is installed.

    cd /tmp
    wget http://public-repo-1.hortonworks.com/HDP-SOLR/hdp-solr-ambari-mp/solr-service-mpack-2.2.8.tar.gz
  2. Install the management pack on the Ambari Server host, using the following command:

    # ambari-server install-mpack --mpack=/tmp/solr-service-mpack-2.2.8.tar.gz

    You should see the following output:

    Using python /usr/bin/python
    Installing management pack
    Ambari Server 'install-mpack' completed successfully.

The management pack has now been added to Ambari.

Add the Solr service, either during initial cluster installation using the Ambari installation wizard or after cluster deployment.

It’s important to note that during the Solr install, the Solr package has a set of prerequisite checks that are performed before the package can be completely installed. Specific checks such as disk space, installation directory access, solr users, and the Java setup are checked during this process. If any of these checks fail, they need to be manually remediated on each node where Solr will be installed before the installation task can be retried.

In the case of the Java preinstall check failing, the easiest remediation is to login to each machine that Solr will be installed on, temporarily set the JAVA_HOME environmental variable, then then use yum/zypper/apt-get to install the package. For example on CentOS:

export JAVA_HOME=/usr/jdk64/jdk1.8.0_77
yum install lucidworks-hdpsearch

Once all of the prerequisite checks have been satisfied and the package is installed, you can simply click “Retry” in the Ambari Web UI to move forward and complete the installation.

For information about Solr configuration options, refer to the Startup Option Reference section of the HDP Search Ambari Installation Guide.