Installing Zoomdata

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


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).

If you have used Zoomdata versions earlier than 3.3, you must delete the RabbitMQ queues before you upgrade to Zoomdata 3.3 or later. In addition, an additional header specifying the media type on non-browser HTTP requests is now required. These changes are required because in Zoomdata version 3.3, we updated the Spring Cloud library underlying our application. See Version 3.3 Upgrade Information.
Zoomdata version 3.2 and later versions use headless Google Chrome instead of Firefox for Zoomdata's Screenshot service. The Chrome-based Screenshot service cannot be installed in CentOS v6 environments because the Google Chrome dependencies do not support that platform. See Setting Up the Screenshot Feature.

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.

In generally, the installation process is automated and you only need to run an installation script. This script accesses a dedicated Zoomdata repository (via the Internet) and automatically downloads all the necessary components to install your Zoomdata service. Zoomdata's streaming architecture is based on RabbitMQ. The installation script handles the installation and setup of RabbitMQ in your environment.

You can install Zoomdata without using the automated installation script. This lets you install and enable each Zoomdata services manually in your target server. If you need an alternative option, read Alternative Installation Options.

After the installation has completed, you need to activate the Zoomdata services, download and configure a JDBC driver if you are using specific data sources (see Post-Installation Options for a list), and open a browser window and enter the specific IP address to access the Zoomdata client.

Review and complete (as appropriate for your installation) the following installation information: