Zoomdata Version

Upgrading the Zoomdata Server

You can upgrade your Zoomdata Server to the current release.

SQL connectors require a JDBC driver to be configured before you can connect to your data source. You can download the driver from the vendor’s site. Be aware that you need to download and configure JDBC drivers for the following Zoomdata connectors:

If you are using one of the above data sources, you need to download and configure a JDBC driver as soon as your Zoomdata server has finished upgrading. For steps, see Add a JDBC Driver.

If you are upgrading from version 2.6.1 to the latest Zoomdata version, you can change the default http port to enable https for your environment. For information and steps, see Configuring Zoomdata Property Files.


Prior to starting any upgrade Zoomdata strongly recommends that you:

  • back up your metadata store.
  • backup any previously uploaded CSV files. These files are located in /opt/zoomdata/data directory.

Failure to have a proper backup could result in losing data during the upgrade process. For more information, see Backing Up and Restoring your Metadata.

The installer script works for the following environments:

  • Centos v6 and v7
  • Ubuntu v14.04 and 16.04

See System Requirements for recommended settings for deploying Zoomdata on-premise.

If you if have any of the above mentioned data sources that require a JDBC driver, you need to download and install the driver from the vendor's website.

The target server for the Zoomdata program should meet the following conditions:

  • Server is connected to the Internet
  • The user installing Zoomdata is able to use the 'sudo' command in the server

UPGRADE Instructions

In order to begin the upgrade process, you first need to receive the upgrade instructions from Zoomdata Support. This email contains the upgrade script that you use to run in the server where the Zoomdata environment will reside.

If you have not received the upgrade instructions, select the Support button on this page to open a ticket with Zoomdata Support.

Run the upgrade script.

You will receive an email from Zoomdata support with upgrade instructions and the command line that needs to be run. Enter the upgrade command into your target server to start the automated upgrade process. The following Zoomdata components are downloaded to your target server:

  • The Zoomdata Server
  • Scheduler service
  • Connector services
  • Query Engine
  • Streamwriter service
  • Upload service

The upgrade script also handles the installation and setup of RabbitMQ in your environment.

The Zoomdata Scheduler is a component within the Server used to run jobs that will refresh Zoomdata’s connection to the data source in asynchronous mode. For more information, see Using the Zoomdata Scheduler.

After the installation script has completed, it takes a few minutes for Zoomdata to complete its update of the metadata store. We recommend that you wait a few minutes before accessing Zoomdata from your web browser.

If you receive a message indicating that Zoomdata is not accessible yet, it may not have completed its setup yet. Wait a few more minutes before trying again or opening a Support ticket. If you continue to have issues accessing Zoomdata from your browser, click the Support button on this page to open a ticket with Zoomdata Technical Support. For information about accessing Zoomdata, read Accessing Zoomdata from Your Web Browser.

If you notice some unusual behavior in the Zoomdata UI after upgrading the Zoomdata software (for example, if a drop-down menu doesn't open or the application doesn't react when you click on a button), clear the browser cache and try again. If the problem persists, contact Support.

The firewall setup should have been retained and the IP address remain the same, but see the following for more information:

Was this topic helpful?