Stopping servers gracefully with the xscmd utility

You can use the xscmd utility with the -c teardown command to stop a list or group of catalog and container servers. This command simplifies shutting down all or portions of a data grid. It also prevents unnecessary placement and recovery catalog service actions that normally occur when processes are stopped ungracefully.

Procedure

Stop a specific list of servers.
Provide a list of servers after the -teardown parameter:
```
xscmd –c teardown -sl catalogServer1,catalogServer2,containerServer1
```
Stop all the servers in a specific zone.
Use the -z parameter and provide the name of the zone. The catalog server determines the servers that are running in the zone. The xscmd utility also prompts you with a list of the servers in the selected zone before the servers are shut down.
```
xscmd –c teardown –z zone_name
```
Stop all the servers on a specific host.
For example, to shut down all the servers on myhost.mycompany.com, enter -hf myhost.mycompany.com.
Use the -hf parameter and provide the name of the host. The catalog server determines the servers that are running on the host. The xscmd utility prompts you with a list of the servers in the selected host before the servers are shut down.
```
xscmd –teardown –hf <host_name>
```
Attention: By default, the JVM continues to run when each eXtreme Scale server in an OSGi framework is stopped in the xscmd utility with the -c teardown command. If you want eXtreme Scale to exit the JVM, then this type of implementation must be planned for. You must set the server property exitJVMOnTeardown to true before the server is started. For more information, see Server properties file.