Oozie Properties in CDH 5.0.0

oozieserver

Advanced

For advanced use only, a string to be inserted into log4j.properties for this role only.

log4j_safety_valve

false

Heap Dump Directory

Path to directory where heap dumps are generated when java.lang.OutOfMemoryError error is thrown. This directory is automatically
created if it does not exist. If this directory already exists, role user must have write access to this directory. If this directory is shared among multiple roles, it should have 1777 permissions.
The heap dump files are created with 600 permissions and are owned by the role user. The amount of free space in this directory should be greater than the maximum Java Process heap size configured
for this role.

oom_heap_dump_dir

/tmp

oom_heap_dump_dir

false

Dump Heap When Out of Memory

When set, generates heap dump file when java.lang.OutOfMemoryError is thrown.

false

oom_heap_dump_enabled

true

Kill When Out of Memory

When set, a SIGKILL signal is sent to the role process when java.lang.OutOfMemoryError is thrown.

For advanced use only. A string to be inserted into oozie-site.xml for this role only.

oozie_config_safety_valve

false

Oozie ActionService Executor Extension Classes

Comma-separated list of ActionService executor extension classes. Only action types with associated executors can be used in
workflows. For CDH 5.4 and higher, this parameter is used only to specify additional classes for workflows. All executor extension classes included in that release will be added automatically and do
not need to be specified.

For advanced use only, key-value pairs (one on each line) to be inserted into a role's environment. Applies to configurations of this
role except client configuration.

OOZIE_SERVER_role_env_safety_valve

false

Oozie SchemaService Workflow Extension Schemas

Comma-separated list of SchemaService workflow extension schemas for additional action types. From CDH 5.4 and higher, this parameter
is used only to specify additional schemas for workflows. All schemas included in that release will be added automatically and do not need to be specified.

When set, this role's process is automatically (and transparently) restarted in the event of an unexpected failure.

false

process_auto_restart

true

Database

Display Name

Description

Related Name

Default Value

API Name

Required

Oozie Server Data Directory

Directory where the Oozie Server places its data. Only applicable when using Derby as the database type.

/var/lib/oozie/data

oozie_data_dir

false

Oozie Server Database Host

Hostname of the database used by Oozie Server. If the port is non-default for your database type, use host:port notation. Does not
apply if you are using Derby as the database type.

localhost

oozie_database_host

false

Oozie Server Database Name

Name of the database used by Oozie Server.

oozie

oozie_database_name

false

Oozie Server Database Password

Password for connecting to the database used by Oozie Server. Does not apply if you are using Derby as the database type.

oozie.service.JPAService.jdbc.password

oozie_database_password

false

Oozie Server Database Type

Type of the database used by Oozie Server.

derby

oozie_database_type

false

Oozie Server Database User

Username for connecting to the database used by Oozie Server. Does not apply if you are using Derby as the database type.

oozie.service.JPAService.jdbc.username

sa

oozie_database_user

false

Logs

Display Name

Description

Related Name

Default Value

API Name

Required

Oozie Server Logging Threshold

The minimum log level for Oozie Server logs

INFO

log_threshold

false

Oozie Server Maximum Log File Backups

The maximum number of rolled log files to keep for Oozie Server logs. Typically used by log4j or logback.

720

max_log_backup_index

false

Oozie Server Log Directory

Directory where Oozie Server will place its log files.

/var/log/oozie

oozie_log_dir

false

Monitoring

Display Name

Description

Related Name

Default Value

API Name

Required

Enable Health Alerts for this Role

When set, Cloudera Manager will send alerts when the health of this role reaches the threshold specified by the EventServer setting
eventserver_health_events_alert_threshold

true

enable_alerts

false

Enable Configuration Change Alerts

When set, Cloudera Manager will send alerts when this entity's configuration changes.

false

enable_config_alerts

false

Heap Dump Directory Free Space Monitoring Absolute Thresholds

The health test thresholds for monitoring of free space on the filesystem that contains this role's heap dump directory.

Warning: 10 GiB, Critical: 5 GiB

heap_dump_directory_free_space_absolute_thresholds

false

Heap Dump Directory Free Space Monitoring Percentage Thresholds

The health test thresholds for monitoring of free space on the filesystem that contains this role's heap dump directory. Specified as
a percentage of the capacity on that filesystem. This setting is not used if a Heap Dump Directory Free Space Monitoring Absolute Thresholds setting is configured.

Warning: Never, Critical: Never

heap_dump_directory_free_space_percentage_thresholds

false

Log Directory Free Space Monitoring Absolute Thresholds

The health test thresholds for monitoring of free space on the filesystem that contains this role's log directory.

Warning: 10 GiB, Critical: 5 GiB

log_directory_free_space_absolute_thresholds

false

Log Directory Free Space Monitoring Percentage Thresholds

The health test thresholds for monitoring of free space on the filesystem that contains this role's log directory. Specified as a
percentage of the capacity on that filesystem. This setting is not used if a Log Directory Free Space Monitoring Absolute Thresholds setting is configured.

The health test thresholds for the weighted average extra time the pause monitor spent paused. Specified as a percentage of elapsed
wall clock time.

Warning: 30.0, Critical: 60.0

oozie_server_pause_duration_thresholds

false

Pause Duration Monitoring Period

The period to review when computing the moving average of extra time the pause monitor spent paused.

5 minute(s)

oozie_server_pause_duration_window

false

Oozie Server Process Health Test

Enables the health test that the Oozie Server's process state is consistent with the role configuration

true

oozie_server_scm_health_enabled

false

Enable Oozie Server Shared Libraries Version Check

If true, enables version check for Oozie Server and installed shared libraries.

true

oozie_server_shared_lib_version_check_enabled

false

Web Metric Collection

Enables the health test that the Cloudera Manager Agent can successfully contact and gather metrics from the web server.

true

oozie_server_web_metric_collection_enabled

false

Web Metric Collection Duration

The health test thresholds on the duration of the metrics request to the web server.

Warning: 10 second(s), Critical: Never

oozie_server_web_metric_collection_thresholds

false

Process Swap Memory Thresholds

The health test thresholds on the swap memory usage of the process.

Warning: Any, Critical: Never

process_swap_memory_thresholds

false

Role Triggers

The configured triggers for this role. This is a JSON formatted list of triggers. These triggers are evaluated as part as the health
system. Every trigger expression is parsed, and if the trigger condition is met, the list of actions provided in the trigger expression is executed. Each trigger has the following fields:

triggerName(mandatory) - The name of the trigger. This value must be unique for the specific role.

streamThreshold(optional) - The maximum number of streams that can satisfy a condition of a trigger before the condition
fires. By default set to 0, and any stream returned causes the condition to fire.

enabled(optional) - By default set to 'true'. If set to 'false', the trigger is not evaluated.

expressionEditorConfig(optional) - Metadata for the trigger editor. If present, the trigger should only be edited from the
Edit Trigger page; editing the trigger here can lead to inconsistencies.

For example, the following JSON formatted trigger configured for a DataNode fires if the DataNode has more than 1500 file descriptors opened:[{"triggerName": "sample-trigger",
"triggerExpression": "IF (SELECT fd_open WHERE roleName=$ROLENAME and last(fd_open) > 1500) DO health:bad", "streamThreshold": 0, "enabled": "true"}]See the trigger rules documentation for
more details on how to write triggers using tsquery.The JSON format is evolving and may change and, as a result, backward compatibility is not guaranteed between releases.

[]

role_triggers

true

Unexpected Exits Thresholds

The health test thresholds for unexpected exits encountered within a recent period specified by the unexpected_exits_window
configuration for the role.

Warning: Never, Critical: Any

unexpected_exits_thresholds

false

Unexpected Exits Monitoring Period

The period to review when computing unexpected exits.

5 minute(s)

unexpected_exits_window

false

Other

Display Name

Description

Related Name

Default Value

API Name

Required

Oozie Email Action From Address

The from address to be used for mailing all emails for Oozie email action

oozie.email.from.address

oozie@localhost

oozie_email_from_address

false

Oozie Email Action SMTP Authentication Enabled

Enable SMTP authentication for Oozie email action

oozie.email.smtp.auth

false

oozie_email_smtp_auth

false

Oozie Email Action SMTP Host

The SMTP server host to use for Oozie email action

oozie.email.smtp.host

localhost

oozie_email_smtp_host

false

Oozie Email Action SMTP Authentication Password

SMTP password for Oozie email action

oozie.email.smtp.password

oozie_email_smtp_password

false

Oozie Email Action SMTP Authentication Username

SMTP username for Oozie email action

oozie.email.smtp.username

oozie_email_smtp_username

false

Oozie Server Plugins

Comma-separated list of Oozie plug-ins to be activated. If one plugin cannot be loaded, all the plugins are ignored.

oozie.services.ext

oozie_plugins_list

false

Maximum concurrency for a given callable type

Maximum concurrency for a given callable type.. Each command is a callable type: submit, start, run, etc.. Each action type is a
callable type: MapReduce, SSH, sub-workflow, etc. All commands that use action executors (action-start, action-end. etc.) use the action type as the callable type.

oozie.service.CallableQueueService.callable.concurrency

10

oozie_service_callablequeueservice_callable_concurrency

false

Maximum Callable Queue Size

Maximum callable queue size

oozie.service.CallableQueueService.queue.size

10000

oozie_service_callablequeueservice_queue_size

false

Number Threads For Executing Callables

Number of threads used for executing callables

oozie.service.CallableQueueService.threads

50

oozie_service_callablequeueservice_threads

false

Enable Oozie Server Web Console

If true, enables the Oozie Server web console. ExtJS 2.2 zip archive must be extracted to /var/lib/oozie on the same host as the
Oozie Server.

false

oozie_web_console

false

Performance

Display Name

Description

Related Name

Default Value

API Name

Required

Maximum Process File Descriptors

If configured, overrides the process soft and hard rlimits (also called ulimits) for file descriptors to the configured value.

Number of CPU shares to assign to this role. The greater the number of shares, the larger the share of the host's CPUs that will be
given to this role when the host experiences CPU contention. Must be between 2 and 262144. Defaults to 1024 for processes not managed by Cloudera Manager.

cpu.shares

1024

rm_cpu_shares

true

Cgroup I/O Weight

Weight for the read I/O requests issued by this role. The greater the weight, the higher the priority of the requests when the host
experiences I/O contention. Must be between 100 and 1000. Defaults to 1000 for processes not managed by Cloudera Manager.

blkio.weight

500

rm_io_weight

true

Cgroup Memory Hard Limit

Hard memory limit to assign to this role, enforced by the Linux kernel. When the limit is reached, the kernel will reclaim pages
charged to the process. If reclaiming fails, the kernel may kill the process. Both anonymous as well as page cache pages contribute to the limit. Use a value of -1 B to specify no limit. By default
processes not managed by Cloudera Manager will have no limit.

memory.limit_in_bytes

-1 MiB

rm_memory_hard_limit

true

Cgroup Memory Soft Limit

Soft memory limit to assign to this role, enforced by the Linux kernel. When the limit is reached, the kernel will reclaim pages
charged to the process if and only if the host is facing memory pressure. If reclaiming fails, the kernel may kill the process. Both anonymous as well as page cache pages contribute to the limit. Use
a value of -1 B to specify no limit. By default processes not managed by Cloudera Manager will have no limit.

memory.soft_limit_in_bytes

-1 MiB

rm_memory_soft_limit

true

Security

Display Name

Description

Related Name

Default Value

API Name

Required

Oozie TLS/SSL Server JKS Keystore File Location

The path to the TLS/SSL keystore file containing the server certificate and private key used for TLS/SSL. Used when Oozie is acting
as a TLS/SSL server. The keystore must be in JKS format.

/var/lib/oozie/.keystore

oozie_https_keystore_file

false

Oozie TLS/SSL Server JKS Keystore File Password

The password for the Oozie JKS keystore file.

oozie_https_keystore_password

false

Oozie HTTPS Port

Port of the Oozie Server when using TLS/SSL.

11443

oozie_https_port

false

Oozie TLS/SSL Certificate Trust Store File

The location on disk of the trust store, in .jks format, used to confirm the authenticity of TLS/SSL servers that Oozie might
connect to. This is used when Oozie is the client in a TLS/SSL connection. This trust store must contain the certificate(s) used to sign the service(s) connected to. If this parameter is not
provided, the default list of well-known certificate authorities is used instead.

oozie_https_truststore_file

false

Oozie TLS/SSL Certificate Trust Store Password

The password for the Oozie TLS/SSL Certificate Trust Store File. This password is not required to access the trust store; this field
can be left blank. This password provides optional integrity checking of the file. The contents of trust stores are certificates, and certificates are public information.

oozie_https_truststore_password

false

Stacks Collection

Display Name

Description

Related Name

Default Value

API Name

Required

Stacks Collection Data Retention

The amount of stacks data that is retained. After the retention limit is reached, the oldest data is deleted.

stacks_collection_data_retention

100 MiB

stacks_collection_data_retention

false

Stacks Collection Directory

The directory in which stacks logs are placed. If not set, stacks are logged into a stacks
subdirectory of the role's log directory.

stacks_collection_directory

stacks_collection_directory

false

Stacks Collection Enabled

Whether or not periodic stacks collection is enabled.

stacks_collection_enabled

false

stacks_collection_enabled

true

Stacks Collection Frequency

The frequency with which stacks are collected.

stacks_collection_frequency

5.0 second(s)

stacks_collection_frequency

false

Stacks Collection Method

The method used to collect stacks. The jstack option involves periodically running the jstack command against the role's daemon
process. The servlet method is available for those roles that have an HTTP server endpoint exposing the current stacks traces of all threads. When the servlet method is selected, that HTTP endpoint
is periodically scraped.

stacks_collection_method

jstack

stacks_collection_method

false

Suppressions

Display Name

Description

Related Name

Default Value

API Name

Required

Suppress Configuration Validator: CDH Version Validator

Whether to suppress configuration warnings produced by the CDH Version Validator configuration validator.

Whether to suppress configuration warnings produced by the built-in parameter validation for the Oozie SchemaService Workflow
Extension Schemas parameter.

false

role_config_suppression_oozie_workflow_extension_schemas

true

Suppress Parameter Validation: Role Triggers

Whether to suppress configuration warnings produced by the built-in parameter validation for the Role Triggers parameter.

false

role_config_suppression_role_triggers

true

Suppress Parameter Validation: Stacks Collection Directory

Whether to suppress configuration warnings produced by the built-in parameter validation for the Stacks Collection Directory
parameter.

false

role_config_suppression_stacks_collection_directory

true

Suppress Health Test: Callable Queue Size

Whether to suppress the results of the Callable Queue Size heath test. The results of suppressed health tests are ignored when
computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_callablequeue_size_health

true

Suppress Health Test: File Descriptors

Whether to suppress the results of the File Descriptors heath test. The results of suppressed health tests are ignored when
computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_file_descriptor

true

Suppress Health Test: Heap Dump Directory Free Space

Whether to suppress the results of the Heap Dump Directory Free Space heath test. The results of suppressed health tests are ignored
when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_heap_dump_directory_free_space

true

Suppress Health Test: Host Health

Whether to suppress the results of the Host Health heath test. The results of suppressed health tests are ignored when computing the
overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_host_health

true

Suppress Health Test: Log Directory Free Space

Whether to suppress the results of the Log Directory Free Space heath test. The results of suppressed health tests are ignored when
computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_log_directory_free_space

true

Suppress Health Test: Pause Duration

Whether to suppress the results of the Pause Duration heath test. The results of suppressed health tests are ignored when computing
the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_pause_duration

true

Suppress Health Test: Process Status

Whether to suppress the results of the Process Status heath test. The results of suppressed health tests are ignored when computing
the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_scm_health

true

Suppress Health Test: Oozie Server Shared Library Check

Whether to suppress the results of the Oozie Server Shared Library Check heath test. The results of suppressed health tests are
ignored when computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_shared_lib_version_health

true

Suppress Health Test: Swap Memory Usage

Whether to suppress the results of the Swap Memory Usage heath test. The results of suppressed health tests are ignored when
computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_swap_memory_usage

true

Suppress Health Test: Unexpected Exits

Whether to suppress the results of the Unexpected Exits heath test. The results of suppressed health tests are ignored when
computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

false

role_health_suppression_oozie_server_unexpected_exits

true

Suppress Health Test: Web Server Status

Whether to suppress the results of the Web Server Status heath test. The results of suppressed health tests are ignored when
computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

service_wide

Advanced

For advanced use only, key-value pairs (one on each line) to be inserted into a role's environment. Applies to configurations of all
roles in this service except client configuration.

oozie_env_safety_valve

false

System Group

The group that this service's processes should run as.

oozie

process_groupname

true

System User

The user that this service's processes should run as.

oozie

process_username

true

Monitoring

Display Name

Description

Related Name

Default Value

API Name

Required

Enable Service Level Health Alerts

When set, Cloudera Manager will send alerts when the health of this service reaches the threshold specified by the EventServer
setting eventserver_health_events_alert_threshold

true

enable_alerts

false

Enable Configuration Change Alerts

When set, Cloudera Manager will send alerts when this entity's configuration changes.

false

enable_config_alerts

false

Healthy Oozie Server Monitoring Thresholds

The health test thresholds of the overall Oozie Server health. The check returns "Concerning" health if the percentage of "Healthy"
Oozie Servers falls below the warning threshold. The check is unhealthy if the total percentage of "Healthy" and "Concerning" Oozie Servers falls below the critical threshold.

Warning: 99.0 %, Critical: 51.0 %

oozie_servers_healthy_thresholds

false

Service Triggers

The configured triggers for this service. This is a JSON formatted list of triggers. These triggers are evaluated as part as the
health system. Every trigger expression is parsed, and if the trigger condition is met, the list of actions provided in the trigger expression is executed. Each trigger has the following fields:

triggerName(mandatory) - The name of the trigger. This value must be unique for the specific service.

streamThreshold(optional) - The maximum number of streams that can satisfy a condition of a trigger before the condition
fires. By default set to 0, and any stream returned causes the condition to fire.

enabled(optional) - By default set to 'true'. If set to 'false', the trigger is not evaluated.

expressionEditorConfig(optional) - Metadata for the trigger editor. If present, the trigger should only be edited from the
Edit Trigger page; editing the trigger here can lead to inconsistencies.

For example, the followig JSON formatted trigger fires if there are more than 10 DataNodes with more than 500 file descriptors opened:[{"triggerName": "sample-trigger",
"triggerExpression": "IF (SELECT fd_open WHERE roleType = DataNode and last(fd_open) > 500) DO health:bad", "streamThreshold": 10, "enabled": "true"}]See the trigger rules documentation for
more details on how to write triggers using tsquery.The JSON format is evolving and may change and, as a result, backward compatibility is not guaranteed between releases.

Whether to suppress configuration warnings produced by the built-in parameter validation for the Service Monitor Derived Configs
Advanced Configuration Snippet (Safety Valve) parameter.

false

service_config_suppression_smon_derived_configs_safety_valve

true

Suppress Health Test: Oozie Server Health

Whether to suppress the results of the Oozie Server Health heath test. The results of suppressed health tests are ignored when
computing the overall health of the associated host, role or service, so suppressed health tests will not generate alerts.

If this documentation includes code, including but not limited to, code examples, Cloudera makes this available to you under the terms of the Apache License, Version 2.0, including any required
notices. A copy of the Apache License Version 2.0 can be found here.