Zoomdata Version

Ubuntu Installation Steps

This article provides instructions for performing a clean installation of Zoomdata in your operating environment.

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?

PRE-INSTALLATION PREP

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:

  1. Use the following command to access and open the limits.conf file:
vi /etc/security/limits.conf
If the configuration file does not exist, this command will create it
  1. Add the following lines to the file:
zoomdata        soft    nproc           4096
zoomdata        hard    nproc           4096
zoomdata        soft    nofile          10000
zoomdata        hard    nofile          10000
  1. 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
*SparkIt must be enabled in order to connect to and use certain data sources including S3 and HDFS as well as Cloud-based sources (Google Analytics, HDFS, Marketo, S3, Salesforce, SendGrid and Zendesk). For more information, access the article An Overview of Spark in Zoomdata .

Post-Requisite

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
If you already have MongoDB in your operating environment, you have the option to connect to it. Refer to the article Installing Zoomdata Using an Existing MongoDB Instance for instructions.
  • 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

Installing MongoDB

To begin, you need to first install MongoDB. Zoomdata uses MongoDB to store its metadata and to cache data coming from Flat Files or fed through the Upload API .

  1. Install MongoDB and the associated tools.
  2. Start MongoDB by issuing the following command:
sudo service mongod start
  1. Add a mongo user:
mongo zoom --eval "db.createUser({user:'anadmin', pwd:'p0ssward2dataz00m',roles:['readWrite']});"

Learn more about MongoDB and installation resources .

Installing the Zoomdata Server

  1. Install Zoomdata .DEB.
sudo dpkg -i zoomdata_ x _amd64.deb
replace the x with the version number of Zoomdata you are installing.

Optional Zoomdata Configurations

After installation you may want to change the default memory settings .

Add a Mongo user credentials into (newly created) file /etc/zoomdata/zoomdata.properties : (skip this if you used  default settings with locally installed MongoDB server):

zoomdata.db.host= localhost:27017
zoomdata.db.name= zoom
zoomdata.db.password= p0ssward2dataz00m
zoomdata.db.username= anadmin

Configure the scheduler settings. Add the following lines to the scheduler.properties file:

scheduler.db.host= localhost:27017
scheduler.db.name= zoom-scheduler

Configuring the Firewall

  1. Configure "iptables" to accept port 8443 and to forward incoming HTTPS requests on port 443 to the zoomdata server port 8443.
sudo iptables -I INPUT 1 -i eth0 -p tcp --dport 8443 -j ACCEPT
sudo iptables -t nat -A PREROUTING -i eth0 -p tcp --dport 443 -j DNAT --to-destination :8443
sudo iptables-save

Identifying the IP Address

  1. 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).

For example:

[[email protected] ~]$ ifconfig eth0
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+):

  1. 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
  2. Be sure to replace the IP Address placeholder with the one you obtained in Step 6: Connect to your Zoomdata environment above.
  3. 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 .
  4. 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 .

By default, the Zoomdata Server is configured to use 8 GB of RAM.  You can change this memory allocation by following these steps .

Once Zoomdata is installed, you can proceed to set up your users as well as connect to data sources. Access the articles Managing Access, Security and Accounts and Connecting to Data for guidance.

For information about creating charts and dashboards, access the User's Guide .

KNOWN ISSUE:

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 .