Zoomdata Version

Install a New Zoomdata Instance

This document provides instructions for performing a clean installation of Zoomdata in your operating environment and is applicable for both RPM (CentOS, RHEL) and Ubuntu environments.

For information about the difference between a clean installation of Zoomdata and an upgrade to the latest GA release, refer to the FAQ What is the difference between a clean install and upgrade of Zoomdata?

Starting in v2.3, the installation process has been automated and all you need to do is run an installer script. This script will access a dedicated Zoomdata repository (via the Internet) and automatically download all the necessary components to install your Zoomdata service. Once the installer script has completed execution, you will need to (1) activate the Zoomdata services then (2) open a browser window and enter the specific IP address to access the Zoomdata Client. This article guides you through the preparation and setup of Zoomdata including:


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 server does not have PostgreSQL already installed
  • The server does not contain any zoomdata property files (in other words, if a previous version of Zoomdata was installed in this server, ensure that all property files have been deleted before running the installer script)
  • The user installing Zoomdata is able to use the 'sudo' command in the server
  • *If you do not have internet connection on the server that Zoomdata is being installed, you will need to either download or otherwise receive the Zoomdata installation package and load into the target server. Once this is done, you can manually install Zoomdata. Refer to the Alternative Installation Options for instructions to do this.
  • If the server where Zoomdata will be installed do not meet all of the conditions, refer to the Alternative Installation Options .

If you are installing Zoomdata in a server running either CentOS v6 or Ubuntu v14, then you need to Configure Max Open Processes and Open Files to Support Zoomdata Runtime . Be sure to complete this prerequisite setup before installing Zoomdata. If your server is running either CentOS v7 or Ubuntu v16, then you may skip this prerequisite step.

In addition, there are configuration options that you may consider adjusting prior to installing Zoomdata. Access the article Installation Configuration Options to review them. Once you have made any needed adjustments to the configurations, return to this article to continue the installation process.

Installation Process

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

If you have not received the installation instructions, please select the green 'Support' button in the lower right corner of this article 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 that installation command into your target server to start the automated installation process. The following Zoomdata components will download to your target server:

  • Database for metadata store (using PostgreSQL v9.5)
  • The Zoomdata Server
  • Scheduler service
  • Spark proxy service
  • Connector services

Zoomdata uses PostgreSQL v9.5 to store its metadata. Due to the specific version used by Zoomdata and the configuration requirements, existing PostgreSQL that you may already have on the server is not supported at this time.

Zoomdata may be able to support using an existing PostgreSQL in a future release.

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, you will need to take the following actions:

STEP 4: Access Zoomdata from a web browser.

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

Alternative Installation Options

You have the option to install Zoomdata without using the automated installation script. This approach lets you install and enable each Zoomdata services manually in your target server. If you need an alternative option, select from the following list:


Safari web browser: selecting any chart may result in a "Connection Closed" error. The error is a result of Zoomdata's self-signed certificate deployed on RPMs. The self-signed certificate is provided for convenience. To fix the issue, deploy your own SSL certificate on your Zoomdata installation. For the instructions, see Adding an SSL certificate to the Zoomdata Server .