4. Configure Hue

Use the following commands to explore the configuration options for Hue.

  • To list all available configuration options:

    /usr/lib/hue/build/env/bin/hue config_help | less

  • To use multiple files to store your configuration:

    Store all of the files in the /etc/hue/conf directory, with extension .ini. Hue will load and merge them.

Configure Web Server

Use the following instructions to configure Web server:

These configuration variables are under the [desktop] section in the hue.ini configuration file.

  1. Specify the Hue HTTP Address.

    Use the following options to change the IP address and port of the existing Web Server for Hue (by default, CherryPy).

    # Webserver listens on this address and port



    The default setting is port 8000 on all configured IP addresses.

  2. Specify the Secret Key.

    To ensure that your session cookies are secure, enter a series of random characters (30 to 60 characters is recommended) as shown below:


  3. Configure authentication.

    By default, the first user who logs in to Hue can choose any username and password and gets the administrator privileges. This user can create other user and administrator accounts. User information is stored in the Django database in the Django backend.

  4. (Optional.) Configure Hue for SSL.

    Install pyOpenSSL in order to configure Hue to serve over HTTPS. To install pyOpenSSL, from the root of your Hue installation path, complete the following instructions:

    • Run the following command on the Hue Server:

      ./build/env/bin/easy_install pyOpenSSL

    • Configure Hue to use your private key. Add the following to hue.ini file:



      ssl_cipher_list = "DEFAULT:!aNULL:!eNULL:!LOW:!EXPORT:!SSLv2" (default).


      Ideally, you should have an appropriate key signed by a Certificate Authority. For test purposes, you can create a self-signed key using the openssl command on your system:

      ### Create a keyopenssl genrsa 1024 > host.key

      ### Create a self-signed certificateopenssl req -new -x509 -nodes -sha1 -key host.key > host.cert

      To upload files using the Hue File Browser over HTTPS, you must have a proper SSL Certificate.

Configure Hadoop

Use the following instructions to configure Hadoop.

The following configuration variables are in the [hadoop] section of the hue.ini configuration file.

  1. Configure an HDFS Cluster.

    Hue currently supports only one HDFS cluster. Ensure that you define the HDFS cluster under the [hadoop][[hdfs_clusters]] [[[default]]] subsection. Use the following variables to configure the HDFS cluster:


    Table 14.3. Variables to Configure HDFS Cluster



    Default/Example Value


    This is equivalent to fs.defaultFS (fs.default.name) in the Hadoop configuration.

    hdfs:// fqdn.namenode.host:8020


    WebHDFS URL.

    The default value is the HTTP port on the NameNode. Example: http://fqdn.namenode.host:50070/webhdfs/v1

  2. Configure a YARN (MR2) Cluster.

    Hue supports only one YARN cluster currently. Ensure that you define the YARN cluster under the [hadoop][[yarn_clusters]] [[[default]]] sub-section. Use the following variables to configure the YARN cluster:


    Table 14.4. Variables to Configure the YARN Cluster



    Default/Example Value


    Set this property to true. Hue will submit jobs to this YARN cluster. Note that JobBrowser will not be able to show MR2 jobs.



    The URL of the ResourceManager API.



    The URL of the ProxyServer API.



    TThe URL of the HistoryServer API.



    The URL of the NodeManager API.



    For more information on how to configure Hue with a NameNode HA cluster, see "Deploy Hue with an HA Cluster."

Configure Beeswax

In the [beeswax] section of the configuration file, you can specify the following values:


Table 14.5. Beeswax Configuration Values



Default/Example Value


Host where Hive server Thrift daemon is running. If Kerberos security is enabled, use fully-qualified domain name (FQDN).


Port where HiveServer2 Thrift server runs on.



Hive configuration directory, where hive-site.xml is located.



Timeout in seconds for Thrift calls to HiveServer2.



Depending on your environment and the Hive queries you run, queries may fail with an internal error processing query message. Look for an error message java.lang.OutOfMemoryError:

GC overhead limit exceeded in the beeswax_server.out log file. To increase the heap size to avoid this out of memory error, modify the hadoop- env.sh file and change the value of HADOOP_CLIENT_OPTS.

Configure Hue to Communicate with HiveServer2 over SSL (Optional)

(Optional) Use the following changes to hue.ini to configure Hue to communicate with HiveServer2 over SSL:

SSL communication enabled for this server.
Path to Certificate Authority certificates.
Path to the public certificate file.
Choose whether Hue should validate certificates received from the server.

Configure JobDesigner and Oozie

In the [liboozie] section of the configuration file, specify oozie_url, the URL of the Oozie service as specified by the OOZIE_URL environment variable for Oozie.

Configure hive-site.xml

Modify the hive-site.xml file. On the HiveServer2 host, add the following property to the $HIVE_CONF_DIR/hive-site.xml Where $HIVE_CONF_DIR is the directory for storing Hive configuration files. For example, /etc/hive/conf.


Configure WebHCat

In the [hcatalog] section of the hue.ini configuration file, set templeton_url, to the hostname or IP of the WebHCat server. For example: http:// hostname:50111/templeton/v1/.

loading table of contents...