tmpfs-varlog/tmpfs-varlog.install

   1 # arg 1:  the new package version
   2 post_install() {
   3
   4 cat << EOF
   5
   6   Before using this tmpfs-varlog rc.d script, you'll need to do two things:
   7
   8   1) insert 'tmpfs-varlog' *before* syslog-ng in the DAEMONS variable in
   9      /etc/rc.conf. This is very important - you need to restore/backup
  10      the log files on the tmpfs file system before/after syslog-ng tries to use
  11      them.
  12
  13   2) configure your system so that /var/log is mounted on a tmpfs filesystem.
  14      A tmpfs file system is an in memory file system that only consumes as
  15      much memory as resquired by the data stored on it. To have /var/log
  16      stored on a tmpfs file system, add the following to your /etc/fstab file:
  17
  18         tmpfs /var/log tmpfs defaults,mode=755 0 0
  19
  20      An additonal option you might want to add is the 'size=<SIZE>' option.
  21      This specifies the maximum size the tmpfs file system can grow to; IOW,
  22      the maximum amount of main memory the tmpfs system can use before it
  23      reports itself to be full. For example, for a machine with 2GB of ram,
  24      the following would be reasonable for /var/log in /etc/fstab:
  25
  26         tmpfs /var/log tmpfs defaults,mode=755,size=256M 0 0
  27
  28      You may wish to temporarily mount this tmpfs /var/log somewhere else,
  29      stop syslog-ng, move the original /var/log files to this new tmpfs
  30      /var/log file system, remount it over the original /var/log and then
  31      restart syslog-ng. This will preserve the original log files.
  32
  33   Using a tmpfs file system for /var/log is beneficial for netbooks with
  34   SSDs, minimising wear, and laptops. As netbooks and laptops have batteries,
  35   the risks of storing logs on a tmpfs are reduced, when compared with non-UPS
  36   protected desktop PCs.
  37
  38   The /etc/conf.d/tmpfs-varlog.conf file specifies where the persistent
  39   tarball of the log files is stored. The default location is the /.var.log
  40   subdirectory.
  41
  42 EOF
  43
  44 }