Zoomdata Version

zoomdata.properties Properties

Property Default Value Description
access.control.allow.origin * By default, CORS is set to --- in the Zoomdata Server. You can set CORS to restrict access:

access.control.allow.origin=<user-defined>

For more information, see Enabling Cross-Origin Requests with CORS Settings.

logs.dir <ZD_install_directory> /logs

Path to Zoomdata logs. The placeholder <ZD_install_directory> is replaced with the actual location where Zoomdata is installed.

Verify that this log directory has all the necessary permissions and that the owner of the directory is set to zoomdata.

The /home directory cannot be used for logging.

Example: logs.dir=/opt/<zoomdata>/logs)

management.endpoints.web.base-path /actuator Path to the Zoomdata actuator.
saml.maxAuthAge 86400 Sets the timeout for SAML, in seconds. The default is 24 hours.

Example: saml.maxAuthAge=86400

scheduler.service.url http://localhost:3333 Points to the scheduler service that Zoomdata uses to clear caches.

Example: scheduler.service.url=http://localhost:3333

server.compression.enabled true

Enables gzip compression for http requests.

Example: server.compression.enabled=true

server.port 8080 The default server port, which is set to use http. Prior releases used http.port
server.servlet.context-path /zoomdata

Example: server.servlet.context-path=/zoomdata

server.session-timeout 1800 Sets when your Zoomdata session will timeout (in seconds).

Example: server.session-timeout=1800

source.attribute.values.limit 1000 Sets the limit for the number of attribute values that can be displayed in the Filter list.

Example: source.attribute.values.limit=1000

spring.servlet.multipart.max-file-size 500Mb

Example: spring.servlet.multipart.max-file-size=500Mb

spring.servlet.multipart.max-request-size 500Mb

Example: spring.servlet.multipart.max-request-size=500Mb

Keystore Properties
keystore.location classpath:security/zoomkeystore.jks Zoomdata uses symmetric encryption. You can point to a new keystore to strengthen security.

Example: keystore.location=classpath:security/zoomkeystore.jks

See Creating a Symmetric Key to Encrypt Data Source Passwords for further guidance.

keystore.password zoomkey Lets you set up a unique password for the keystore.

Example: keystore.password=zoomkey

keystore.key.alias zoomkey

Example: keystore.key.alias=zoomkey

keystore.key.password zoomkey

Example: keystore.key.password=zoomkey

Server SSL Properties
server.ssl.key-store <Zoomdata_install_directory>/conf/keystore Sets the path for the keystore location.

Example: server.ssl.key-store=HOME/conf/keystore

server.ssl.key-store-password changeit Stores the keystore password.

Example: server.ssl.key-store-password=<YourPassword>

SAML Configuration Properties
saml.artifactBindingDefault true

Example: saml.artifactBindingDefault=true

saml.useMultiValueList true

Example: saml.useMultiValueList=true

saml.stringDelimiter ,

Example: saml.stringDelimiter=,

Kerberized PostgreSQL Properties
spring.datasource.connection-properties:jaasApplicationName com.sun.security.jgss.initiate Property that identifies the library to use for secure connection between PostgreSQL and the Zoomdata Server.

Example: spring.datasource.connection-properties:jaasApplicationName=com.sun.security.jgss.initiate

spring.datasource.url jdbc:postgresql://<IP_address> :5432/zoomdata Property to identify PostgreSQL URL.

Example: spring.datasource.url=jdbc:postgresql:// <IP_address>:5432/zoomdata

spring.datasource.username zoomdata Property to identify the username in PostgreSQL.

Example: spring.datasource.username=zoomdata

Source Sampling Properties
source.sampling.count.default 1000

Example: source.sampling.count.default=1000

source.attribute.values.limit 1000

Example: source.attribute.values.limit=1000

Logging Properties
logging.level.com.zoomdata INFO Sets the log level for log messages in the Zoomdata service log file. The following options are available for this property: TRACE, DEBUG, INFO, WARN, and ERROR.

Example: logging.level.com.zoomdata=DEBUG

logging.unified.level
OFF

Sets the log level for messages logged to the Fluentd server. The following options are available for this property: TRACE, DEBUG, INFO, WARN, ERROR, and OFF. If set to OFF, Fluentd unified logging is disabled. For more information, see Setting Up Fluentd Unified Logging.

Example: logging.unified.level=INFO

logging.unified.tag zoomdata-server

Sets the service tag name for messages logged to the Fluentd server. This is important because the tag identifies the service to which the log messages apply. Valid values are query-engine, job-scheduler, zoomdata-server, stream-writer, upload-service, and edc-<connector-name> (where <connector-name> is one of the names listed in Connector Properties). For more information, see Setting Up Fluentd Unified Logging.

Example: logging.unified.tag = zoomdata-server

logging.unified.host 127.0.0.1

Sets the host IP address for Fluentd server message logging. For more information, see Setting Up Fluentd Unified Logging.

Example: logging.unified.host=123.4.5.6

logging.unified.port 24224

Sets the port for Fluentd server message logging. For more information, see Setting Up Fluentd Unified Logging.

Example: logging.unified.port=1234

syslog.log.level OFF Sets the syslog log level for messages logged to the Syslog server. The following options are available for this property: TRACE, DEBUG, INFO, WARN, ERROR, and OFF.

Example: syslog.log.level=DEBUG

syslog.host 127.0.0.1 Sets the host IP address for Syslog server message logging.

Example: syslog.host=127.0.0.1

syslog.port 1514 Sets the port for Syslog server message logging.

Example: syslog.port=1514

syslog.suffix local Specifies a suffix that is appended at the end of the Syslog server log entry that Zoomdata generates.

Example: syslog.suffix=local

Password Policy
auth.password.policy.specialCharacters !@#$%^&*()-_=+,.:;<>
auth.password.policy.minCharacters 9
auth.password.policy.maxCharacters 255
auth.password.policy.minLowercaseCharacters 1
auth.password.policy.minUppercaseCharacters 1
auth.password.policy.minNumericCharacters 1
auth.password.policy.minSpecialCharacters 1
auth.password.policy.helpMessage Password must contain at least 9 characters including 1 lowercase, 1 uppercase, 1 number and 1 special (!@#$%^&*()-_=+,.:;<>). Text is not enclosed in quotation marks.
Data Export Properties
zoomdata.export.data.max.cols 1000 columns

Use this property to define the maximum number of columns that can be exported for two-dimensional chart visualizations (such as a pivot table). Zoomdata enforces this limit for chart data, but does not enforce it for raw data.

The distributed default for this setting is 1000 columns. Valid values can range from 0 through 2147483647 columns.

zoomdata.export.data.max.rows 100000 rows

Use this property to define the maximum number of rows that can be exported for charts. Zoomdata enforces this limit for chart data. However, for raw data, Zoomdata produces an error if the number of rows requested for export exceeds this setting.

The distributed default for this setting is 100000 rows. Valid values can range from 0 through 2147483647 rows.

Field Settings
zoomdata.detect.type.attribute.max.length 200 characters Use this property to set the maximum character length of attribute fields. If this limit is exceeded, the field will be recognized as a Text field.

Was this topic helpful?