Service Configuration
The LAT service is configurable via Service Configuration.
This configuration is derived from three sources, with the following precedence order:
- Environment Variables
- Properties File
- Code Defaults
Upon installation of a new LAT instance or upgrade, LAT preserves the configuration file /etc/lat/lat.conf as /etc/lat/override.conf.
Default number of workers used by a newly configured pipeline.
Environment Variable: | LAT_DEFAULT_WORKERS |
|---|---|
Property: | lat.default.workers |
Default: | Server core count |
Duration, in milliseconds, to wait prior to termination on shutdown.
Environment Variable: | LAT_SHUTDOWN_DURATION |
|---|---|
Property: | lat.shutdown.duration |
Default: | 120000 |
Directory containing zero or more user defined transformation (UDT) jars. Ensure that the specified path can be accessed by the LAT (e.g., does not allow the LAT to access the home directory of an administrative user).
Environment Variable: | LAT_UDT_PATH |
|---|---|
Property: | lat.udt.path |
Default: | null |
REST API and Metrics port.
Environment Variable: | LAT_API_PORT |
|---|---|
Property: | lat.api.port |
Default: | 8080 |
Path to the LAT data directory. This directory is used to store persistent data related to pipelines (pipeline/) and sinks (sink/). In almost all cases, using the LAT Client Command Line Interface is preferred over editing the files in this directory manually. Ensure that the specified path can be accessed by the LAT (e.g., CentOS does not allow the LAT to access the home directory of an administrative user).
Environment Variable: | LAT_DATA_PATH |
|---|---|
Property: | lat.data.path |
Default: | .lat-data |
On LAT startup, automatically starts running a Pipeline if one is present. This only supports pipelines with sources; File sources will not automatically start even if this configuration is set to true.
Environment Variable: | LAT_AUTO_START |
|---|---|
Property: | lat.auto.start |
Default: | false |
Allow the original records that are being loaded to be logged when errors occur. This setting must be enabled for log_original_records to be enabled.
This setting only affects pipelines that log errors to the error log file.
Environment Variable: | LAT_ALLOW_LOG_ORIGINAL_RECORDS |
|---|---|
Property: | lat.allow.log.original.records |
Default: | false |
A limit on the number of errors that you can retrieve using the pipeline errors command of the LAT client.
Environment Variable: | LAT_MAX_RETRIEVABLE_ERRORS |
|---|---|
Property: | lat.max.retrievable.errors |
Default: | 1000 |
API proxy host for authorization requests.
Environment Variable: | LAT_API_PROXY_HOST |
|---|---|
Property: | lat.api.proxy.host |
Default: | null |
API proxy port for Okta authorization requests.
Environment Variable: | LAT_API_PROXY_PORT |
|---|---|
Property: | lat.api.proxy.PORT |
Default: | null |
Okta authorization domain.
Environment Variable: | LAT_API_OAUTH_DOMAIN |
|---|---|
Property: | lat.api.oauth.domain |
Default: | null |
A list of LAT API endpoints that Okta should apply authentication on. To override, provide a comma-delimited list, e.g., /endpoint1,/endpoint2,/endpoint3.
Environment Variable: | LAT_API_OAUTH_ENDPOINTS |
|---|---|
Property: | lat.api.oauth.endpoints |
Default: | null |
Okta authorization server.
Environment Variable: | LAT_API_OAUTH_SERVER |
|---|---|
Property: | lat.api.oauth.server |
Default: | null |
API cert file path. Ensure that the specified path can be accessed by the LAT (e.g., does not allow the LAT to access the home directory of an administrative user).
Environment Variable: | LAT_API_CERT_PATH |
|---|---|
Property: | lat.api.cert.path |
Default: | null |
The time-to-live (TTL) in seconds that the LAT should use for its DNS cache. This configuration is only supported as an Environment Variable or as Default.
Environment Variable: | LAT_DNS_CACHE_TTL |
|---|---|
Property: | N/A |
Default: | 30 |
Maximum JVM® heap memory. This configuration is only supported as an Environment Variable or as Default when running the LAT through the provided package service file or through the provided lat.sh script. If directly running the Jar JVM heap memory should be set through command line arguments.
Environment Variable: | LAT_MEMORY |
|---|---|
Property: | N/A |
Default: | 32G |
Maximum JVM direct memory. This configuration is only supported as an Environment Variable or as Default when running the LAT through the provided package service file or through the provided lat.sh script. If directly running the Jar JVM heap memory should be set through command line arguments.
Environment Variable: | LAT_MEMORY_DIRECT |
|---|---|
Property: | N/A |
Default: | 32G |