From 921dde131b1e53c336dd9491ab4c187631f51f36 Mon Sep 17 00:00:00 2001 From: Heikki Hannikainen Date: Thu, 18 Oct 2012 00:04:42 +0300 Subject: [PATCH] CONFIGURATION doc: document on-line reconfiguration --- doc/CONFIGURATION.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/doc/CONFIGURATION.md b/doc/CONFIGURATION.md index f38ecd2..f0f8ffd 100644 --- a/doc/CONFIGURATION.md +++ b/doc/CONFIGURATION.md @@ -45,6 +45,30 @@ syslog socket within the chroot. [chroot]: http://en.wikipedia.org/wiki/Chroot +On-line reconfiguration +-------------------------- + +aprsc has been designed from the start to support configuration reloading +without requiring a full software restarts. Many APRS server operators +value high uptimes and service availability, so server restarts should be +kept to a minimum. + +To reload configuration, execute the `reload` option of the startup script. + +On Ubuntu or Debian: + + sudo service aprsc reload + +On Centos (and others): + + /etc/init.d/aprsc reload + +If there are any obvious problems with the new configuration, the startup +script will complain about that and skip the reconfiguration step. The same +check will be executed before restarting, should you use the `restart` +option of the start script. + + Configuration file format ----------------------------