home *** CD-ROM | disk | FTP | other *** search
/ Clickx 115 / Clickx 115.iso / software / tools / windows / tails-i386-0.16.iso / live / filesystem.squashfs / usr / share / doc / rsyslog / README.Debian < prev   
Encoding:
Text File  |  2010-11-30  |  3.2 KB  |  84 lines
  1. rsyslog for Debian
  2. ==================
  3.  
  4. Configuration file(s)
  5. ---------------------
  6. The default configuration file for rsyslog is /etc/rsyslog.conf.
  7.  
  8. Its format is based on the standard syslog.conf format. As rsyslog
  9. has a lot more advanced features than sysklogd, it extends this format
  10. with special configuration directives which all start with the '$'
  11. prefix. See the rsyslogd(8) and rsyslog.conf(5) man pages for further
  12. information or install the rsyslog-doc package which provides much
  13. more detailed documentation.
  14.  
  15. The Debian default configuration for rsyslog uses:
  16.  
  17.  $IncludeConfig /etc/rsyslog.d/*.conf
  18.  
  19. That means, all configuration files in /etc/rsyslog.d/ with a .conf file
  20. extension are read by rsyslog. This allows to easily extend the rsyslog
  21. configuration (either by package maintainers or local administrators).
  22.  
  23.  
  24. Command line arguments, modules and compatibility levels
  25. --------------------------------------------------------
  26. With version 3, rsyslog became much more modular. A lot of
  27. functionality has been moved into loadable modules, e.g. udp reception,
  28. which must be loaded explicitly.
  29. To keep compatibility with sysklogd, rsyslog introduced the concept of
  30. compatibility modes, which can be selected with the -c command line
  31. argument. E.g. with -c0, rsyslog becomes command line compatible with
  32. sysklogd and loads a default set of modules automatically.
  33.  
  34. The default in Debian is -c3, i.e. command line arguments like -r or
  35. -m 0 have no effect and instead have to be configured via special
  36. configuration directives in rsyslog.conf.
  37.  
  38. The options that are passed to rsyslog can be changed easily by
  39. modifying the RSYSLOGD_OPTIONS variable in /etc/default/rsyslog.
  40.  
  41. If you have an existing, customized syslog.conf, it is recommended that
  42. you migrate your custom logging rules to rsyslog.conf or into a separate
  43. configuration file in /etc/rsyslog.d (in most cases it should be as
  44. simple as copy&paste).
  45.  
  46. To read more about this topic please see
  47. /usr/share/doc/rsyslog-doc/html/v3compatibility.html or
  48. http://www.rsyslog.com/doc-v3compatibility.html.
  49.  
  50.  
  51. Log rotation
  52. ------------
  53. Rsyslog uses the logrotate(8) utilitiy to rotate the standard Debian
  54. log files. The configuration file can be found at
  55. /etc/logrotate.d/rsyslog.
  56.  
  57. The rotation cycle starts with .1, as this is the logrotate default.
  58. In contrast to sysklogd, which starts with .0.
  59.  
  60. When upgrading from sysklogd, the postinst script will automatically
  61. rotate the existing standard Debian log files, if it is safe to do so
  62. (i.e. only if .0 is newer than .1).
  63.  
  64.  
  65. Forwarding messages to sysklogd
  66. -------------------------------
  67. If you are forwarding messages from a rsyslog client to a sysklogd
  68. server, it can lead to doubled hostnames in the syslog message on the
  69. server side. The reason is a limitation in sysklogd which does not parse
  70. the hostname in the syslog header (as defined by RFC 3164). See Debian
  71. bug #514051 for more details.
  72.  
  73. A simple workaround in rsyslog is, to define a custom template, which
  74. does not include the hostname:
  75.  
  76.  $template sysklogd,"<%PRI%>%TIMESTAMP% %syslogtag%%msg%"
  77.  *.* @remote-host;sysklogd
  78.  
  79. This creates a template called "sysklogd" and assigns it to the forward
  80. rule when logging to "remote-host".
  81.  
  82.  
  83.  -- Michael Biebl <biebl@debian.org>  Sat, 07 Feb 2009 18:54:37 +0100
  84.