RPM Install and Upgrade

This topic describes how to install and upgrade Dremio using an RPM package.

Installing Dremio

Perform these steps on each node of your Dremio cluster:

  1. Download and install Dremio via RPM.

      $ sudo yum install dremio-<VERSION>.rpm
    
  2. (Optional) Enable dremio to start at boot.

     $ sudo chkconfig --level 3456 dremio on
    
  3. Configure Dremio. See Dremio Configuration for more information.

Default Configuration

The following configurations are created by default when you install Dremio using the RPM package.

Software/File Location
Software location /opt/dremio
dremio.conf configuration file /etc/dremio/dremio.conf
dremio-env environment configuration file /etc/dremio/dremio-env
Local path (for data location) /var/lib/dremio
Log directory /var/log/dremio
PID files directory /var/run/dremio

Changing the Dremio User and Group

The generic installation steps assume a user called dremio.

To run the Dremio daemon service under a different username (for example, testuser), apply the following changes before configuring.

  1. Update the DREMIO_USER in the /etc/sysconfig/dremio file to testuser.
  2. Apply the following permissions:
     sudo chown -R testuser:testuser /var/log/dremio
     sudo chown -R testuser:testuser /var/lib/dremio
     sudo chown -R testuser:testuser /var/run/dremio
    

Upgrading Dremio

This topic provides upgrade instructions for RPM-based installations. These instructions assume you are using the default RPM installation paths for configuration, data and logging.

Before you begin, do the following:

To upgrade your Dremio installation:

  1. Ensure that your existing Dremio cluster is backed up. See Create a backup for more information.

  2. Shut down all Dremio provisioned nodes. For example: service dremio stop

  3. On each Dremio node in your cluster, copy your old Dremio installation to another location on the node. For example:
    cp -r /opt/dremio /opt/dremio_bak

  4. Download and install the new Dremio version. For example:
    sudo yum install dremio-<version>.rpm

    • For YARN deployments, install on each coordinator node in your Dremio cluster.
    • For non-YARN deployments, install on all nodes in your Dremio cluster.
  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 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 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: service dremio start.

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


results matching ""

    No results matching ""