7.3.58. shutdown#

7.3.58.1. Summary#

shutdown stops the Groonga server process.

shutdown uses graceful shutdown by default. If there are some running commands, the Groonga server process stops after these running commands are finished. New command requests aren’t processed after shutdown command is executed.

Added in version 6.0.1: shutdown uses immediate shutdown by specifying immediate to mode parameter. The Groonga server process stops immediately even when there are some running commands.

Note

You need to set Request ID to all requests to use immediate shutdown.

Added in version 9.1.2: The Groonga HTTP server accepts immediate shutdown immediately even when all threads are used.

Note

This feature can only use on the Groonga HTTP server.

7.3.58.2. Syntax#

This command takes only one optional parameter:

shutdown [mode=graceful]

7.3.58.3. Usage#

shutdown use graceful shutdown by default:

Execution example:

shutdown
# [[0,1337566253.89858,0.000355720520019531],true]

You can specify graceful to mode parameter explicitly:

Execution example:

shutdown --mode graceful
# [[0,1337566253.89858,0.000355720520019531],true]

You can choose immediate shutdown by specifying immediate to mode parameter:

Execution example:

shutdown --mode immediate
# [[0,1337566253.89858,0.000355720520019531],true]

Immediate shutdown is useful when you don’t have time for graceful shutdown. For example, Windows kills service that takes long time to stop on Windows shutdown.

7.3.58.4. Parameters#

This section describes parameters of this command.

7.3.58.4.1. Required parameters#

There is no required parameter.

7.3.58.4.2. Optional parameters#

There are optional parameters.

7.3.58.4.2.1. mode#

Specifies shutdown mode. Here are available shutdown modes:

Value

Description

graceful

Stops after running commands are finished.

This is the default.

immediate

Added in version 6.0.1: Stops immediately even if there are some running commands.

7.3.58.5. Return value#

shutdown returns true as body when shutdown is accepted:

[HEADER, true]

If shutdown doesn’t accept shutdown, error details are in HEADER.

See Output format for HEADER.