alter

Modify an existing Geode resource.

• alter disk-store

  Modify or remove a region from an offline disk-store.

• alter region

  Alters the configuration of a region.

• alter runtime

  Alters configuration properties for all members or a subset of members while the member or members are running.

alter disk-store

Modify or remove a region from an offline disk-store.

When modifying a region's configuration, it is customary to take the region off-line and restart using the new configuration. You can use the alter disk-store command to change the configuration of the region stored in the disk-store to match the configuration you will use at restart.

Availability: Offline.

Syntax:

alter disk-store --name=value --region=value --disk-dirs=value(,value)*
    [--compressor(=value)] [--concurrency-level=value]
    [--enable-statistics=value] [--initial-capacity=value] [--load-factor=value]
    [--lru-algorithm=value] [--lru-action=value] [--lru-limit=value]
    [--off-heap(=value)] [--remove(=value)]

The three required options, --name, --region, and --disk-dirs, identify the disk store and region to be altered. If no additional options are specified, gfsh displays the current configuration without making any changes.

Example Commands:

alter disk-store --name=DiskStore1 --region=region1 --disk-dirs=/Disks/DiskStore1 --off-heap
alter disk-store --name=DiskStore1 --region=region1 --disk-dirs=/Disks/DiskStore1 --remove

alter region

Alters the configuration of a region.

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

Syntax:

alter region --name=value [--group=value(,value)*]
    [--entry-idle-time-expiration(=value)?]
    [--entry-idle-time-expiration-action(=value)?]
    [--entry-time-to-live-expiration(=value)?]
    [--entry-time-to-live-expiration-action(=value)?]
    [--region-idle-time-expiration(=value)?]
    [--region-idle-time-expiration-action(=value)?]
    [--region-time-to-live-expiration(=value)?]
    [--region-time-to-live-expiration-action(=value)?]
    [--cache-listener=value(,value)*] [--cache-loader(=value)?]
    [--cache-writer(=value)?] [--async-event-queue-id=value(,value)*]
    [--gateway-sender-id=value(,value)*] [--enable-cloning(=value)?]
    [--eviction-max(=value)?]

Table 1. Alter Region Parameters

Example Commands:

alter region --name=region1 --eviction-max=5000 [-group=all]

Sample Output:

gfsh>alter region --name=customer --eviction-max=5000
Member  | Status
server1 | Region "/customer" altered on "server1"

alter runtime

Alters configuration properties for all members or a subset of members while the member or members are running.

For more information on these configuration properties, see cache.xml and configuration parameter reference.

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] [--copy-on-read(=value)?] [--lock-lease=value]
    [--lock-timeout=value] [--message-sync-interval=value] [--search-timeout=value]

Table 2. Alter Runtime Parameters

Example Commands:

alter runtime --member=server1 --loglevel=WARN --enable-statistics=true

Sample Output:

gfsh>alter runtime --member=server1 --loglevel=WARN --enable-statistics=true
Runtime configuration altered successfully for the following member(s)
192.0.2.0(server1:240)<v1>:64871