Free cookie consent management tool by TermsFeed Stop Script [Server Administration]
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.
-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
-nw --no-wait No Skip the warning when shutting down the cluster without the "-s" flag

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

Tip:  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, 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 specific node

This will stop all services (including the Internal Messaging Service)

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

Tip:  This script can be used for a single server environment or against one server for a High Availability or distributed deployment. Only the services on the machine where the script is being run will affected.

Stop a cluster

Caution:  This must be run on all nodes.

1
./stop.sh -p <password>

Rolling restarts for maintenance

To be the least disruptive for end users when you need to restart nodes in a Highly Available environment for maintenance. This is not recommended for distributed environments.

  1. Manually checkpoint all engines
    1
    
    ./checkpoint.sh -p <password> -s all
    
  2. Stop all engines and skip checkpointing
    1
    
    ./stop.sh -p <password> -s all -q
    
  3. Restart the node

Stop Script

FEEDBACK