Hue High Availability

/etc/nginx/conf.d/hue.conf

server {
    server_name NGINX_HOSTNAME;
    charset utf-8;

    listen 8001;

    # Or if running hue on https://
    ## listen 8001 ssl;
    ## ssl_certificate /path/to/ssl/cert;
    ## ssl_certificate_key /path/to/ssl/key;

    client_max_body_size 0;
    location / {
        proxy_pass http://hue;
        proxy_set_header Host $http_host;
        proxy_set_header X-Forwarded-For $remote_addr;

        # Or if the upstream Hue instances are running behind https://
        ## proxy_pass https://hue;
    }

    location /static/ {
        # Uncomment to expose the static file directories.
        ## autoindex on;

        # If Hue was installed with packaging install:
        ## alias /usr/lib/hue/build/static/;

        # Or if on a parcel install:
        alias /opt/cloudera/parcels/CDH/lib/hue/build/static/;

        expires 30d;
        add_header Cache-Control public;
    }
}

upstream hue {
    ip_hash;

    # List all the Hue instances here for high availability.
    server HUE_HOST1:8888 max_fails=3;
    server HUE_HOST2:8888 max_fails=3;
    ...
}

• Replace NGINX_HOSTNAME with the URL of the host where you installed nginx. For example:

  server_name myhost-2.myco.com;

• In the location/static block, comment or uncomment the alias lines, depending on whether your cluster was installed using parcels or packages. (The comment indicator is #.)
• In the upstream hue block, list all the hostnames, including port number, of the Hue instances in your cluster. For example:

  server myhost-1.myco.com:8888 max_fails=3;
  server myhost-2.myco.com:8888 max_fails=3;
  server myhost-4.myco.com:8888 max_fails=3;
  

• If the Hue service in your cluster is configured to use TLS/SSL:
  • Uncomment these lines, and replace the path names with the paths for your cluster:

    ## listen 8001 ssl;
    ## ssl_certificate /path/to/ssl/cert;
    ## ssl_certificate_key /path/to/ssl/key;

  • Uncomment the following line in the location / block:

    ## proxy_pass https://hue;

    and comment out the following line:

    proxy_pass http://hue;

  • Comment out the following line:

    listen 8001

sudo service nginx start

• Without TLS/SSL: http://NGINX_HOSTNAME:8001

• With TLS/SSL: https://NGINX_HOSTNAME:8001

NGINX_HOSTNAME is the name of the host machine where you installed nginx.

1. Stop the Hue service instance on the host where you installed nginx.
2. Access the Hue application as described in the previous step. If you can connect to the Hue application, you have successfully enabled high availability.