Zoomdata Version

Zoomdata Configuration Properties

The following application parameters are configurable in either the zoomdata.properties or zoomdata.env file. Table 1 shows the variables that can be set in zoomdata.properties . Table 2 shows the variables that can be set in zoomdata.env .

Table 1: Zoomdata.properties Options

Property Name Default Value Description
http.port 8080

Sets the alternative http port that can accept connections. This property can be disabled by leaving an empty string as the value. See 'server.port' property for additional information.

This property is only applicable when server.ssl.enabled is set to 'true'.
http.redirect.port customer defined

Sets the https port to send browser redirect from http connection request. This property can be disabled by leaving an empty string as the value.

This property is only applicable when server.ssl.enabled is set to 'true'.
logs.dir $ install_dir /logs Path to Zoomdata logs. The placeholder install.dir is replaced with the actual location where Zoomdata is installed (for example, $ zoomdata /logs).
proxyHost customer defined For cloud-based connectors (including Google Analytics and Salesforce) being used in a proxy configuration, this property specifies the server host to be returned for calls, and identifies the proxy host server that will provide internet access.
proxyPort customer defined For cloud-based connectors (including Google Analytics and Salesforce) being used in a proxy configuration, this property specifies the server port to be returned for calls, and identifies the proxy port server that will provide internet access.
saml.maxAuthAge 86400 Sets the timeout for SAML, in seconds. The default is 24 hours.
server.port 8443 Sets the default http / https port. If SSL is enabled, then this port will be https and the 'http.port' property will be an alternative http port.
server.ssl.enabled true Toggle switch to determine whether the ssl connection for the default port is enabled or not.
server.ssl.key-store HOME/conf/keystore Sets the path for the keystore location.
server.ssl.key-store-password customer defined Stores the keystore password.
source.attribute.values.limit 1000 Sets the limit for the number of attribute values that can be displayed in the Filter list.
syslog.log.level

OFF

Sets the message logging function. The following options are available for this property:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
syslog.host 127.0.0.1 Sets the host IP address for message logging.
syslog.port 1514 Sets the port for message logging.
syslog.suffix local Specifies a suffix that is appended at the end of the log entry that Zoomdata generates.

Table 2: Zoomdata.env Variables

Environment Property Name Default Value Description
DEBUG_ENABLED 0/false Toggle switch to enable or disable the Java debug capability. To enable, enter '1' or 'true'.
DEBUG_PORT 9393 The default port for the Java debug capability.
EDC_SERVICE true Toggle switch to enable or disable Zoomdata's enterprise data connector service.
JAVA_OPTS -Xss256k -Xms2048m -Xmx8192m Java-related options for JVM. Refer to Oracle's article on Java HotSpot VM Options for information.
KERBEROS_CONFIG /etc/krb5.conf Default location for the Kerberos configuration details. However, the path to the file may be different in your environment. Refer to Oracle's article on File Formats for information.
SCHEDULER_JAVA_OPTS -Xms512m -Xmx1024m Java-related options for JVM specifically for the Scheduler component. Refer to Oracle's article on Java HotSpot VM Options for information.
SCHEDULER_SERVICE true Toggle switch to enable or disable the local (that is, Scheduler component is installed in same server as Zoomdata) scheduler.
SCREENSHOTS_ENABLED

Toggle switch to enable or disable the xvfb file related to the screenshots feature . Variable options:

  • 'true' - enables screenshots
  • 'false' - disables screenshots

SPARK_LOCAL_IP

127.0.0.1 Identifies the location of the Spark driver; must be a public IP address since Zoomdata needs to connect to it. Refer to the Spark Configuration article.
SPARK_PUBLIC_DNS localhost Provides the hostname your Spark Proxy will share with other servers.
SPARK_PROXY_HADOOP_DISTRO cdh5

Sets the default version of the sparkLib.

SPARK_PROXY_JAVA_OPTS -Xss256k -Xms512m -Xmx2048m Java-related options for JVM specifically for a standalone Spark Proxy component. Refer to Oracle's article on Java HotSpot VM Options for information.
SPARK_PROXY_MASTER_URL local[*] Run Spark locally with as many worker threads as logical cores on your machine.
Refer to Apache Spark's documentation .
SPARK_PROXY_PIDFILE /tmp/spark-proxy.pid Sets the path to the Spark Proxy process identifier. Refer to wiki article on process identifier for more information.
SPARK_PROXY_RMIHOST 0.0.0.0 Identifies the IP address for the RMI Host and interface for Zoomdata's Spark Service.
SPARK_PROXY_RMIPORT 9292 Identifies the RMI Port for Zoomdata's Spark Service.
SPARK_PROXY_SERVICE true Toggle switch to enable or disable a standalone Spark Proxy service that's been set up for Zoomdata access.
SPARK_PROXY_TMPDIR $BASE_PATH/temp Specifies the path to the directory where Spark Proxy holds TMP data.
ULIMIT_FILES 10000 Sets the maximum number of open file descriptors.
ULIMIT_PROCESSES 1024 Sets the maximum number of processes.
ZOOMDATA_PID /tmp/zoomdata.pid Sets the path to Zoomdata's process identifier.