home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / adialin1.zip / ADIALIN.DOC < prev    next >
Text File  |  1996-10-04  |  34KB  |  690 lines
  1. ┌────────────────────────────────────────────────────────────────────────────┐
  2. │                                                                            │
  3. │               aDialIn - Dial-in server package for OS/2                    │
  4. │                          - Version 1.10 -                                  │
  5. │                                                                            │
  6. │                      *** S H A R E W A R E ***                             │
  7. │                                                                            │
  8. │                      D o c u m e n t a t i o n                             │
  9. │                                                                            │
  10. │       (C) 1996 Axel Mueller                                                │
  11. │       Email:             amueller@stargate.rz.fh-offenburg.de              │
  12. │       Official FTP site: ftp://stargate.rz.fh-offenburg.de/aDialIn         │
  13. └────────────────────────────────────────────────────────────────────────────┘
  14.  
  15.    The aDialIn package contains all dial-in services of the SIDIS/2 package
  16.    which I introduced 3 months ago. The SIDIS/2 package also contained
  17.    email services now available as aPOP3d package. (APOP3D??.ZIP)
  18.    While both packages will stay compatible to each other they are more easy
  19.    to set up.
  20.  
  21.  
  22. ┌────────────────────────────────────────────────────────────────────────────┐
  23. │                                                                            │
  24. │ Content                                                                    │
  25. │                                                                            │
  26. └────────────────────────────────────────────────────────────────────────────┘
  27.  
  28.                 1.      Legal stuff
  29.                 2.      Files included in this package
  30.                 3.      Features
  31.                 4.      System requirements
  32.                 5.      General Installation
  33.                 6.      User and programm administration (ACCOUNTS.EXE)
  34.                 7.      Client login scipts for OS/2, Windows 3.1, Windows 95/NT
  35.                 8.      Conclusion
  36.        APPENDIX A       Network structure
  37.        APPENDIX B       Work-around for routing bug in PPP.EXE
  38.  
  39.  
  40.  
  41.  
  42. ┌────────────────────────────────────────────────────────────────────────────┐
  43. │                                                                            │
  44. │ 1. Legal stuff                                                             │
  45. │                                                                            │
  46. └────────────────────────────────────────────────────────────────────────────┘
  47.  
  48.        IF YOU DOWNLOAD OR USE THIS PROGRAM YOU AGREE TO THESE TERMS.
  49.  
  50.        Under no circumstances am I liable for any of the following:
  51.  
  52.        1. third-party claims against you for losses or damages;
  53.        2. loss of, or damage to, your records or data; or
  54.        3. economic consequential damages (including lost profits or
  55.           savings) or incidental damages
  56.  
  57.        I do not warrant uninterrupted or error free operation of the
  58.        Program. I have no obligation to provide service, defect
  59.        correction, or any maintenance for the Program. I have no
  60.        obligation to supply any Program updates or enhancements to you
  61.        even if such are or later become available.
  62.  
  63.        THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE
  64.        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  65.        PARTICULAR PURPOSE.
  66.  
  67.  
  68.  
  69. ┌────────────────────────────────────────────────────────────────────────────┐
  70. │                                                                            │
  71. │ 2. Files included in this package                                          │
  72. │                                                                            │
  73. └────────────────────────────────────────────────────────────────────────────┘
  74.  
  75.    ACCOUNTS.EXE   user & programm administration
  76.    ADIALOS2.RSP   Response script for OS/2 based dial-in client
  77.    ADIALW3.CMD    Response script for Windwos 3.x based dial-in client
  78.    ADIALW95.SCP   Response script for Windows 95/NT based dial-in client
  79.    ASHARED.DLL    central module used by all EXEs/DLLs of aPOP3d package
  80.    MONTHTOT.CMD   calculate total monthly on-line for each modem
  81.    PPP1.CFG       PPP configuration file for modem 1
  82.    PPP2.CFG       PPP configuration file for modem 2
  83.    PPP3.CFG       PPP configuration file for modem 3
  84.    PPP4.CFG       PPP configuration file for modem 4
  85.    REESTAB.CMD    work-around for routing table bug in PPP.EXE
  86.                   (explained in APPENDIX B)
  87.    RXIOCTL.CMD    script for registration of RXIOCTL.DLL functions
  88.    RXIOCTL.DLL    provision of REXX functions for asyncronous I/O
  89.    RXPRF.CMD      script for registration of RXPRF.DLL functions
  90.    RXPRF.DLL      provision of REXX functions for user database access
  91.    SWREG.EXE      shareware registration utility
  92.    UC1.CMD        activate modem 1
  93.    UC2.CMD        activate modem 2
  94.    UC3.CMD        activate modem 3
  95.    UC4.CMD        activate modem 4
  96.    USERCTRL.CMD   modem control script
  97.    USERCTRL.INI   configuration file for modem control script
  98.    WAITXS.CMD     REXX script causes the session to sleep for X seconds
  99.    WELCOME.MSG    sample file for modem login message
  100.  
  101.  
  102. ┌────────────────────────────────────────────────────────────────────────────┐
  103. │                                                                            │
  104. │ 3. Features                                                                │
  105. │                                                                            │
  106. └────────────────────────────────────────────────────────────────────────────┘
  107.  
  108.    - central user database (USER.INI) for all user- and program-relevant
  109.      information
  110.    - user administration compatible with aPOP3d package (email server)
  111.    - uses PPP protocol (PPP.EXE not included in this package)
  112.    - supports as many modems as PPP.EXE does (up to 10)
  113.    - modem control implemented as REXX script and therefore highly configurable
  114.      (script runs once for each modem connected)
  115.    - user administration tool provides a lot of information about users
  116.    - tool for calculation of total on-line time for past month included
  117.  
  118.    The aDialIn package has been used on a daily basis to provide efficient
  119.    and reliable Internet access to about 70 students (including myself).
  120.    Even using a not-state-of-the-art 486-DX/2-66 with 16 MB it serves
  121.    4 high speed modems (2x 28,8 kB, 2x 19,2 kB) well at high throughput
  122.    rates even with 4 simultanous PPP sessions.
  123.  
  124.  
  125.  
  126. ┌────────────────────────────────────────────────────────────────────────────┐
  127. │                                                                            │
  128. │ 4. System requirements                                                     │
  129. │                                                                            │
  130. └────────────────────────────────────────────────────────────────────────────┘
  131.  
  132.    - Hardware suggestion: 486-DX/2-66 with 16 MB RAM
  133.    - OS/2 Merlin
  134.          * or *
  135.      OS/2 Warp Connect
  136.          * or *
  137.      OS/2 Warp Server
  138.          * or *
  139.      OS/2 Warp + TCP/IP 2.0 + CSD UN64092
  140.    - HPFS is *HIGHLY* recommended (otherwise the length of usernames is
  141.      restricted to 8 characters. FAT has not been tested!)
  142.  
  143.  
  144.  
  145. ┌────────────────────────────────────────────────────────────────────────────┐
  146. │                                                                            │
  147. │ 5. General Installation                                                    │
  148. │                                                                            │
  149. └────────────────────────────────────────────────────────────────────────────┘
  150.  
  151.    1. Use the following hints to place the files included in this package in
  152.       the correct directories:
  153.  
  154.       ACCOUNTS.EXE   a directory in your PATH      (recommended: \TCPIP\BIN)
  155.       ASHARED.DLL    a directory in your LIBPATH   (recommended: \TCPIP\DLL)
  156.       MONTHTOT.CMD   same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  157.       PPP1.CFG       directory defined in ETC variable
  158.                      You may try "echo %ETC%" to check where your ETC
  159.                      variable points to
  160.       PPP2.CFG       "
  161.       PPP3.CFG       "
  162.       PPP4.CFG       "
  163.       REESTAB.CMD    same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  164.       RXIOCTL.CMD    a directory in your PATH      (recommended: \TCPIP\BIN)
  165.       RXIOCTL.DLL    a directory in your LIBPATH   (recommended: \TCPIP\DLL)
  166.       RXPRF.CMD      a directory in your PATH      (recommended: \TCPIP\BIN)
  167.       RXPRF.DLL      a directory in your LIBPATH   (recommended: \TCPIP\DLL)
  168.       SWREG.EXE      a directory in your PATH      (recommended: \TCPIP\BIN)
  169.       UC1.CMD        same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  170.       UC2.CMD        same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  171.       UC3.CMD        same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  172.       UC4.CMD        same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  173.       USERCTRL.CMD   directory defined in USERCTRLDIR variable
  174.                      You may try "echo %USERCTRLDIR%" to check where your
  175.                      USERCTRLDIR variable points to (see Chapter 5.2)
  176.       USERCTRL.INI   same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  177.       WAITXS.CMD     a directory in your PATH      (recommended: \TCPIP\BIN)
  178.       WELCOME.MSG    same diretory as USERCTRL.CMD (recommended: \USERCTRL)
  179.  
  180.    2. Make sure that the following environment variables are set in
  181.       CONFIG.SYS:
  182.  
  183.         SET ETC=c:\mptn\etc
  184.  
  185.         The ETC variable is most likely already set. If this is the case
  186.         you don't have to change it.
  187.  
  188.  
  189.         SET USERCTRLDIR=C:\USERCTRL
  190.  
  191.         The USERCTRLDIR variable defines the directory for the main
  192.         components of this package.
  193.  
  194.  
  195.         SET MAILDIR=C:\MAIL
  196.  
  197.         This definition is only needed if you also have the aPOP3d package
  198.         installed and want to let the users know the mailbox count during
  199.         the modem login stage.
  200.         The MAILDIR variable points to the base mail directory under which
  201.         all the user mail directories (mailboxes) will be created.
  202.         Make sure that this directory exists; otherwise no user mail
  203.         directories can be created.
  204.  
  205.    3. Verify that a COM port driver is installed and that every COM port
  206.       has been set to a unique IRQ which you must tell to the COM port
  207.       driver:
  208.  
  209.        DEVICE=C:\OS2\BOOT\COM.SYS (1,3F8,4) (2,2F8,3) (3,3E8,11) (4,2E8,12)
  210.  
  211.       As you can see I'm using COM.SYS provided by IBM. You don't have to
  212.       use special COM drivers (like SIO.SYS) if you use 4 modems.
  213.  
  214.    4. Verify that every COM ports is set to the correct speed. I set the
  215.       COM port parameters in CONFIG.SYS as follows:
  216.  
  217.        CALL=C:\OS2\MODE.COM COM1:57600,N,8,1,TO=OFF,XON=OFF,OCTS=ON,RTS=HS,
  218.              DTR=ON,IDSR=OFF,ODSR=OFF,BUFFER=ON
  219.  
  220.       Note that in CONFIG.SYS all parameters have to be in the same line as
  221.       the CALL command belongs to. (not as shown above)
  222.  
  223.    5. Each of the REXX scripts for modem control (USERCTRL.CMD) runs in
  224.       a session of CMD.EXE. This makes it difficult to know which modem
  225.       is served by which session (e.g. if you want to kill one of the sessions
  226.       only). To overcome this you simply have to create unique copies of
  227.       CMD.EXE. To do this type at the OS/2 prompt, while you are in the \OS2
  228.       directory:
  229.          copy cmd.exe cmd1.exe
  230.          copy cmd.exe cmd2.exe
  231.          copy cmd.exe cmd3.exe
  232.          copy cmd.exe cmd4.exe
  233.       The digit in the filename indicates the COM port to which the modem
  234.       is connected, e.g. if you have only 2 modems on COM3 and COM4 you will
  235.       need CMD3.EXE and CMD4.EXE which will be started respectively by UC3.CMD
  236.       and UC4.CMD.
  237.  
  238.    6. Before you can use the main REXX script for modem control the DLLs
  239.       needed by the script have to be registered. This is done by RxPRF.CMD
  240.       and RxIOCTL which should be called once during startup, e.g. by
  241.       putting the lines "call RxPRF.CMD" and "call RxIOCTL.CMD" in STARTUP.CMD
  242.       on your boot drive. If you also want to start-up modem control from
  243.       STARTUP.CMD, during boot-up, then for a machine with 3 modems connected
  244.       your STARTUP.CMD should include this:
  245.  
  246.          REM Register DLLs ...
  247.          call rxprf.cmd
  248.          call waitXs 2
  249.          call rxioctl.cmd
  250.          call waitXs 2
  251.          cd c:\userctrl
  252.          REM Start control for modem 1 ...
  253.          call uc1.cmd
  254.          call waitXs 2
  255.          REM Start control for modem 2 ...
  256.          call uc2.cmd
  257.          call waitXs 2
  258.          REM Start control for modem 3 ...
  259.          call uc3.cmd
  260.  
  261.     7. There is a configuration file USERCTRL.INI in the directory where
  262.        your USERCTRLDIR variable points to. In contains a number of parameters
  263.        used to adapt the aDialIn package to your preferences:
  264.  
  265.           LogPath           = c:\userctrl\log
  266.  
  267.              This directory will contain all the log files produced.
  268.              Make sure that this directory exists; otherwise no log files can
  269.              be created.
  270.  
  271.           FirstModemCOM     = 1
  272.  
  273.              This is the COM port where your first modem is connected to.
  274.  
  275.           LastModemCOM     = 4
  276.  
  277.              This is the COM port where your last modem is connected to.
  278.  
  279.           ModemInitString   = ATZQ0V1S0=0S3=13S4=10S7=60S10=7
  280.  
  281.              This is the init string to initialize the modems.
  282.              Note that you have to set up your modem to NO ECHO (e.g. ATE0)
  283.              and store this setting in the modem CMOS (e.g. AT&W).
  284.  
  285.           WelcomeFile       = welcome.msg
  286.  
  287.              The content of this file will be sent to the peer right after
  288.              the modem connect. In this file you may use $DATE$ and $TIME$
  289.              as macros which will be replaced by current values during
  290.              transmission.
  291.              You should adapt the content of this file for your preferences.
  292.  
  293.           ShowWelcomeScreen = 1
  294.  
  295.              Toggles transmission of WelcomeFile ON (1) or OFF (0).
  296.  
  297.           ShowLastLogin     = 1
  298.  
  299.              Toggles transmission of last login date during the login stage
  300.              ON (1) or OFF (0).
  301.  
  302.           ShowMailboxStatus = 1
  303.  
  304.              Toggles transmission of users mailbox count during the login
  305.              stage ON (1) or OFF (0).
  306.              This feature is designed for use with the aPOP3d package which
  307.              acts as a email server.
  308.  
  309.           ShowLineUsage     = 1
  310.  
  311.              Toggles transmission of names of current users of other modem
  312.              lines on this system during the login stage ON (1) or OFF (0).
  313.  
  314.           PPPWorkAround     = 1
  315.  
  316.              Use work-around for routing table bug in PPP.EXE which is
  317.              explained in APPENDIX B.
  318.  
  319.    8. Since the dial-up machine isn't connected directly to the ethernet all
  320.       other machines on this ethernet have to know how to reach the dial-up
  321.       host. This will be done by pulishing an ARP (Address resolution protocol)
  322.       entry. There has to be one entry for each dial-up host (which equals the
  323.       number of modems installed on the dial-in server). A good place for the
  324.       appropriate commands is TCPEXIT.CMD which you should create or append to
  325.       in the \TCPIP\BIN directory.
  326.       The ARP command is followed by the parameter "-s", then the IP
  327.       number of the dial-up host, next comes the ethernet address of
  328.       the dial-in server's ethernet adaptor and finally the "pub" parameter
  329.       is required.
  330.       If you have 4 modems and IP numbers according to the NETWORK STRUCTURE
  331.       sketch in APPENDIX A, your TCPEXIT.CMD might look like this:
  332.  
  333.          REM Add arp entries for remote hosts (via modem connected)
  334.          arp -s 111.222.333.11 00:00:C0:04:F7:37 pub
  335.          arp -s 111.222.333.12 00:00:C0:04:F7:37 pub
  336.          arp -s 111.222.333.13 00:00:C0:04:F7:37 pub
  337.          arp -s 111.222.333.14 00:00:C0:04:F7:37 pub
  338.  
  339.       Make sure that there is either no "ipgate" statement or an "ipgate=on"
  340.       statement in \TCPIP\BIN\TCPSTART.CMD. Using "ipgate=off" the dial-in
  341.       server will not gate any IP packets to the dial-up machine!
  342.  
  343.    9. Depending on the number of modems installed on your dial-in server
  344.       you have to configure the appropriate PPP config file e.g. PPP1.CFG
  345.       for the modem connected to COM1, PPP2.CFG for the modem connected to
  346.       COM2 etc..
  347.       Only line 3 of each of the configuration files needs changing.
  348.       Line 3 should have IP number of you dial-in server, then a colon,
  349.       followed by the IP number of your dial-up machine (the same
  350.       IP number as you have put in your TCPEXIT.CMD before in order to
  351.       publish an ARP entry for).
  352.       Again you should have a look at the NETWORK STRUCTURE sketch in
  353.       APPENDIX A to get a clearer picture.
  354.  
  355.  
  356.  
  357. ┌────────────────────────────────────────────────────────────────────────────┐
  358. │                                                                            │
  359. │ 6. User and programm administration (ACCOUNTS.EXE)                         │
  360. │                                                                            │
  361. └────────────────────────────────────────────────────────────────────────────┘
  362.  
  363.    Before any user can dial ina record for this user has to be created.
  364.  
  365.    If you type "accounts" without any parameters (or wrong parameters)
  366.    a syntax description will be displayed:
  367.  
  368.    ------------------------------------------------------------------------------
  369.    H:\Dev>accounts
  370.  
  371.    aCCOUNTS - User administration for aPOP3d and aDialIn   v1.10/Sep  8 1996
  372.    (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  373.    === Usage: ===================================================================
  374.    -a  <user> <password> <Real name>      -l[m[a|c|f|j|n|o|p|r|s|t|u]]
  375.    -d  <user>                             -m  [<user> <name> <program> <subject>]
  376.    -ds                                    -n <user> [subject]
  377.    -e  [size]                             -p  <user> <password>
  378.    -f  <user> [forward address]           -r  <user>
  379.    -fc <user> [forward address]           -s  <user> [size]
  380.    -i                                     -sd [size]
  381.    -l[d[a|l|n|t|r|u]
  382.    === Explanation: =============================================================
  383.    -a  add user   -d  display user record   -ds  display settings   -e  set
  384.    encryption size   -f  activate mail forward   -fc  activate copy forward
  385.    -i  display registration information   -ld  list dial-in related information
  386.    of all users;  display: dAys since last login, Numbered list, on-line time of
  387.    Last month, Total on-line time, Real name, Username   -lm  list Mail related
  388.    information of all users; display: Age of mails, mailbox Count, Forward address,
  389.    notification subJect, Numbered list, forward cOunt, days since last Pop3 check,
  390.    Real name, mailbox Size, notification counT, Username  (only one UPPER letter=
  391.    sort criteria; following "-" will cause reverse order)   -m  define mail
  392.    processor   -n  activate sender notification   -p  assign password to user
  393.    -r  remove user   -s  set max mailbox size   -sd  set max mailbox size default
  394.    ------------------------------------------------------------------------------
  395.  
  396.  
  397.    ┌─────────────────────────────────────────────────────────┐
  398.    │ Add user record                                         │
  399.    └─────────────────────────────────────────────────────────┘
  400.  
  401.    accounts -a <user> <password> <Real name>
  402.  
  403.       Note that the username "system" is reserved for the mail processor
  404.       of the aPOP3d package.
  405.  
  406.       <user>
  407.          ... Username the user will be assigned
  408.              This also determines the email address of the user to
  409.              "user@hostname.domainname" in the aPOP3d package.
  410.       <password>
  411.          ... Password is used to authenticate user during modem login
  412.              and also for email retrieval via POP3.  It must contain
  413.              only digits and letters (no spaces etc.)
  414.              Note that the password is case sensitive!
  415.       <Real Name>
  416.          ... This is the real name of the user. There may be spaces between
  417.              first, middle and last name.
  418.  
  419.       You will get a confirmation of the newly created user:
  420.  
  421.    ------------------------------------------------------------------------------
  422.    H:\Dev>accounts -a smith terraX Robert Smith
  423.  
  424.    aCCOUNTS - User administration for aPOP3d and aDialIn   v1.10/Sep  8 1996
  425.    (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  426.    User smith created.
  427.    New password for user smith has been assigned.
  428.    ------------------------------------------------------------------------------
  429.  
  430.  
  431.    ┌─────────────────────────────────────────────────────────┐
  432.    │ Display user record                                     │
  433.    └─────────────────────────────────────────────────────────┘
  434.  
  435.    accounts -d <user>
  436.  
  437.       <user>
  438.          ... Username the user the record should be displayed for
  439.  
  440.    ------------------------------------------------------------------------------
  441.    H:\Dev>accounts -d smith
  442.  
  443.    aCCOUNTS - User administration for aPOP3d and aDialIn   v1.10/Sep  8 1996
  444.    (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  445.    *** User record per 12.08.1996 13:01:01 ***
  446.    GENERAL
  447.       User:                      Robert Smith  (smith)
  448.       Record created:            08.04.1996 22:33:31
  449.       Last password change:      08.04.1996 22:33:32
  450.    DIAL IN
  451.       First/last login:          09.04.1996 17:10:07 / 25.09.1996 20:00:26
  452.       Login total/last month:    00693x(00098:06:23) / 0098x(014:25:01) (h:m:s)
  453.    ------------------------------------------------------------------------------
  454.  
  455.  
  456.    ┌─────────────────────────────────────────────────────────┐
  457.    │ Display registration information                        │
  458.    └─────────────────────────────────────────────────────────┘
  459.  
  460.    accounts -i
  461.  
  462.    ------------------------------------------------------------------------------
  463.    H:\Dev\bin>accounts -i
  464.  
  465.    aCCOUNTS - User administration for aPOP3d and aDialIn   v1.10/Sep  8 1996
  466.    (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  467.    *** Registration information per 12.08.1996 15:52:43 ***
  468.  
  469.           aPOP3d: registered for FH Offenburg, Standort Gengenbach
  470.          aDialIn: no (valid) registration found
  471.    ------------------------------------------------------------------------------
  472.  
  473.  
  474.    ┌─────────────────────────────────────────────────────────┐
  475.    │ Display user list                                       │
  476.    └─────────────────────────────────────────────────────────┘
  477.  
  478.    accounts -l[d[a|l|n|r|t|u]]
  479.  
  480.       -l  ... displays a list containing username and real name of all users
  481.       -ld ... display a list of dial-in related information; if no further flag
  482.               is set the list will contain only username and real name
  483.       The -ld parameter may be followed by one or more of the following flags:
  484.        a  ... days since last login
  485.        l  ... on-line time of the last month the user has dialed in
  486.        n  ... number the users in list
  487.        r  ... real name of user
  488.        t  ... total on-line time since the user record was created
  489.        u  ... username
  490.  
  491.        The columns are in the same order as the flags following the -ld parameter.
  492.        The flags have to be in lower case. However you may put _one_ letter in
  493.        upper case which will result in a sorted list with the uppercase letter
  494.        beeing the sort criteria. If you want the sorted list in reverse order
  495.        simply put a "-" sign behind the uppercase letter.
  496.  
  497.    ------------------------------------------------------------------------------
  498.    H:\Dev\bin>accounts -ldurL
  499.  
  500.    aCCOUNTS - User administration for aPOP3d and aDialIn   v1.10/Sep  8 1996
  501.    (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  502.    *** User list per 04.10.1996 19:08:08 ***
  503.  
  504.    Username        Real name                      Last month 
  505.    ----------------------------------------------------------
  506.    aherrmann       Axel Herrmann                   15:57:47 
  507.    amueller        Axel Mueller                    14:25:01 
  508.    meisenmann      Martin Eisenmann                 4:46:28 
  509.    hkern           Hansi Kern                       0:42:05 
  510.    dmannes         Delf Mannes                      -:--:-- 
  511.    ----------------------------------------------------------
  512.                                                    35:51:21
  513.  
  514.    ------------------------------------------------------------------------------
  515.  
  516.  
  517.  
  518.    ┌─────────────────────────────────────────────────────────┐
  519.    │ Assign (new) password to user                           │
  520.    └─────────────────────────────────────────────────────────┘
  521.  
  522.    accounts -p <user> <password>
  523.  
  524.       <user>
  525.          ... Username for to which the password should be assigned
  526.  
  527.       <password>
  528.          ... New password which should be assigned to the user
  529.  
  530.    ------------------------------------------------------------------------------
  531.    H:\Dev\bin>accounts -p smith newPassword
  532.  
  533.    aCCOUNTS - User administration for aPOP3d and aDialIn   v1.10/Sep  8 1996
  534.    (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  535.    New password for user smith has been assigned.
  536.    ------------------------------------------------------------------------------
  537.  
  538.    ┌─────────────────────────────────────────────────────────┐
  539.    │ Remove user                                             │
  540.    └─────────────────────────────────────────────────────────┘
  541.  
  542.    accounts -r <user>
  543.  
  544.       <user>
  545.          ... Username which should be removed
  546.  
  547.       This command removes the compley user record from the user database.
  548.  
  549.    ------------------------------------------------------------------------------
  550.    H:\Dev\bin>accounts -r smith
  551.  
  552.    aCCOUNTS - User administration for aPOP3d and aDialIn   v1.10/Sep  8 1996
  553.    (C) 1996, Axel Mueller (amueller@stargate.rz.fh-offenburg.de)
  554.    User smith removed.
  555.    ------------------------------------------------------------------------------
  556.  
  557.  
  558.  
  559. ┌────────────────────────────────────────────────────────────────────────────┐
  560. │                                                                            │
  561. │ 7. Client login scipts for OS/2, Windows 3.1, Windows 95/NT                │
  562. │                                                                            │
  563. └────────────────────────────────────────────────────────────────────────────┘
  564.  
  565.  
  566.    At our local campus we have dial-in users using OS/2, Windows 3.1,
  567.    Windows 95 and Windows NT. For an efficient time-saving login procedure
  568.    it is important to use a script for dial-in. Therefore I have included
  569.    the scripts the students of our local campus use for dialling into our
  570.    aDialIn package equipped machine:
  571.  
  572.    *** OS/2 *** (script file: aDialOS2.RSP)
  573.    You should get a copy of PPPDIAL.CMD (available on many FTP servers as
  574.    PPDIAL29.ZIP - featuring automatic redial if line is busy) and create a
  575.    new provider in the DIAL OTHER INTERNET PROVIDERS notebook.
  576.    Enter the Login ID and password an check the "required" box.
  577.    In the Phone number field you can specify different phone numbers.
  578.    These numbers will be dialed one after another if a line is busy.
  579.    In the login sequence field you should specify
  580.   "pppdial.cmd c:\mptn\etc\aDialOS2.RSP" (change drive and directory if
  581.    necessary). Make sure PPPDIAL.CMD is in a directory included in your
  582.    PATH statement. All other settings in the notebook should be obviously.
  583.  
  584.    *** Windows 3.1x *** (script file: aDialW3.CMD)
  585.    This script is for use with Trumpet WinSock. Just copy it to the
  586.    directory where your Trumpet WinSock resides.
  587.  
  588.    *** Windows 95 *** (script file: aDialW95.SCP)
  589.    This script has to be used with the DIAL UP NETWORK. I know that it works
  590.    but I don't know how (since I do not use Windows 95).
  591.  
  592.  
  593.  
  594. ┌────────────────────────────────────────────────────────────────────────────┐
  595. │                                                                            │
  596. │ 8. Conclusion                                                              │
  597. │                                                                            │
  598. └────────────────────────────────────────────────────────────────────────────┘
  599.  
  600.    I have tried my best to make this documentation better than the one I
  601.    provided in the SIDIS/2 package. But it is always difficult to explain
  602.    things to someone when you are familiar with it and the others are not.
  603.    If you experience any problems the easiest and fastest way to overcome
  604.    them is to drop me an email. Under normal circumstances you should
  605.    receive an answer within one day (of course solving the problem may
  606.    take longer)
  607.    I regulary monitor the Internet news group comp.os.os2.networking.tcp-ip
  608.    as well.
  609.  
  610.    Keep in mind - I rely on the feedback I get ;-))
  611.  
  612.  
  613.    Axel Mueller
  614.    amueller@stargate.rz.fh-offenburg.de
  615.  
  616.    09/30/96
  617.  
  618.  
  619.  
  620.  
  621.  
  622. ┌────────────────────────────────────────────────────────────────────────────┐
  623. │                                                                            │
  624. │ APPENDIX A: Network structure                                              │
  625. │                                                                            │
  626. └────────────────────────────────────────────────────────────────────────────┘
  627.  
  628.  
  629. <--------------- DOMAIN: modem-domain.com ----------------------------------->
  630.  
  631. ┌─────────────────┐                                          LAN
  632. │ remote "host1"  │                                         (Net 111.222.333)
  633. │ 111.222.333.11  │-Modem--(Telephon network)--Modem1---.      ---
  634. └─────────────────┘                                     |       |
  635.                                                         |       |
  636. ┌─────────────────┐                                     |       |
  637. │ remote "host2"  │                                     |       |
  638. │ 111.222.333.12  │-Modem--(Telephon network)--Modem2-. |       |
  639. └─────────────────┘                                   | |       |
  640.                                                       | '-┌──────────────────┐
  641.                                                       '---│ "modem-host"     │
  642.                                                       .---│ 111.222.333.10   │
  643.                                                       | .-│ Ethernet Address │
  644. ┌─────────────────┐                                   | | │ 00:00:C0:04:F7:37│
  645. │ remote "host3"  │                                   | | │                  │
  646. │ 111.222.333.13  │-Modem--(Telephon network)--Modem3-' | └──────────────────┘
  647. └─────────────────┘                                     |       |
  648.                                                         |       |
  649. ┌─────────────────┐                                     |  ┌─────────────────┐
  650. │ remote "host4"  │                                     |  │ default router  │
  651. │ 111.222.333.14  │-Modem--(Telephon network)--Modem4---'  │ 111.222.333.254 │
  652. └─────────────────┘                                        └─────────────────┘
  653.                                                                 |
  654.                                                                 '---<INTERNET>
  655.  
  656.  
  657.  
  658. ┌────────────────────────────────────────────────────────────────────────────┐
  659. │                                                                            │
  660. │ APPENDIX B: Work-around for routing bug in PPP.EXE                         │
  661. │                                                                            │
  662. └────────────────────────────────────────────────────────────────────────────┘
  663.  
  664.    Unfortunately there is a routing bug in PPP.EXE since it went "gamma"
  665.    (2 years ago). Obviously IBM is testing PPP.EXE only with one single
  666.    PPP connection at a time. The bug only becomes visible if you have
  667.    mutliple simultanous PPP sessions. In this case it may happen that
  668.    the routing table entry for one already active PPP session will be
  669.    removed if another PPP session starts. The modem link will still be up
  670.    but there is no TCP/IP connection to the network (and even to the modem
  671.    server) anymore. I have informed IBM Corp. in the USA but they told me
  672.    the IBM Germany is responsible. For the latter I was not able to locate
  673.    somebody I could report this bug to. That's the way thing will improve
  674.    soon ...
  675.    Anyway - I have implemented a "small & dirty" work-around which is
  676.    better than loosing your network connection from time to time.
  677.    You will need two programs called "netstat.exe" and "ifconfig.exe"
  678.    which are part of TCP/IP, Warp Connect and Warp Server. They already
  679.    should be in the PATH.
  680.    Some seconds before a new PPP.EXE will be started, the modem control
  681.    script (USERCTRL.CMD) will start "netstat.exe". The output (content of
  682.    the routing table) will be redirected to a file. Afterwards it will
  683.    start another another script (REESTAB.CMD) which will wait for
  684.    5 seconds (during this time the new PPP.EXE will have been established)
  685.    and then re-configure the PPP interfaces (according to the routing table
  686.    from the file) that were in existence before the new PPP.EXE was started.
  687.    The REESTAB.CMD script will only be started if somebody dials in and there
  688.    is already one or more active PPP sessions.
  689.  
  690.