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

Installing Hue

This section describes Hue installation and configuration on a cluster. The steps in this section apply whether you are installing on a single machine in pseudo-distributed mode, or on a cluster.

Install Python 2.6 or 2.7

Python 2.6 or 2.7 is required to run Hue. RHEL 5 and CentOS 5, in particular, require the EPEL repository package.

In order to install packages from the EPEL repository, first download the appropriate repository rpm packages to your machine and then install Python using yum. For example, use the following commands for RHEL 5 or CentOS 5:
$ su -c 'rpm -Uvh http://download.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm'
...
$ yum install python26

Installing the Hue Packages

  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 CDH 5 and make sure it is functioning correctly. For instructions, see CDH 5 Installation and the instructions for upgrading to CDH 5 .

You must install the hue-common package on the machine where you will run the Hue Server. In addition, if you will be using Hue with MRv1, you must install the hue-plugins package on the system where you are running the JobTracker. (In pseudo-distributed mode, these will all be the same system.)

The hue meta-package installs the hue-common package and all the Hue applications; you also need to install hue-server, which contains the Hue start and stop scripts.

  Note: If you do not know which system your JobTracker is on, install the hue-plugins package on every node in the cluster.

On RHEL systems:

  • On the Hue Server machine, install the hue package:
$ sudo yum install hue
  • For MRv1: on the system that hosts the JobTracker, if different from the Hue server machine, install the hue-plugins package:
$ sudo yum install hue-plugins

On SLES systems:

  • On the Hue Server machine, install the hue package:
$ sudo zypper install hue
  • For MRv1: on the system that hosts the JobTracker, if different from the Hue server machine, install the hue-plugins package:
$ sudo zypper install hue-plugins

On Ubuntu or Debian systems:

  • On the Hue Server machine, install the hue package:
$ sudo apt-get install hue 
  • For MRv1: on the system that hosts the JobTracker, if different from the Hue server machine, install the hue-plugins package:
$ sudo apt-get install hue-plugins
  Important: For all operating systems, restart the Hue service once installation is complete. See Starting and Stopping the Hue Server.

Hue Dependencies

The following table shows the components that are dependencies for the different Hue applications and provides links to the installation guides for the required components that are not installed by default.

Component Required Applications
HDFS Yes Core, File Browser
MapReduce No Job Browser, Job Designer, Oozie, Hive Editor, Pig, Sqoop
YARN No Job Browser, Job Designer, Oozie, Hive Editor, Pig, Sqoop
Oozie Yes Job Designer, Oozie Editor/Dashboard
Hive Yes Hive Editor, Metastore Tables
Impala No Impala Editor, Metastore Tables
HBase No HBase Browser
Pig No Pig Editor, Oozie
Search No Solr Search
Spark Installation No Spark
Sqoop No Oozie
Sqoop 2 No Sqoop Transfer
ZooKeeper No ZooKeeper
Page generated September 3, 2015.