This is the documentation for Cloudera Enterprise 5.12.x. Documentation for other versions is available at Cloudera Documentation.

Install Hue 1-2-3

Minimum Required Role: Full Administrator

This page explains the simplest way to install Cloudera Manager and CDH 5 with Hue.

  Important: Easy Install uses an embedded database and should not be used in production. For custom database solutions, see Hue Databases.

Easy Install

The simplest way to install CDH and Hue is with Cloudera Manager using the embedded database. Easy Install is for proof-of-concept installations only.

  Note: We install the latest version of CDH on CentOS 7. For more platforms, see Easy Install Variations.
Figure 1. Video: Easy Install of CDH and Hue with Cloudera Manager

Install Cloudera Manager at the Command Line

  1. Prepare a cluster of four or more Linux machines with a supported operating system.
  2. Download a compatible Cloudera Manager package repo (or list) to one host.
  3. Install Oracle JDK, Cloudera Manager server and daemons, and the embedded PostgreSQL database (from the repo).
  4. Start the embedded database and Cloudera Manager server. 
    ## Download Cloudera Manager to your package manager source directory.  
wget https://archive.cloudera.com/cm5/redhat/7/x86_64/cm/cloudera-manager.repo -P /etc/yum.repos.d/

## Install Cloudera Manager and Dependencies (sourced from the Cloudera Manager repo)
sudo yum install -y oracle-j2sdk1.7
sudo yum install -y cloudera-manager-daemons cloudera-manager-server
sudo yum install -y cloudera-manager-server-db-2

## Start the database and server
sudo service cloudera-scm-server-db start
sudo service cloudera-scm-server start


Install CDH and Hue with Cloudera Manager Installation Wizard

  1. Point a browser to the host with the Cloudera Manager server: 
    http:/myhost.example.com:7180
  2. Log on to Cloudera Manager as admin/admin.
  3. Specify hosts with patterns (myhost-[1-n].example.com), or use a legal delimiter.
  4. Run Cluster Installation to install Cloudera Manager agents:
    • Step 1 Use parcels (or packages). Keep the other repository defaults.
    • Step 2 Check both boxes to install JDK 7u67. Do not check if using another supported version.
    • Step 3 Skip Single User Mode if possible.
    • Step 4 Enter SSH login credentials. For tips with ec2, see Install Hue on EC2 in AWS.
    • Step 5 Cloudera Manager agents are installed. If they fail, click Uninstall failed hosts and Retry.
    • Step 6 Parcels are downloaded, distributed, and activated across the cluster.
    • Step 7 Run the Host Inspector to repair issues and click Finish.
        Note: If prompted to disable Transparent Huge Page Compaction, run on each host: 
      echo never > /sys/kernel/mm/transparent_hugepage/defrag
echo never > /sys/kernel/mm/transparent_hugepage/enabled
  5. Run Cluster Setup to install Hue and other CDH services:
    • Step 1 Select services that include Hue, such as Core with Impala. Check Include Cloudera Navigator.
    • Step 2 Add 2 roles for the ZooKeeper Server Zookeeper Server Role (for a total of 3).
    • Step 3 Use default Embedded Database and store password (or see Hue Custom Databases) .
    • Step 4 Review Changes.
    • Step 5 First Run commands deploy all selected services.
    • Step 6 Click Finish.
  6. Go to the Green Status icon Hue Service.

Easy Install Variations

This section expands Install Cloudera Manager at the Command Line for other supported platforms.

CentOS / RHEL

Available versions: http://archive.cloudera.com/cm5/redhat/ 
## Download cloudera-manager.repo to your package manager source directory 
wget https://archive.cloudera.com/cm5/redhat/7/x86_64/cm/cloudera-manager.repo -P /etc/yum.repos.d/
#wget https://archive.cloudera.com/cm5/redhat/6/x86_64/cm/cloudera-manager.repo -P /etc/yum.repos.d/
#wget https://archive.cloudera.com/cm5/redhat/5/x86_64/cm/cloudera-manager.repo -P /etc/yum.repos.d/
  
## Install Oracle JDK (sourced from the Cloudera repo)
sudo yum install -y oracle-j2sdk1.7
  
## Install Cloudera Manager daemons and server
sudo yum install -y cloudera-manager-daemons cloudera-manager-server
  
## Install the embedded PostreSQL database
sudo yum install -y cloudera-manager-server-db-2
  
## Start the database and server
sudo service cloudera-scm-server-db start
sudo service cloudera-scm-server start
  Important: CentOS/RHEL 5: You must install python26 and psycopg2 (Python-PostgreSQL Database Adapter). 
## On all machines in the cluster
yum install -y python26

## On the machine hosting the Hue server
yum install -y gcc python26-devel postgresql84-devel
wget http://initd.org/psycopg/tarballs/PSYCOPG-2-6/psycopg2-2.6.2.tar.gz
tar zxvf psycopg2-2.6.2.tar.gz
cd psycopg2-2.6.2
/usr/bin/python2.6 ./setup.py install

If the Hue Server is already installed, import or link to psycopg2 into the Hue environment:

## Navigate to Hue within your specific CDH parcel version
cd /opt/cloudera/parcels/`ls -l /opt/cloudera/parcels | grep CDH | tail -1 | awk '{print $9}'`/lib/hue/build/env/bin
./python2.6
>>>> import psycopg2
cd /opt/cloudera/parcels/`ls -l /opt/cloudera/parcels | grep CDH | tail -1 | awk '{print $9}'`/lib/hue/build/env/lib/python2.6/site-packages/
ln -s /usr/lib64/python2.6/site-packages/psycopg2 psycopg2
  Note: CentOS/RHEL 7.3: To resolve transparent huge page compaction errors, you must run: 
# Run on each host in cluster and add to rc.local
echo never > /sys/kernel/mm/transparent_hugepage/defrag
echo never > /sys/kernel/mm/transparent_hugepage/enabled

SLES

Available versions: http://archive.cloudera.com/cm5/sles/

SLES 12sp2

## Refresh repo for python-psycopg2 on each host in the cluster
zypper addrepo http://download.opensuse.org/repositories/server:/database:/postgresql/SLE_12_SP2/server:database:postgresql.repo
zypper refresh
## Download cloudera-manager.repo to your package manager source directory 
wget https://archive.cloudera.com/cm5/sles/12/x86_64/cm/cloudera-cm.repo -P /etc/zypp/repos.d/
  
## Install Oracle JDK (sourced from the Cloudera repo)
sudo zypper install oracle-j2sdk1.7
  
## Install Cloudera Manager daemons and server
sudo zypper install cloudera-manager-daemons cloudera-manager-server
  
## Install the embedded PostreSQL database
sudo zypper install cloudera-manager-server-db-2

## Start the database and server
sudo service cloudera-scm-server-db start
sudo service cloudera-scm-server start
  Note: SLES 12sp1: Two workarounds are required: 
## Edit baseurl in devel_languages_python.repo to avoid refresh error
vi /etc/zypp/repos.d/devel_languages_python.repo
baseurl=http://download.opensuse.org/repositories/devel:/languages:/python/SLE_12_SP1
---
sudo zypper refresh
## To start the Cloudera Manager server, reload the daemon)
cd /var/log/cloudera-scm-server
sudo systemctl daemon-reload

SLES 11sp4

## Refresh repo for python-psycopg2 on each host in the cluster
zypper addrepo http://download.opensuse.org/repositories/server:database:postgresql/SLE_11_SP4/server:database:postgresql.repo
zypper refresh
## Download cloudera-manager.repo to your package manager source directory 
wget https://archive.cloudera.com/cm5/sles/11/x86_64/cm/cloudera-manager.repo -P /etc/zypp/repos.d/
  
## Install Oracle JDK (sourced from the Cloudera repo)
sudo zypper install oracle-j2sdk1.7
  
## Install Cloudera Manager daemons and server
sudo zypper install cloudera-manager-daemons cloudera-manager-server
  
## Install the embedded PostreSQL database
sudo zypper install cloudera-manager-server-db-2
  
## Start the database and server
sudo service cloudera-scm-server-db start
sudo service cloudera-scm-server start

Ubuntu

Available versions: http://archive.cloudera.com/cm5/ubuntu/ 
## Download cloudera.list to your package manager source directory 
wget https://archive.cloudera.com/cm5/ubuntu/xenial/amd64/cm/cloudera.list -P /etc/apt/sources.list.d/
#wget https://archive.cloudera.com/cm5/ubuntu/trusty/amd64/cm/cloudera.list -P /etc/apt/sources.list.d/
#wget https://archive.cloudera.com/cm5/ubuntu/precise/amd64/cm/cloudera.list -P /etc/apt/sources.list.d/
  
## Add a repository key
wget https://archive.cloudera.com/cm5/ubuntu/xenial/amd64/cm/archive.key -O archive.key
#wget https://archive.cloudera.com/cm5/ubuntu/trusty/amd64/cm/archive.key -O archive.key
#wget https://archive.cloudera.com/cm5/ubuntu/precise/amd64/cm/archive.key -O archive.key
sudo apt-key add archive.key
sudo apt-get update
  
## Install Oracle JDK (sourced from the Cloudera repo)
sudo apt-get install oracle-j2sdk1.7
  
## Install Cloudera Manager daemons and server
sudo apt-get install cloudera-manager-daemons cloudera-manager-server
  
## Install the embedded PostreSQL database
sudo apt-get install cloudera-manager-server-db-2
  
## Start the database and server
sudo service cloudera-scm-server-db start
sudo service cloudera-scm-server start

Debian

Available versions: http://archive.cloudera.com/cm5/debian/ 
## Download cloudera.list to your package manager source directory
wget https://archive.cloudera.com/cm5/debian/jessie/amd64/cm/cloudera.list -P /etc/apt/sources.list.d/
#wget https://archive.cloudera.com/cm5/debian/wheezy/amd64/cm/cloudera.list -P /etc/apt/sources.list.d/
  
## Add a repository key
wget https://archive.cloudera.com/cm5/debian/jessie/amd64/cm/archive.key -O archive.key
#wget https://archive.cloudera.com/cm5/debian/wheezy/amd64/cm/archive.key -O archive.key
sudo apt-key add archive.key
sudo apt-get update
  
## Install Oracle JDK (sourced from the Cloudera repo)
sudo apt-get install oracle-j2sdk1.7
  
## Install Cloudera Manager daemons and server
sudo apt-get install cloudera-manager-daemons cloudera-manager-server
  
## Install the embedded PostreSQL database
sudo apt-get install cloudera-manager-server-db-2
  
## Start the database and server
sudo service cloudera-scm-server-db start
sudo service cloudera-scm-server start
Page generated August 14, 2017.