1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154
|
Installation instructions for QuickPage v3.3:
---------------------------------------------
1) Make sure you have the latest version. The latest version of QuickPage
can be found at http://www.qpage.org/.
2) Edit config.input as appropriate and type "./configure" in this
directory.
3) Type "make" to build the QuickPage binary, or type "make client" for a
stripped down client-only version.
4) Install qpage and qpage.man in appropriate directories.
5) Create a run-time configuration file. See the man page for complete
details on the syntax of this file.
6) Edit the appropriate system startup file to start a QuickPage daemon
process when the system boots.
7) Send e-mail to tomiii@qpage.org telling me how you like QuickPage! :-)
**********************************************************************
How to use the "tcp_wrappers" package with QuickPage:
-----------------------------------------------------
QuickPage has builtin support for Wietse Venema's "tcp_wrappers" package.
If you don't know what this means, forget about it and skip to the next
section. The "configure" script in this directory automatically checks
for the presence of tcpd.h and libwrap.a on your system and will make
appropriate changes to QuickPage's Makefile if they are found. However,
as Tony Dal Santo likes to say, "There is no magic." You might need to
give the configure script a little help. It will try to compile and link
this program:
#include "tcpd.h"
int main()
{
request_init(0);
return(0);
}
In doing so, it will look for tcpd.h and libwrap.a in a variety of places
including those specified by --includedir and --libdir (respectively) and
in the current directory. If this program compiles and links successfully,
QuickPage will be configured for tcp_wrapper support. If "configure"
cannot find both tcpd.h and libwrap.a then you have three options:
1) copy those files to this directory and rerun "./configure"
2) run "./configure" with appropriate --includedir and --libdir
options
3) You didn't really want to use tcp_wrappers, did you?
If you have trouble, please send e-mail to tomiii@qpage.org explaining
your problem.
**********************************************************************
How to integrate QuickPage into your e-mail system:
---------------------------------------------------
There are many ways to integrate QuickPage into your e-mail system. None
of them require running a QuickPage daemon on your mail server. Two
common methods of using QuickPage via e-mail without requiring changes
to sendmail.cf are:
1) Create aliases for each user, such as:
<user>-page: "|/usr/local/bin/qpage -l 0 -m -p <user>"
Sending messages to <user>-page will result in the message being
forwarded to the user's pager.
2) Install the procmail package from ftp.informatik.rwth-aachen.de.
Procmail can either be installed as the sendmail local delivery
agent (preferred) or simply executed from the user's .forward file.
If you're using a recent version of sendmail, no user aliases are
required. Versions of sendmail 8.x or later will accept usernames
containing a plus sign and will deliver them as though the username
were truncated at the plus sign (it's actually more complicated
than this--see the Sendmail book mentioned above for complete details).
For example, sending a message to "tomiii+page@some.domain.name" will
result in the message going to tomiii's mailbox. If this doesn't
work on your system, you will need to create aliases such as:
<user>-page: <user>
The following rule in /etc/procmailrc (or .procmailrc in the user's
home directory) should work nicely with QuickPage:
:0c
* ^To: .*[+-]page@
|/usr/local/bin/qpage -l 0 -m -p $LOGNAME
This procmail rule will check for a "To:" line that contains a
username ending with "-page" or "+page" and will invoke qpage to
handle such messages. The 'c' in the first line causes procmail to
also deliver the e-mail message to the user's mailbox in case the
user's pager is turned off. The "-l 0" option causes the QuickPage
daemon to send an e-mail reply containing status information about
the page to the original sender. Consult the procmail documentation
for more information.
QuickPage can also be installed as a sendmail delivery agent. To do
this requires modifying /etc/sendmail.cf (or /etc/mail/sendmail.cf on
some systems) and should not be attempted without understanding how
sendmail works. Explaining the syntax requirements of sendmail.cf is
beyond the scope of this document. However, the O'Reilly "Sendmail"
book (also known as the Bat book) is an excellent reference. It
contains a wealth of information about sendmail and shows specific
examples on how to modify the sendmail configuration file for programs
such as QuickPage. For those of you who already understand the details
of sendmail.cf, keep reading; otherwise, stop here and go get yourself
a sendmail book.
If you intend to use QuickPage as a sendmail delivery agent, you'll
need to and create a new mailer definition in sendmail.cf. Insert the
following line somewhere near the local mailer definition (typically
called Mlocal in most configuration files):
Mqpage, P=/usr/local/bin/qpage, F=lmsDF, A=qpage -l0 -m -P$u
Note that when using the 'm' flag in the F= portion of the mailer
definition, you'll probably want to use -P instead of -p in the
argument list so that any -a, -c, or -l options you specify will
apply to all recipients.
Now you need to modify ruleset 0 to use this new mailer definition.
The specifics are left for you to decide. This can be as simple
or as complicated as you want to make it. One possibility would
be to add rules such as:
# send local pages to the QuickPage mailer
R$+.page $#qpage $: $1
R$+.page<@$=w>$* $#qpage $: $1
With these rules and the mailer definition above, a message sent to
user.page or user.page@your.domain.name would cause sendmail to forward
the message to the user's pager by executing the command:
/usr/local/bin/qpage -l0 -m -Puser
It would be wise to save a backup copy of your existing sendmail.cf
before attempting to make any changes.
|