Grid Properties
Properties whose names are grayed out on the screen are ones that apply globally only. You cannot override them in another context.
Property | Type | Description | Default value |
---|---|---|---|
Node Memory | |||
Max Heap | integer, MB | Sets the maximum heap space for the JVM. | 256 MB |
Throttling Memory Threshold | integer, percent | Threshold, expressed as percentage of maximum heap, for when to start throttling the node (putting the node in an off-line state). | The default is 85% of max heap. |
Throttling GC Frequency | integer, seconds | When throttling, how often a garbage collect should be performed. | 5 seconds |
Node Logging | |||
Node Log Level | list | The logging level of the node: ALL, ERROR, WARN, INFO, NOTE, DEBUG, TRACE | ERROR, WARN, INFO, NOTE |
Node Log Detail Level | list |
The logging level of a particular logger, the format
is [logger-name]=[levels] , for example, Node=INFO,DEBUG .
|
|
Add System Thread Names | Boolean | Whether or not to add thread names to system log entries, the default is false. | False |
Add Application Thread Names | Boolean | Whether or not to add thread names to application log entries, the default is false. | False |
Node Log Capture Standard Out | boolean | Whether or not to capture stdout in the log file. | true |
Node Log Capture Standard Err | boolean | Whether or not to capture stderr in the log file. | true |
Node Log Max File Size | integer | The maximum size of a log file. | 5 MB |
Logging Time Zone | enumeration | Determines whether to use the local or UTC time zone for logging. Overrides the Server Time Zone property. | undefined |
Node Profiling and Monitoring | |||
Profiler | enumeration | Turns the profiler on or off. | off |
Node JMX Enabled | boolean | Setting to enable or disable a node's JMX server. | true |
Counters Poll Delay | integer, seconds | How many seconds to wait between polling counters. | 15 seconds |
Counters Keep History | integer, minutes | How many minutes of counter history to retain. | 60 minutes |
CPU Sampling | enumeration | Enables or disables CPU sampling. | The default is on (if the JVM supports it). |
CPU Sampling Frequency | integer, seconds | How often to sample CPU usage. | 5 seconds |
Thread Priority Capping | boolean | Enables or disables thread priority capping; that is, threads with consistently high CPU usage will automatically get their priority lowered temporarily. Note that CPU Sampling must be enabled in order for priority capping to work. | The default is on. |
Thread Priority Capping Threshold | integer, percent | Threshold for thread priority capping based on CPU percentage. | 85% |
Node Properties | |||
Node Weight | integer | Node weights are used as a load balancing mechanism. Each Node has a weight (>= 0). | 100 |
Node Startup Failure Shutdown Grace Period | integer, seconds | How many seconds to wait before automatically shutting down a node when the hosted application failed to load or start. If the node hosts several application modules, it will only shut itself down if all modules fail to start. | 60 seconds |
Java Executable | path | The path to a Java executable. | The default is the one used to start the grid agent. |
Working Directory | path | The path to use as working directory for a node. Use a forward slash (/) as the directory separator. | |
Library Path | path list | Adds the specified paths to the library path of the JVM. Use a forward slash (/) as the directory separator. | |
Generic JVM Commands | list | A list of generic JVM command line switches. | |
Debug Port | integer, port number | Adds JVM arguments to start the node in debug mode (not suspended). | The argument is the port where you attach your debugger. |
Default Session Timeout for Ephemeral Sessions | integer, minutes | Sets the default timeout for ephemeral session, that is, sessions logged on as a result of an HTTP request without grid session header(s). | |
Stream Buffer Size | integer, KB | The buffer size for transporting stream data. A higher value will potentially increase throughput speed, but have a larger memory footprint. | 64 KB |
Http Idle Timeout | integer, seconds |
The timeout used for closing idle HTTP connections automatically. Set to 0 to disable timeout completely. This property is only valid in a router context. |
3600 seconds |
Path Element (sub context root) routing key | string | Configures which path element (sub context root) gets routed to "this" node. | blank |
Grid Database Library | string | Grid installation database library on IBM i. | blank |
Node Subsystem | string | Used by Java executable script (grid.jvm.executable) to control where to submit JVMs (nodes) on IBM i. | blank |
Server Time Zone | enumeration | Determines whether to use the local or UTC time zone for running nodes. | undefined |
Connection Pool Max Idle Time | integer, seconds | The timeout used for closing idle connections to the grid configuration database automatically. The default is to never close idle connections (value set to 0). | 0 |
Launch Timeout | integer, seconds | The timeout to wait for node start before declaring the start as failed (default is 120 seconds). | The default is 120 seconds. |
Log Archiving | |||
Days of Week | enumeration set | The selected days the log archiver will run. | undefined |
Time of Day | integer, hour | The time (hour) the log archiver will run during your selected days. | undefined |
Max Archive Age | integer, days | The maximum number of days an archive will persist in the database. | undefined |
Max Archive Size | integer, MB | The maximum total size of all archives that will persist in the database before starting to remove the oldest. | undefined |
Grid Monitoring | |||
Unresponsive Node Monitoring Retry Count | integer | The number of times an unresponsive node will get a second chance to respond before being blacklisted (and hence disconnected from the grid) by the registry. The default is 0. That is, it will be blacklisted after 60+ seconds. Each retry count adds another 60 seconds to let the unresponsive node respond before being blacklisted. | The default is 0 (60 seconds). |
Unresponsive Node Monitoring Process Termination | boolean | Uncheck to prevent the grid from attempting to forcefully terminate an unresponsive node. | Default is true (unresponsive node will be terminated). |
Grid Shutdown | |||
Grid Shutdown Wait Timeout | integer, seconds | How long to wait for the grid or a grid host to shutdown before forcefully stopping processes. | The default is 60 seconds. |
Module Thread Pool | |||
Thread Pool Max Queued | integer | Sets the maximum number of queued proxy request threads. | The default is 0 (unlimited). |
Thread Pool Max Concurrent | integer | Sets the maximum number of concurrently executing proxy request threads. | The default is 0 (unlimited). |
Thread Pool Max Pooled | integer | Sets the maximum number of pooled proxy request threads. | The default is 0 (unlimited). |
Thread Pool Min Pooled | integer | Sets the minimum number of pooled proxy request threads. | The default is 5 (although the minimum number of pooled threads can actually be lower if the number of concurrently executing threads never exceeds the minimum). |
Thread Pool Warn Delay | integer, seconds | The number of seconds to wait for a proxy request to finish before the system puts a warning in the log. | The default is 0 (off). |
Module Web Service | |||
Web service Chunked Transfer Encoding | boolean | If set to true, chunked transfer encoding will be used for web service responses. This will override the auto buffer setting (Web Service Auto Buffer Size) meaning auto buffering will not be used when chunking is set to true. | The default is true. |
Web Service Auto Buffer Size | integer | When set to a value higher than zero (0), web service responses will be buffered up until the specified size (KB) in an attempt to determine the content length. When successful, the content length will be sent, otherwise connection close will be used. This feature is disabled when chunking (Web service chunked transfer encoding) is used. | The default value is 16 KB |
Misc. Module Properties | |||
Class Path | path list | Sets the specified paths as the class path for the module. Use a forward slash (/) as the directory separator. | |
Stop Timeout | integer, seconds | When stopping a module, how many seconds to wait for the module to stop by itself before forcefully shutting it down. | The default is 60 seconds. |
Add slf4j to module classpath | boolean | By default, slf4j-api and slf4j-gird are added to the classpath for all Grid applications. If you absolutely need your own slf4j based logging, disable this by setting this boolean to false. Do not modify this setting unless asked to do so by Infor. | true |
Skip Local Proxy Call Serialization | boolean | If set to true, no serialization/deserialization will be performed on module local proxy calls, that is, the method parameters are used exactly as if it was a standard method invocation. Do not modify this setting unless asked to do so by Infor. | false |
Security Properties | |||
Default Session Provider | string | Sets the name of the preferred session provider, if any, to use when requesting a provider using the SessionUtils getProvider(int type) method. | |
Default Session Timeout | minutes, integer | Sets the default timeout for sessions. | |
Use ephemeral sessions | boolean | Grid sessions established as a consequence of authenticated http requests will only be valid for that request and logged out immediately when the request is finished. | false |
Default Logon Service | string | Sets the name of the default logon service used when using session providers from this module. | |
Trusted Routers Http Entrypoints | map to string | Trusted routers HTTP entry point mappings. | |
Role mapping proxy timeout | integer, seconds | Set the timeout value to be used when the session provider looks up roles and/or groups from external credential stores. | 180 |
Grid HTTP Configuration | |||
Context root discovery urls | map to string list | Configures how context roots are presented when discovered through the grid info http service. | |
Grid Internal Properties | |||
grid.internal.jsm | boolean | Internal option. Only set to false if instructed by Infor. | true |
grid.internal.jna | boolean | Internal option. Sets whether to use native access functions. Only set to false if instructed by Infor. | true |
grid.internal.dup | boolean | Internal option. Sets whether to disable property updates on an entity. Only set to true if instructed by Infor. | false |
grid.internal.diepar | boolean | Internal option. Sets whether to disable IE pre-auth request interception. Only set to true if instructed by Infor. | false |
grid.internal.rme | boolean | Internal option. Sets whether to use role mapping resolution. Only set to false if instructed by Infor. | true |
grid.internal.wdm | boolean | Internal option. Enables web ui tracing for developer purposes. Only set to true if instructed by Infor. | false |
grid.internal.dnm | boolean | Internal option. Sets whether to disable the network monitor. Only set to true if instructed by Infor | false |
java.net.preferIPv4Stack | boolean | Maps to the Java system property java.net.preferIPv4Stack if true. | true |
java.net.preferIPv6Addresses | boolean | Maps to the Java system property java.net.preferIPv6Addresses if true. | false |
File Access Local Overrides | |||
Local File Access Override | map to string | Map a known share name to a local absolute path name. | undefined |