repmgr daemon stop

repmgr daemon stop

Stop the &repmgrd; daemon on the local node

## Description

This command stops the &repmgrd; daemon on the local node.

By default, &repmgr; will wait for up to 15 seconds to confirm that &repmgrd; stopped. This behaviour can be overridden by specifying a different value using the `--wait` option, or disabled altogether with the `--no-wait` option.

If PostgreSQL is not running on the local node, under some circumstances &repmgr; may not be able to confirm if &repmgrd; has actually stopped.

The `repmgr.conf` parameter `repmgrd_service_stop_command` must be set for `repmgr daemon stop` to work; see section repmgr-daemon-stop-configuration for details.

## Configuration

`repmgr daemon stop` will execute the command defined by the `repmgrd_service_stop_command` parameter in `repmgr.conf`. This must be set to a shell command which will stop &repmgrd;; if &repmgr; was installed from a package, this will be the service command defined by the package. For more details see Appendix: &repmgr; package details.

If &repmgr; was installed from a system package, and you do not configure `repmgrd_service_stop_command` to an appropriate service command, this may result in the system becoming confused about the state of the &repmgrd; service; this is particularly the case with `systemd`.

## Options

`--dry-run`

- Check prerequisites but don't actually attempt to stop &repmgrd;.

  This action will output the command which would be executed.

`-w`

`--wait`

- Wait for the specified number of seconds to confirm that &repmgrd; stopped successfully.

  Note that providing `--wait=0` is the equivalent of `--no-wait`.

`--no-wait`

- Don't wait to confirm that &repmgrd; stopped successfully.

  This is equivalent to providing `--wait=0`.

## Configuration file settings

The following parameter in `repmgr.conf` is relevant to `repmgr daemon stop`:

`repmgrd_service_stop_command`

- `repmgr daemon stop` will execute the command defined by the `repmgrd_service_stop_command` parameter in `repmgr.conf`. This must be set to a shell command which will stop &repmgrd;; if &repmgr; was installed from a package, this will be the service command defined by the package. For more details see Appendix: &repmgr; package details.

  If &repmgr; was installed from a system package, and you do not configure `repmgrd_service_stop_command` to an appropriate service command, this may result in the system becoming confused about the state of the &repmgrd; service; this is particularly the case with `systemd`.

## Exit codes

One of the following exit codes will be emitted by `repmgr daemon stop`:

`SUCCESS (0)`

- &repmgrd; could be stopped.

`ERR_BAD_CONFIG (1)`

- `repmgrd_service_stop_command` is not defined in `repmgr.conf`.

`ERR_REPMGRD_SERVICE (27)`

- &repmgrd; could not be stopped.

## See also

repmgr-daemon-start, repmgrd-daemon, repmgr-service-status, repmgr-service-pause, repmgr-service-unpause