Zoomdata Version

Upgrading the Zoomdata Server

This articles provides the guidance to help you upgrade Zoomdata Server v2.3 for RPM and Ubuntu platforms to the current v2.4 release. Upgrade instructions are provided below.

If you need to upgrade from Zoomdata v2.2, then refer to the Upgrading from Zoomdata v2.2 article.


Prior to starting any upgrade, Zoomdata strongly recommends that you back up your metadata store (held in PostgreSQL) first. Otherwise, you run the risk for data loss during the upgrade process. Please refer to the instructions on the PostgreSQL website .

The installer script works for the following environments:

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

Refer to the System Requirements article for recommended settings for deploying Zoomdata on-premise.

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


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

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

STEP 1: Run the installation script.

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

  • The Zoomdata Server
  • Scheduler service
  • Spark proxy service
  • Connector services
  • 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. Access the article Using the Zoomdata Scheduler for more information.
  • Zoomdata employs a 'Spark Proxy' component (or service) which runs as a separate process in one of the nodes in Zoomdata. Access the article How Zoomdata Uses Apache Spark for more information.

After the installation script has completed, take the following actions to complete the installation process:

Beginning in Zoomdata release version 2.4, a health check report related to charts and dashboards will be provided when upgrading from earlier versions. This report is provided in a dedicated file - zoomdata-upgrade.log - which is located in the /opt/zoomdata/logs directory. If after upgrading Zoomdata, you find there are issues with your charts and dashboards, then access this log file to determine the issues. You may open a ticket with Zoomdata Technical Support to help you troubleshoot these issues.

STEP 4: Access Zoomdata from a web browser.

When you are ready to access Zoomdata, refer to the article Access Zoomdata from Your Web Browser .