home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / sidis100.zip / SIDIS.DOC < prev   
Text File  |  1996-05-31  |  31KB  |  646 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │                                                                            │
  3. │       SIDIS/2 - Small Internet Dial-In Server Package for OS/2             │
  4. │                          - Version 1.0 -                                   │
  5. │                                                                            │
  6. │                      D o c u m e n t a t i o n                             │
  7. │                                                                            │
  8. │       (C) 1996 Axel Mueller                                                │
  9. │       Email:             amueller@stargate.rz.fh-offenburg.de              │
  10. │       Official FTP site: ftp://stargate.rz.fh-offenburg.de/sidis           │
  11. └────────────────────────────────────────────────────────────────────────────┘
  12.  
  13.    As you already may guess this software package is designed to give people
  14.    access to a LAN or the Internet via a LAN connected PC and up to 4 modems.
  15.    My SIDIS/2 equipped machine currently serves 2x 28,8 kB modems (Creatix)
  16.    and 2x 19,2 kB modems (ZyXel) with high throughput rates even with 4
  17.    simultanous PPP sessions.
  18.    SIDIS/2 has grown over the last 1 1/2 years out of the need to provide
  19.    efficient and reliable Internet access for students (I'm one of them) of
  20.    our local campus.
  21.  
  22.    The SIDIS/2 package contains programms for 2 major fields:
  23.  
  24.     - EMAIL SERVICES (mail sorting program, POP3 server, mail processor)
  25.  
  26.     - MODEM SERVICES (modem control, user access control)
  27.  
  28.  
  29.  
  30. ┌────────────────────────────────────────────────────────────────────────────┐
  31. │                                                                            │
  32. │ Content                                                                    │
  33. │                                                                            │
  34. └────────────────────────────────────────────────────────────────────────────┘
  35.  
  36.                 1.      Legal stuff
  37.                 2.      Features
  38.                 3.      System requirements
  39.                 4.      Network structure
  40.                 5.      General Installation
  41.                 5.1     Installation of Email Services
  42.                 5.1.1   SENDMAIL setup for use with SIDIS/2
  43.                 5.1.2   Setting up the automatic mail processor
  44.                 5.1.3   Adapting TCP/IP
  45.                 5.2     Installation of Modem Services
  46.                 5.2.1   Work-around for routing bug in PPP.EXE
  47.                 6.      Client login scripts for OS/2, Win 3.1, Win 95
  48.                 7.      Conclusion
  49.  
  50.  
  51. ┌────────────────────────────────────────────────────────────────────────────┐
  52. │                                                                            │
  53. │ 1. Legal stuff                                                             │
  54. │                                                                            │
  55. └────────────────────────────────────────────────────────────────────────────┘
  56.  
  57.        IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS.            
  58.                                                                                 
  59.        Under no circumstances I am liable for any of the following:           
  60.                                                                                 
  61.        1. third-party claims against you for losses or damages;                 
  62.        2. loss of, or damage to, your records or data; or                       
  63.        3. economic consequential damages (including lost profits or             
  64.           savings) or incidental damages                                        
  65.                                                                                 
  66.        I do not warrant uninterrupted or error free operation of the           
  67.        Program. I have no obligation to provide service, defect                
  68.        correction, or any maintenance for the Program. I have no               
  69.        obligation to supply any Program updates or enhancements to you          
  70.        even if such are or later become available.                              
  71.                                                                                 
  72.        THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE               
  73.        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A                  
  74.        PARTICULAR PURPOSE.                                                      
  75.                                                                                 
  76.  
  77.  
  78. ┌────────────────────────────────────────────────────────────────────────────┐
  79. │                                                                            │
  80. │ 2. Features                                                                │
  81. │                                                                            │
  82. └────────────────────────────────────────────────────────────────────────────┘
  83.  
  84. ALL PROGRAMMS
  85.  
  86.    - ONE user database (\MPTN\ETC\USER.INI)
  87.    - Passwords stored encrypted in user database
  88.    - extensive user information stored in user database
  89.    - all programms operate in VIO mode meaning that they can be exectuted in
  90.      telnet sessions
  91.  
  92.  
  93. \TCPIP\BIN\MAIL.EXE - sorts incoming mail in user mailboxes (mail directories)
  94.  
  95.    - stores mails encrypted
  96.    - uses semaphores in order to ensure unique assignment of mails
  97.      (can handle 2 different mails arriving at exactly the same time for the
  98.       same user)
  99.    - mail forwarding; a forward address can be specified for each user
  100.      (using ACCOUNTS.EXE) which will cause each incoming mail to be forwared
  101.      immediately. The incoming mail can be kept (COPY FORWARD) or
  102.      deleted (FORWARD).
  103.    - loop detection for mail forward; each mail forwarded will get a header 
  104.      attached to it for information of the receipent and to prevent a mail loop
  105.    - automatic mail processor; if a mail for a special user ("system" or any 
  106.      specified alias) arrives, a special program (e.g. "mailproc.cmd" included
  107.      in the SIDIS/2 archive) can process this mail and send out a response
  108.      email immediately
  109.    - a maximum encryption size can be defined to avoid system overload
  110.      (using ACCOUNTS.EXE)
  111.    - maximum disk space allocatation by emails can be defined as default for
  112.      all users or user specific (or both). If a email arrives which would
  113.      exceed this disk space limit it would be rejected
  114.    - produces detailed log file in \TCPIP\ETC\MAIL.LOG
  115.  
  116.  
  117. \TCPIP\BIN\POP3D.EXE - POP3 server
  118.  
  119.    - supports all POP3 commands and extented POP3 commands (except APOP)
  120.    - uses semaphores for user mailbox locking while POP3 session is active
  121.    - decrypt mails before transmission
  122.    - supports INET server
  123.    - very robust - no problems with mailbox containing more than 1.000 mails
  124.      or with very large mails
  125.    - produces detailed log file in \TCPIP\ETC\POP3D.LOG
  126.  
  127.  
  128. \USERCTRL\MAILPROC.CMD - automatic mail processor
  129.  
  130.    - implemented as REXX script and therefore highly configurable
  131.    - "help" mail as resonse to mails with incorrect syntax or to help
  132.      requests
  133.    - users can maintain their passwords and mail forward settings themselves
  134.    - produces detailed log file in \TCPIP\ETC\MAILPROC.LOG
  135.    - already implemented features:
  136.       * help
  137.       * change_password
  138.       * forward_mail     (activate forward of all arriving emails)
  139.       * forward_copy     (activate forward of a copy of all arriving emails)
  140.       * stop_forward
  141.  
  142.  
  143. \USERCTRL\USERCTRL.CMD - modem control/user access control for dial-in users
  144.  
  145.    - implemented as REXX script and therefore highly configurable
  146.    - this script runs once for each modem connected
  147.    - produces detailed log file and connection log file in the directory
  148.      specified in the ONLINELOGDIR environment variable
  149.  
  150.  
  151. \USERCTRL\MONTHTOT.CMD - calculate total on-line time of last month
  152.  
  153.    - implemented as REXX script
  154.    - run this script at the beginning of each new month to get the
  155.      total on-line time of last month (per modem and all modems)
  156.  
  157.  
  158. \USERCTRL\RXPRF.DLL - provides user database access functions from REXX
  159.  
  160.     - used by mail processor (\USERCTRL\MAILPROC.CMD)
  161.     - used by modem control script (\USERCTRL\USERCTRL.CMD)
  162.  
  163.  
  164. \USERCTRL\RXIOCTL.DLL - provides asyncronous I/O functions from REXX
  165.  
  166.     - used by modem control script (\USERCTRL\USERCTRL.CMD)
  167.  
  168.  
  169. \USERCTRL\REG_DLLS.CMD - registers functions RXPRF.DLL
  170.  
  171. \USERCTRL\SREG.EXE - Shareware registration utility. You will need this
  172.                      utility together with the registration key to "brand"
  173.                      your SIDIS/2 as registered.
  174.  
  175.  
  176.  
  177. ┌────────────────────────────────────────────────────────────────────────────┐
  178. │                                                                            │
  179. │ 3. System requirements                                                     │
  180. │                                                                            │
  181. └────────────────────────────────────────────────────────────────────────────┘
  182.  
  183.    - Hardware suggestion:
  184.       * 486-DX40 with 16 MB RAM
  185.       * I/O card which can assign a unique IRQ to each COM port
  186.    - OS/2 Warp Connect 
  187.          * or *
  188.      OS/2 Warp Server   
  189.          * or *
  190.      OS/2 Warp + TCP/IP 2.0 + CSD UN64092
  191.    - PPP.EXE
  192.    - HPFS is *HIGHLY* recommended (otherwise the length of usernames is
  193.      restricted to 8 characters (You may try FAT but it was not tested !)
  194.  
  195.  
  196.  
  197. ┌────────────────────────────────────────────────────────────────────────────┐
  198. │                                                                            │
  199. │ 4. Network structure                                                       │
  200. │                                                                            │
  201. └────────────────────────────────────────────────────────────────────────────┘
  202.  
  203.  
  204. <--------------- DOMAIN: modem-domain.com ----------------------------------->
  205.  
  206. ┌─────────────────┐                                          LAN
  207. │ remote "host1"  │                                         (Net xxx.yyy.zzz)
  208. │ xxx.yyy.zzz.11  │-Modem--(Telephon network)--Modem1---.      ---
  209. └─────────────────┘                                     |       |
  210.                                                         |       | 
  211. ┌─────────────────┐                                     |       |
  212. │ remote "host2"  │                                     |       |
  213. │ xxx.yyy.zzz.12  │-Modem--(Telephon network)--Modem2-. |       |
  214. └─────────────────┘                                   | |       |
  215.                                                       | '-┌──────────────────┐
  216.                                                       '---│ "modem-host"     │
  217.                                                       .---│ xxx.yyy.zzz.10   │
  218.                                                       | .-│ Ethernet Address │
  219. ┌─────────────────┐                                   | | │ 00:00:C0:04:F7:37│
  220. │ remote "host3"  │                                   | | │                  │
  221. │ xxx.yyy.zzz.13  │-Modem--(Telephon network)--Modem3-' | └──────────────────┘
  222. └─────────────────┘                                     |       |
  223.                                                         |       |
  224. ┌─────────────────┐                                     |  ┌─────────────────┐
  225. │ remote "host4"  │                                     |  │ default router  │
  226. │ xxx.yyy.zzz.14  │-Modem--(Telephon network)--Modem4---'  │ xxx.yyy.zzz.254 │
  227. └─────────────────┘                                        └─────────────────┘
  228.                                                                 |
  229.                                                                 '---<INTERNET>
  230.  
  231.  
  232. ┌────────────────────────────────────────────────────────────────────────────┐
  233. │                                                                            │
  234. │ 5. General Installation                                                    │
  235. │                                                                            │
  236. └────────────────────────────────────────────────────────────────────────────┘
  237.  
  238.    1. Copy SIDIS*.ZIP to a directory different from root directory.
  239.  
  240.    2. If you extract the files from the archive the following files and
  241.       directories will be created:
  242.  
  243.        \SIDIS.DOC
  244.        \MPTN\BIN\SETUP.CMD
  245.        \MPTN\BIN\STRTINET.CMD
  246.        \MPTN\BIN\STRTSEMA.CMD
  247.        \MPTN\BIN\TCPSTART.CMD
  248.        \MPTN\ETC\ALIASES
  249.        \MPTN\ETC\PPP1.CFG
  250.        \MPTN\ETC\PPP2.CFG
  251.        \MPTN\ETC\PPP3.CFG
  252.        \MPTN\ETC\PPP4.CFG
  253.        \MPTN\ETC\SENDMAIL.CF
  254.        \SCIPT\SIDISOS2.RSP
  255.        \SCIPT\SIDISW3.CMD
  256.        \SCIPT\SIDISW95.SCP
  257.        \TCPIP\BIN\MAIL.EXE
  258.        \TCPIP\BIN\POP3D.EXE
  259.        \USERCTRL\ACCOUNTS.EXE
  260.        \USERCTRL\MAILPROC.CMD
  261.        \USERCTRL\MONTHTOT.CMD
  262.        \USERCTRL\REESTAB.CMD
  263.        \USERCTRL\REG_DLLS.CMD
  264.        \USERCTRL\RXIOCTL.DLL
  265.        \USERCTRL\RXPRF.DLL
  266.        \USERCTRL\SREG.EXE
  267.        \USERCTRL\UC1.CMD
  268.        \USERCTRL\UC2.CMD
  269.        \USERCTRL\UC3.CMD
  270.        \USERCTRL\UC4.CMD
  271.        \USERCTRL\USERCTRL.CMD
  272.        \USERCTRL\WELCOME.MSG
  273.  
  274.    3. The directory structure above already suggests the necessary placement
  275.       of the files within those directories. It may happen that a file with
  276.       the same name already exists in the specified directory. In this case
  277.       you have to migrate the files provided in the SIDIS/2 archive into the
  278.       already existing files (this goes not for SENDMAIL.CF).
  279.  
  280.       *** NOTE ***
  281.       This directory structure assumes that you have OS/2 Warp Connect
  282.       or OS/2 Warp Server installed. If you are using OS/2 Warp with TCP/IP 2.0
  283.       you have to place the files from \MPTN\BIN into the \TCPIP\BIN directory
  284.       and the files from \MPTN\ETC into the \TCPIP\ETC directory.
  285.  
  286.    4. Add C:\USERCTRL (change drive letter if necessary) to your PATH and
  287.       LIBPATH in CONFIG.SYS.
  288.  
  289.    5. add the following lines to CONFIG.SYS:
  290.         SET HOSTNAME=myHostname
  291.         SET MAILDIR=C:\MAIL                 REM needed for email services
  292.         SET MODEMNUMBER=4                   REM needed for modem services
  293.         SET ONLINELOGDIR=C:\USERCTRL\LOG    REM needed for modem services
  294.  
  295.       MAILDIR is the base directory under which the user mail directories will
  296.       be created, e.g. if you create the user "spiderman" the directory
  297.       C:\MAIL\SPIDERMAN will be created automatically.
  298.       MODEMNUMBER is the number of modems installed (on my machine there are
  299.       4 modems installed)    
  300.       ONLINELOGDIR is the directory, where the log files of the modem
  301.       activities are located.
  302.  
  303.       HOSTNAME should have been already set by TCP/IP installation process
  304.       andis absolutely needed as well as ETC and TMP.
  305.  
  306.    6. Before you can use modem services or email services you have to
  307.       create users using ACCOUNTS.EXE:
  308.  
  309.        accounts -a <user> <password> <Real name of user>
  310.  
  311.       Username and password are used for email services and modem services.
  312.  
  313.  
  314.       *** Example ***
  315.  
  316.        accounts -a smith topsecret Robert Smith
  317.  
  318.       This will create an account for Robert Smith with login ID "smith"
  319.       and password "topsecret".
  320.       You will get a confirmation of the newly created user:
  321.  
  322.        SIDIS/2 Accounts - User & program administration   v0.99/May 16 1996
  323.        (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  324.        User smith created.
  325.        New password for user smith has been assigned.
  326.        Mail directory C:\MAIL\smith was created.
  327.  
  328.    7. Make sure your domain and your domain name server (DNS) is specified
  329.       correctly in the \MPTN\ETC\RESOLV file:
  330.  
  331.       *** Example ***
  332.  
  333.         domain modem-domain.com
  334.         nameserver 123.456.789.987
  335.  
  336.  
  337.  
  338. ┌────────────────────────────────────────────────────────────────────────────┐
  339. │                                                                            │
  340. │ 5.1 Installation of Email Services                                         │
  341. │                                                                            │
  342. └────────────────────────────────────────────────────────────────────────────┘
  343.  
  344.      ┌───────────────────────────────────────────────┐
  345.      │ 5.1.1 SENDMAIL setup for use with SIDIS/2     │
  346.      └───────────────────────────────────────────────┘
  347.  
  348.    1. If you have SENDMAIL already running you can continue with step 10.
  349.  
  350.    2. If you want to set up SENDMAIL you cannot use Ultimedia Mail/2 anymore
  351.       since it uses SENDMAIL for sending its mails. However there are much
  352.       better email programs like PMMail or Post Road Mailer.
  353.  
  354.    3. You have to modify the SENDMAIL.CF file included in the SIDIS/2 archive
  355.       as follows (editor must preserve TABS - use E.EXE/don't use EPM!!!):
  356.  
  357.    4. a) Look for a line starting with "Dw" (without the ").
  358.       b) Put your hostname there e.g. "Dwmodem-host"
  359.  
  360.    5. a) Look for a line starting with "Cw" (without the ").
  361.       b) Put your hostname there e.g. "Cwmodem-host"
  362.  
  363.    6. a) Look for a line starting with "DD" (without the ").
  364.       b) Put your domain name there e.g. "DDmodem-domain.com"
  365.  
  366.    7. a) Look for a line starting with "DR" (without the ").
  367.       b) Put your mail relay host there e.g. "DRmail-relay.modem-domain.com"
  368.  
  369.    8. a) Look for a line starting with "OA" (without the ").
  370.       b) Specify the path to your ALIASES file here
  371.          e.g. "OAc:\mptn\etc\aliases"
  372.  
  373.    9. a) Look for a line starting with "OQ" (without the ").
  374.       b) Specify the directory where the mails are queued for transmission
  375.          e.g. "OQc:\mptn\etc\mqueue"
  376.  
  377.   10. a) Look for a line starting with "Mlocal" (without the ").
  378.       b) Change the line as follows (without the "):
  379.          "Mlocal, P=c:\tcpip\bin\mail.exe, F=lnsDFMP,  S=10, R=20, A=c:\mail $u $f"
  380.          Change drive letters if necessary. The Argument "A=c:\mail" specifies
  381.          the base directory for mailboxes (which must be the same directory as
  382.          specified in the MAILDIR variable in CONFIG.SYS)
  383.  
  384.  
  385.      ┌───────────────────────────────────────────────┐
  386.      │ 5.1.2 Setting up the automatic mail processor │
  387.      └───────────────────────────────────────────────┘
  388.  
  389.    1. The mail processor will be invoked for all mails received for 
  390.       "system@modem-host.modem-domain.com". Hoever you can set up an
  391.       alias for the mail processor in order to have a more user friendly
  392.       name for it:
  393.       e.g. "mail-processor@modem-host.modem-domain.com" or
  394.            "mp@modem-host.modem-domain.com".
  395.       Those two aliases are already set up in the \MPTN\ETC\ALIASES file
  396.       included in the SIDIS/2 archive. You can change them if you want to.
  397.  
  398.    2. Use ACCOUNTS.EXE with the following syntax to define your mail processor:
  399.  
  400.        accounts -m [<user> <name> <program> <subject>]
  401.  
  402.       user     has to be one of the aliases defined in the \MPTN\ETC\ALIASES
  403.                file e.g. "mail-processor" - without the "
  404.       name     this is the name most email programs will display instead of
  405.                the email address of the sender.
  406.                e.g. "Mail-Processor" - without the "
  407.       program  is the program which does the mail processing. If you are not
  408.                going to write your own mail processor you should use the one
  409.                included with the SIDIS/2 archive.
  410.                e.g. "c:\userctrl\mailproc.cmd" - without the "
  411.       subject  is the subject line of all response emails generated by the
  412.                mail processor.
  413.                e.g. "Response for request" - without the "
  414.  
  415.       If you want to remove the definition in order to deactivate the mail
  416.       processor just type "accounts -m".
  417.  
  418.    *** Example ***
  419.  
  420.         "accounts -m mail-processor Mail-Processor c:\userctrl\mailproc.cmd
  421.         Response for Request"
  422.         (this is ONE command! You only press RETURN after you have
  423.          typed "...Request")
  424.  
  425.       You will get a confirmation of the (new) mail processor settings:
  426.  
  427.        SIDIS/2 Accounts - User & program administration   v0.99/May 16 1996
  428.        (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  429.        Mail processor defined.
  430.        User:    mail-processor
  431.        Name:    Mail-Processor
  432.        Subject: Response for request
  433.        Path and file name: c:\userctrl\mailproc.cmd
  434.  
  435.    3. Now you can test the mail processor. Simply send a email to
  436.       "mail-processor" with "help" as subject of this email. 
  437.       If you do not get a response email from the mail processor (should be
  438.       within 30 seconds) you should have a look at the log file of the mail
  439.       processor (\MPTN\ETC\MAILPROC.LOG) or of MAIL.EXE (\MPTN\ETC\MAIL.LOG).
  440.  
  441.       You can also test the mail processor which runs on my machine.
  442.       Send an email to "mail-processor@stargate.rz.fh-offenburg.de"
  443.       with subject "help" and you should get the response email soon.
  444.  
  445.  
  446.      ┌───────────────────────────────────────────────┐
  447.      │ 5.1.3 Adapting TCP/IP                         │
  448.      └───────────────────────────────────────────────┘
  449.  
  450.    1. To reduce system load I would suggest that you run the POP3 server
  451.       together with the INET server. By doing so the POP3 server will only
  452.       be started if actually someone wants POP3 services.
  453.       Therefore you should create or modify the file \MPTN\ETC\INETD.LST
  454.       as follows:
  455.          pop3 tcp c:\tcpip\bin\pop3d.exe
  456.       (change drive letter if necessary)
  457.  
  458.       UnREM the line "call strtinet.cmd" in \MPTN\BIN\TCPSTART.CMD if you
  459.       want the INET server to be started.
  460.  
  461.    2. UnREM the line "call strtsema.cmd" in \MPTN\BIN\TCPSTART.CMD in order
  462.       to start SENDMAIL.
  463.  
  464.    3. Make sure that the service POP3 is defined correctly in the
  465.       \MPTN\ETC\SERVICES files. There should be a line beginning with:
  466.          pop3            110/tcp
  467.  
  468.  
  469.    *** NOTE ***
  470.    POP clients must specify "SMTP" (not "POP3"!) for sending emails.
  471.  
  472.    Sending/Receiving emails should work at this state if you have set up
  473.    things as described in 5.1.1 - 5.1.3.
  474.  
  475.  
  476.      ┌───────────────────────────────────────────────┐
  477.      │ 5.1.4 Options                                 │
  478.      └───────────────────────────────────────────────┘
  479.  
  480.    1. You can set limits for maximum disk space allocation by emails for all
  481.       users ("accounts -sd) and/or for specific users
  482.       (e.g. "accounts -sd 600" AND "accounts -s smith 2000" will give all
  483.       user 600 KB available for storing mails but will give 2 MB for the
  484.       mailbox of user "smith").
  485.  
  486.    2. You can set a maximum mail size above which mails will not be stored
  487.       encrypted ion order to reduce system load
  488.       (e.g. "accounts -e 20" will cause all mails bigger than 20 KB to be
  489.       stored not encrypted).
  490.  
  491.  
  492.  
  493. ┌────────────────────────────────────────────────────────────────────────────┐
  494. │                                                                            │
  495. │ 5.2 Installation of Modem Services                                         │
  496. │                                                                            │
  497. └────────────────────────────────────────────────────────────────────────────┘
  498.  
  499.  
  500.    1. Before you start setting up software for modem services you should
  501.       set up your modem(s). You have to set up your modem to NO ECHO
  502.       (ATE0) and store this setting in the modem CMOS (try AT&W).
  503.       All other settings will be set by USERCTRL.CMD during modem
  504.       initialisation.
  505.  
  506.    2. Verify that a COM port driver is installed and that every COM port
  507.       has been set to a unique IRQ which you must tell to the COM port
  508.       driver:
  509.  
  510.        DEVICE=C:\OS2\BOOT\COM.SYS (1,3F8,4) (2,2F8,3) (3,3E8,11) (4,2E8,12)
  511.  
  512.       As you can see I'm using COM.SYS provided by IBM. You don't have to
  513.       use special COM drivers (like SIO.SYS) if you use 4 modems.
  514.  
  515.    3. Verify that your COM ports are set to the correct speed. I set the
  516.       COM port parameters in CONFIG.SYS as follows:
  517.  
  518.        CALL=C:\OS2\MODE.COM COM1:57600,N,8,1,TO=OFF,XON=OFF,OCTS=ON,RTS=HS,
  519.              DTR=ON,IDSR=OFF,ODSR=OFF,BUFFER=ON
  520.        CALL=C:\OS2\MODE.COM COM2:57600,N,8,1,TO=OFF,XON=OFF,OCTS=ON,RTS=HS,
  521.              DTR=ON,IDSR=OFF,ODSR=OFF,BUFFER=ON
  522.        CALL=C:\OS2\MODE.COM COM3:57600,N,8,1,TO=OFF,XON=OFF,OCTS=ON,RTS=HS,
  523.              DTR=ON,IDSR=OFF,ODSR=OFF,BUFFER=ON
  524.        CALL=C:\OS2\MODE.COM COM4:57600,N,8,1,TO=OFF,XON=OFF,OCTS=ON,RTS=HS,
  525.              DTR=ON,IDSR=OFF,ODSR=OFF,BUFFER=ON
  526.  
  527.       Note that in CONFIG.SYS all parameters has to be in the same line as
  528.       the CALL command the belong to. (not like shown above)
  529.  
  530.    4. Create the log file directory specified in the ONLINELOGDIR environment
  531.       variable (e.g. C:\USERCTRL\LOG)
  532.  
  533.    5. Modify \USERCTRL\UC1.CMD, UC2.CMD, UC3.CMD, UC4.CMD:
  534.       Change the drive and path to USERCTRL.CMD if necessary.
  535.  
  536.    6. Modify \MPTN\BIN\TCPSTART.CMD:
  537.       UnREM as many of the "call uc1", "call uc2" lines, as you have modems
  538.       installed. Note that UC1.CMD serves COM1, UC2.CMD serves COM2, ...
  539.  
  540.    7. Modify \MPTN\BIN\SETUP.CMD:
  541.       Replace IP numbers like xxx.yyy.zzz.??? with your unique IP numbers.
  542.       Use the the sketch "Network structure" (chapter 4) for an overview.
  543.  
  544.       UnREM as many of the "arp -s ..." lines, as you have modems installed.
  545.       Replace "00:00:C0:04:F7:37" with the ethernet address of the network
  546.       adapter of your modem host.
  547.  
  548.    8. Configure PPP1.CFG (used by modem connected to COM1), PPP2.CFG
  549.       (used by modem connected to COM1), ...
  550.       Replace IP numbers like xxx.yyy.zzz.??? with your unique IP numbers.
  551.       Use the the sketch "Network structure" (chapter 4) for an overview.
  552.  
  553.    9. Modify the modem user login screen (\USERCTRL\WELCOME.MSG) to your needs
  554.       Keep the "$" character in the last line which marks the end of the file!
  555.  
  556.  
  557.      ┌───────────────────────────────────────────────┐
  558.      │ 5.2.1 Work-around for routing bug in PPP.EXE  │
  559.      └───────────────────────────────────────────────┘
  560.  
  561.    Unfortunately there is a routing bug in PPP.EXE since it went "gamma"
  562.    (2 years ago). Obviously IBM is testing PPP.EXE only with one single
  563.    PPP connection at a time. The bug only becomes visible if you have
  564.    mutliple simultanous PPP sessions. In this case it may happen that
  565.    the routing table entry for one already active PPP session will be
  566.    removed if another PPP session starts. The modem link will still be up
  567.    but there is no TCP/IP connection to the network (and even to the modem
  568.    server) anymore. I have informed IBM Corp. in the USA but they told me
  569.    the IBM Germany is responsible. For the latter I was not able to locate
  570.    somebody I could report this bug to. That's the way thing will improve
  571.    soon ...
  572.    Anyway - I have implemented a "small & dirty" work-around which is
  573.    better than loosing your network connection from time to time.
  574.    You will need two programs called "netstat.exe" and "ifconfig.exe"
  575.    which are part of TCP/IP, Warp Connect and Warp Server. They already
  576.    should be in the PATH.
  577.    Some seconds before a new PPP.EXE will be started, the modem control
  578.    script (\USERCTRL\USERCTRL.CMD) will start "netstat.exe" and will 
  579.    redirect the output (the routing table) to a file. Afterwards it will
  580.    start another another script (\USERCTRL\REESTAB.CMD) which will wait for 
  581.    5 seconds (during this time the new PPP.EXE will have been established)
  582.    and then re-configure the PPP interfaces (according to the routing table
  583.    from the file) that were in existence before the new PPP.EXE was started.
  584.    The REESTAB.CMD script will only be started if somebody dials in and there
  585.    is already one or more active PPP sessions.
  586.  
  587.  
  588.  
  589. ┌────────────────────────────────────────────────────────────────────────────┐
  590. │                                                                            │
  591. │ 6. Client login scipts for OS/2, Windows 3.1, Windows 95                   │
  592. │                                                                            │
  593. └────────────────────────────────────────────────────────────────────────────┘
  594.  
  595.  
  596.    At our local campus we have dial-in users using OS/2, Windows 3.1 or 
  597.    Windows 95. For an efficient time-saving login procedure it is important
  598.    to use a script for dial-in. Therefore I have included the scripts the
  599.    students of our local campus use for dial-in into our SIDIS/2 OS/2 machine.
  600.  
  601.    *** OS/2 *** (script file: sidisos2.rsp)
  602.    You should get a copy of PPPDIAL.CMD (available on many FTP servers as
  603.    PPDIAL28.ZIP - featuring automatic redial if line is busy) and create a
  604.    new provider in the DIAL OTHER INTERNET PROVIDERS notebook.
  605.    Enter the Login ID and password an check the "required" box.
  606.    In the Phone number field you can specify different phone numbers.
  607.    These numbers will be dialed one after another if a line is busy (if
  608.    telephone system will not put the dialer automatically through to the
  609.    next available line).
  610.    In the login sequence multiple line entry field you should specify
  611.    "pppdial.cmd c:\mptn\etc\sidisos2.rsp" (change drive and directory if
  612.    necessary). Make sure PPPDIAL.CMD is in a directory included in your
  613.    PATH statement. All other settings in the notebook should be obviously.
  614.  
  615.    *** Windows 3.1x *** (script file: sidisw3.cmd)
  616.    This script is for use with Trumpet WinSock. Just copy it to the
  617.    directory where your Trumpet WinSock resides.
  618.  
  619.    *** Windows 95 *** (script file: sidisw95.scp)
  620.    This script has to be used with the DIAL UP NETWORK. I know that it works
  621.    but I don't know how (since I do not use Windows 95).
  622.  
  623.  
  624.  
  625. ┌────────────────────────────────────────────────────────────────────────────┐
  626. │                                                                            │
  627. │ 7. Conclusion                                                              │
  628. │                                                                            │
  629. └────────────────────────────────────────────────────────────────────────────┘
  630.  
  631. It is always difficult to explain things one is familiar with to others 
  632. unfamiliar with it. I rewrote this documentation according to feedback I've
  633. got from beta testers of SIDIS/2. There may still be some missing or
  634. misunderstandable information.
  635. The easiest and fast ways to overcome this problem is to drop me an email.
  636. I regulary monitor the Internet news group comp.os.os2.networking.tcp-ip as
  637. well.
  638.  
  639. Keep in mind - I have to rely on the feedback I get ;-))
  640.  
  641.  
  642. Axel Mueller
  643. amueller@stargate.rz.fh-offenburg.de
  644.  
  645. 05/31/96
  646.