Command Line Upgrade
Also available as:
loading table of contents...

Upgrade the Knox Gateway

If you are not currently using Ambari to manage your Hadoop cluster, you need to upgrade Knox manually to the latest version.  Because “rolling upgrades” are now supported in HDP-2.5.3, it is not important which version of Knox you are currently running, only that you have an instance of the Knox Gateway running.


If you have not already installed Knox, refer to the "Install the Knox RPMs on the Knox Server" section of the Non-Ambari Cluster Installation Guide for instructions on how to install and configure the Knox Gateway.

Before upgrading the Knox Gateway, there are a several steps you must follow to ensure your configuration files, settings, and topology files can be copied to the new Knox Gateway instance when the upgrade is complete, which are described below.

  1. Back up your existing conf directory.

  2. Stop each Knox server.

    su -l knox /usr/hdp/{the current Knox version}/knox/bin/ stop
  3. Select the HDP server version you are upgrading to after you have stopped each Knox server.

    hdp-select set knox-server {the HDP server version}
  4. Unzip your previously saved configuration directory (the conf directory you backed up in step 1) into the new /var/log/knox/gateway.conf directory to import these files.

  5. Create the Master Secret:

    su - knox -c “/usr/hdp/current/knox/bin/ create-master”

  6. Start the Gateway:

    su - knox -c "/usr/hdp/current/knox-server/bin/ start"

  7. Restart the Knox server to complete the upgrade.

    su -l knox /usr/hdp/{the new HDP server version}/knox/bin/ start