Zoomdata Version

Upgrading the Zoomdata 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 Configuring JRE/JVM.

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. 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 Version 3.7 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. The Chrome-based Screenshot microservice cannot be installed in CentOS v6 environments because the Google Chrome dependencies do not support that platform. See Setting Up the Screenshot Microservice.

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.

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 Configuring Zoomdata Property Files.

Prerequisites

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.

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 v6 and v7
  • Ubuntu v14.04 and 16.04

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 able 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 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:

Was this topic helpful?