This is the documentation for CDH 5.1.0.
Documentation for other versions is available at Cloudera Documentation.

Installing Hue Search

You must install and configure Hue before you can use Search with Hue.

  1. Follow the instructions for Installing Hue.
  2. Use one of the following commands to install Search applications on the Hue machine:
    For package installation on RHEL systems:
    sudo yum install hue-search
    For package installation on SLES systems:
    sudo zypper install hue-search
    For package installation on Ubuntu or Debian systems:
    sudo apt-get install hue-search
    For installation using tarballs:
    $ cd /usr/share/hue
    $ sudo tar -xzvf hue-search-####.tar.gz
    $ sudo /usr/share/hue/tools/app_reg/app_reg.py \
    --install /usr/share/hue/apps/search
  3. Update the configuration information for the Solr Server:
    Cloudera Manager-managed Environment Environment without Cloudera Manager
    1. Connect to Cloudera Manager.
    2. Select the Hue service.
    3. Click Configuration > View and Edit.
    4. Search for the word "safety".
    5. Add information about your Solr host to Hue Server (Base) / Advanced. For example, if your hostname was SOLR_HOST, you might add the following:
      [search]
      # URL of the Solr Server
      solr_url=http://SOLR_HOST:8983/solr
    6. (Optional) To enable Hue in environments where Kerberos authentication is required, update the security_enabled property as follows:
      # Requires FQDN in solr_url if enabled
      security_enabled=true
    Update configuration information in /etc/hue/hue.ini.
    1. Specify the Solr URL. For example, to use localhost as your Solr host, you would add the following:
      [search]
      # URL of the Solr Server, replace 'localhost' if Solr is running on another host
      solr_url=http://localhost:8983/solr/
    2. (Optional) To enable Hue in environments where Kerberos authentication is required, update the security_enabled property as follows:
      # Requires FQDN in solr_url if enabled
      security_enabled=true
  4. Configure secure impersonation for Hue.
    • If you are using Search in a Cloudera Manager-managed environment that uses Cloudera Manager 4.8 or later, secure impersonation for Hue is automatically configured. To review secure impersonation settings in the Cloudera Manager home page click the Solr Service, then click the Configuration tab and choose View and Edit, then expand Service-Wide and click Proxy.
    • If you are not using Cloudera Manager or are using a version of Cloudera Manager that is before Cloudera Manager 4.8, configure Hue to impersonate any user that makes requests by modifying /etc/default/solr. The changes you make may vary according to the users for which you want to configure secure impersonation. For example, you might make the following changes:
      SOLR_SECURITY_ALLOWED_PROXYUSERS=hue
      SOLR_SECURITY_PROXYUSER_hue_HOSTS=*
      SOLR_SECURITY_PROXYUSER_hue_GROUPS=*

      For more information about Secure Impersonation or to setup additional users for Secure Impersonation, see Enabling Secure Impersonation.

  5. (Optional) To view files on HDFS, ensure the correct webhdfs_url is included in hue.ini and WebHdfs is properly configured as described in Configuring CDH Components for Hue.
  6. Restart Hue:
    $ sudo /etc/init.d/hue restart
  7. Open http://hue-host.com:8888/search/ in your browser.