---
title: stop
---

<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<a id="topic_45125131A45F4713BBC63E7225AAD91B"></a>


Stop gateway receivers, gateway senders, locators and servers.

-   **[stop gateway-receiver](#topic_CD1D526FD6F84A7B80B25C741129ED30)**

    Stop the gateway receiver on a member or members.

-   **[stop gateway-sender](#topic_0BBDD4B3B8A44A65A610F766C9E85519)**

    Stop a gateway sender with a given id on a specified member or members of a specified member group.

-   **[stop locator](#topic_EF61C54B35BA4AB7B14E58CF911F283E)**

    Stop a locator.

-   **[stop server](#topic_723EE395A63A40D6819618AFC2902115)**

    Stop a <%=vars.product_name%> cache server.

## <a id="topic_CD1D526FD6F84A7B80B25C741129ED30" class="no-quick-link"></a>stop gateway-receiver

Stop the gateway receiver on a member or members.

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

**Syntax:**

``` pre
stop gateway-receiver [--groups=value(,value)*] [--members=value(,value)*]
```

<a id="topic_CD1D526FD6F84A7B80B25C741129ED30__table_knl_r5g_2w"></a>

| Name                                            | Description                                                                                                       |
|-------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| <span class="keyword parmname">\\-\\-groups</span>  | Group(s) of members on which to stop the Gateway Receiver. Use a comma-separated list for multiple member groups. |
| <span class="keyword parmname">&#8209;&#8209;members </span> | Name/Id of the member(s) on which to stop the Gateway Receiver.                                                      |

<span class="tablecap">Table 1. Stop Gateway-Receiver Parameters</span>

**Example Commands:**

``` pre
stop gateway-receiver --members=receiver1-LN 
stop gateway-receiver --groups=LN-Group1
```

**Sample Output:**

``` pre
gfsh>stop gateway-receiver
      Member                | Result | Message
--------------------------- | -------| -----------------------------------------------------------------------
pc13(2266)<v6>:56852        | OK     | GatewayReceiver is stopped on member pc13(2266)<v6>:56852
pc13(Manager:2242)<v5>:57631| Error  | GatewayReceiver is not available on member pc13(Manager:2242)<v5>:57631
pc13(2275)<v7>:47480        | OK     | GatewayReceiver is stopped on member pc13(2275)<v7>:47480
pc13(2293)<v8>:55472        | OK     | GatewayReceiver is stopped on member pc13(2293)<v8>:55472

gfsh>stop gateway-receiver --members=pc13(2266)<v14>:36579
GatewayReceiver is stopped on member pc13(2266)<v14>:36579

gfsh>stop gateway-receiver --groups=RG1
         Member      | Result | Message
-------------------- | -------| ----------------------------------------------------------
pc13(2275)<v23>:27484| OK     | GatewayReceiver is stopped on member pc13(2275)<v23>:27484
pc13(2293)<v24>:55810| OK     | GatewayReceiver is stopped on member pc13(2293)<v24>:55810
pc13(2266)<v22>:4522 | OK     | GatewayReceiver is stopped on member pc13(2266)<v22>:4522
```

## <a id="topic_0BBDD4B3B8A44A65A610F766C9E85519" class="no-quick-link"></a>stop gateway-sender

Stop a gateway sender with a given id on a specified member or members of a specified member group.

**CAUTION:**
Use caution with the `stop gateway-sender` command (or equivalent `GatewaySender.stop()` API) on parallel gateway senders. Instead of stopping an individual parallel gateway sender on a member, we recommend shutting down the entire member to ensure that proper failover of partition region events to other gateway sender members. Using this command on an individual parallel gateway sender can occur in event loss. See [Stopping Gateway Senders](../../../topologies_and_comm/topology_concepts/multisite_overview.html#topic_9AA37B43642D4DE19072CA3367C849BA__section_aqm_2js_bq) for more details.

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

**Syntax:**

``` pre
stop gateway-sender --id=value [--groups=value(,value)*] [--members=value(,value)*]
```

<a id="topic_0BBDD4B3B8A44A65A610F766C9E85519__table_ggf_55g_2w"></a>

| Name                                            | Description                                                |
|-------------------------------------------------|------------------------------------------------------------|
| <span class="keyword parmname">\\-\\-id </span>    | *Required.* ID of the Gateway Sender.                      |
| <span class="keyword parmname">\\-\\-groups</span>  | Group(s) of members on which to stop the Gateway Sender.   |
| <span class="keyword parmname">\\-\\-members</span> | Name/Id of the member(s) on which to stop the Gateway Sender. |

<span class="tablecap">Table 2. Stop Gateway-Sender Parameters</span>

**Example Commands:**

``` pre
stop gateway-sender --id=ln --members=server1
```

**Sample Output:**

``` pre
gfsh>stop gateway-sender --id=ln
Member                       | Result | Message
---------------------------- | ------ | ------------------------------------------------------------------------
pc13(5184)<v7>:41914         | OK     | GatewaySender ln is stopped on member pc13(5184)<v7>:41914
pc13(5192)<v8>:25704         | OK     | GatewaySender ln is stopped on member pc13(5192)<v8>:25704
pc13(5174)<v6>:53996         | OK     | GatewaySender ln is stopped on member pc13(5174)<v6>:53996
pc13(Manager:5148)<v5>:64040 | Error  | GatewaySender ln is not available on member pc13(Manager:5148)<v5>:64040

gfsh>stop gateway-sender --id=ln --members=pc13(5174)<v14>:17819
GatewaySender ln is stopped on member pc13(5174)<v14>:17819

gfsh>stop gateway-sender --id=ln --groups=SenderGroup1

Member                | Result | Message
--------------------- | ------ | -----------------------------------------------------------
pc13(5174)<v18>:63332 | OK     | GatewaySender ln is stopped on member pc13(5174)<v18>:63332
pc13(5184)<v19>:20055 | OK     | GatewaySender ln is stopped on member pc13(5184)<v19>:20055
pc13(5192)<v20>:14622 | OK     | GatewaySender ln is stopped on member pc13(5192)<v20>:14622
```

## <a id="topic_EF61C54B35BA4AB7B14E58CF911F283E" class="no-quick-link"></a>stop locator

Stop a locator.

**Note:** One of the command line options `--name` or `--dir` 
must be specified to identify the locator to be stopped.

**Availability:** Online or offline. If you want to stop a locator while you are offline, use the `--dir` option.

**Syntax:**

``` pre
stop locator --name=value | --dir=value
```

<a id="topic_EF61C54B35BA4AB7B14E58CF911F283E__table_ojb_x5g_2w"></a>

| Name                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                     | Default Value     |
|----------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
| <span class="keyword parmname">&#8209;&#8209;name</span> | The <%=vars.product_name%> member name of the locator to stop. You must be connected to the JMX Manager to use this option. Can be used to stop remote locators. See [Using gfsh to Manage a Remote Cluster Over HTTP or HTTPS](../../../configuring/cluster_config/gfsh_remote.html). | |
| <span class="keyword parmname">\\-\\-dir</span>  | Directory in which the locator was started. | current directory |

<span class="tablecap">Table 3. Stop Locator Parameters</span>

**Example Commands:**

``` pre
stop locator --name=locator3
```

**Sample Output:**

```
gfsh>stop locator --name=locator3
Stopping Locator running in /Users/test/locator3 on 192.0.2.0[10334] as locator3...
Process ID: 71531
Log File: /Users/test/locator3/locator3.log
...
No longer connected to 192.0.2.0[1099].
```

```
gfsh>stop locator --dir=loc2
Stopping Locator running in /Users/test/loc2 on 192.0.2.0[10334] as loc2...
Process ID: 71714
Log File: /Users/test/loc2/loc2.log
...
No longer connected to 192.0.2.0[1099].
```

## <a id="topic_723EE395A63A40D6819618AFC2902115" class="no-quick-link"></a>stop server

Stop a <%=vars.product_name%> cache server.

**Availability:** Online or offline. If you want to stop a cache server while you are offline, use the `--dir` option.

**Syntax:**

``` pre
stop server [--name=value] [--dir=value]
```

<a id="topic_723EE395A63A40D6819618AFC2902115__table_f12_2vg_2w"></a>

| Name                                          | Description                                                                                                                                                                                                                                                                                                                                                                                                                           | Default Value     |
|-----------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|
| <span class="keyword parmname">&#8209;&#8209;name </span> | Name/Id of the <%=vars.product_name%> Cache Server to stop. You must be connected to the JMX Manager to use this option. Can be used to stop remote servers. See [Using gfsh to Manage a Remote Cluster Over HTTP or HTTPS](../../../configuring/cluster_config/gfsh_remote.html). |                   |
| <span class="keyword parmname">\\-\\-dir </span>  | Directory in which the <%=vars.product_name%> Cache Server was started.                                                                                                                                                                                                                                                                                                                                                   | current directory |

<span class="tablecap">Table 4. Stop Server Parameters</span>

**Example Commands:**

``` pre
stop server --name=server1
stop server --dir=server1
```
