alter

Modify an existing GemFire resource.

alter disk-store

Modify certain configuration options for a specified region or remove a region from an offline disk-store. You can also use the command to reset specific configuration attributes of the disk-store to their default values. For example, you could use alter disk-store command to set the region's LRU action to overflow-to-disk.

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:
alter disk-store --name=value --region=value --disk-dirs=value(,value)*
[--lru-algorthm=value] [--lru-action=value] [--lru-limit=value] 
[--concurrency-level=value] [--initial-capacity=value] [--load-factor=value] 
[--enable-statistics=value] [--remove(=value)?]
name Required. Name of the disk-store whose contents will be altered.
region Required. Name/Path of the region in the disk store to alter.
disk-dirs Required. Directories where data for the disk store was previously written.
lru-algorthm Least recently used eviction algorithm. Valid types are: none, lru-entry-count, lru-heap-percentage, or lru-memory-size
lru-action Action to take when evicting entries from the region. Valid values are: none, overflow-to-disk and local-destroy.
lru-limit Number of entries allowed in the region before eviction will occur.
concurrency-level An estimate of the maximum number of application threads that will concurrently access a region entry at one time. This attribute does not apply to partitioned regions.
initial-capacity Together with --load-factor, sets the parameters on the underlying java.util.ConcurrentHashMap used for storing region entries.
load-factor Together with --initial-capacity, sets the parameters on the underlying java.util.ConcurrentHashMap used for storing region entries. This must be a floating point number between 0 and 1, inclusive.
enable-statistics Sets the region's statistics enabled. Valid values are true or false. Default is false.
remove Whether to remove the region from the disk-store. Default is false. If a value is not specified for this parameter, the default value of true is used.
Example Commands:
alter disk-store --name=DiskStore1 --region=region1 --disk-dirs=/Disks/DiskStore1
alter disk-store --name=DiskStore1 --region=region1 --disk-dirs=/Disks/DiskStore1 --remove

alter runtime

Alter a subset of configuration properties for specific member or members while the member or members are running.

For definitions of these configuration properties, see gemfire.properties and gfsecurity.properties (GemFire Properties).

Availability: Online. You must be connected in gfsh to a JMX Manager member to use this command.

Syntax:
alter runtime [--member=value] [--group=value] 
[--archive-disk-space-limit=value] [--archive-file-size-limit=value] 
[--log-disk-space-limit=value] [--log-file-size-limit=value] [--log-level=value] 
[--statistic-archive-file=value] [--statistic-sample-rate=value] 
[--enable-statistics=value]
member Required if --group is not specified. Name/Id of the member whose configuration is to be altered at runtime.
group Required if --member is not specified. Name of the group whose member's runtime configuration is to be altered.
archive-disk-space-limit Archive disk space limit. Valid values are (in megabytes): 0 - 1000000.
archive-file-size-limit Archive file size limit. Valid values are (in megabytes): 0 - 1000000.
log-disk-space-limit Log disk space limit. Valid values are (in megabytes): 0 - 1000000.
log-file-size-limit Log file size limit. Valid values are (in megabytes): 0 - 1000000.
log-level Log level. Valid values are: none, error, info, config, fine, finer and finest.
statistic-archive-file File to which the statistics will be written.
statistic-sample-rate Statistic sampling rate. Valid values are (in milliseconds): 100 - 60000.
enable-statistics Whether statistic sampling should be enabled. Valid values are: true and false.
Example Commands:
alter runtime --member=server1 --log-level=finest --enable-statistics=true
Sample Output:
gfsh>alter runtime --member=server1 --log-level=finest --enable-statistics=true
Runtime configuration altered successfully for the following member(s)
192.168.129.129(server1:240)<v1>:64871