home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / KSP-MAIL.TXT < prev    next >
Text File  |  1998-03-01  |  20KB  |  437 lines

  1.                   Newsgroups and TBBS - The Missing Link
  2.  
  3.      I've found it. Finally. An inexpensive, reliable, automated, easy to
  4. install method for importing and exporting Usenet Newsgroups to/from a TBBS
  5. BBS directly from the Internet via IPAD or any other fulltime TCP/IP
  6. connection to a standard Internet NNTP news server (or alternately via a
  7. standard consumer dialup ISP account offering access to a news server). I'm
  8. neither selling this nor advertising it. This is just an excellent solution
  9. I want to share with any of you other TBBS Sysops and/or IPAD owners.
  10.  
  11.      Background:
  12.  
  13.      We'd been successfully using the Planet Connect satellite system and
  14. TIGER to provide Usenet Newsgroups to our TBBS BBS for several years prior
  15. to getting our own T1 and the IPAD. But with a direct connection from the
  16. BBS to the Internet via the IPAD for Telnet in/out and other text-based
  17. Internet features we offer to our BBS users, not to mention the fact that
  18. Planet Connect long ago ran out of available cycle time to transmit
  19. anything near the entire Usenet, we were frustrated by not having a simple,
  20. fast, and efficient way to feed newsgroups into TBBS from our Usenet news
  21. server via the IPAD/LAN/T1. And of course, we wanted to avoid placing those
  22. expensive long-distance UUCP calls to Planet Connect to post outgoing
  23. Usenet articles.
  24.  
  25.      I'd been looking at all sorts of Windows-based consumer-oriented
  26. "clients" which purportedly go out and retrieve Internet stuff as directed
  27. on schedule, but none of them could then deliver Internet newsgroups in a
  28. format easily "stuffable" into the TBBS message base. It looked like
  29. massive custom-programming just to reformat incoming/outgoing Usenet
  30. articles.
  31.  
  32.      Then I stumbled across this solution.
  33.  
  34.      Voila!
  35.  
  36.      What Is It?
  37.  
  38.      First of all ... it's cheap! We're now importing/exporting newsgroups
  39. to/from TBBS for $120.00 total purchase price, no contracts, no service
  40. fees, no further expense at all. And you can actually do it for less than
  41. that. Still interested?
  42.  
  43.      This solution is "KSP-Mail", a complete Usenet Newsgroup and e-mail
  44. server software package originally designed for BBSes running on software
  45. other than TBBS, and fulltime Internet PPP connections other than the IPAD
  46. ... and yes, currently supported by its author!
  47.  
  48.      What's more, he's worked with us to adapt it to TBBS and optionally
  49. the IPAD, and the end result is frankly awesome.
  50.  
  51.      A recently added "plus" to KSP-Mail is an optional "Spam Filter" which
  52. can filter unwanted "Spam" advertising messages from your incoming e-mail.
  53. We use a similar function provided by the IPAD and thus don't need this
  54. option, but it looks like a superb solution to your BBS users' mailboxes
  55. filling up with advertising garbage.
  56.  
  57.      How does it work?
  58.  
  59.      KSP-Mail runs on a separate LAN workstation under DOS. We use the
  60. diskless '386 that previously ran our Planet Connect receiver, but KSP-Mail
  61. will happily operate on anything from an 8088 on up. It needs nothing much
  62. in terms of the computer it runs on, other than a standard IP address and
  63. TCP/IP shim (a full-time Internet connection), or alternately, a standard
  64. consumer dialup Internet account with a local Internet Service Provider
  65. which includes access to a news server. While KSP-Mail was originally
  66. designed to work with a direct full-time Internet connection and works most
  67. efficiently that way, the author of KSP-Mail has developed alternate
  68. methods for using it with a dialup account. (We haven't tried that dialup
  69. option, but we understand it does work).
  70.  
  71.      Because the IPAD is an excellent e-mail server, we don't use
  72. KSP-Mail's SMTP potential, although if you're not using the IPAD for your
  73. Internet connection, you may wish to implement that e-mail feature.
  74. Essentially, we just use its NNTP news processing functions, and since you
  75. purchase and activate each of KSP-Mail's individual features (mail in, mail
  76. out, news in, news out, time set, and remote administration) separately to
  77. order, this is an incredibly practical way to get the job done.
  78.  
  79.      KSP-Mail is easy to install and set up. You basically just follow the
  80. .DOC file that comes with it. To use the latest version with TBBS and
  81. TIGER, you simply set it up using the information below. From then on, you
  82. just watch it periodically access your local or remote news server via your
  83. IPAD or other Internet connectivity service, pull down new entries to the
  84. specific newsgroups that you want to carry on your BBS and pass them on to
  85. TIGER, post outgoing replies/articles to those newsgroups from your BBS
  86. users, and log its activities. Rather than have it "pull" articles from
  87. your news server, it can alternately be configured to accept "pushed" news.
  88. With a fulltime connection, you can also log into it for remote maintenance
  89. from anywhere on the Internet. That's it, and it works.
  90.  
  91.      Obtaining KSP-Mail:
  92.  
  93.      Call the author's BBS at: 415-364-9847. You'll find complete ordering
  94. options and instructions there.
  95.  
  96.      Or, send e-mail to the author at:dan.lewis@ksp.com.
  97.  
  98.      Using KSP-Mail with TBBS/TIGER:
  99.  
  100.      As would newsgroup delivery via a satellite system, this
  101. implementation requires the TBBS add-in software package called "TIGER".
  102. TIGER is the interface between KSP-Mail and the TBBS message base. When
  103. properly installed, KSP-Mail automatically imports and exports newsgroup
  104. articles and (optionally) e-mail via TIGER.
  105.  
  106.      Installation:
  107.  
  108.      1. This installation assumes you are already running TIGER with TBBS.
  109. If you're not, procure TIGER from its publisher: eSoft, Inc., and install
  110. TIGER as directed by its manual. It also assumes you're using a filltime
  111. direct Internet connection, as we do. Use the following TIGER.CFG file
  112. (with appropriate adjustments for your own LAN server and workstation drive
  113. letters and directory names, as well as other obvious settings unique to
  114. your own BBS):
  115.  
  116.  FILE: TIGER.CFG
  117.  
  118.  SPEED: 15
  119.  ORGANIZATION: Community Educational Services Foundation
  120.  UUCICO: internal 23
  121.  MINUTES: 1
  122.  HOST: news
  123.  DOMAIN: @glib.org
  124.  BOARD: Internet
  125.  UUCPIN: e:\uuin\
  126.  UUCPOUT: e:\uuout\
  127.  ENCLOSURE: e:\encl\
  128.  LOGFILE: e:\tbbs\logs\tiger.log
  129.  USERLOG: e:\TBBS\
  130.  TOPIC BOARD: List-Servers
  131.  MAIL LOG: ON
  132.  UUCPNAME: glib
  133.  FTPMAIL: tims.ctl
  134.  LOCALMAIL: no
  135.  SUPPRESS HEADERS: yes
  136.  TIME ZONE: -0500 Eastern
  137.  NO DIAL HOURS: 01:00 01:00
  138.  -----------
  139.  
  140.      NOTES ON TIGER.CFG:
  141.  
  142.      The above TIGER.CFG file works for us exactly as shown. I've made no
  143. changes to it which were not absolutely necessary to switch from Planet
  144. Connect to KSP-Mail, thus while some of them may be unnecessary, they work!
  145. You may find other settings which work equally well for you, but we haven't
  146. tried and cannot comment on any other than these.
  147.  
  148.      Although they may appear to be incorrect, "UUCICO" and "NO DIAL HOURS"
  149. are purposely configured as shown. With these settings, TIGER "thinks" it
  150. is doing UUCP file transfers, but cannot actually make any outgoing calls.
  151. Such news and e-mail files are instead "snatched" from TIGER's outgoing
  152. directory by KSP-Mail. You may substitute any of your TBBS line numbers in
  153. "UUCICO".
  154.  
  155.       2. Purchase at least the following KSP-Mail options (you need pay
  156. only for those you order, and you can add remote maintenance and mail
  157. in/out if you wish), and install them as directed by the KSP-Mail manual:
  158.  
  159.           NEWS IN
  160.           NEWS OUT
  161.           TIME SET
  162.  
  163.       3. Configure KSP-Mail using the following WATTCP.CFG file (with
  164. appropriate adjustments for your own LAN server and workstation drive
  165. letters and directory names and IP addresses). Only those settings used in
  166. our basic news in/out installation are shown here. URLs and IP addresses
  167. here are, of course, fictitious, and you may need to adapt or add to these
  168. settings for your own needs:
  169.  
  170. FILE: WATTCP.CFG
  171.  
  172.  ;--[ Configuration file (WATTCP.CFG) for KSP-Mail ]--------------------;
  173.  hostname=robot
  174.  domainslist=yourdomain.org
  175.  netmask=255.255.255.0
  176.  my_ip=999.999.999.9
  177.  gateway=888.888.888.8
  178.  nameserver=777.777.777.7
  179.  nameserver=666.666.6.66
  180.  nameserver=555.555.55.55
  181.  ;
  182.  ;--[ Configuration parameters to enable/disable processes ]-------------------
  183.  ;
  184.  ksp-mail.import_news_process=pulled
  185.  ;ksp-mail.import_news_process=disabled
  186.  ;
  187.  ;ksp-mail.import_mail_process=enabled
  188.  ksp-mail.import_mail_process=disabled
  189.  ksp-mail.export_news_process=enabled
  190.  ;ksp-mail.export_news_process=disabled
  191.  ;
  192.  ;ksp-mail.export_mail_process=enabled
  193.  ksp-mail.export_mail_process=disabled
  194.  ;
  195.  ksp-mail.set_clock_process=enabled
  196.  ;
  197.  ;ksp-mail.command_shell_process=disabled
  198.  ;
  199.  ;--[ Internet Mail Parameters ]-----------------------------------------------
  200.  ;
  201.  ; Required:
  202.  ;ksp-mail.esmtp_server=222.222.222.2                     ; Mail-Out (1st)
  203.  ;ksp-mail.mail_in_directory=e:\uuin
  204.  ;ksp-mail.mail_out_directory=e:\uuout
  205.  ;ksp-mail.mail_directory=f:\kspmail\in-out               ; Mail-In, Mail-Out
  206.  ;
  207.  ; Optional:
  208.  ;
  209.  ;ksp-mail.import_mail_command="uuin -s mail"            ; Mail-In
  210.  ;ksp-mail.import_mail_seconds=600                       ; Mail-In (dflt=60)
  211.  ;ksp-mail.import_mail_trigger=on_arrival                ; Mail-In
  212.  ;ksp-mail.export_mail_command="uuout -c 5"              ; Mail-Out
  213.  ;ksp-mail.export_mail_seconds=600                       ; Mail-Out (dflt=60)
  214.  ;ksp-mail.export_mail_trigger=60,c:\pcb\i-email\msgs    ; Mail-Out
  215.  ;ksp-mail.forwarding=enabled                            ; Mail-In
  216.  ;ksp-mail.esmtp_greeting="This server now supports ESMTP!"
  217.  ;ksp-mail.max_message_bytes=100000                      ; Mail-In (dflt:none)
  218.  ;ksp-mail.vrfy_program=<program_filespec>               ; Mail-In (dflt:none)
  219.  ;ksp-mail.mailing_list=<filespec>                       ; (May be repeated)
  220.  ;ksp-mail.check_recipients_at=<host.domain>             ; (May be repeated)
  221.  ;ksp-mail.uucp_from_line=disabled                       ; Mail-In (dflt:enbld)
  222.  ;
  223.  ;--[ Usenet News Parameters ]-------------------------------------------------
  224.  ;
  225.  ; Required:
  226.  ;
  227.  ksp-mail.nntp_server=999.888.77.66                      ; News server
  228.  ksp-mail.nntp_server=999.888.77.55                      ; Alternate news server
  229.  ksp-mail.news_in_directory=e:\uuin\news
  230.  ksp-mail.news_out_directory=e:\uuout
  231.  ;ksp-mail.news_directory=f:\kspmail\in-out              ; News-In, News-Out
  232.  ksp-mail.newsgroups=f:\kspmail\newsgrps.lst             ; News-In (filespec)
  233.  ksp-mail.news_hour=0-23                                 ; News-In
  234.  ksp-mail.export_news_seconds=60                         ; News-Out (dflt=60)
  235.  ;
  236.  ;
  237.  ksp-mail.import_news_command=command /K f:\kspmail\in-news.bat
  238.  ksp-mail.import_news_trigger=on_arrival                 ; News-In
  239.  ksp-mail.export_news_command=command /K e:\robot\robot.bat
  240.  ;ksp-mail.batch_news=disabled                           ; News-In
  241.  ksp-mail.news_filter=glib.org                           ; News-In
  242.  ksp-mail.max_article_days=3                             ; News-In (Pulled)
  243.  ;ksp-mail.max_article_bytes=100000                      ; News-In (dflt:none)
  244.  ksp-mail.newnews_timeout=60                             ; News-In (Pulled)
  245.  ;
  246.  ksp-mail.inbound_data_extension=.D                      ; TBBS file
  247.  ksp-mail.inbound_exec_extension=.X                      ;  name extensions
  248.  ksp-mail.outbound_data_extension=.D                     ;
  249.  ksp-mail.outbound_exec_extension=.X                     ;
  250.  ksp-mail.outbound_work_extension=.CMD                   ;
  251.  ;
  252.  ;--[ Network Time Server Parameters ]-----------------------------------------
  253.  ;
  254.  ; Required:
  255.  ;
  256.  ksp-mail.time_server=999.888.77.66                      ; Set-Clock
  257.  ksp-mail.time_server=999.888.77.55                      ; Alternate time server
  258.  ;
  259.  ; Optional:
  260.  ;
  261.  ksp-mail.set_clock_hours=24                             ; default is 24 hours
  262.  ;
  263.  ;--[ Log File Parameters (Optional) ]-----------------------------------------
  264.  ;
  265.  ksp-mail.logging=disabled                               ; default is enabled
  266.  ;ksp-mail.log_directory=f:\kspmail\logs                 ; If logs are desired
  267.  ;ksp-mail.verbose=log_files                             ; Level of detail
  268.  ;ksp-mail.log_days_newsin=1                             ; Default is 7 days
  269.  ;ksp-mail.log_days_mailin=3                             ; Default is 7 days
  270.  ;ksp-mail.log_days_newsout=5                            ; Default is 7 days
  271.  ;ksp-mail.log_days_mailout=7                            ; Default is 7 days
  272.  ;ksp-mail.log_days_setclock=7                           ; Default is 7 days
  273.  ;ksp-mail.log_days_extcmds=7                            ; Default is 7 days
  274.  ;
  275.  ;--[ Screen Display Parameters (Optional) ]-----------------------------------
  276.  ;
  277.  ksp-mail.local_bell=DISABLED                            ; On error messages
  278.  ksp-mail.verbose=on_screen                              ; Level of detail
  279.  ;ksp-mail.monitor=error                                 ; To window on error
  280.  ;ksp-mail.monitor=memory                                ; Stack & heap
  281.  ;ksp-mail.monitor=speed                                 ; Threads/second
  282.  ksp-mail.screen_saver_seconds=0                         ; Screen saver timeout
  283.  ;
  284.  ;--[ Other Parameters (Optional) ]--------------------------------------------
  285.  ;
  286.  ksp-mail.watchdog_seconds=10                            : default is 10 secs
  287.  ;
  288.  ;ksp-mail.close_timeout=10                              ; default is 10 secs
  289.  ;ksp-mail.client_timeout=200                            ; default is 300 secs
  290.  ;ksp-mail.server_timeout=600                            ; default is 300 secs
  291.  ;
  292.  ksp-mail.outbound_retry_seconds=60                      ; default is 10 mins!
  293.  ;ksp-mail.outbound_check_seconds=15                     ; default is 5 secs
  294.  ;ksp-mail.share_delay_seconds=30                        ; default is 0 seconds
  295.  ;
  296.  ;ksp-mail.sequence_file=d:\pcb\uucp\ksp-mail.seq        ; Mail-In, News-In
  297.  ;
  298.  ;ksp-mail.dont_swap_to=xms                              ; default is enabled
  299.  ;ksp-mail.dont_swap_to=ems                              ; default is enabled
  300.  ;ksp-mail.dont_swap_to=disk                             ; default is enabled
  301.  ;
  302.  ;ksp-mail.remote_management_password=pswd               ; default is no pswd
  303.  ;
  304.  ;ksp-mail.ok_filespec=<filespec>,<seconds>              ; default is 60 secs
  305.  ;ksp-mail.exit_spec=c:\ksp\ksp-exit.*,5                 ; default is 10 secs
  306.  ;
  307.  ksp-mail.retrieve_hostnames=disabled                    ; default is enabled
  308.  ksp-mail.sitename_alias=<host.domain>                   ;
  309.  -----------------------
  310.  
  311.      NOTES ON WATTCP.CFG:
  312.  
  313.      As with TIGER.CFG, these settings work for us, but you'll need to
  314. substitute your own drive/directory designations and IP numbers. You may
  315. find other settings work better for you, but these should get you started.
  316.  
  317.      Obviously, you need to define in your IPAD .NAM and .REV DNS files (or
  318. other TCP/IP control files) a unique URL and IP address for the machine on
  319. which KSP-Mail will run.
  320.  
  321.      Note that you can use KSP-Mail's remote maintenance option only if you
  322. also run a continuously functioning client such as "in-mail" or pushed
  323. news. In an application utilizing an IPAD Internet connection, "in-mail"
  324. has no other purpose, thus you may wish to forego remote maintenance if you
  325. don't really need it.
  326.  
  327.      4. If you wish, install a batch file to run after KSP-Mail retrieves
  328. your news. This one automatically maintains an updated listing of new
  329. newsgroups added to the news server you use. We make that list available
  330. through our web home page.
  331.  
  332.      NOTE: Be sure that your batch file terminates with "exit" as this one
  333. does. It is called in the configuration above by "command /K
  334. f:\kspmail\in-news.bat", thus you must "exit" that second copy of
  335. COMMAND.COM in order to return to KSP-Mail after running this batch
  336. process.
  337.  
  338.  FILE: IN-NEWS.BAT
  339.  
  340.  @echo off
  341.  rem - IN-NEWS.BAT
  342.  rem   Called by KSPMAIL after each incoming newsgroup session
  343.  
  344.  :datetime
  345.  rem - Create "DATETIME.TXT" to show most recent update
  346.  rem   ------------------------------------------------
  347.  e:
  348.  cd \uuin\news
  349.  echo >datetime.nws Most recent Usenet News update was:
  350.  e:\util\timestmp >>datetime.nws
  351.  
  352.  :newgrps
  353.  rem - Update new newsgroups listing
  354.  rem   -----------------------------
  355.  rem
  356.  if not exist f:\kspmail\groups.new goto no-newgps
  357.  e:
  358.  cd \ipad\weblite\forms
  359.  e:\util\timestmp >>newgrps.fmt
  360.  echo ------------------------------------------->> newgrps.fmt
  361.  if exist f:\kspmail\groups.srt del f:\kspmail\groups.srt
  362.  sort f:\kspmail\groups.srt
  363.  copy newgrps.fmt + f:\kspmail\groups.srt
  364.  copy newgrps.fmt + newftr.htm newgrps.htm
  365.  copy f:\kspmail\groups.new f:\kspmail\groups.bak
  366.  del f:\kspmail\groups.new
  367.  :no-newgps
  368.  
  369.  :return
  370.  rem - Return to KSP-Mail working directory
  371.  rem
  372.  f:
  373.  cd \kspmail
  374.  
  375.  :end
  376.  exit
  377.  ------------------
  378.  
  379.      "TIMESTMP" is a simple .EXE utility which generates current time and
  380. date for inclusion in a small text file ("datetime.nws") we display on the
  381. TBBS newsgroups menu to show the most recent newsgroup update date/time.
  382. Substitute any similar utility, or simply delete this function from this
  383. batch file.
  384.  
  385.      KSP-Mail maintains a file in its home directory called "groups.new"
  386. which automatically maintains a listing of all new newsgroups added to your
  387. server. The ":newgrps" procedure takes advantage of this handy feature to
  388. update a plain-text "Newly Added Newsgroups" file we offer in our web page
  389. for the convenience of our subscribers.
  390.  
  391.      Note that you can add any additional processes to IN-MAIL.BAT which
  392. you may wish to do on a periodic basis.
  393.  
  394.      KSP-Mail features a sophisticated internal scheduler which can
  395. initiate multiple events simulating a "multi-tasking" environment. Thus,
  396. the above parameter ...
  397.  
  398. "ksp-mail.export_news_command=command /K e:\robot\robot.bat"
  399.  
  400. ... periodically runs a batch file which does general housekeeping duties
  401. totally unrelated to KSP-MAIL, such as dialing out to contracted
  402. news/weather services, printing subscription and information request forms
  403. received from IPAD's forms processor, and maintaining/archiving system
  404. logs. Again, be sure to terminate any such batch file with "exit" in order
  405. to exit the second called copy of COMMAND.COM.
  406.  
  407.      OK...
  408.  
  409.      That should do it.
  410.  
  411.      This information should get you up and running, automatically
  412. importing/exporting Usenet news (and optionally e-mail) between TBBS and
  413. your Usenet News (and mail) server(s) via IPAD or any other fulltime TCP/IP
  414. Internet connection.
  415.  
  416.      This file describes the methods we used. You may find ways to
  417. significantly improve this interface, and if you do, we hope you'll share
  418. them with us, as well as any solutions to problems you've encountered that
  419. aren't mentioned here, so we can update this file to reflect those
  420. improvements.
  421.  
  422.      Should you need information configuring and/or using KSP-Mail itself,
  423. please contact the author of that program. You can reach him at his e-mail
  424. address: dan.lewis@ksp.com, or via his BBS at: 415-364-9847.
  425.  
  426.      The author also runs a KSP-Mail Internet Mailing List. You may wish to
  427. ask him to add you to it.
  428.  
  429.      Should you need additional information specifically regarding using
  430. KSP-Mail with TBBS and the IPAD, I'll be glad to try to expand upon these
  431. instructions, limited only by my own experience as detailed here.
  432.  
  433.      Jon Larimore
  434.      Sysop, GLIB
  435.      Systems Administrator, ZZAPP! Internet Services
  436.      (jon@zzapp.org)
  437.