LATEST VERSION: 8.2.6 - CHANGELOG
Pivotal GemFire® v8.2

Interactive Configuration Reference for the tc Server Module

Interactive Configuration Reference for the tc Server Module

This section describes each prompt when entering into interactive configuration mode of the GemFire HTTP Session Management Module for tc Server.

See Changing the Default GemFire Configuration in the tc Server Module for specific pointers on how to use the interactive mode for common configuration changes.

  Please enter a value for 'gemfire.maximum.vm.heap.size.mb'. Default '512':
  Please enter a value for 'gemfire.initial.vm.heap.size.mb'. Default '512':
  Please enter a value for 'gemfire.cms.initiating.heap.percentage'. Default '50':
The above properties allow you to fine-tune your JVM heap and garbage collector. For more information, refer to Heap Use and Management.
  Please specify whether to enable a GemFire listener that logs session create, 
  update, destroy and expiration events. Default 'false':

The above property determines whether a debug cache listener is added to the session region. When true, info-level messages are logged to the GemFire log when sessions are created, updated, invalidated, or expired.

With the gemfire-p2p template:
  Please specify whether to maintain a local GemFire cache. Default 'false':
  
With the gemfire-cs template:
  Please specify whether to maintain a local GemFire cache. Default 'true':

The above property determines whether a local cache is enabled; if this parameter is set to true, the app server load balancer should be configured for sticky session mode.

With the gemfire-p2p template:
  Please enter the id of the attributes of the GemFire region used to cache 
      sessions.
  Default 'REPLICATE':

With the gemfire-cs template:
  Please enter the id of the attributes of the GemFire region used to cache 
      sessions.
  Default 'PARTITION_REDUNDANT':

The above property determines the ID of the attributes for the cache region; possible values include PARTITION, PARTITION_REDUNDANT, PARTITION_PERSISTENT, REPLICATE, REPLICATE_PERSISTENT, and any other region shortcut that can be found in Region Shortcuts and Custom Named Region Attributes. When using a partitioned region attribute, it is recommended that you use PARTITION_REDUNDANT (rather than PARTITION) to ensure that the failure of a server does not result in lost session data.

  Please enter the name of the GemFire region used to cache sessions. 
  Default 'gemfire_modules_sessions':

The above property determines the GemFire region name.

  Please enter the port that Tomcat Shutdown should listen on. Default '-1':
  Please enter the port that the JMX socket listener should listen on. 
      Default '6969':

The above properties are application server properties.

  Please enter a value for 'bio.http.port'. Default '8080':
  Please enter a value for 'bio.https.port'. Default '8443':

tc Server requires information about connector ports. bio.http.port is the http port for tc Server and bio.https.port is the secure http port for tc Server.

With the gemfire-p2p template:
  Please enter the name of the GemFire cache configuration file. 
  Default 'cache-peer.xml':
  
With the gemfire-cs template:
  Please enter the name of the GemFire cache configuration file. 
  Default 'cache-client.xml':

You can change the name of the cache configuration file with the above property. If you do change this value, be sure to include an xml file by that name in the conf subdirectory.

  Please enter the percentage of heap at which updates to the cache are refused.
  0.0 means disabled. Default '0.0':
  Please enter the percentage of heap at which sessions will be evicted from the 
  local cache. Default '80.0':

The above properties allow you to control the critical and eviction watermarks for the heap. By default, the critical watermark is disabled (set to 0.0) and the eviction watermark is set to 80%.

Applicable to the gemfire-p2p template ONLY:
  Please enter the list of locators used by GemFire members to discover each other. 
  The format is a comma-separated list of host[port]. Default ' ':

The above property specifies the list of locators. For more information on locators, refer to Peer-to-peer Configuration Using Locators.

  Please enter the name of the file used to log GemFire messages. 
  Default 'gemfire_modules.log':

The above property determines the filename for the GemFire log file.

Applicable to the gemfire-p2p template ONLY:
  Please enter the port used by GemFire members to discover each other using 
  multicast networking. Default '10334': 

The above property specifies the port used for multicast discovery. When using locators, this value should be 0. For more information on multicast discovery, refer to Using a Different Multicast Port.

Applicable to the gemfire-p2p template ONLY:
  Please specify whether to rebalance the GemFire cache at startup.
  Default 'false':

This property allows you to rebalance a partitioned GemFire cache when a new GemFire peer starts up.

  Please enter the name of the file used to store GemFire statistics. 
  Default 'gemfire_modules.gfs':

The above property determines the filename for the GemFire statistics file.

  Please specify whether GemFire statistic sampling should be enabled. 
  Default 'false':

The above property determines whether statistics sampling should occur. See Statistics for more information.