Upgrading Hue

Upgrading Hue from CDH 4 to CDH 5

If you have already removed Hue as part of your upgrade to CDH 5, skip to Installing and Configuring Hue.

Step 1: Stop the Hue Server

See Starting and Stopping the Hue Server.

Step 2: Uninstall the Old Version of Hue

  • On RHEL systems:
$ sudo yum remove hue-common
  • On SLES systems:
$ sudo zypper remove hue-common
  • On Ubuntu or Debian systems:
sudo apt-get remove hue-common

Step 3: Install Hue 3.x

Follow the instructions under Installing Hue.
If Using MySQL as Hue Backend: You may face issues after the upgrade if the default engine for MySQL does not match the engine used by the Hue tables. To confirm the match:
  1. Open the my.cnf file for MySQL, search for "default-storage-engine" and note its value.
  2. Connect to MySQL and run the following commands: 
    use hue;
show create table auth_user;
  3. Search for the "ENGINE=" line and confirm that its value matches the one for the "default-storage-engine" above.

    If the default engines do not match, Hue will display a warning on its start-up page (http://$HUE_HOST:$HUE_PORT/about). Work with your database administrator to convert the current Hue MySQL tables to the engine in use by MySQL, as noted by the "default-storage-engine" property.

Step 4: Start the Hue Server

See Starting and Stopping the Hue Server.

Upgrading Hue from an Earlier CDH 5 Release

You can upgrade Hue either as part of an overall upgrade to the latest CDH 5 release (see Upgrading from an Earlier CDH 5 Release to the Latest Release) or independently. To upgrade Hue from an earlier CDH 5 release to the latest CDH 5 release, proceed as follows.

Step 1: Stop the Hue Server

See Starting and Stopping the Hue Server.

Step 2: Install the New Version of Hue

Follow the instructions under Installing Hue.

Step 3: Start the Hue Server

See Starting and Stopping the Hue Server.