Install Hue for Production

Minimum Required Role: Full Administrator

A production-ready installation of CDH and Hue must be robust and secure. At a minimum, it has:
  • Custom database for Cloudera Manager and select servers such as Hue, Hive Metastore, Oozie
  • High Availability for Hue, Hive, Impala, YARN (Resource Manager), HDFS (NameNode)
  • Secure ecosystem with authentication, authorization, data protection, and data governance.

This page explains how to install a custom (external) database for Cloudera Manager server and all applicable CDH components (not only Hue). We also configure Hue with multiple servers and a Load Balancer to increase performance.

Custom Database

On this page, we configure Cloudera Manager and applicable CDH services with MySQL 5.7 on CentOS 7.3.

Prepare Cluster

When setting up a cluster of machines, you can refresh the default packages, but it is best not to upgrade. Cloudera packages are built with the defaults.

  1. Prepare at least four machines with a supported operating system and uniform capacity:
    • Data replication defaults to three, so a good minimum configuration is three DataNodes, plus the NameNode, each on their own hosts.
    • The HDFS balancer distributes data according to the capacity of the host, so uniform DataNode hosts allows for the even distribution of bytes.
  2. Ensure that the primary host, with Cloudera Manager server, has uniform SSH access on the same port to all hosts.
  3. Ensure that all hosts have internet access to (a) standard package repositories and the (b) archives for Cloudera Manager and CDH.

Install Cloudera Manager

  1. Download cloudera-manager.repo to your package manager source directory. For CentOS 7:
    wget -P /etc/yum.repos.d/
  2. Install Oracle JDK (sourced from the Cloudera repo)
    sudo yum install -y oracle-j2sdk1.7
  3. Install Cloudera Manager daemons and server (and let Cloudera Manager install the agents)
    sudo yum install cloudera-manager-daemons cloudera-manager-server
Available Cloudera Manager Packages
OS Target Dir Repo
CentOS / RHEL /etc/yum.repos.d/ .../redhat/<ver>/x86_64/cm/cloudera-manager.repo
SLES /etc/zypp/repos.d/ .../sles/<ver>/x86_64/cm/cloudera-manager.repo
Ubuntu /etc/apt/sources.list.d/ .../ubuntu/<ver>/x86_64/cm/cloudera.list
Debian /etc/apt/sources.list.d/ .../debian/<ver>/x86_64/cm/cloudera.list

Install Custom Database

We install MySQL 5.7 (64 bit) on CentOS 7.3. It can be on one host within the cluster or remotely. For help with other databases and platforms, see Hue Custom Databases.
  1. Download MySQL 5.7 from the MySQL Yum repository, install, and start:
    rpm -ivh mysql57-community-release-el7-9.noarch.rpm               
    yum install -y mysql-community-server
    systemctl start mysqld.service
  2. Update the temporary password to one that passes the default Validation Plugin options:
    sudo grep 'temporary password' /var/log/mysqld.log
    mysql -uroot -p
    Enter password: <Enter temporary password>
    mysql> ALTER USER 'root'@'localhost' IDENTIFIED BY 'Create new root password';
    mysql> quit
  3. Secure your installation. If you make a mistake, simply rerun:
    sudo /usr/bin/mysql_secure_installation
    Enter password for user root: [Enter new root password] 
    Change the password for root ? n
     ... skipping.
    Remove anonymous users? Y
    Disallow root login remotely? n
     ... skipping.
    Remove test database and access to it? Y
    Reload privilege tables now? Y
    All done!
  4. Enable the server to automatically start on boot:
    sudo systemctl enable mysqld.service
  5. Configure /etc/my.cnf. The bind/listen address and storage engine are important:
    A typical my.cnf file might have these settings:
    ## Example of my.cnf settings
    ## Set value to ~ (CPUs/cores) * 2
    ## For log_file_size errors, see InnoDB Error ib_logfile0 of different size
    ## Disable to prevent various security risks
    ## Do not skip InnoDB!
  6. Restart the server:
    sudo systemctl restart mysqld.service
  7. Ensure InnoDB is the default storage engine:
    mysql -u root -p
    Enter password: <root password>
    mysql> show engines;
    mysql> quit

  8. Create databases and grant permissions (with scripts):
    vi mysql_create_dbs.ddl
    # Paste into database script
    create database scm default character set utf8 default collate utf8_general_ci;
    create database amon default character set utf8 default collate utf8_general_ci;
    create database rman default character set utf8 default collate utf8_general_ci;
    create database hive default character set utf8 default collate utf8_general_ci;
    create database hue default character set utf8 default collate utf8_general_ci;
    create database nav default character set utf8 default collate utf8_general_ci;
    create database navms default character set utf8 default collate utf8_general_ci;
    create database oozie default character set utf8 default collate utf8_general_ci;
    create database sentry default character set utf8 default collate utf8_general_ci;
    vi mysql_grant_perms.ddl
    # Assign passwords and paste into grant script
    grant all on scm.*    to 'scm'@'%'    identified by 'scmP@ssw0rd';
    grant all on amon.*   to 'amon'@'%'   identified by 'amonP@ssw0rd';
    grant all on rman.*   to 'rman'@'%'   identified by 'rmanP@ssw0rd';
    grant all on hive.*   to 'hive'@'%'   identified by 'hiveP@ssw0rd';
    grant all on hue.*    to 'hue'@'%'    identified by 'hueP@ssw0rd';
    grant all on nav.*    to 'nav'@'%'    identified by 'navP@ssw0rd';
    grant all on navms.*  to 'navms'@'%'  identified by 'navmsP@ssw0rd';
    grant all on oozie.*  to 'oozie'@'%'  identified by 'oozieP@ssw0rd';
    grant all on sentry.* to 'sentry'@'%' identified by 'sentryP@ssw0rd';
    # Run scripts
    mysql -u root -p < mysql_create_dbs.ddl
    Enter password: <root password>
    mysql -u root -p < mysql_grant_perms.ddl
    Enter password: <root password>
  9. Verify the connection to the scm database:
    mysql -u scm -p
    Enter password: scmP@ssw0rd
    mysql> quit

Prepare Database

The Cloudera Manager server only starts with the JDBC driver on every applicable host.

  1. Install the JDBC driver on every host in the cluster (or on every host with a server role that uses a custom database).
    # Downlaod and unpack MySQL/J connector
    tar zxvf mysql-connector-java-5.1.41.tar.gz
    # Create directory /usr/share/java if it does not exist
    sudo mkdir -p /usr/share/java/
    # Copy to /usr/share/java
    sudo cp mysql-connector-java-5.1.41/mysql-connector-java-5.1.41-bin.jar /usr/share/java/mysql-connector-java.jar
  2. Prepare scm database (only on the host with Cloudera Manager server):
    /usr/share/cmf/schema/ mysql scm scm 
    Enter SCM password: scmP@ssw0rd
  3. Start the Cloudera Manager server!
    sudo service cloudera-scm-server start

Install CDH and Hue

  1. Point a browser to the host with Cloudera Manager server:
  2. Log on to Cloudera Manager as admin/admin.
  3. Install CDH and Hue with Cloudera Manager Installation Wizard.
    • Stop at the Database Setup page and set all database properties for name, username, and password. Hostname and database type should be set.

  4. When Hue is running, add more Hue servers and a Load Balancer:
    1. Select Actions > Add Role Instances.
    2. Add 2 additional Hue servers (for a total of 3) and click OK.
    3. Add 1 Load Balancer and click OK > Continue.
    4. Check the boxes for the new servers and load balancer.
    5. Select Actions for Selected > Start > Start.
    6. Click Save Changes and Restart Hue.
  5. Click Hue Web UI > Load Balanced Hue Web UI.
  6. Log on to Hue Hue and ensure the port is 8889.