Red Hat SummitA.2. TCP Default and Recommended Values
To learn more about JGroups and using TCP and UDP, see Section 26.2, “Configure JGroups (Library Mode)”.
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| bind_addr | Any non-loopback | Set address on specific interface |
| bind_port | Any free port | Set specific port |
| loopback | true | Same as default |
| port_range | 50 | Set based on desired range of ports |
| recv_buf_size | 150,000 | Same as default |
| send_buf_size | 150,000 | 640,000 |
| use_send_queues | true | Same as default |
| sock_conn_timeout | 2,000 | 300 |
| max_bundle_size | 64,000 | 64,000 |
| enable_diagnostics | true | false |
| thread_pool.enabled | true | Same as default |
| thread_pool.min_threads | 2 | This should equal the number of nodes |
| thread_pool.max_threads | 30 | This should be higher than thread_pool.min_threads. For example, for a smaller grid (2-10 nodes), set this value to twice the number of nodes, but for a larger grid (20 or more nodes), the ratio should be lower. As an example, if a grid contains 20 nodes, set this value to 25 and if the grid contains 100 nodes, set the value to 110. |
| thread_pool.keep_alive_time | 30,000 | 60,000 |
| thread_pool.queue_enabled | true | false |
| thread_pool.queue_max_size | 500 | None, queue should be disabled |
| thread_pool.rejection_policy | Discard | Same as default |
| internal_thread_pool.enabled | true | Same as default |
| internal_thread_pool.min_threads | 2 | 5 |
| internal_thread_pool.max_threads | 4 | 20 |
| internal_thread_pool.keep_alive_time | 30,000 | 60,000 |
| internal_thread_pool.queue_enabled | true | false |
| internal_thread_pool.rejection_policy | Discard | Abort |
| oob_thread_pool.enabled | true | Same as default |
| oob_thread_pool.min_threads | 2 | 20 or higher |
| oob_thread_pool.max_threads | 10 | 200 or higher, depending on the load |
| oob_thread_pool.keep_alive_time | 30,000 | 60,000 |
| oob_thread_pool.queue_enabled | true | false |
| oob_thread_pool.queue_max_size | 500 | None, queue should be disabled |
| oob_thread_pool.rejection_policy | Discard | Same as default |
Note
Red Hat JBoss Data Grid 6.4 uses JGroups 3.6.1, in which the TCPPING timeout value is removed and the
pbcast.GMS join_timeout value indicates the timeout period instead.
Recommended Values for S3_PING
See Section 27.2, “S3_PING Configuration Options” for details about configuring S3_PING for JBoss Data Grid.
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| bind_addr | Any non-loopback | Set address on specific interface |
| break_on_coord_rsp | true | Same as default |
| mcast_addr | 230.5.6.7 | Same as default |
| mcast_port | 7555 | Same as default |
| ip_ttl | 8 | 2 |
Note
In JGroups 3.6.1, the MPING timeout value is removed and the
pbcast.GMS join_timeout value indicates the timeout period instead.
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| min_interval | 1,000 | 10,000 |
| max_interval | 10,000 | 30,000 |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| client_bind_por | 0 (randomly selects a port and uses it) | Same as default |
| get_cache_timeout | 1000 milliseconds | Same as default |
| keep_alive | true | Same as default |
| num_tries | 3 | Same as default |
| start_port | 0 (randomly selects a port and uses it) | Same as default |
| suspect_msg_interval | 5000 milliseconds. | Same as default |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| timeout | 40,000 | 60,000. The FD_ALL timeout value is set to two times the longest possible stop the world garbage collection pause in the CMS garbage collector. In a well-tuned JVM, the longest pause is proportional to heap size and should not exceed 1 second per GB of heap. For example, an 8GB heap should not have a pause longer than 8 seconds, so the FD_ALL timeout value must be set to 16 seconds. If longer garbage collection pauses are used, then this timeout value should be increased to avoid false failure detection on a node. |
| interval | 8,000 | 15,000. The FD_ALL interval value must be at least four times smaller than the value set for FD_ALL's timeout value. |
| timeout_check_interval | 2,000 | 5,000 |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| check_timeout | 3,000 | 5,000 |
| cmd | InetAddress.isReachable() (ICMP ping) | - |
| interval | 20,000 | 15,000. The interval value for FD_HOST must be four times smaller than FD_HOST's timeout value. |
| timeout | 60,000 | 60,000. |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| timeout | 2,000 | 5,000 |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| use_mcast_xmit | true | false |
| xmit_interval | 1,000 | Same as default |
| xmit_table_num_rows | 50 | 50 |
| xmit_table_msgs_per_row | 10,000 | 1,024 |
| xmit_table_max_compaction_time | 10,000 | 30,000 |
| max_msg_batch_size | 100 | Same as default |
| resend_last_seqno | false | true |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| xmit_interval | 500 | Same as default |
| xmit_table_num_rows | 100 | 50 |
| xmit_table_msgs_per_row | 1,0000 | 1,024 |
| xmit_table_max_compaction_time | 600,000 | 30,000 |
| max_msg_batch_size | 500 | 100 |
| conn_close_timeout | 60,000 | No recommended value. |
| conn_expiry_timeout | 120,000 | 0 |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| stability_delay | 6,000 | 500 |
| desired_avg_gossip | 20,000 | 5,000 |
| max_bytes | 2,000,000 | 1,000,000 |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| print_local_addr | true | false |
| join_timeout | 5,000 | 15,000 |
| view_bundling | true | Same as default |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| max_credits | 500,000 | 2,000,000 |
| min_threshold | 0.40 | Same as default |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| frag_size | 60,000 | Same as default |
| Parameter | Default Value (from JGroups) | Recommended Value (for JBoss Data Grid) |
|---|---|---|
| asymAlgorithm | RSA | - |
| asymInit | 512 | - |
| asymProvider | Bouncy Castle Provider | - |
| changeKeysOnViewChange | false | - |
| symAlgorithm | AES | - |
| symInit | 128 | - |
| symProvider | Bouncy Castle Provider | - |
Note
See the Red Hat JBoss Data Grid Developer Guide's JGroups ENCRYPT section for details.
Recommended Values for SASL
See the Red Hat JBoss Data Grid Developer Guide's User Authentication over Hot Rod Using SASL section for details.
Recommended Values for RELAY2
See Chapter 30, Set Up Cross-Datacenter Replication for details.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}