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

Name Description

cassandra.driver_exception_warn_log_cool_down

Cool down to log Cassandra driver exceptions encountered by Rhino at the WARN log level.

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.config.yaml_code_point_limit

Set the maximum number of code points supported in a declarative YAML bundle for importing

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.lenient_config_property_validation

Relax resource adaptor entity config property validation.

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.monitoring.clocksync.check_interval

Interval in milliseconds between cluster node clock sync checks

rhino.monitoring.clocksync.max_fail_count

Number of times a clock sync check must fail for a node before an alarm is raised

rhino.monitoring.clocksync.threshold

Threshold in milliseconds over which a cluster node will be reported as being out of clock synchronisation

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.slee_restricted_lifecycle

Restrict SLEE lifecycle changes depending on current node actual states.

rhino.state.convergence.interval_seconds

Interval between state convergence checks

rhino.state.convergence.retry_interval_millis

Interval between state convergence task retries

rhino.state.convergence.timeout_seconds

Time before a convergence task is considered to have timed out

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.filename.max-length

The maximum allowed filename length, used when generating MIBs during a MIB export

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

snmp.name.max-length

The maximum number of characters allowed in object identifiers included in generated MIBs

snmp.name.uppercase

Determines if MIB identifiers and filenames will be forced to uppercase, used when generating MIBs during a MIB export

snmp.suppress_service_oid_conflict_alarms

Suppress the raising of alarms for duplicate parameter set type OID mappings when multiple services use the same base OID

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.gc.duration_threshold

The threshold for garbage collection pause time duration to flag an adverse GC event

watchdog.gc.enabled

Whether to enable the GC watchdog

watchdog.gc.no_exit

Specifies whether the GC watchdog should raise an alarm instead of triggering a node shutdown/restart.

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.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

cassandra.driver_exception_warn_log_cool_down

Description

Cool down to log Cassandra driver exceptions encountered by Rhino at the WARN log level.

Valid values

positive integer

Default value

10000

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.config.yaml_code_point_limit

Description

Set the maximum number of code points supported in a declarative YAML bundle for importing

Valid values

positive integers

Default value

10485760

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.lenient_config_property_validation

Description

Relax resource adaptor entity config property validation.

Extended Description

When set to false (the default), Rhino will reject an attempt to create a resource adaptor entity or update the config properties of an existing resource adaptor entity if the config properties provided by the client contains unrecognised config property names, ie. names not defined by the resource adaptor or any known vendor-specific properties.

If this system property is set to true, this validation check is skipped and any config property name will be accepted.

Valid values

true,false

Default value

false

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

3

rhino.monitoring.clocksync.check_interval

Description

Interval in milliseconds between cluster node clock sync checks

Valid values

time in milliseconds

Default value

10000

rhino.monitoring.clocksync.max_fail_count

Description

Number of times a clock sync check must fail for a node before an alarm is raised

Valid values

Positive integer

Default value

5

rhino.monitoring.clocksync.threshold

Description

Threshold in milliseconds over which a cluster node will be reported as being out of clock synchronisation

Valid values

time in milliseconds

Default value

2000

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.slee_restricted_lifecycle

Description

Restrict SLEE lifecycle changes depending on current node actual states.

Extended Description

Normally the start and stop SLEE lifecycle operations only consider the current node desired state(s) when determining if the operation is valid. When this property is set to true, Rhino will revert to legacy behaviour and also consider current node actual state(s) as well. The legacy behaviour, for example, doesn’t allow a node to be started if it is currently in the STOPPING state.

Valid values

true,false

Default value

false

rhino.state.convergence.interval_seconds

Description

Interval between state convergence checks

Valid values

an integer specifying the delay from the end of one scheduled convergence check to the start of the next

Default value

30

rhino.state.convergence.retry_interval_millis

Description

Interval between state convergence task retries

Valid values

an integer specifying the delay from the completion of a batch of state convergence operations after which to retry ones that did not meet the required preconditions

Default value

1000

rhino.state.convergence.timeout_seconds

Description

Time before a convergence task is considered to have timed out

Valid values

An integer specifying the interval in seconds from the creation of a convergence task to when it can be considered to have timed out and an alarm raised

Default value

300

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.filename.max-length

Description

The maximum allowed filename length, used when generating MIBs during a MIB export

Valid values

Any positive integer. Any value less than or equal to zero will disable the length limit.

Default value

255

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

snmp.name.max-length

Description

The maximum number of characters allowed in object identifiers included in generated MIBs

Valid values

Any positive integer. Any value less than or equal to zero will disable the length limit.

Default value

127

snmp.name.uppercase

Description

Determines if MIB identifiers and filenames will be forced to uppercase, used when generating MIBs during a MIB export

Valid values

true, false

Default value

false

snmp.suppress_service_oid_conflict_alarms

Description

Suppress the raising of alarms for duplicate parameter set type OID mappings when multiple services use the same base OID

Valid values

true,false

Default value

false

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

180000

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.gc.duration_threshold

Description

The threshold for garbage collection pause time duration to flag an adverse GC event

Valid values

Any positive long

Default value

7000

watchdog.gc.enabled

Description

Whether to enable the GC watchdog

Valid values

true, false

Default value

false

watchdog.gc.no_exit

Description

Specifies whether the GC watchdog should raise an alarm instead of triggering a node shutdown/restart.

Valid values

true, false

Default value

true

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.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 3.2