home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / 311ABETA.ZIP / readme.txt < prev   
Text File  |  2003-12-07  |  8KB  |  193 lines
  1. /* Synchronet BBS for Win32 v3.11 Revision A Beta Release */
  2.  
  3. (The Pearl Harbor release)
  4.  
  5. This is an UPGRADE ONLY
  6. ~~~~~~~~~~~~~~~~~~~~~~~
  7. You must have Synchronet v3.1x (any revision) installed prior to upgrading to
  8. v3.11 beta. This release includes all previous updates, patches, etc. as of 
  9. December 7th, 2003.
  10.  
  11. This is a RELEASE CANDIDATE
  12. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  13. If there are no show-stopper bugs, this release will become the final official
  14. release of 3.11 (packaged as a full-install without the "beta" label
  15. obviously), so if you find any new bugs or old bugs that were supposed to
  16. have been fixed, please let us know as soon as possible.
  17.  
  18. INSTALLATION INSTRUCTIONS
  19. ~~~~~~~~~~~~~~~~~~~~~~~~~
  20. 1. Shut-down Synchronet if its running.
  21.  
  22. 2. Back-up all of your Synchronet files (this is a BETA release).
  23.  
  24.    This upgrade may overwrite files you've modified, so be sure to BACK-UP
  25.    any files you've modified (and want to keep) from the CTRL and EXEC
  26.    directories.
  27.  
  28.    NOTE:
  29.    If you have modified any of the stock JavaScript (*.js) or Baja (*.src)
  30.    files in your EXEC directory, you should move those files into a
  31.    "mods" directory (protecting them from being over-written by future
  32.    updates and upgrades, including this one) and specify the path to this
  33.    directory in SCFG->System->Advanced Options->Mods Directory
  34.    (Example: "../mods"). Synchronet will search this directory for any
  35.    modules (*.js or *.bin) to be executed before searching the EXEC
  36.    directory.
  37.  
  38. 3. Unzip EXEC.ZIP into your EXEC directory, overwriting existing files.
  39.  
  40.    NOTE: You must use a 32-bit unzip utility (e.g. WinZip) to get the correct
  41.          filenames!
  42.  
  43.    New/updated JavaScript and Baja modules you might be interested in:
  44.  
  45.    dyndns.js
  46.      The yourbbs.synchro.net Dynamic DNS client, see http://www.synchro.net
  47.      for details.
  48.  
  49.    typehtml.js
  50.      Displays an HTML document (in monochrome or color) for Telnet/Rlogin
  51.      clients (replaces typehtml.bin).
  52.  
  53.    ircd*.js
  54.      Cyan's Synchronet IRC Daemon (uses irclib.js). See docs/ircd.txt for
  55.      details.
  56.  
  57.    irc.js
  58.      Deuce's IRC client (updated).
  59.  
  60.    newslink.js
  61.      Updated NewsLink (NNTP gateway) module.
  62.  
  63.    mailproc_example.js
  64.      Example external mail processor (uses mailproc_util.js) for Synchronet
  65.      SMTP Mail Server. This could be the basis for a list server, mail
  66.      responder, content filter, file requester, whatever you want.
  67.  
  68.    playtone.js
  69.      New .ton file player for Synchronet written in 100% JavaScript
  70.      (replaces tone.exe).
  71.  
  72.    mlistgate.js
  73.      Mailing list gateway module (timed event). Sends any newly posted
  74.      messages in a specific sub-board to a specified list server
  75.      (written for Hausmaus).
  76.  
  77.    chat_sec.src/bin
  78.      Updated chat section module, allows user to choose which IRC server
  79.      to connect to (defaults to #synchronet at irc.synchro.net).
  80.  
  81.    New/Updated executables you might be interested in:
  82.  
  83.    sexyz.exe
  84.      An early preview of a new 32-bit socket X/Y/Zmodem file transfer
  85.      program (sorry, no docs - support downloads only currently).
  86.  
  87.    ans2asc.exe and asc2ans.exe
  88.      32-bit utilities replacing ans2msg.exe nad msg2ans.exe (same
  89.      functionality).
  90.  
  91.    sbbsNTsvcs.exe
  92.      Synchronet NT services. See docs/sbbsNTsvcs.txt for details.
  93.  
  94.    JSexec.exe
  95.      New program to execute Synchronet JavaScript modules externally from
  96.      Synchronet. Can be used to execute Synchronet .js files as web server
  97.      CGI scripts, external services/servers (e.g. ircd.js), and much more.
  98.  
  99.    fixsmb.exe
  100.      v2.0 of this utility now retains message numbers while reconstructing
  101.      message base files, making it much more useful for restoring corrupted
  102.      sub-boards.
  103.  
  104. 4. Unzip DOCS.ZIP into your DOCS directory, overwriting existing files.
  105.  
  106.    v311_new.html
  107.      Detailed list of all the changes made since v3.10L (the last official
  108.      Synchronet release).
  109.  
  110.    v311_jsnew.html
  111.      List of JavaScript methods and properties added or modified in v3.11.
  112.      For the complete object model documentation, see jsobjs.html.
  113.  
  114.    jsobjs.html
  115.      Complete details on the JavaScript object model. Most new/updated
  116.      methods or properties are designated as version "3.11".
  117.  
  118.    sbbsNTsvcs.txt
  119.      Instructions on running Synchronet as a set of NT Services on Microsoft
  120.      Windows NT based operating systems (i.e. Windows NT, 2000, XP, 2003).
  121.  
  122.    ircd.txt
  123.      Instructions on the new Synchronet IRC Daemon (written in 100%
  124.      JavaScript), the foundation of the new irc.synchro.net IRC network.
  125.  
  126. 5. Unzip CTRL.ZIP into your CTRL directory, choosing which files to
  127.    overwrite (if any).
  128.  
  129.    sbbs.ini
  130.      If you've modified your ctrl/sbbs.ini file, you probably do not want
  131.      to overwrite it. This updated default initialization file contains new
  132.      options and is easier to read and modify.
  133.  
  134.    text.dat
  135.      This file contains the majority of "built-in" text that is displayed
  136.      to BBS users logged into the Telnet/RLogin server.
  137.      As of v3.10 Revision E, there are REQUIRED ctrl/text.dat changes:
  138.      Either copy the included text.dat to your ctrl directory or see
  139.      text310g.dif for the required changes. If you see <UNUSED> anywhere
  140.      while logged in, you're using the WRONG TEXT.DAT FILE!!!
  141.  
  142.    services.ini 
  143.      This is the new format services configuration file, replacing or
  144.      augmenting services.cfg. Synchronet will read both the old services.cfg
  145.      and the new file and ignore any duplicate services (configured in both
  146.      files). If you've made *no* modifications to your ctrl/service.cfg file,
  147.      you can safely delete it as the stock services.ini file (included in this
  148.      package) has all the same services configured, plus the new IRC Daemon
  149.      service, and it's much easier to read and modify.
  150.  
  151.    mailproc.cfg
  152.      The external mail process support in the Synchronet SMTP Mail Server
  153.      is much more powerful now as it can run native JavaScript processors
  154.      (see exec/mailproc_example.js for details). If you've made any 
  155.      modifications to your mailproc.cfg file, then you probably do *not* want
  156.      to overwrite it with the stock file included in this package. This
  157.      updated file includes documentation about the newest features to support
  158.      external mail processors (SPAM/content filters, mailing lists, etc).
  159.  
  160.    sockopts.cfg
  161.      This updated default socket options configuration file now disables the
  162.      TCP "nagle algorithm" since the Synchronet Telnet Server now controls its
  163.      own packet buffering to optimize through-put to Telnet/RLogin users. This
  164.      file now supports advanced options like "REUSEADDR 1" to allow address/port
  165.      re-use when binding sockets.
  166.  
  167.    dns_blacklist.cfg
  168.      The default DNS Blacklist configuration file in v3.00-v3.10 included
  169.      relays.osirusoft.com (run by Joe Jared) which has since started erroneously
  170.      reporting EVERY IP address as a blacklisted server, causing EVERY e-mail to
  171.      be flagged as SPAM or rejected (depending on the configuration). This
  172.      updated DNS Blacklist configuration file removes relays.osirusoft.org and
  173.      adds several other (working) DNS blacklist servers.
  174.  
  175.    ircd.conf
  176.      This is the Synchronet IRC Daemon (exec/ircd.js) configuratoin file. See
  177.      docs/ircd.txt for details.     
  178.  
  179.  
  180. Please report any bugs in one of the Synchronet-related discussion groups
  181. (see http://synchro.net/docs/support.html for details), please include
  182. detailed instructions on how to reproduce the bug and exactly what the error
  183. messages or other symptoms are.
  184.  
  185. Thanks for the bug reports, keep 'em coming!
  186.  
  187. -Rob
  188.  
  189. P.S. Please DO NOT redistribute alpha or beta versions of Synchronet as they 
  190. are very short-term releases and I don't want them to remain "in the wild" for
  191. extended periods of time. - Thanks.
  192.  
  193. /* End of file */