• Options, chosen from the following:
• h
display this help text and exit
• v
display program version and exit
• q
quiet mode
• l
cause running daemon to reopen its logfile
• r
cause running daemon to resume after error
• t
cause running daemon to enter smart shutdown mode
• T
cause running daemon to enter immediate shutdown mode
• c
destroy existing semaphore set and message queue (use with caution)
• f
stay in foreground (don't daemonize)
• w
enter smart shutdown mode immediately
• A specified log shipper configuration file
This configuration file consists of the following specifications:
• logfile='./offline_logs/logshipper.log';
Where the log shipper will leave messages.
• clustername='T1';
Cluster name
• destinationdatabase='dbname=slony_test3';
Optional conninfo for the destination database. If given, the log shipper will connect to this
database, and apply logs to it.
• archivedir='./offline_logs';
The archive directory is required when running in ‘database-connected’ mode to have a place to scan
for missing (unapplied) archives.
• destinationdir='./offline_result';
If specified, the log shipper will write the results of data massaging into result logfiles in this
directory.
• maxarchives=3600;
This fights eventual resource leakage; the daemon will enter ‘smart shutdown’ mode automatically
after processing this many archives.
• ignoretable"public"."history";
One may filter out single tables from log shipped replication
• ignorenamespace"public";
One may filter out entire namespaces from log shipped replication
• renamenamespace"public"."history"to"site_001"."history";
One may rename specific tables.
• renamenamespace"public"to"site_001";
One may rename entire namespaces.
• postprocessingcommand='gzip-9$inarchive';
Pre- and post-processing commands are executed via system(3).
An ‘@’ as the first character causes the exit code to be ignored. Otherwise, a nonzero exit code is
treated as an error and causes processing to abort.
Pre- and post-processing commands have two further special variables defined:
• $inarchive - indicating incoming archive filename
• $outnarchive - indicating outgoing archive filename
• errorcommand='(echo"archive=$inarchive"echo"errormessages:"echo"$errortext")|mail-s"Slonylogshippingfailed"postgres@localhost';
The error command indicates a command to execute upon encountering an error. All logging since the last
successful completion of an archive is available in the $errortext variable.
In the example shown, this sends an email to the DBAs upon encountering an error.
• Archive File Names
Each filename is added to the SystemV Message queue for processing by a slony_logshipper process.
19 September 2024 slony_logshipping(1)