home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / OFFLINE / THUB20.ZIP / TRIHUB.DOC < prev    next >
Text File  |  1993-09-16  |  12KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                    TriHub 2.0
  8.            A QWK Networking Program for Streamlining Network Transfers
  9.                       Copyright (c) 1993 By Mark D. Goodwin
  10.  
  11.      TriHub 2.0 is distributed as a shareware  program.  You can freely use
  12.      TriHub for  30  days  in order  to  evaluate its  usefulness.    After
  13.      TriHub's 30 day  evaluation period, you must register it.  The current
  14.      registration  fee  for  TriHub  is   $25.00.    Please  see  the  file
  15.      REGISTER.DOC that is included in  the TriHub archive for details about
  16.      registering TriHub.
  17.  
  18.  
  19.      Why TriHub?
  20.      ===========
  21.  
  22.      Although a TriBBS board can serve as a hub on a QWK-based network with
  23.      TriMail, TriHub  can greatly  reduce the costs  incurred by  the nodes
  24.      that pull from  your hub by moving  the majority of the  mail handling
  25.      activities offline.  TriMail requires the caller to wait while it puts
  26.      together a QWK packet and to wait while it processes incoming messages
  27.      in a REP packet.  TriHub performs both of  these activities completely
  28.      offline.    Therefore,  the only  time  a node  spends  online  is for
  29.      performing the actual file transfers.
  30.  
  31.  
  32.      Getting Started With TriHub
  33.      ===========================
  34.  
  35.      The first step in  setting up TriHub is to create a  directory for it.
  36.      Let's assume you chose to setup the directory as C:\TRIHUB and that C:
  37.      is your current drive.  You would use the following command  to create
  38.      the directory on your C: drive:
  39.  
  40.      md \trihub
  41.  
  42.      Next copy  the three TriHub  EXE files (CONFIG.EXE,  MAKEQWKS.EXE, and
  43.      TRIHUB.EXE) into the TriHub directory with the following command:
  44.  
  45.      copy *.exe \trihub
  46.  
  47.      Next change to  the TriHub directory and run  the TriHub Configuration
  48.      program with the following two commands:
  49.  
  50.      cd \trihub
  51.      config
  52.  
  53.  
  54.      The TriHub Configuration Program
  55.      ================================
  56.  
  57.      The TriHub configuration program features  a single pulldown menu: the
  58.      "Configure" menu.   The  "Configure" menu is  pulled down  by pressing
  59.      <ALT><C> and offers the following four options:
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      System
  74.      Accounts
  75.      About TriHub
  76.      Exit TriHub
  77.  
  78.  
  79.      Configuring the System
  80.      ----------------------
  81.  
  82.      The TriHub system is configured by either pressing <S>  in response to
  83.      the "Configure"  menu or  by moving the  menu's highlight  bar to  the
  84.      "System" option and pressing <ENTER>.
  85.  
  86.      After  selecting the "System"  option, the configuration  program will
  87.      open  a dialog  box that allows  you to  set the following  two system
  88.      parameters:
  89.  
  90.      Main TriBBS Directory
  91.      The Hub's QWK Name
  92.  
  93.      If, for example, your main TriBBS directory is C:\TRIBBS  and the name
  94.      you use  for your  board's QWK packets  is LOBSTER,  you would  simply
  95.      enter these values in the appropriate data entry field.
  96.  
  97.      Note that  you can use  the following  control keys when  entering the
  98.      system information:
  99.  
  100.           =================================================================
  101.           Control Key    Action
  102.           -----------------------------------------------------------------
  103.           <ENTER>        Move down to the next data entry field.
  104.           <TAB>          Move down to the next data entry field.
  105.           <DOWN ARROW>   Move down to the next data entry field.
  106.           <SHIFT><TAB>   Move up to the previous data entry field.
  107.           <UP ARROW>     Move up to the previous data entry field.
  108.           <F10>          Close the dialog box.
  109.           =================================================================
  110.  
  111.  
  112.      Configuring the Accounts
  113.      ------------------------
  114.  
  115.      Next you  must let TriHub know what accounts  will be using the TriHub
  116.      door  for mail  transfers.    The accounts  are  configured by  either
  117.      pressing <A>  in response  to the  "Configure" menu or  by moving  the
  118.      menu's highlight bar to the "Accounts" option and pressing <ENTER>.
  119.  
  120.      After  selecting the "Accounts" option, the configuration program will
  121.      open a dialog box that allows you to specify up  to 200 account names.
  122.      You should note that all account names must be entered exactly as they
  123.      are recorded in the user's TriBBS record.
  124.  
  125.      IMPORTANT: Be sure  that you have given  all users that will  be using
  126.      TriHub netstatus  by setting the  "QWK Mail Network Node"  to "Yes" in
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      their TriBBS record.  Without this set properly, they will not be able
  140.      to download private message or enter messages from another person.
  141.  
  142.      Note  that you can  use the following  control keys  when entering the
  143.      account information.
  144.  
  145.           =================================================================
  146.           Control Key    Action
  147.           -----------------------------------------------------------------
  148.           <ENTER>        Move down to the next data entry field.
  149.           <TAB>          Move down to the next data entry field.
  150.           <DOWN ARROW>   Move down to the next data entry field.
  151.           <SHIFT><TAB>   Move up to the previous data entry field.
  152.           <UP ARROW>     Move up to the previous data entry field.
  153.           <PG DN>        Move to the next ten accounts.
  154.           <PG UP>        Move to the previous ten accounts.
  155.           <DEL>          Delete the  account in the highlighted  data entry
  156.                          field.
  157.           <F10>          Close the dialog box.
  158.           =================================================================
  159.  
  160.  
  161.      Other Configuration Program Options
  162.      -----------------------------------
  163.  
  164.      If you want to see a dialog box  containing TriHub's copyright notice,
  165.      you can press <T> in response to the "Configure" menu or by moving the
  166.      menu's  highlight  bar  to  the "About  TriHub"  option  and  pressing
  167.      <ENTER>.
  168.  
  169.      If you want  to exit the configuration  program, you can press  <E> in
  170.      response to the "Configure" menu or by moving the menu's highlight bar
  171.      to the "Exit TriHub" option and pressing <ENTER>.
  172.  
  173.  
  174.      Generating QWK Packets
  175.      ======================
  176.  
  177.      As the  above  introduction  stated,  all QWK  packets  are  generated
  178.      offline  by  TriHub.    The  particular  program  that  performs  this
  179.      operation is  called MakeQWKs  and is run  with the  following command
  180.      line:
  181.  
  182.      MAKEQWKS
  183.  
  184.      IMPORTANT:  Be sure  that you  have configured  the TriHub  system and
  185.      accounts  with   the  TriHub  configuration  program   before  running
  186.      MakeQWKs.
  187.  
  188.      When you run MakeQWKs, it will generate  a QWK packet for each account
  189.      that has been  setup for TriHub.   If there is an  existing QWK packet
  190.      for an account, MakeQWKs will simply  append any new messages onto the
  191.      end of the existing QWK packet.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      When Should You Run MakeQWKs
  206.      ----------------------------
  207.  
  208.      MakeQWKs should be run at least once a day in an event file.  However,
  209.      there is no reason  why it can't be run more often.   For example, you
  210.      may want to test  for the zero-byte file POSTED,  which TriBBS creates
  211.      for  each  caller  if  the  caller  has  posted  a  message,  in  your
  212.      BETWEEN.BAT file  and run MakeQWKs if  POSTED exists.  If  you require
  213.      all network nodes to use TriHub, you could just run MakeQWKs after the
  214.      TriHub door is run.
  215.  
  216.  
  217.      The TriHub Door
  218.      ===============
  219.  
  220.      The  TriHub Door is  used by the  network nodes to  perform the actual
  221.      mail  transfers.   You  can  add TriHub  to  your Door  menu  with the
  222.      following line in your DOORS.MNU file:
  223.  
  224.      T,TriHub,TRIHUB,10
  225.  
  226.      The above line tells TriBBS  to generate TRIBBS.SYS, use a description
  227.      of  TriHub in  the  Door  menu, run  the  batch file  "TRIHUB.BAT"  or
  228.      "TRIHUB", and set the door's minimum security level to 10.
  229.  
  230.  
  231.      The Door's Batch File
  232.      ---------------------
  233.  
  234.      The next step is to create the door's batch file.  The following is an
  235.      example or a TriHub batch file:
  236.  
  237.      cd \trihub
  238.      trihub thub1.cfg
  239.      cd \tribbs
  240.      board
  241.  
  242.      The following is a line-by-line description of the above batch file:
  243.  
  244.      cd \trihub               <- Change to the door's directory
  245.      trihub thub1.cfg         <- Run TriHub and specify the configuration
  246.                               <- file
  247.      cd \tribbs               <- Change back to TriBBS's directory
  248.      board                    <- Run TriBBS again
  249.  
  250.  
  251.      Modifying THUB1.CFG
  252.      -------------------
  253.  
  254.      The next  step is to modify THUB1.CFG to meet your board's needs.  The
  255.      following is a sample THUB1.CFG file:
  256.  
  257.      TRIBBS
  258.      C:\TRIBBS
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.      The Lobster Buoy
  272.      Mark Goodwin
  273.      38400
  274.      C:\TRIBBS
  275.      C:\TRIBBS
  276.      LOBSTER
  277.  
  278.      The following is a line-by-line description of THUB1.CFG:
  279.  
  280.      TRIBBS                   <- The door uses TRIBBS.SYS
  281.      C:\TRIBBS                <- The directory where TRIBBS.SYS is located
  282.      The Lobster Buoy         <- The board's name
  283.      Mark Goodwin             <- The sysop's name
  284.      0                        <- The board's locked baud rate or 0 for not
  285.                               <- locked
  286.      C:\TRIBBS                <- The board's main directory
  287.      C:\TRIBBS                <- The node's main directory
  288.      LOBSTER                  <- The board's QWK id
  289.  
  290.  
  291.      Nonstandard IRQs
  292.      ----------------
  293.  
  294.      TriHub supports nonstandard IRQs.   If a nonstandard IRQ is being used
  295.      with your  board, you simply specify  the IRQ number being  used after
  296.      the TriHub configuration file's name  in the TriMail batch file.   The
  297.      following  example shows  how the  above  TriHub batch  file could  be
  298.      modified so that TriHub will use IRQ 5:
  299.  
  300.      cd \trihub
  301.      trihub thub1.cfg 5
  302.      cd \tribbs
  303.      board
  304.  
  305.  
  306.      Multinodes
  307.      ----------
  308.  
  309.      TriHub supports multinode TriBBS systems.   You must create a separate
  310.      configuration  file for  each node.   Node  1's configuration  file is
  311.      TriMail's  normal THUB1.CFG,  node 2's  configuration  file should  be
  312.      named THUB2.CFG, etc.  Be sure  to specify the correct batch file  for
  313.      each node's door batch file.
  314.  
  315.  
  316.      Archiver and File Transfer Protocol
  317.      -----------------------------------
  318.  
  319.      TriHub uses PKWare's  PKZIP program for file compression.   Therefore,
  320.      the files PKZIP.EXE and PKUNZIP.EXE must be in your DOS PATH.
  321.  
  322.      TriHub  uses  HS/Link  for performing  bidirectional  file  transfers.
  323.      Therefore, the file  HSLINK.EXE must be in  your DOS PATH.   Because I
  324.      wanted TriHub to provide as much efficiency as possible,  I decided to
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.      choose  HS/Link as  the  protocol  driver because  of  its ability  to
  338.      perform bidirectional file transfers.
  339.  
  340.      IMPORTANT: If you are using a HS/Link configuration file, be sure that
  341.      you do not set a transfer directory or TriHub may not be able to  find
  342.      the files during file transfers.
  343.  
  344.      IMPORTANT: Both PKZIP and HS/Link  are shareware programs and I highly
  345.      encourage  you to  register  them  as  per  their  respective  license
  346.      agreements.
  347.  
  348.  
  349.      Running TriHub at Logon
  350.      -----------------------
  351.  
  352.      In order  to let  your users go  directly into  the TriHub  door after
  353.      logging on, you can  set up a security-specific batch file  to run the
  354.      door.   For example, on The Lobster  Buoy I assign all  TriHub users a
  355.      security level  of 62  and use  the following  security-specific batch
  356.      file called SEC62.BAT:
  357.  
  358.      cd \trihub
  359.      trihub thub1.cfg
  360.      cd \tribbs
  361.      board
  362.  
  363.      Note that this is the same as the above door batch file.
  364.  
  365.  
  366.      Support
  367.      =======
  368.  
  369.      If you have any  problems installing or  using TriHub, you can  obtain
  370.      support by calling The Lobster Buoy at 207-941-0805.
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.