From 882b07660c2b7137d8fcd5a15142eed25a634638 Mon Sep 17 00:00:00 2001 From: Dimitrios Liappis Date: Tue, 19 Nov 2019 11:59:12 +0200 Subject: [PATCH] Move logrotate comments to separate lines because logrotate doesn't support in-line comments. --- docs/configuration.rst | 21 ++++++++++++++------- docs/migrate.rst | 21 ++++++++++++++------- 2 files changed, 28 insertions(+), 14 deletions(-) diff --git a/docs/configuration.rst b/docs/configuration.rst index 3b48e0146..bf0edf0b2 100644 --- a/docs/configuration.rst +++ b/docs/configuration.rst @@ -126,13 +126,20 @@ By default, Rally will log all output to ``~/.rally/logs/rally.log``. The log file will not be rotated automatically as this is problematic due to Rally's multi-process architecture. Setup an external tool like `logrotate `_ to achieve that. See the following example as a starting point for your own ``logrotate`` configuration and ensure to replace the path ``/home/user/.rally/logs/rally.log`` with the proper one:: /home/user/.rally/logs/rally.log { - daily # rotate daily - rotate 7 # keep the last seven log files - maxage 14 # remove logs older than 14 days - compress # compress old logs ... - delaycompress # ... after moving them - missingok # ignore missing log files - notifempty # don't attempt to rotate empty ones + # rotate daily + daily + # keep the last seven log files + rotate 7 + # remove logs older than 14 days + maxage 14 + # compress old logs ... + compress + # ... after moving them + delaycompress + # ignore missing log files + missingok + # don't attempt to rotate empty ones + notifempty } Example diff --git a/docs/migrate.rst b/docs/migrate.rst index ede980485..772e6a294 100644 --- a/docs/migrate.rst +++ b/docs/migrate.rst @@ -156,13 +156,20 @@ With Rally 1.0.1 we have disabled automatic rotation of logs by default because To rotate logs we recommend to use external tools like `logrotate `_. See the following example as a starting point for your own ``logrotate`` configuration and ensure to replace the path ``/home/user/.rally/logs/rally.log`` with the proper one:: /home/user/.rally/logs/rally.log { - daily # rotate daily - rotate 7 # keep the last seven log files - maxage 14 # remove logs older than 14 days - compress # compress old logs ... - delaycompress # ... after moving them - missingok # ignore missing log files - notifempty # don't attempt to rotate empty ones + # rotate daily + daily + # keep the last seven log files + rotate 7 + # remove logs older than 14 days + maxage 14 + # compress old logs ... + compress + # ... after moving them + delaycompress + # ignore missing log files + missingok + # don't attempt to rotate empty ones + notifempty } Migrating to Rally 1.0.0