Shutdown configuration

The configuration items on this page allow you to configure Liberator’s behaviour on shutdown.

sigterm-shutdown-options

This configuration item changes the behaviour of Liberator when it receives a SIGTERM signal. The standard behaviour is for Liberator to initiate an immediate shutdown. When sigterm-shutdown-options is set, Liberator initiates a graceful (delayed) shutdown.

During a graceful shutdown, existing connections are still honoured, but no new client connections are accepted. Liberator will shutdown automatically either when all clients have disconnected, or at the conclusion of the grace period; whichever happens first.

You can send the SIGTERM signal to Liberator using the Bash built-in command kill or Linux’s /bin/kill command.

You can also initiate a graceful shutdown by sending Liberator the UDP command shutdown, or by executing the monitoring operation "shutdown" under the rttpd.server.liberator mbean in the Caplin Management Console.

Syntax: sigterm-shutdown-options <time-specification> <reason>

Parameter Type Default Description

time-specification

string

The number of seconds to delay shutdown or a specific local-time to shutdown the server in the format %Y-%m-%dT%H:%M

reason

string

Descriptive text to enter in Liberator’s log

Since: Liberator 7.1.1

Operating system: Linux

Type: string array

Default: none

Examples:

  • sigterm-shutdown-options 10 "Graceful shutdown initiated. Liberator will shutdown in 10 seconds."

  • sigterm-shutdown-options "2099-09-23T23:00" "Graceful shutdown initiated. Liberator will shutdown at 23:00 on 23 Sep 2099."