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, 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.
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:
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 chmod 0644 /etc/zoomdata/zoomdata.properties
sudo vi /etc/zoomdata/zoomdata.properties
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 will contain 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 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.
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.
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:
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 will allow 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 on
For Ubuntu v14 run the following:
sudo update-rc.d zoomdata-edc- connector _service defaultsupdate-rc.d
For CentOS v7 and Ubuntu 16, run the following:
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:
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 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:
- STEP 4: Configure the firewall
- STEP 5: Identify the IP address
- 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. Access the article Post Installation Options for setup instructions.
Lastly, be aware of a Known Issue concerning using Zoomdata in a Safari web browser.