Upgrading with Custom Sources
Upgrading Dremio to enable new features may have unexpected behaviors upon your instance for users operating with their own custom Advanced Relational Pushdown (ARP) source, or written source, such as Netezza. If your environment utilizes external query (which is only supported via ARP sources), then you will need to complete the following steps to safely enable functionality in newer versions of Dremio for your environment:
- Download the desired version of Dremio (v16.0+).
- Back up your custom source.
- Update the custom source to build using the new Dremio version.
- Perform the activities associated with upgrading Dremio, but stop before actually upgrading the application.
- Copy the rebuilt custom source
- Run the Dremio upgrade.
Step 1: Download the desired version of Dremio
Obtain a copy of the desired version of Dremio for upgrade purposes. The file type will vary based on your current environmental needs. Once you’ve downloaded the version you wish to upgrade to, continue to the next step.
Do not execute the new Dremio installer before completing this outlined process.
Step 2: Back up your custom source
As part of the upgrade process, we highly recommend that you back up your custom source to preserve the current state of your data. Upgrading Dremio may have an unexpected impact on the accessibility or structure of your source, so we always recommend backing up your sources.
This may be done either by copying and pasting the entire source to another location on your host computer, or by creating a branch with a version control tool.
A common practice is to also back up your instance of Dremio prior to an upgrade with features that hold an application-wide impact. For information on how to back up Dremio, review the Backup Dremio help topic.
Step 3: Update the custom source to build using the new Dremio version
Due to the nature of custom-written sources, you must update the
pom.xml file from your Maven repository to reference the new Dremio version used post-upgrade. This file is typically found in the dremio-sqllite-connector folder, but may vary based on the structure of your repository.
On line 29, update the value found between the
<version.dremio> tags to reflect the downloaded version of Dremio you will be upgrading to. This should look similar to the following example:
<properties> <version.dremio>16.0.0-202105120132280783-b6a3f06a</version.dremio> </properties>
Then you must update the value on line 36 with the same value as on line 29. The existing value may appear as follows:
Once completed, you may begin the process of upgrading your instance of Dremio.
Step 4: Perform the activities associated with upgrading Dremio
Before initiating the upgrade process for Dremio, you’ll need to complete a series of activities in preparation to the upgrade. Follow the steps documented on these pages, but stop before the command to begin the upgrade.
Again, stop prior to initiating the actual Dremio upgrade as you must complete one more activity for your source.
Step 5: Copy the rebuilt custom source
Compile any custom source connector files created as part of the ARP-based plugin. This includes the storage pluigin configuration and the plugin ARP (YAML) file.
Follow the same process you completed for backing up the custom source, only now with your connector files. These are typically
.jar files and are located in the
/dremio/jars folder in Dremio.
Step 6: Run the Dremio upgrade
Now you are ready to upgrade Dremio and enable new Dremio functionality. Depending on your environment, use one of the following methods to initiate the upgrade: