Ubuntu Installation Steps
This article provides instructions for performing a clean installation of Zoomdata in your operating environment.
You can request the .DEB Package by visiting our Free Trials page .
The following system requirements are recommended for installation of the Zoomdata Server using Ubuntu:
- 64-bit long-term support (LTS) Ubuntu server releases (14.04, 15.04)
- Java SE JDK 8
- 64 GB RAM
- 500 GB disk space
OPTIONAL: Firefox v36 and Xvfb
(needed to install the optional screenshot feature for the Home screen’s visual gallery)
Configuring Max Open Processes and Open Files To Support Zoomdata Runtime
To avoid runtime issues with the Zoomdata platform (which include services like the Scheduler), Zoomdata recommends configuring the maximum number of open processes and open files that can be run in your operating environment. These recommended settings will help avoid having Zoomdata processes hit the resource limits that may be imposed by your operating system.
Perform the following steps:
Use the following command to access and open the
- Add the following lines to the file:
zoomdata hard nproc 4096
zoomdata soft nofile 10000
zoomdata hard nofile 10000
- Save and exit the configuration file.
Additional Configuration Options
Additional options to consider prior to installation:
|Requirement||Access this article:|
|Synchronize time for your networked servers||Using Network Time Protocol to Synchronize Time|
|Use your existing MongoDB instance||Installing Zoomdata Using an Existing MongoDB Instance|
|Add an SSL Certificate||Adding an SSL Certificate to the Zoomdata Server|
|Disable SSL||Disabling SSL in Zoomdata|
|Configure Zoomdata memory mettings||Configuring Zoomdata Memory Settings|
|Edit the default SparkIt settings*||An Overview of Spark in Zoomdata|
|Disable the sample data generator source that comes installed with Zoomdata||Disabling the Real Time Sales Demo Source|
Zoomdata offers the ability to take periodic snapshots of your saved dashboards and data sources on Zoomdata's home screen (as shown in the screenshot below). This requires the installation of Firefox v36 and the Xvfb file.
After successfully installing the Zoomdata Server, you can install the (Ubuntu version of) screenshots feature by following the setup instructions in the article Setting Up the Screenshot Feature (for Ubuntu) .
INSTALLING THE ZOOMDATA .DEB PACKAGE
The main steps to install and configure the Zoomdata Server include:
- Installing MongoDB
- Installing the Zoomdata Server
- Configuring the firewall
- Identifying the IP address for your Zoomdata client
You also have configuration options available during the installation process:
- Changing the default Java location
- Adding credentials for MongoDB
- Install MongoDB and the associated tools.
- Start MongoDB by issuing the following command:
- Add a mongo user:
- Install Zoomdata .DEB.
Optional Zoomdata Configurations
After installation you may want to change the default memory settings .
Add a Mongo user credentials into (newly created) file
: (skip this if you used default settings with locally installed MongoDB server):
Configure the scheduler settings. Add the following lines to the
- Configure "iptables" to accept port 8443 and to forward incoming HTTPS requests on port 443 to the zoomdata server port 8443.
sudo iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 443 -j DNAT --to-destination :8443
Identifying the IP Address
Connect to your Zoomdata environment.
After installing Zoomdata or launching a preconfigured virtual machine image, record the IP address of the host where Zoomdata is installed (for virtual machines you will need to log into the machine and run the "ifconfig" command).
eth0 Link encap:Ethernet HWaddr 00:0C:29:BA:52:71
inet addr:172.29.70.17 Bcast:172.29.70.255 Mask:255.255.255.0
After successfully installing the Zoomdata Server, you are ready to access the Zoomdata client on your web browser.
ACCESSING THE ZOOMDATA CLIENT FROM THE WEB BROWSER
Open a web-socket supported web browser (that is, Google Chrome 29+, Firefox 23+, IE 10+ and Safari 6+):
If you have configured your firewall based on instructions above then use the following URL format:
https:// IP_Address_of_Zoomdata_Server /zoomdata
Otherwise, use the following URL format:
https:// IP_Address_of_Zoomdata_Server :8443/zoomdata
- Be sure to replace the IP Address placeholder with the one you obtained in Step 6: Connect to your Zoomdata environment above.
- The browser will issue a warning specifying that the security certificate is not trusted. This warning occurs because the certificate deployed is self-signed. The warning does not appear when deploying your own certificate. Click Proceed anyway .
- The first time that you access the login screen, you will be asked to change the passwords for both the Admin and the Supervisor roles. Access the article Roles in Zoomdata for details about administrative roles.
We recommend you log into Zoomdata
in the browser
using the 'supervisor' credentials first to review all the account-level features available. Then log in as the 'admin' to test
the Zoomdata web application using the supplied sample data source - Real Time Sales.
Learn more about exploring and analyzing your data .
For information about creating charts and dashboards, access the User's Guide .
Safari web browser: selecting any chart may result in a "Connection Closed" error. The error is a result of Zoomdata's self-signed certificate deployed on Ubuntu. The self-signed certificate is provided for convenience. To fix the issue, deploy your own SSL certificate on your Zoomdata installation. Learn how to add an SSL certificate to the Zoomdata Server .