Zoomdata Version

Managing Configurations in Zoomdata (Properties files)

The Zoomdata Server leverages 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 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 below.

Accessing A Zoomdata Properties 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), refer to Stopping Zoomdata Services .
  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 need to enter sudo vi /etc/zoomdata/ zoomdata.properties in order to create the desired file.
    • If the configuration file does not exist, this command creates it.
    • If zoomdata.properties is not the configuration file you need to edit, replace with the needed filename: 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.
    Refer to either Configuration Property Files and Their Corresponding Variables or Connector Properties (depending on your needs), to view the available variables and parameters.
  5. Save and exit the configuration file.
  6. Restart Zoomdata services.
    For the appropriate Linux command line, refer to the article Restarting Zoomdata Services.

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?