This is the documentation for Cloudera Enterprise 5.8.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

CDH 5 Hue will only work with the default system Python version of the operating system it is being installed on. For example, on RHEL/CentOS 6 you will need Python 2.6 to start Hue.
To install packages from the EPEL repository, 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.
  • Install or upgrade CDH 5 and make sure it is functioning correctly.
For instructions, see Installing the Latest CDH 5 Release and Upgrading Unmanaged CDH Using the Command Line.

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:

Component Dependent Applications
HDFS Core, File Browser
MapReduce Job Browser, Job Designer, Oozie, Hive Editor, Pig, Sqoop
YARN Job Browser, Job Designer, Oozie, Hive Editor, Pig, Sqoop
Oozie Job Designer, Oozie Editor/Dashboard
Hive Hive Editor, Metastore Tables
Impala Impala Editor, Metastore Tables
HBase HBase Browser
Pig Pig Editor, Oozie
Search Solr Search
Spark Spark
Sentry Hadoop Security
Sqoop Oozie
Sqoop 2 Sqoop Transfer
ZooKeeper ZooKeeper
Page generated July 8, 2016.