Zoomdata Version

Managing Configurations Using Zoomdata Properties

The Zoomdata server uses multiple configuration files to ensure successful deployment of Zoomdata in your operating environment. Each Zoomdata component has a configuration file including:

See Configuration Property Files and Their Corresponding Variables to view the variables and parameters available in these files.

Beginning with Zoomdata v2.2, the zoomdata configuration file was renamed from zoomdata.conf to zoomdata.properties . The .conf filename was deprecated 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 to override Zoomdata's default configuration. This section describes how to access these files on the Zoomdata server and make edits.

Accessing A Zoomdata Configuration File

The configuration files are located in either the /etc/zoomdata or /opt/zoomdata/conf directory (depending on how you set up your server). Take the following steps to access these files:

  1. From your terminal, SSH to your Zoomdata Server.

  2. Stop the appropriate Zoomdata service (Zoomdata, Scheduler, or the specific Connector server). For the appropriate Linux command line (for CentOS v6, v7 or Ubuntu v14, v16), see Stopping Zoomdata Services .

  3. Use the following command to access and open the configuration file:

    • If the configuration file does not exist, this command creates it.

    • If you are not logged in as a root user, then you need to enter sudo vi /etc/zoomdata/<configuration-file-name to create the desired file.

    • If zoomdata.properties is not the configuration file you need to edit, supply the correct file name: zoomdata.env | scheduler.properties | scheduler.env

    • Make sure the file is readable by the zoomdata service account.

  4. Add the new variable into the file on a new line or edit an existing variable, as needed. See either Configuration Property Files and Their Corresponding Variables or Connector Properties for a description of the available variables and parameters.
  5. Save and exit the configuration file.
  6. Restart Zoomdata services. See Restarting Zoomdata Servicesfor the appropriate Linux command.

Wait a few minutes for the service to restart completely, then open a new browser window to log back into Zoomdata. Confirm that 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

Was this topic helpful?