MarkLogic 9 Product Documentation

Group Configuration Help

A Group is a set of similarly configured hosts within a cluster.

• group name specifies the name of the group.
• list cache size specifies the amount of memory to dedicate to caching termlist data for all on-disk stands.
• list cache partitions specifies the number of independent list cache partitions to allocate. More partitions allow more concurrency, but make each individual cache partition smaller, which could make it more likely for the cache to fill up. The default is determined based on the amount of memory on your system and on the number of cores (the number of CPUs times the number of cores per CPU) in the system, and should work well for most installations. If you see a lot of CPU under-utilization under heavy concurrent query loads, then raising this value can improve performance.
• compressed tree cache size specifies the amount of memory to dedicate to caching tree data in compressed form for all on-disk stands.
• compressed tree cache partitions specifies the number of independent compressed tree cache partitions to allocate. More partitions allow more concurrency, but make each individual cache partition smaller, which could make it more likely for the cache to fill up. The default is determined based on the amount of memory on your system and on the number of cores (the number of CPUs times the number of cores per CPU) in the system, and should work well for most installations. If you see a lot of CPU under-utilization under heavy concurrent query loads, then raising this value can improve performance.
• compressed tree read size specifies the size of the block for random access when reading compressed tree files.
• expanded tree cache size specifies the amount of memory to dedicate to caching tree data in expanded form for the query evaluator.
• expanded tree cache partitions specifies the number of independent expanded tree cache partitions to allocate. More partitions allow more concurrency, but make each individual cache partition smaller, which could make it more likely for the cache to fill up. The default is determined based on the amount of memory on your system and on the number of cores (the number of CPUs times the number of cores per CPU) in the system, and should work well for most installations. If you see a lot of CPU under-utilization under heavy concurrent query loads, then raising this value can improve performance.
• triple cache size specifies the amount of memory to dedicate to caching triple data for all on-disk stands.
• triple cache partitions specifies the number of independent triple cache partitions to allocate. More partitions allow more concurrency, but make each individual cache partition smaller, which could make it more likely for the cache to fill up. The default is determined based on the amount of memory on your system and on the number of cores (the number of CPUs times the number of cores per CPU) in the system, and should work well for most installations. If you see a lot of CPU under-utilization under heavy concurrent query loads, then raising this value can improve performance.
• triple cache timeout specifies the time, in seconds, that a cached triple index page can be unused before being eligable to be flushed from the cache. Larger values can potentially cause more memory to be used for by the triple cache. Smaller values can potentially cause more time to be used reloading triple index pages.
• triple value cache size specifies the amount of memory to dedicate to caching triple value data for all on-disk stands.
• triple value cache partitions specifies the number of independent triple value cache partitions to allocate. More partitions allow more concurrency, but make each individual cache partition smaller, which could make it more likely for the cache to fill up. The default is determined based on the amount of memory on your system and on the number of cores (the number of CPUs times the number of cores per CPU) in the system, and should work well for most installations. If you see a lot of CPU under-utilization under heavy concurrent query loads, then raising this value can improve performance.
• triple value cache timeout specifies the time, in seconds, that a cached triple value index page can be unused before being eligable to be flushed from the cache. Larger values can potentially cause more memory to be used for by the triple value cache. Smaller values can potentially cause more time to be used reloading triple value index pages.
• smtp relay specifies the hostname of the SMTP server. This server is used for all SMTP requests issued through the xdmp:email built-in function.
• smtp timeout specifies the time, in seconds, before an SMTP request times out and issues an error.
• http user agent specifies the User-agent string issued when making HTTP requests from an App Server in the group.
• http timeout specifies the time, in seconds, before an HTTP request times out.
• xdqp timeout specifies the time, in seconds, before a request between a MarkLogic Server evaluator node (the node from which the query is issued) and a MarkLogic Server data node (the node from which the forest data is retrieved) times out.
• host timeout specifies the time, in seconds, before a MarkLogic Server host-to-host request times out. The host-to-host requests are used for communication between nodes in a MarkLogic Server cluster.
• host initial timeout specifies the time, in seconds, that an instance of MarkLogic Server will wait for another node to come online when the cluster first starts up before deciding that the node is down, and initiating failover for any forests that are assigned to that offline host.
• retry timeout specifies the time, in seconds, before a MarkLogic Server stops retrying a request.
• module cache timeout specifies the time, in seconds, that a cached module can be unused before being flushed from the cache. Larger values can potentially cause more memory to be used for cached modules. Smaller values can potentially cause more time to be used reloading uncached modules.
• system log level specifies the minimum log level for log messages sent to the operating system logging facility.
• file log level specifies the minimum log level for log messages sent to the MarkLogic Server log file (ErrorLog.txt).
• rotate log files specifies the when new log files are opened and old log files rotated.
• keep log files specifies the number of log files to keep on rotation.
• If you have the failover option enabled, setting failover-enable to true enables failover for the hosts in the group. To use failover, you must also enable failover for individual forests. If you set this to false, failover is disabled for all the hosts in the group, regardless of their forest configurations.
• xdqp-ssl-enabled specifies whether SSL is enabled for XDQP.
• xdqp-ssl-allow-sslv3 specifies whether the SSL v3 protocol is allowed for XDQP.
• xdqp-ssl-allow-tls specifies whether the Transport Layer Security protocol is allowed for XDQP.
• xdqp-ssl ciphers specifies the SSL ciphers that may be used.
• background I/O limit specifies the maximum megabytes per second that a host may use for background I/O (merge, backup, restore). A value of 0 means no limit.
• metering enabled specifies if usage metering is enabled for this group. When usage metering is enabled, a small amount of statistics about resources being used is saved to the meters database.
• performance metering enabled specifies if performance metering is enabled for this group. When enabled, performance statistics are stored in the Meters database to enable historic views of cluster performance.
• metering database specifies the name of the database in which usage metering and historic performance data will be stored.
• performance metering period specifies the performance metering period in seconds.
• metering retain raw specifies the number of days raw performance metering data is retained.
• metering retain hourly specifies the number of days hourly performance metering data is retained.
• metering retain daily specifies the number of days daily performance metering data is retained.
• s3 domain specifies the internet domain name of the simple storage service. The default value is "s3.amazonaws.com". To access a different simple storage service that is API compatible with Amazon S3, specify it here.
• s3 protocol specifies the network protocol to use when accessing the simple storage service. The default is "http". To use a more secure protocol when accessing the simple storage service, choose "https".
• s3 server side encryption specifies the method of data encryption for data at rest on the simple storage storage service. The default is "none". To encrypt data at rest on the simple storage service, choose "aes256".
• security database specifies the security database where global security data are kept for hosts in the group. This database is where Amazon Web Services access keys and secret keys are kept for use with the simple storage service.

---

Buttons and Tabs:

• Clicking the delete button on the group configuration page deletes the current group from the cluster.
• The Status tab for each group displays current information on hosts, App Servers, and forests in the group.
• Use the Create tab to create a new group.