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.
Installing Zoomdata manually entails completing the following activities:
- Reviewing the prerequisites and prepping the server as recommended in this section.
- Preconfiguring your server by establishing a dedicated Zoomdata directory on your target server.
- 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.
- Installing the metadata store that Zoomdata uses (which is PostgreSQL v9.5).
- Installing then activating the Zoomdata components (including the Zoomdata Server, Scheduler service, Spark Proxy service and Connector services).
- Completing the post installation steps .
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.
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:
Create the Default Zoomdata Configuration File
Create the default Zoomdata configuration file that contains the available variables and parameters related to Zoomdata operation:
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.
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 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.
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.
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.
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.
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:
Install Zoomdata in an Ubuntu Environment
Use the following command to install Zoomdata in Ubuntu environment:
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:
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:
sudo update-rc.d zoomdata-edc- connector _service defaultsupdate-rc.d
sudo update-rc.d zoomdata-consul defaults
For CentOS v7 and Ubuntu 16, run the following:
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
After you have activated the Zoomdata services, you need to do the following:
- STEP 4: Configure the firewall
Identify the IP address
After installation is completed, it takes a few minutes for Zoomdata to complete its update of the metadata store. Please wait a few minutes before going to Step 6 to access Zoomdata from your web browser.
- STEP 6: Access the Zoomdata Client from Your Web Browser
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.