ModulePropagationMonitor.conf(5)

1MODULEPROPAGATIONMONITOR.CONF(5) File Formats MODULEPROPAGATIONMONITOR.CONF(5)
2
3
4

NAME

6       ModulePropagationMonitor.conf  -  Configuration  file  for  the SvxLink
7       server PropagationMonitor module
8

DESCRIPTION

10       svxlink is a general purpose voice service system for  ham  radio  use.
11       This  man-page describe the SvxLink server configuration for the Propa‐
12       gationMonitor module.
13
14       The PropagationMonitor module is used to  announce  propagation  alerts
15       received  from  vhfdx.info  or gooddx.net. The process of receiving the
16       emails is outside of this module and have to  be  arranged  separately.
17       This  module  expect to find new emails under the spool directory. Mes‐
18       sages from VHFDX should be put in a  vhfdx  subdirectory  and  messages
19       from  GoodDX  should be put in a dxrobot subdirectory. This module must
20       have write access to the subdirectories under the spool directory since
21       it will move processed messages to an archive directory.
22

CONFIGURATION VARIABLES

24       There  are  a  couple of configuration variables that are common to all
25       modules.   The  documentation  for  these   can   be   found   in   the
26       svxlink.conf(5) manual page.
27
28       Here  is the description of all module specific configuration variables
29       that the SvxLink PropagationMonitor module understands.
30
31   ModulePropagationMonitor
32       SPOOL_DIR
33              Specify which  directory  to  read  incoming  emails  from.  The
34              default is /var/spool/svxlink/propagation_monitor.
35

RECEIVING THE ALERT EMAILS

37       The  first  step  in setting up the flow of alert emails is to actually
38       getting them to the computer running SvxLink and, on that computer,  to
39       the  user  SvxLink  run as. This can be done in two ways. One way is to
40       forward emails directly via SMTP to the  computer,  if  you  have  that
41       possibility.  A  more  common  case  propably is that you want to fetch
42       alert emails using POP from some email account. The latter can be  done
43       using the fetchmail(1) utility for example.
44
45       The  next  step is to store incoming emails in files under the propaga‐
46       tion monitor spool directory. This is done using the procmail(1)  util‐
47       ity.  When an incoming email is received, the mail server call procmail
48       which look for a configuration  file  in  the  destination  users  home
49       directory.    For   SvxLink,  the  home  directory  should  be  set  to
50       /etc/svxlink.  In that directory a procmail configuration file,  .proc‐
51       mailrc,  is  installed  by default. The syntax is a bit cryptic but the
52       file contains some helpful comments to help you understand it.  Have  a
53       look  at  the  procmailrc  [22m(5)  and procmailex(5) manual pages for more
54       details.
55
56       Finally, of course, you need to register  with  the  vhfdx.info  and/or
57       gooddx.net site and set up for what geographic area and which bands you
58       wish to receive alert emails for.
59

SELINUX

61       Some Linux distributions have the SELinux security  framework  enabled.
62       This  is  true for RedHat based distributions, like Fedora for example.
63       SELinux will by default deny procmail to write the mail  files  in  the
64       propagation  monitor  spool  directory.  To fix this, run the following
65       commands:
66
67           semanage fcontext -a -t user_home_t \
68                    "/var/spool/svxlink/propagation_monitor(/.*)?"
69           restorecon -r /var/spool/svxlink/propagation_monitor
70

FILES

72       /etc/svxlink/svxlink.conf (or deprecated /etc/svxlink.conf)
73              The system wide configuration file.
74
75       ~/.svxlink/svxlink.conf
76              Per user configuration file.
77
78       /etc/svxlink/svxlink.d/ModulePropagationMonitor.conf
79              Global modularized configuration file. Depends  on  the  CFG_DIR
80              configuration variable setting.
81
82       ~/.svxlink/svxlink.d/ModulePropagationMonitor.conf
83              Per  user modularized configuration file. Depends on the CFG_DIR
84              configuration variable setting.
85
86       /var/spool/svxlink/propagation_monitor
87              Spool directory for alert mails. This is the default path.  What
88              path  is actually used is determined by the SPOOL_DIR configura‐
89              tion variable.
90
91       /etc/svxlink/.procmailrc
92              The configuration file for procmail. Procmail is used  to  write
93              incoming alert emails into files in the spool directory.
94

AUTHOR

96       Tobias Blomberg (SM0SVX) <sm0svx at users dot sourceforge dot net>
97