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

Hue Installation

Hue is a suite of applications that provide web-based access to CDH components and a platform for building custom applications.

The following figure illustrates how Hue works. Hue Server is a "container" web application that sits in between your CDH installation and the browser. It hosts the Hue applications and communicates with various servers that interface with CDH components.

The Hue Server uses a database to manage session, authentication, and Hue application data. For example, the Job Designer application stores job designs in the database.

Some Hue applications run Hue-specific daemon processes. For example, Beeswax runs a daemon (Beeswax Server) that keeps track of query states. Hue applications communicate with these daemons either by using Thrift or by exchanging state through the database.

In a CDH cluster, the Hue Server runs on a special node. For optimal performance, this should be one of the nodes within your cluster, though it can be a remote node as long as there are no overly restrictive firewalls. For small clusters of less than 10 nodes, you can use your existing master node as the Hue Server. In a pseudo-distributed installation, the Hue Server runs on the same machine as the rest of your CDH services.

  Note: Install Cloudera Repository

Before using the instructions on this page to install or upgrade, install the Cloudera yum, zypper/YaST or apt repository, and install or upgrade CDH4 and make sure it is functioning correctly. For instructions, see CDH4 Installation and the instructions for upgrading to CDH4 or upgrading from an earlier CDH4 release.

  Note: Running Services

When starting, stopping and restarting CDH components, always use the service (8) command rather than running scripts in /etc/init.d directly. This is important because service sets the current working directory to / and removes most environment variables (passing only LANG and TERM) so as to create a predictable environment in which to administer the service. If you run the scripts in/etc/init.d, any environment variables you have set remain in force, and could produce unpredictable results. (If you install CDH from packages, service will be installed as part of the Linux Standard Base (LSB).)