1. Prerequisites


Hue is not supported on Ubuntu or Debian.

Complete the following prerequisites before deploying Hue.

  1. Verify that you have a host that supports Hue:

    • 64-bit Red Hat Enterprise Linux (RHEL) 5 or 6

    • 64-bit CentOS 5 or 6• 64-bit Oracle Linux 5 or 6

    • 64-bit SUSE Linux Enterprise Server (SLES) 11, SP1, SP3, or SP4

  2. Verify that you have a browser that supports Hue:


    Table 14.1. Hue-Supported Browsers

    Linux (RHEL, CentOS, Oracle, SLES)

    Windows (VISTA, 7)

    Mac OS X (10.6 or later)

    Firefox latest stable release

    Firefox latest stable release

    Firefox latest stable release

    Google Chrome latest stable release

    Google Chrome latest stable release

    Google Chrome latest stable release


    Internet Explorer 9 (for Vista + Windows 7)



    Safari latest stable release

    Safari latest stable release

  3. Verify that you have at least Python 2.6.6 or higher installed.

  4. Stop all of the services in your cluster. For more information see the instructions provided in the HDP Reference Guide.

  5. Install and run the HDP Hadoop cluster from HDP-2.2.X.

    The following table outlines dependencies on HDP components:


    Table 14.2. Hue Dependencies on HDP Components







    Core, Filebrowser

    HDFS access through WebHDFS or HttpFS



    Core, Filebrowser

    Transitive dependency via Hive or Oozie



    JobDesigner, Oozie

    Oozie access through REST API



    Hive, HCatalog

    Beeswax server uses the Hive client libraries



    HCatalog, Pig

    HCatalog and Pig use WebHcat REST API

  6. Choose a Hue Server host machine in your cluster to deploy your Hue Server.

    You can deploy Hue on any host within your cluster. If your corporate firewall policies allow, you can also use a remote host machine as your Hue server. For evaluation or small cluster sizes, use the master install machine for HDP as your Hue server.

    The Hive client configuration (hive-site.xml file) needs to be populated on the host to run Hue. In the beeswax section of hue.ini, configure hive_conf_dir to point to the location of the Hive configuration:


  7. Configure the firewall.

    • Verify that the host machines within your cluster can connect to each other over TCP.

    • The machines outside your cluster must be able to open TCP port 8000 on the Hue Server (or the configured Hue web HTTP port) to interact with the system.

loading table of contents...