Stop Script

Purpose

The stop script shuts down the Appian engines and associated other services, like Service Manager and the Internal Messaging Service.

Location

<APPIAN_HOME>/services/bin/stop.sh (.bat)

Options

Short Name Long Name Required Meaning
-h --help No Show usage information
-p --password Yes Password for Admin REST API
-s --services No A comma-separated list of services to stop. See below for values. Excluding this flag will result in stopping the cluster.
-c --cluster No Default stopping behavior. For HA this will stop the entire Service Manager cluster.
-nk --no-kafka No Skip stopping Internal Messaging Service
-par --parallel No Stop all engines at once (deprecated; this will have no effect)
-q --quick No Skip checkpointing when stopping an engine or engines

Available values for the --services parameter: all, analytics00analytics31, channels, content, download-stats, execution00execution31, forums, groups, notifications, notifications-email, portal, process-design, manager, mirror-maker.

If you are shutting down a single server you should use -s all. Otherwise, you do not need to use the -s flag and by default the cluster will be shut down.

When using the default shutdown behavior or explicitly using the --cluster option, you must run the stop script on all servers that are configured to run engines at the same time as the script will pause and wait for other servers to indicate that they have shut down their services before exiting.

By default, and unless you use the --quick option, the stop script will checkpoint the engines as they shut down. This results in .kdb files that contain up-to-date data (i.e. no data is persisted solely in the Internal Messaging Service - Kafka) which are suitable for performing an upgrade. Using the --quick option will result in .kdb files that do not contain all of the engine's data and the remaining transactions will need to be replayed as part of the subsequent startup. Kdb files like this are not suitable for performing an upgrade.

Usage examples

Stop services on a single node

1
./stop.sh -p <password> -s all

Stop a cluster

This must be run on all nodes.

1
./stop.sh -p <password>
Open in Github Built: Mon, May 23, 2022 (06:15:44 PM)

On This Page

FEEDBACK