Tarball Upgrade

This topic provides upgrade instructions for Tarball-based installations.

Upgrade Checklist

Performing an Upgrade

To upgrade your Dremio installation:

  1. Ensure that your existing Dremio cluster is backed up. See the Create a backup section.

  2. Shut down all Dremio provisioned nodes. For example: <DREMIO-HOME>/bin/dremio stop

  3. On each Dremio node in your cluster, move your old Dremio installation to another location. For example:
    mv /opt/dremio /opt/dremio_bak

  4. Download and install the new Dremio version.

    • For YARN deployments, install on each coordinator node in your Dremio cluster.
    • For non-YARN deployments, install on all nodes in your Dremio cluster.

      Perform the following steps on each Dremio node depending on your deployment (YARN vs non-YARN):

      [warning] Important
      Be sure the create the new directories with the same path as the original installation. In particular, the /data directory and associated data files must be in the same path as the original installation.

    • Create a new Dremio directory. For example:

       sudo mkdir /opt/dremio
      
    • Unpack Dremio into the /opt/dremio directory. For example:
      sudo tar xvf dremio-<version>.tar.gz -C /opt/dremio --strip-components=1
    • Create a symbolic link for the configuration folder. For example:
      sudo ln -s /opt/dremio/conf /etc/dremio
  5. Copy the /conf directory and associated configuration files from your backup-copy location (from Step# 3) to the new installation location. As a result, the default files from the fresh install are overwritten. For example:
    cp /opt/dremio_bak/conf/* /opt/dremio/conf

    • For YARN deployments, perform this step on each coordinator node in your Dremio cluster.
    • For non-YARN deployments, perform this step on all nodes in your Dremio cluster.
  6. On the master-coordinator node, copy the /data directory and associated data files from your backup-copy location (from Step# 3) to the new installation location. For example:
    cp -r /opt/dremio_bak/data /opt/dremio/data

    [warning] Important
    The new /data directory and files must be in the same directory path as the original installation. A different directory path results in the loss of all reflections because they are accessed by their full path.

    If your original data directory is in a location different from /opt/dremio/data, then this step can be skipped.

  7. On the master-coordinator node, execute the upgrade script as the user running the Dremio Daemon service. For example, as "dremio":
    dremio-<version>/bin/dremio-admin upgrade

  8. Start up all Dremio provisioned nodes in the Dremio cluster. For example: <DREMIO-HOME>/bin/dremio start.

  9. Backup your new Dremio cluster. See Create a backup for more information.


results matching ""

    No results matching ""