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

Preconfiguration Steps

Before you can download the load the Zoomdata installation packages onto your server, you will need to create the Zoomdata directory where the installation and property files will be located. After the directory is created, you will 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 will contain 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 will contain 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.

Access the article Install and Set Up Zoomdata's Metadata Store . Complete the setup instructions and 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 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.

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 will allow 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 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 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-elasticsearch-1.7
sudo systemctl enable zoomdata-edc-rts
sudo systemctl enable zoomdata-scheduler
sudo systemctl enable zoomdata-spark-proxy
sudo systemctl enable zoomdata-xvfb
sudo systemctl enable zoomdata

Step 3: Enable Zoomdata Services

To enable Zoomdata services in CentOS v6 and Ubuntu v14 environments, run the following:

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

sudo service zoomdata-edc-elasticsearch-1.7 start
sudo service zoomdata-edc-rts start
sudo service zoomdata-scheduler start
sudo service zoomdata-spark-proxy start
sudo service zoomdata-xvfb start
sudo service zoomdata start

To enable Zoomdata services in CentOS v7 and Ubuntu v16 environments, run the following:

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

sudo systemctl start zoomdata-edc-elasticsearch-1.7
sudo systemctl start zoomdata-edc-rts
sudo systemctl start zoomdata-scheduler
sudo systemctl start zoomdata-spark-proxy
sudo systemctl start zoomdata-xvfb
sudo systemctl start zoomdata

After you have activated the Zoomdata services, you will need to take the following actions:

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. Access the article Post Installation Options for setup instructions.

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