MapR 5.0 Documentation : Upgrading to the Latest Version of Drill

If you installed Drill with the MapR Installer, use the latest version of the MapR Installer to perform the upgrade. 

Upgrading to the latest version of Drill is not supported. However, if you have an earlier version of Drill installed and you want to upgrade to the latest version, you must complete the following steps to ensure a smooth transition to the latest version of Drill:

Before You Begin

This document assumes that you have the correct packages and repositories required to install Drill using the mapr-drill package. For a list of prerequisites, refer to Installing Drill on MapR.

Perform the following steps on Drill servers and clients to upgrade to the latest version of Drill:

Step 1: Back Up Storage Plugins and Configuration Files

Back up storage plugin configurations and Drill configuration files to avoid having to redefine them after you install the latest version of Drill. Back up drill-override.conf to preserve your ZooKeeper configuration and any options specified in the file. Back up drill-env.sh if you modified any options in the file (for example, to allocate more memory to Drill).

Backing Up Storage Plugins

To back up your storage plugins, complete the following steps:

  1. Start the Web Console. The Drill node that you use to access the Web Console must be a node that is currently running the Drillbit process.
  2. Click Storage.
  3. Click Update next to a storage plugin.
  4. Copy the configuration to a text file, and save the file.
  5. Repeat steps 3 and 4 for each storage plugin configuration that you want to save.

Backing Up Configuration Files

To back up drill-override.conf and drill-env.sh, navigate to /opt/mapr/drill/drill-<version>/conf, and copy the files to a location outside of the Drill installation directory.

Example
cp drill-override.conf drill-env.sh /home/max/drill_conf 

Step 2: Remove Drill from ZooKeeper

When Drill is installed, the various system options and their default values are stored in ZooKeeper. To remove this metadata from ZooKeeper using zkCli, complete the following steps:

  1. Go to the bin directory of the ZooKeeper installation, for example:
    cd /opt/mapr/zookeeper/zookeeper-3.4.5/bin 
  2. Issue the following command to start the ZooKeeper command line interface:

    ./zkCli.sh -server <ip-address>:<port>
  3. Issue the following command to connect to the MapR ZooKeeper port of the Drill node.
    connect localhost:5181
  4. Issue the following command to remove /drill from ZooKeeper.
    rmr /drill

Step 3: Uninstall Drill

To uninstall Drill, issue the command appropriate for your system:

RedHat/CentOS
$ sudo yum remove mapr-drill
Ubuntu
$ sudo apt-get remove mapr-drill
SUSE
$ sudo zypper remove mapr-drill

Step 4: Install Drill, run configure.sh, and restart warden

To install the latest version of Drill, reconfigure components, and restart warden, follow the instructions in Installing Drill on MapR.

Step 5: Restore storage plugins and configuration files

Restoring Storage Plugins

To restore the storage plugin configuration information, complete the following steps:

  1. Start the Web Console. The Drill node that you use to access the Web Console must be a node that is currently running the Drillbit process.
  2. Click Storage.
  3. Click Update next to a storage plugin.
  4. Copy the configuration for the storage plugin from the text file that you saved into the Configuration window, and click Update.
  5. Repeat steps 3 and 4 for each storage plugin configuration that you want to restore.

Restoring drill-override.conf

In most cases, to restore drill-override.conf you can just replace the new version in Drill’s /conf directory with the version of the file that you backed up in Step 1: Back Up Storage Plugins and Configuration Files.

To restore drill-override.conf , navigate to the directory where you saved drill-override.conf, and copy drill-override.conf to the Drill /conf directory, replacing the existing file.

Example
cp drill-override.conf /opt/mapr/drill/drill-<version>/conf

Restoring drill-env.sh

The latest version of drill-env.sh may contain some new configurations for Drill. If you backed up this file, you can merge the saved version with the latest version in /opt/mapr/drill/drill-<version>/conf to preserve your modifications and the new configurations.

Step 6: Restart the Drillbit Service

If the MapR cluster was running when you installed Drill, you must restart the Drillbit service in order for Drill to get the configuration updates.

To restart the Drillbit on the node, issue the following command:

maprcli node services -name drill-bits -action restart -nodes <node host names separated by a space>

You can run jps to verify that the Drillbit process is running.

To restart all Drillbits, issue the following command:

maprcli node services -name drill-bits -action restart -filter csvc=="drill-bits"