home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / BURKS / LINUX / HOWTO / mini / pager.txt < prev    next >
Text File  |  1997-07-07  |  22KB  |  571 lines
  1. Originally Drafted: Sun Jun 23 17:55:14 MDT 1996
  2. Last Revision:  Sun Jun 15 01:48:35 MDT 1997
  3.  
  4.                               The
  5.  
  6.               Linux Alphanumeric Pager Gateway Mini-HOWTO
  7.  
  8.                             by Chris Snell
  9.                           chris@unm.dorm.net
  10.                     http://www.unm.dorm.net/~chris
  11.  
  12.  
  13.               +-----------------------------------------+
  14.               | The latest version of this document is  |
  15.               | always available at the Pager FTP site: |
  16.               |    ftp://ftp.unm.dorm.net/pub/paging    |
  17.               +-----------------------------------------+
  18.  
  19.  
  20. PREFACE & DISCLAIMER:
  21. ---------------------
  22.  
  23. This document sucks.  I'm not a technical writer, nor do I plan to be one.
  24. I had a hard enough time pasing my English Composition class last semester.
  25. If anything, this document provides too much detail.  If you have half a 
  26. brain, some sendmail experience and some experience with modems, skim this
  27. thing.  Otherwise, read on.
  28.  
  29. If you blow up your computer/pager/modem or ruin your company network trying
  30. to set this up, go whine to your mother.  Most likely, you won't mess up
  31. anything but I should warn you that sendmail is a tricky thing to play with
  32. and you will definitely be playing with it if you follow this document.
  33.  
  34. PURPOSE:
  35. --------
  36.  
  37. This mini-HOWTO will describe how to set up an alphanumeric paging 
  38. gateway on any linux machine.  Your gateway will be able to send messages 
  39. originating from both the World Wide Web and the Internet e-mail system 
  40. to your alphanumeric pager.  This is especially convienent, because no 
  41. special skills are required for someone to send a message to your pager.  
  42. All they must be able to do is use e-mail or the World Wide Web.
  43.  
  44.                          **SPECIAL NOTE: **  
  45. This document does not cover the setup of paging gateways which are intended 
  46. to send messages to non-alphanumeric (ie numbers-only) pagers or voice pagers.
  47. You'll need to look elsewhere for that information.
  48.  
  49.  
  50. REQUIREMENTS:
  51. -------------
  52.  
  53. - one or more alphanumeric pagers (see the ABOUT ALPHANUMERIC PAGERS section)
  54. - a machine running linux
  55. - a working modem (documentation reccomended!)
  56. - a telephone line
  57. - an Internet connection (if you wish to use the WWW interface and the 
  58.   net-wide e-mail interface)
  59. - compiler tools (gcc, make, etc. and some basic knowledge of their use.)
  60. - the sendmail electronic mail handler (you probably have this)
  61. - a working httpd (web server) if you want to create a WWW interface
  62.  
  63.  
  64. ABOUT ALPHANUMERIC PAGERS:
  65. --------------------------
  66.  
  67. Alphanumeric pagers are available from most reputable paging companies 
  68. (and even some non-reputable ones ;-)).  The prices range, but you should 
  69. be able to pick up a good one for less than $200.  I paid $180 for mine 
  70. (and probably paid too much).
  71.  
  72. Here are some things to look for when you go shopping for your pager:
  73.  
  74.   - Is this a name brand (ie. Motorola or the like) pager?
  75.   - *MOST IMPORTANT* Does this pager support paging via a dialup line 
  76.     provided by your pager company? (See THE DIALUP PAGING LINE section)
  77.   - Does it's memory have enough room for the pages you wish to recieve?
  78.   - How reputable is the company?  (See THE DIALUP PAGING LINE section)
  79.  
  80. I don't work for any pager manufacturers but I wholeheartedly reccommend 
  81. the Motorola line of pagers.  I own one myself and will testify to their 
  82. reliability and durability.  In fact, mine has been dropped onto the 
  83. concrete on many occaisions and did not sustain so much as a chipped case.
  84. You can find this line of pagers on Motorola's web site at:
  85.     
  86.              http://www.mot.com/MIMS/MSPG/Products/Alpha/
  87.  
  88.  
  89. THE DIALUP PAGING LINE
  90. ----------------------
  91.  
  92. In order for your gateway to work, we need a way to deliver the messages 
  93. to your paging company, which encodes them and transmits them over 
  94. the air to your pager.  This is done via a dialup (modem) connection 
  95. with your paging company.  Without this connection, you cannot setup 
  96. a paging gateway.  Therefore, it is very important that your paging 
  97. company have such a dialup line.  Unfortunately, many paging companies 
  98. either do not have such a dialup line or do not know about the line they 
  99. have.  When inquiring with a paging company about this line, I found it 
  100. helpful to ask if they could provide "computer software to send an 
  101. alphanumeric page with".  If they make available such software, you can 
  102. bet that they make the dialup line availble that is necessary to use it.  
  103.  
  104. SPECIFICS ON THE DIALUP LINE
  105. ----------------------------
  106.  
  107. The dialup line is simply a modem on a remote computer (or possibly some 
  108. kind of specialized box).  The modem usually connects at 
  109. 300-1200bps, although some (including my provider's) connect using v.22b 
  110. at speeds up to 2400bps.  Once the connection is made, your computer 
  111. sends the page to the remote site by using a protocol known as TAP 
  112. (formerly known as IXO).  You do not need to know the details of this 
  113. protocol, but if you are interested, check out the following document on 
  114. my ftp site:
  115.  
  116.                ftp://ftp.unm.dorm.net/pub/paging/ixo.txt
  117.  
  118. HOW YOUR GATEWAY WILL WORK
  119. --------------------------
  120.  
  121. Before we proceed, I will provide a brief explanation of how the 
  122. e-mail->pager gateway will work.   The WWW gateway is similar and will be 
  123. explained later.
  124.  
  125.   1.   A message intended for your pager is sent by someone via e-mail to 
  126.        a special address on your linux machine.
  127.  
  128.   2.   Your machine, using sendmail, accepts the message and routes it to 
  129.        a filter program, which strips the message of it's header and parses 
  130.        out important information like the sender's name and e-mail address 
  131.        and the subject of the message.  This filter also strips the 
  132.        message of any .signature lines so that they do not clog your pager 
  133.        with unimportant information.
  134.  
  135.   3.   The paging filter passes the message onwards to the "sendpage" 
  136.        paging software which queues it for delivery.
  137.  
  138.   4.   Sendpage then dials your paging company's dialup line and (using 
  139.        TAP) sends the message.
  140.  
  141.   5.   Your paging company then beams the message to your pager over the 
  142.        radio waves.
  143.  
  144.  
  145. BEGINNING THE SETUP
  146. -------------------
  147.  
  148. The setup of the gateway will consist of four parts:
  149.     - setting up sendpage
  150.     - (optionally) getting a special DNS entry added for your paging gateway
  151.           - setting up linux to handle multiple IP addresses
  152.     - setting up sendmail to handle the message routing
  153.     - setting up the World Wide Web interface
  154.  
  155.  
  156. GETTING THE SOFTWARE
  157. --------------------
  158.  
  159. Every peice of software necessary to set up this product can be obtained 
  160. from my home site, ftp://ftp.unm.dorm.net/pub/paging.  I will try to 
  161. keep these files current but will also list the alternate sites for 
  162. the packages required.
  163.  
  164.  
  165. SENDPAGE SETUP
  166. --------------
  167.  
  168. Sendpage is the most important component of your paging gateway.  To get 
  169. anywhere in this project, you will need to obtain this software and 
  170. compile it on your machine.  The sendpage software can be obtained via 
  171. ftp at:
  172.  
  173.         ftp://ftp.net.ohio-state.edu/pub/pagers/sendpage7a.tar.Z
  174.  
  175. or from my machine:
  176.  
  177.         ftp://ftp.unm.dorm.net/pub/paging/sendpage/sendpage7a.tar.Z
  178.  
  179. Create a "paging" subdirectory somewhere.  Fetch this software and unpack it 
  180. (tar zxvf) in the paging directory.  
  181.  
  182. At this point, I would strongly suggest that you read over all the 
  183. configuration information and README and INSTALL files in the sendpage 
  184. package.  However, you should probably ignore all the discussion on the 
  185. setup of sendmail and instead rely on my procedure.
  186.  
  187. Follow the instructions in the INSTALL file for compiling sendpage.  Here 
  188. are a few notes about the settings in the sendpage.h file which you will 
  189. need to edit:
  190.  
  191. - Make sure you have the "#define ARSYSTEM_NOTIFIER" line commented out 
  192. (using "/*" and "*/") unless you own the commercial Remedy system monitor 
  193. package.
  194.  
  195. - Following the ARSYSTEM_NOTIFIER line, there are a few Linux (POSIX) 
  196. specific lines that need to be defined:
  197. #define POSIX_SIGNALS 
  198. #define POSIX_OPEN
  199.  
  200.  
  201. - For the modem definition, I recommend using:
  202. #define MODEM_DEV "/dev/modem" 
  203.      or "/dev/cua0"