Upgrade the Zoomdata v4 Server

    Manually upgrading Zoomdata 4.1 or later no longer provides the Java Runtime Environment (JRE) needed for Zoomdata to start. Make sure you have Java 8 (1.8.0_131) or later installed before you manually install or manually upgrade to Zoomdata 4.1 or later. If you do not, Zoomdata will not start. See How Zoomdata Validates an Environment's Java Version.

Due to the upgrade of the HashiCorp Consul (service discovery) version from 0.7.5 to 1.2.2, custom connectors built before Zoomdata 3.2 ( built for versions 3.1 or earlier versions) will not appear in Zoomdata after you migrate to Zoomdata 3.7 or later. This is caused by incompatibilities between old connectors and the new Consul. To make your custom connectors compatible with Zoomdata 3.7 (and later versions), you must migrate them as described in Custom Connector Migration Information.

This migration step is required only for custom connectors built with Zoomdata versions earlier than 3.2 or for connectors that were present before Zoomdata 3.2 but that are now deprecated (for example, the Hive on Tez connector, which was replaced by the Hive connector in Zoomdata 3.7).

Zoomdata version 3.2 and later versions use headless Google Chrome instead of Firefox for Zoomdata's Screenshot microservice. See Setting Up the Screenshot Microservice.

You can upgrade your Zoomdata server to the current release.

For information about the difference between a clean installation of Zoomdata and an upgrade to the latest GA release, see Clean Installation and Upgrade Differences.

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 Configuration Property Files


Prior to upgrading your Zoomdata software, Zoomdata strongly recommends that you:

  • Back up your metadata store
  • Back up any previously uploaded CSV files. These files are located in the /opt/zoomdata/data directory.
  • Store or back up any CA certificates you added to the Java code installed by Zoomdata in its version 2 and 3 installations. The CA certificates you added to Java in previous Zoomdata versions will be lost when you perform the manual installation of Java 8 (1.8.0_131) or later requested by Zoomdata 4.1 (or later) installations. After you have upgraded to Zoomdata 4.1 (or later), you can reimport the CA certificates to your new version of Java.

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

An option to install OpenJDK is included in the installation and upgrade scripts provided by Zoomdata. If you skip this option or if you install or upgrade the product manually, make sure that Java 8 (or later) is installed. If you do not, Zoomdata will not start after the upgrade.

The installer script works in the following environments:

  • Centos v7
  • Ubuntu v14.04 and 16.04

CentOS 6 is no longer supported by this product. CentOS 6 is no longer supported by Red Hat Linux (RHEL). Use CentOS 7 instead.

See Supported Browsers 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 abl to use the 'sudo' command in the server

Upgrade Instructions

To begin the upgrade process, you must receive an email containing upgrade instructions from Zoomdata Support. This email provides the upgrade script that you need to run on the server where the Zoomdata environment resides.

If you have not received upgrade instructions, click the button in this page to open a ticket with Zoomdata Support.
  1. When you receive the email, enter the upgrade command on your target server to start the automated upgrade process. The following Zoomdata components are downloaded on your target server:

    • The Zoomdata server
    • Connector microservices
    • Query Engine
    • Data Writer microservice
  2. After the upgrade script has completed, it will take 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 yet accessible, 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, see Accessing Zoomdata.

    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.

  3. The upgrade script provided by Technical Support assumes that your Postgres metadata store is running locally on the same machine as the Zoomdata code and automatically adds the new databases required by Zoomdata version 4.9 (and later) to your local installation. If you have upgraded to version 4.9 or later and your metadata store is installed on a different machine (not locally), you will need to manually create the following databases in your Postgres metadata store after the upgrade.

    • zoomdata
    • zoomdata-keyset
    • zoomdata-qe
    • zoomdata-upload

    See Creating the Zoomdata User.

  4. The firewall setup you used with earlier versions of Zoomdata should have been retained and your Zoomdata IP address should remain unchanged, but see the following for more information:

  5. 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 these connectors, you need to download and configure a JDBC driver as soon as your Zoomdata server has finished upgrading. For steps, see Adding a JDBC Driver.

  6. Reimport any CA certificates to the Java 8 (1.8.0_131) or later you installed prior to the Zoomdata upgrade. (In Prerequisites, we recommended that you store them or back them up before the Zoomdata upgrade.