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

Administering Hue

The following sections contain details about managing and operating a Hue installation:

Starting and Stopping the Hue Server

The hue-server package includes service scripts to start and stop the Hue Server.

To start the Hue Server:

$ sudo service hue start

To restart the Hue Server:

$ sudo service hue restart

To stop the Hue Server:

$ sudo service hue stop

Configuring Your Firewall for Hue

Hue currently requires that the machines within your cluster can connect to each other freely over TCP. The machines outside your cluster must be able to open TCP port 8888 on the Hue Server (or the configured Hue web HTTP port) to interact with the system.

Anonymous Usage Data Collection

Hue tracks anonymised pages and application versions in order to gather information to help compare each application's usage levels. The data collected does not include any hostnames or IDs. For example, the data is of the form: /2.3.0/pig, /2.5.0/beeswax/execute.

For Hue 2.5.0 (and later), you can restrict this data collection by setting the collect_usage property to false under the [desktop] section in the Hue configuration file, hue.ini.

[desktop]
...
# Help improve Hue with anonymous usage analytics.
# Use Google Analytics to see how many times an application or specific section of an application is used, nothing more.
## collect_usage=false

If you are using an earlier version of Hue, disable this data collection by navigating to Step 3 of Hue's Quick Start Wizard. Under Anonymous usage analytics, uncheck the Check to enable usage analytics checkbox.

Managing Hue Processes

A script called supervisor manages all Hue processes. The supervisor is a watchdog process; its only purpose is to spawn and monitor other processes. A standard Hue installation starts and monitors the runcpserver process.

  • runcpserver – a web server that provides the core web functionality of Hue

If you have installed other applications into your Hue instance, you may see other daemons running under the supervisor as well.

You can see the supervised processes running in the output of ps -f -u hue.

Note that the supervisor automatically restarts these processes if they fail for any reason. If the processes fail repeatedly within a short time, the supervisor itself shuts down.

Viewing Hue Logs

You can view the Hue logs in the /var/log/hue directory, where you can find:

  • An access.log file, which contains a log for all requests against the Hue Server.
  • A supervisor.log file, which contains log information for the supervisor process.
  • A supervisor.out file, which contains the stdout and stderr for the supervisor process.
  • A .log file for each supervised process described above, which contains the logs for that process.
  • A .out file for each supervised process described above, which contains the stdout and stderr for that process.

If users on your cluster have problems running Hue, you can often find error messages in these log files.

Viewing Recent Log Messages

In addition to logging INFO level messages to the logs directory, the Hue Server keeps a small buffer of log messages at all levels in memory. The DEBUG level messages can sometimes be helpful in troubleshooting issues.

In the Hue UI you can view these messages by selecting the Server Logs tab in the About application. You can also view these logs by visiting http://myserver:port/logs.

Page generated September 3, 2015.