Zoomdata Version

Managing Configurations in Zoomdata (Properties files)

The Zoomdata Server leverages the following configuration files to ensure successful deployment in your operating environment:

  • The zoomdata.properties file defines variables and parameters related to Zoomdata specifically.
  • The zoomdata.env file defines configurations and variables that help Zoomdata connect to and communicate with your network.
  • The scheduler.properties file defines variables and parameters related to Zoomdata Scheduler process.
  • The spark-proxy.properties file defines variables and parameters related to Zoomdata SparkIT process.
Beginning with Zoomdata v2.2, the zoomdata configuration file was renamed from zoomdata.conf to zoomdata.properties . The .conf filename is depricated in v2.3 so for existing users that deployed earlier versions of Zoomdata Server and used zoomdata.conf , please copy configurations to zoomdata.properties .

These configuration files are the 'admin-facing' documents where the Zoomdata Administrator can make changes to the Zoomdata Server. These files need to be created after the Zoomdata Server has been installed in order to override Zoomdata's default configuration.

To access these files on the Zoomdata Server and make edits, follow the step-by-step instructions provided below.

Accessing A Zoomdata Properties File

The configuration files are located in the /etc/zoomdata or /opt/zoomdata/conf directory. Take the following steps to access these files:

  1. From your terminal, SSH to your Zoomdata Server.
  2. Stop the Zoomdata Server service:
    sudo service zoomdata stop
  3. Use the following command to access and open the configuration file:
    vi /etc/zoomdata/ zoomdata.properties
  • If you are not logged in as a root user, then you will need to enter sudo vi /etc/zoomdata/ zoomdata.properties or zoomdata.env or scheduler.properties or spark-proxy.properties in order to create the desired file.
  • If the configuration file does not exist, this command will create it.
  • Make sure the file is readable by the zoomdata service account
  1. Add the new variable into the file on a new line or edit an existing variable, as needed.
  2. Save and exit the configuration file.
  3. Restart the Zoomdata Server:
    sudo service zoomdata start

Once the Zoomdata Server has successfully restarted, you can open a new browser window and log in. Check to determine whether your change(s) has taken effect.

Situations where the zoomdata.properties file needs to be created include:

Situations where the zoomdata.env file needs to be created include:

Situations where the scheduler.properties file needs to be created include:

  • Connecting Scheduler to Postgres on a separate server
  • Running the Scheduler process on a different port

Situations where the spark-proxy.properties file needs to be created include: