Below is a list of system properties that can be used to modify Rhino behaviour.

Name Description

com.opencloud.savanna2.framework.GroupHeartbeat.interval

Interval between sending per-group heartbeat messages

com.opencloud.savanna2.framework.GroupHeartbeat.loss_threshold

Number of unreceived pending heartbeats before the group heartbeat watchdog condition triggers

eventrouter.transaction_timeout

Transaction timeout for eventrouter transactions

logging.status.level

Log level to set on the Log4j status logger

notifications.max_pending_notifications

Maximum number of pending JMX notifications before notifications are dropped

notifications.notification_threads

Number of JMX notification threads to run

rhino.ah.gcthreads

Set the max number of AH GC threads

rhino.ah.pessimistic.maxlocktimeout

Set the maximum lock timeout for local activity handler

rhino.ah.replicating.maxlocktimeout

Set the maximum lock timeout for replicated activities

rhino.ah.replicating.migrationtimeout

Default ah migration timeout

rhino.audit.log_format

Format of CSV management audit log

rhino.bootup.locktimeout

Distributed lock timeout used during node bootup

rhino.er.ra_notifier_threads

Number of resource adaptor entity notifier (callback) threads

rhino.group_rmi.max_threads

Maximum number of threads available to handle group RMI operations.

rhino.halttimeout

The timeout in milliseconds before a JVM shutdown is forcibly terminated with a Runtime.halt().

rhino.license.default

Location of default Rhino license file

rhino.lock.lockmanager.defaultlocktimeout

Set the default timeout for lock acquisitions

rhino.mbean.boot.timeout

Timeout used for write operations during exceptionally long SLEE starts (during Rhino boot)

rhino.misc.queue_size

Queue size for Distributed Resource Manager’s misc. runnable stage

rhino.misc.thread_count

Number of threads used in Distributed Resource Manager’s misc. runnable stage

rhino.rem.enabled

Enable the embedded Rhino Element Manager (SDK only).

rhino.skip_lifecycle_checks

Whether to skip check that prevents a resource adaptor from creating an activity in the STOPPING state.

rhino.tm.resources.queue_size

Queue size for Transaction Manager’s executor for blocking resource callbacks

rhino.tm.resources.thread_count

Number of threads used in Transaction Manager’s executor for blocking resource callbacks

rhino.tm.synchronization.queue_size

Queue size for Transaction Manager’s executor for synchronization callbacks

rhino.tm.synchronization.thread_count

Number of threads used in Transaction Manager’s executor for synchronization callbacks

rhino.verification.traceexceptions

Print exception stack traces for DU verification errors

sas.queue_full_interval

Interval in milliseconds to wait before clearing the queue-full alarm

savanna.receive_watchdog_interval

Maximum time a Savanna receive-thread may remain busy before it is considered stuck

snmp.locktimeout

Default lock acquisition timeout for SNMP config update thread

snmp.max_config_update_retries

Maximum number of times the SNMP config update thread will attempt to obtain an exclusive lock in order to apply a given configuration update work item

staging.lifo_scan_interval

Interval between scans of the LIFO queue’s tail to check for expired items

staging.live_threads_fraction

Minimum percentage of staging threads that must remain alive to prevent a watchdog restart

transaction.default_timeout

Default transaction age in milliseconds before a long-running transaction is aborted

transaction.timeout_check_interval

Interval in milliseconds between checks for transactions that need timing out

transaction.timeout_warn_percent

Transaction age (as a percentage of transaction timeout) to warn about long-running transactions at

watchdog.check_interval

Interval in milliseconds between watchdog checks

watchdog.max_pause_margin

Maximum delay in watchdog scheduling before a warning is displayed

watchdog.no_exit

Override the default behaviour of the watchdog to disable terminating the JVM.Do not use in a production deployment. An alarm will be raised when this mode is active.

watchdog.oom_clear_count

Number of consecutive times below the limit required the clear the failed count

watchdog.oom_fail_count

Number of times above the limit required to trigger the condition

watchdog.oom_min_free

Minimum free memory or 0 to disable (deprecated: use watchdog.oom_percent_used instead, this value takes precedence)

watchdog.oom_percent_used

Maximum used memory or 0 to disable

watchdog.reverse_timewarp_margin

Maximum watchdog 'early wakeup' in milliseconds before a reverse-timewarp warning is displayed

watchdog.warn_interval

Minimum interval in milliseconds between displaying timewarp warnings

com.opencloud.savanna2.framework.GroupHeartbeat.interval

Description

Interval between sending per-group heartbeat messages

Valid values

time in milliseconds

Default value

5000

com.opencloud.savanna2.framework.GroupHeartbeat.loss_threshold

Description

Number of unreceived pending heartbeats before the group heartbeat watchdog condition triggers

Valid values

positive integer

Default value

10

eventrouter.transaction_timeout

Description

Transaction timeout for eventrouter transactions

Valid values

milliseconds

Default value

30000

logging.status.level

Description

Log level to set on the Log4j status logger

Valid values

ERROR,WARN,INFO,DEBUG,TRACE

Default value

ERROR

notifications.max_pending_notifications

Description

Maximum number of pending JMX notifications before notifications are dropped

Valid values

number of pending notifications, >= 0

Default value

500

notifications.notification_threads

Description

Number of JMX notification threads to run

Valid values

number of threads; ⇐0 implies same-thread delivery

Default value

1

rhino.ah.gcthreads

Description

Set the max number of AH GC threads

Valid values

>2

Default value

2

rhino.ah.pessimistic.maxlocktimeout

Description

Set the maximum lock timeout for local activity handler

Valid values

time in milliseconds

Default value

15000

rhino.ah.replicating.maxlocktimeout

Description

Set the maximum lock timeout for replicated activities

Valid values

time in milliseconds

Default value

15000

rhino.ah.replicating.migrationtimeout

Description

Default ah migration timeout

Valid values

time in milliseconds

Default value

60000

rhino.audit.log_format

Description

Format of CSV management audit log

Valid values

2.4 (old format) or 2.5 (includes an extra namespace field)

Default value

2.5

rhino.bootup.locktimeout

Description

Distributed lock timeout used during node bootup

Valid values

Positive integer (seconds)

Default value

120

rhino.er.ra_notifier_threads

Description

Number of resource adaptor entity notifier (callback) threads

Valid values

Positive integer

Default value

1

rhino.group_rmi.max_threads

Description

Maximum number of threads available to handle group RMI operations.

Valid values

Positive integer

Default value

10

rhino.halttimeout

Description

The timeout in milliseconds before a JVM shutdown is forcibly terminated with a Runtime.halt().

Valid values

null

Default value

60000

rhino.license.default

Description

Location of default Rhino license file

Valid values

absolute or relative file path

Default value

../rhino.license (rhino-sdk.license for Rhino SDK)

rhino.lock.lockmanager.defaultlocktimeout

Description

Set the default timeout for lock acquisitions

Valid values

time in milliseconds

Default value

60000

rhino.mbean.boot.timeout

Description

Timeout used for write operations during exceptionally long SLEE starts (during Rhino boot)

Valid values

Positive integer (seconds)

Default value

120

rhino.misc.queue_size

Description

Queue size for Distributed Resource Manager’s misc. runnable stage

Valid values

Positive integer

Default value

100

rhino.misc.thread_count

Description

Number of threads used in Distributed Resource Manager’s misc. runnable stage

Valid values

Positive integer

Default value

2

rhino.rem.enabled

Description

Enable the embedded Rhino Element Manager (SDK only).

Valid values

true,false

Default value

true

rhino.skip_lifecycle_checks

Description

Whether to skip check that prevents a resource adaptor from creating an activity in the STOPPING state.

Extended Description

This property should be set to false (the default) to enforce the restriction on creating activities in the STOPPING state.

When set to true, resource adaptors should check the state before creating an activity, to avoid a situation where a resource adaptor entity never deactivates because new activities are being created.

See the documentation reference for more details.

Valid values

true,false

Default value

false

Reference

rhino.tm.resources.queue_size

Description

Queue size for Transaction Manager’s executor for blocking resource callbacks

Valid values

Positive integer

Default value

100

rhino.tm.resources.thread_count

Description

Number of threads used in Transaction Manager’s executor for blocking resource callbacks

Valid values

Positive integer

Default value

2

rhino.tm.synchronization.queue_size

Description

Queue size for Transaction Manager’s executor for synchronization callbacks

Valid values

Positive integer

Default value

500

rhino.tm.synchronization.thread_count

Description

Number of threads used in Transaction Manager’s executor for synchronization callbacks

Valid values

Positive integer

Default value

2

rhino.verification.traceexceptions

Description

Print exception stack traces for DU verification errors

Valid values

true, false

Default value

false

sas.queue_full_interval

Description

Interval in milliseconds to wait before clearing the queue-full alarm

Valid values

positive integer

Default value

5000

savanna.receive_watchdog_interval

Description

Maximum time a Savanna receive-thread may remain busy before it is considered stuck

Valid values

time in milliseconds

Default value

5000

snmp.locktimeout

Description

Default lock acquisition timeout for SNMP config update thread

Valid values

time in milliseconds

Default value

30000

snmp.max_config_update_retries

Description

Maximum number of times the SNMP config update thread will attempt to obtain an exclusive lock in order to apply a given configuration update work item

Valid values

Positive integer

Default value

10

staging.lifo_scan_interval

Description

Interval between scans of the LIFO queue’s tail to check for expired items

Valid values

time in milliseconds

Default value

1000

staging.live_threads_fraction

Description

Minimum percentage of staging threads that must remain alive to prevent a watchdog restart

Valid values

0 - 100

Default value

25

transaction.default_timeout

Description

Default transaction age in milliseconds before a long-running transaction is aborted

Valid values

Default value

120000

transaction.timeout_check_interval

Description

Interval in milliseconds between checks for transactions that need timing out

Valid values

time in milliseconds

Default value

10000

transaction.timeout_warn_percent

Description

Transaction age (as a percentage of transaction timeout) to warn about long-running transactions at

Valid values

0 - 100

Default value

75

watchdog.check_interval

Description

Interval in milliseconds between watchdog checks

Valid values

positive integer

Default value

1000

watchdog.max_pause_margin

Description

Maximum delay in watchdog scheduling before a warning is displayed

Valid values

Default value

1000

watchdog.no_exit

Description

Override the default behaviour of the watchdog to disable terminating the JVM.Do not use in a production deployment. An alarm will be raised when this mode is active.

Valid values

true,false

Default value

false

watchdog.oom_clear_count

Description

Number of consecutive times below the limit required the clear the failed count

Valid values

Positive integer

Default value

3

watchdog.oom_fail_count

Description

Number of times above the limit required to trigger the condition

Valid values

Positive integer

Default value

5

watchdog.oom_min_free

Description

Minimum free memory or 0 to disable (deprecated: use watchdog.oom_percent_used instead, this value takes precedence)

Valid values

Positive integer (bytes)

Default value

33554432 (32MB)

watchdog.oom_percent_used

Description

Maximum used memory or 0 to disable

Valid values

Positive integer (percentage of heap)

Default value

95

watchdog.reverse_timewarp_margin

Description

Maximum watchdog 'early wakeup' in milliseconds before a reverse-timewarp warning is displayed

Valid values

Default value

500

watchdog.warn_interval

Description

Minimum interval in milliseconds between displaying timewarp warnings

Valid values

Default value

15000

Changes in Rhino 2.6

Rhino 2.6 has removed some system properties previously available for extended configuration. These include:

Property Replaced by
rhino.tracer.defaultlevel
setloglevel trace <trace_level>
Previous page Next page
Rhino Version 2.6.1