Zoomdata Version

Installing Zoomdata Manually

This document provides instructions for manually performing a clean installation of Zoomdata in your operating environment, specifically, RPM (CentOS, RHEL) and Ubuntu environments. This alternative installation option is available if running the installer script is not a viable option.

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?

Installing Zoomdata manually entails completing the following activities:

  1. Reviewing the prerequisites and prepping the server as recommended in this section.
  2. Preconfiguring your server by establishing a dedicated Zoomdata directory on your target server.
  3. Downloading the Zoomdata installation component packages (that is, the Zoomdata environment includes multiple services, all of which can be installed separately) and placing in the Zoomdata directory.
  4. Installing the metadata store that Zoomdata uses (which is PostgreSQL v9.5).
  5. Installing then activating the Zoomdata components (including the Zoomdata Server, Scheduler service, Spark Proxy service and Connector services).
  6. Completing the post installation steps .
Review the Known Issue related to using Zoomdata on the Safari web browser.

PREREQUISITES

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:

  • 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 starting the installation process)
  • The user installing Zoomdata is able to use the 'sudo' command in the server

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, Zoomdata functionalities benefit from having time synchronization in your network. Specifically, Zoomdata leverages Network Time Protocol (NTPD), which performs time synchronization of networked servers to Coordinated Universal Time (UTC). If needed, refer to the article Using Network Time Protocol to Synchronize Time for instructions to set this up.

Once you have made any needed adjustments to your network configurations, return to this article to continue the installation process.

Preconfiguration Steps

Before you can download the Zoomdata installation packages onto your server, you need to create the Zoomdata directory where the installation and property files are stored. After the directory is created, you also need to create property files in that directory.

Create Zoomdata Directory

Create the following directory to store all Zoomdata-related files:

sudo install -o root -g root -m 0755 -d /etc/zoomdata

Create the Default Zoomdata Configuration File

Create the default Zoomdata configuration file that contains the available variables and parameters related to Zoomdata operation:

sudo touch /etc/zoomdata/zoomdata.properties
sudo chmod 0644 /etc/zoomdata/zoomdata.properties
sudo vi /etc/zoomdata/zoomdata.properties

Add the Default Metadata Parameters to the Zoomdata.Properties File

Add the following metadata store-related parameters into the newly-created zoomdata.properties file. Essentially, you are storing the username and password details for the metadata store in this property file.

spring.datasource.url=jdbc:postgresql:// db_host :5432/zoomdata
spring.datasource.username= db_username
spring.datasource.password= db_password

Remember to save the file before exiting it.

Create the Scheduler Property File

Create the Zoomdata Scheduler-related property file that contains the variables and parameters related to the Zoomdata Scheduler service:

sudo touch /etc/zoomdata/scheduler.properties
sudo chmod 0644 /etc/zoomdata/scheduler.properties
sudo vi /etc/zoomdata/scheduler.properties

Add the Default Metadata Parameters to the Scheduler Property File

Add the following metadata store-related parameters into the newly-created scheduler.properties file. As with the zoomdata.properties file, you are storing the username and password details for the metadata store here.

spring.datasource.url=jdbc:postgresql:// db_host :5432/zoomdata-scheduler
spring.datasource.username= db_username
spring.datasource.password= db_password

Download the Appropriate Zoomdata Installation Package

If you did not already receive the installation package, then you can contact Zoomdata Technical Support to request it. In the request, be sure to include the Linux OS version you are using (for example, CentOS v7). Select the button to create the request.

Set Up Zoomdata's Metadata Store

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.

Install and Set Up Zoomdata's Metadata Store . Complete the setup instructions and then return to this article to continue the manual installation of Zoomdata in your server.

Installation Steps

Once you have received the download instructions from your Zoomdata rep, remember to place the installation package in the Zoomdata directory on the target server. The following Zoomdata components are included in your installation package:

  • The Zoomdata Server
  • Scheduler service
  • Spark proxy service
  • Connector services

The Zoomdata Scheduler is a component within the Server used to run jobs that refresh Zoomdata’s connection to the data source in asynchronous mode. For more information, see Using the Zoomdata Scheduler .

Zoomdata employs a 'Spark Proxy' component (or service) which runs as a separate process in one of the nodes in Zoomdata. For more information, see How Zoomdata Uses Apache Spark .

Follow the steps below for your server's OS to (1) install, (2) enable and (3) run Zoomdata services on your server.

Step 1: Install Zoomdata

Install Zoomdata in a CentOS Environment

Use the following command to install Zoomdata in CentOS environment:

sudo yum install zoomdata* -y

Install Zoomdata in an Ubuntu Environment

Use the following command to install Zoomdata in Ubuntu environment:

sudo dpkg -i zoomdata*

Step 2: Set Zoomdata Services to Start Whenever the Server Booted

The following command line allows Zoomdata services to automatically start up whenever the server is started or rebooted:

For CentOS v6 run the following:

ls /etc/init.d/zoomdata* | xargs -n1 basename | xargs -I % sudo chkconfig % on
Optionally, you can manually set each Zoomdata service by running the following command lines:

sudo chkconfig zoomdata-edc- connector _service on
sudo chkconfig zoomdata-scheduler on
sudo chkconfig zoomdata-spark-proxy on
sudo chkconfig zoomdata-xvfb on
sudo chkconfig zoomdata-consul on
sudo chkconfig zoomdata on

For Ubuntu v14 run the following:

ls /etc/init.d/zoomdata* | xargs -n1 basename | xargs -I % sudo update-rc.d % defaults
Optionally, you can manually set each Zoomdata service by running the following command lines:

sudo update-rc.d zoomdata-edc- connector _service defaults
sudo
update-rc.d zoomdata-scheduler defaults
sudo update-rc.d zoomdata-spark-proxy defaults
sudo update-rc.d zoomdata-xvfb defaults
sudo update-rc.d zoomdata-consul defaults

sudo update-rc.d zoomdata defaults

For CentOS v7 and Ubuntu 16, run the following:

sudo systemctl enable $(systemctl list-unit-files | grep zoomdata | awk '{print $1}')
Optionally, you can manually set each Zoomdata service by running the following command lines:

sudo systemctl enable zoomdata-edc- connector _service
sudo systemctl enable zoomdata-scheduler
sudo systemctl enable zoomdata-spark-proxy
sudo systemctl enable zoomdata-xvfb

sudo systemctl enable zoomdata-consul
sudo systemctl enable zoomdata

Step 3: Enable Zoomdata Services

{{snipt.install-upgrade-enable-RPM6U14}}

{{snipt.install-upgrade-enable-RPM7U16}}

After you have activated the Zoomdata services, you need to do the following:

Post Installation Steps

There are also post installation options available to you including (1) enabling the Real Time Sales demo data source and (2) setting up the Screenshot function.See Post Installation Options for setup instructions.

Lastly, be aware of any Known Issues concerning using Zoomdata in a Safari web browser.