On this page

    RPM and Tarball Install

    Prerequisites

    • Be sure that Java SE 8 (also known as JDK 1.8) is installed. Supported distributions are OpenJDK and Oracle JDK. Other versions are currently not supported.

    See System Requirements for more information.

    RPM Installation

    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/FileLocation
    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
      

    Using a Tarball

    Perform these steps on each node of your Dremio cluster:

    1. Create a dremio group.

      sudo groupadd -r dremio
      
    2. Create a dremio user.

      sudo useradd -r -g dremio -d /var/lib/dremio -s /sbin/nologin dremio
      
    3. Create Dremio directories.

      sudo mkdir /opt/dremio
      sudo mkdir /var/run/dremio && sudo chown dremio:dremio /var/run/dremio
      sudo mkdir /var/log/dremio && sudo chown dremio:dremio /var/log/dremio
      sudo mkdir /var/lib/dremio && sudo chown dremio:dremio /var/lib/dremio
      
    4. Unpack Dremio into the /opt/dremio directory.

      sudo tar xvf dremio-<VERSION>.tar.gz -C /opt/dremio --strip-components=1
      
    5. Create a symbolic link for the configuration folder.

      sudo ln -s /opt/dremio/conf /etc/dremio
      
    6. (Optional) Set up your service configuration (SystemD setup).

      a. Copy the unit file for the dremio daemon from <DREMIO_HOME>/share/dremio.service to /etc/systemd/system/dremio.service.

      sudo cp <DREMIO_HOME>/share/dremio.service /etc/systemd/system/dremio.service
      

      b. Restart systemd.

      sudo systemctl daemon-reload
      

      c. (Optional) Enable dremio to start at boot.

      sudo systemctl enable dremio
      
    7. Configure Dremio. See Dremio Configuration for more information.

    Sample Service Configuration

    The following snippet shows the configuration in the <DREMIO_HOME>/share/dremio.service file:

        #
        # Installation is assumed to be under /opt/dremio
        #
        [Unit]
        Description=Dremio Daemon Server
        Documentation=https://docs.dremio.com
        Wants=network-online.target
        After=network-online.target
        
        [Service]
        User=dremio
        Group=dremio
        RuntimeDirectory=dremio
        ExecStart=/opt/dremio/bin/dremio start-fg
        Restart=on-failure
        # Set maximum number of file descriptors Dremio can open.
        # Dremio requires a large number to work correctly.
        LimitNOFILE=65536
        
        
        [Install]
        WantedBy=multi-user.target