Zoomdata Version

Installing Zoomdata Manually

If running the installer script is not a viable options for you, you can install Zoomdata manually.

Installing Zoomdata manually entails completing the following activities:

  1. Reviewing the prerequisites and prepping the server as recommended.
  2. Preconfiguring your server by establishing a dedicated Zoomdata directory on your target server.
  3. Downloading the Zoomdata installation component packages and placing the services 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, and Connector services).
  6. Completing the post installation steps .

PREREQUISITES

Refer to System Requirements for information on the 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, meaning if a previous version of Zoomdata was installed in this server, ensure that all property files have been deleted.
  • 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 Support button to create the request.

Set Up Zoomdata's Metadata Store

Zoomdata uses a packaged PostgreSQL v9.5 database instance to store its metadata and strongly recommends using this instance due to the specific configuration and version employed. If you would like to use another PostgreSQL instance, contact Support for further guidance.

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
  • Connector services
  • Query Engine
  • RabbitMQ

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.

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-xvfb on
sudo chkconfig zoomdata-consul on
sudo chkconfig zoomdata on
sudo chkconfig zoomdata-query-engine 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-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-xvfb
sudo systemctl enable zoomdata-consul
sudo systemctl enable zoomdata
sudo systemctl enable zoomdata query engine

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-xvfb start
sudo service zoomdata-query-engine 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-xvfb
sudo systemctl start zoomdata-query-engine
sudo systemctl start zoomdata

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.

Was this topic helpful?