home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / genppp.txt < prev    next >
Text File  |  1996-03-15  |  16KB  |  323 lines
  1.               General Recipe for OS/2 TCP/IP (and IAK) PPP
  2.                     Last updated 96/01/18
  3. NOTE: If you are going to use Compuserve as your internet service 
  4. provide, download file CISPPP.TXT from OS2USER library 20.
  5.  
  6. This file is authored by Tony Rall of TEAMIBM
  7. (trall@almaden.ibm.com) with some minor assistance from Howie Acheson 
  8. (102562.102@compuserve.com) with a special thanks to Ron Higgin, OS/2 
  9. Advisor, for his comments and advise.
  10.  
  11. PURPOSE - To configure the "Dial Other Internet Provider" dialer for 
  12. accessing an Internet Service Provider (ISP).
  13.  
  14. To establish an internet connection you must have either:
  15.  
  16. Warp's IBM Internet Connection for OS/2 (IIC) installed on your machine.  You 
  17. must also have the PPP update installed (tcpip\bin\ppp.exe should be dated 
  18. at least 95/07/13) which you can ftp from ftp.ibm.net as
  19. /pub/PPP/PPP.ZIP or you can download the file from the OS/2 USERS
  20. forum (GO OS2USER) in library 20 with the filename PPP.ZIP.  Place the
  21. PPP.ZIP file in your TCPIP directory and unzip.  If you are using the
  22. PKZIP or INFOzip archiver, use the "-d" parameter to ensure that files
  23. are placed in the proper subdirectories (ie: UNZIP -d PPP.ZIP).  If you are 
  24. using WARP for Windows (red spine) you must install FixPak #5, or later
  25.  
  26. Or, 
  27.  
  28. WARP Connect with the  TCP/IP v3.0 feature installed.  It is NOT 
  29. necessary to install the IBM Internet Connection for OS/2 feature of 
  30. the WARP Connect Bonus Pack when the TCP/IP feature is installed. 
  31. Indeed, installing the IIC over the WARP Connect TCP/IP feature will
  32. render TCP/IP inoperative.
  33.  
  34. Once you have the PPP update installed, you need to open the Dial
  35. Other Internet Providers object in the Internet Utilities folder. Then
  36. choose the Add Entry object, or select Add Entry from the Configure
  37. pull-down menu, then configure dialer as follows:
  38.  
  39.  
  40. * Your primary source of assistance for signing on to an Internet 
  41.     Service Provider(ISP) should be the ISP.  The ISP will have to 
  42.     provide you with some of the information to configure the dialer.
  43.  
  44. * If your provider has given specific instructions for connecting
  45.   using OS/2 TCP/IP or the Warp IIC, follow them (to the letter)
  46.   (and hope they know what they're doing - not many do with respect
  47.   to OS/2).
  48.  
  49. GENERAL CAVEAT - The Internet is CASE SENSITIVE.  Any place in this 
  50. document where a case is shown for information to be entered into the 
  51. dialer, be sure to follow the case EXACTLY.  Be sure to understand and
  52. follow the case for any information provided by your ISP.
  53.  
  54.  * Use the "Dial Other Internet Providers" application.
  55.  
  56. * Click on "Add Entry"
  57.  
  58. * Page 1: (Login Info)
  59.  
  60.   - In the Name:  field, type a "name" for this connection. 
  61.     BE SURE TO USE ALL UPPER CASE.  This name serves only to
  62.     identify the target provider dialer entry.  The dialer
  63.     itself does NOT reference this "Name", and hence, it may
  64.     contain any name YOU find meaningful.
  65.  
  66.   - In the Description:  field, enter a description for this 
  67.      connection.  This is for descriptive purposes only.  The dialer
  68.      does NOT use the contents of this field.
  69.  
  70.    -For the Login ID: field enter your User ID number.     
  71.  
  72.    - Fill in your password.  If you leave Password blank, check 
  73.      "Required" and you will be prompted for your pw each time you 
  74.      dial.  IMPORTANT-If your password contains one or more blank 
  75.      characters (spaces), substitute the the TWO character string "\s" 
  76.      for EACH blank character.
  77.  
  78.    - For the Login Sequence use "NONE".  PAP authorization will be
  79.       attempted by ppp.  If this does not work with your provider, try 
  80.       a completely blank Login Sequence.  If this doesn't work, look 
  81.       at the help information (put cursor in the area and hit F1).
  82.  
  83.     * General comments about the Login Sequence:
  84.       o The first string is sent FROM you to your provider - it is
  85.         usually just a carriage return, "\r".
  86.       o Alternate lines are those that the dialer is to wait for from
  87.         your provider.  The dialer (actually slattach.exe) will ignore
  88.         everything it receives until it get an exact match with the
  89.         string you've entered - and the comparison is case-sensitive.
  90.         If slattach doesn't get what it expects in (by default) one
  91.         minute, it will abort the connection.
  92.       o If it does get a match, it will send the next line in the
  93.         Login Sequence.
  94.       o The on-line help for the Login Sequence is reasonably good.  To
  95.         see it, place your cursor in the LS and hit F1.  It omits a
  96.         couple of details; you can get those using, at an OS/2 command
  97.         prompt, "slattach -?".
  98.  
  99.     * If a Login Sequence, by itself, is insufficient for your needs,
  100.       you must go to a Rexx script (a .cmd file).  One of the most
  101.       frequent motives for this is when you have a provider that
  102.       doesn't have enough phone lines to accommodate his customers
  103.       (I would have to be pretty desperate to use a provider like
  104.       that) - in this case, you may want an automatic redial script.
  105.       The Login Sequence doesn't supply this capability.  (Note:
  106.       using a response file (.rsp) provides no functional advantage
  107.       over using a regular Login Sequence; the only impetus I can
  108.       see for a response file is if slippm.exe has some undesirable
  109.       side effects in your environment.)  WHEN SPECIFYING A "cmd" 
  110.       OR "rsp" FILE IN THE LOGIN SEQUENCE, IT MUST BE DONE IN LOWER 
  111.       CASE.
  112.  
  113.       Unfortunately, IBM does not include any sample scripts for 
  114.       ppp,but here are some samples in OS2USER library 20.  If you 
  115.       feel that you need a Rexx scrip, I recommend trying to get
  116.       a hold of pppdial.cmd, distributed at popular OS/2 
  117.       ftp sites as ppdialxx.zip.
  118.  
  119.       If you want to make your own, issue "ppp -?" for help on the
  120.       parameters required by the ppp driver.  Annex.cmd (or
  121.       slipup.cmd) would need to be changed in the following ways:
  122.  
  123.       The arguments are passed differently to ppp scripts than they
  124.       were for slip.  They come in as individual parameters which,
  125.       in Rexx, must be separated by commas in your script.  (The
  126.       third parameter is CMD - I don't know of a use for it, so I
  127.       discard it.)  The "parse arg" statement near the beginning of
  128.       your script must look like this:
  129.        parse arg interface , port , . , dialcmd , username , password
  130.       typical values: ppp0   com1       ATDTnnn   userid     password
  131.  
  132.       Change all occurrences of the function calls "slip_..." to
  133.       "ppp_...".
  134.  
  135.       Assuming your provider supports PPP IP address configuration
  136.       (this is dynamic and under the covers), you can remove the
  137.       parsing of addresses, configuring the interface, and setting the
  138.       default route - this will be taken care of automatically.
  139.   - Connection Type: PPP
  140.  
  141. * Page 2: (Connect Info)
  142.   - Leave blank Your IP Address, Destination IP Address, Netmask.
  143.   - Don't change the MRU (ppp seems to ignore this anyway).
  144.   - Domain Nameserver - add the numeric IP address of your provider's
  145.     primary nameserver, e.g., 1.2.3.4
  146.   - Your Host Name - enter a name for your PC (mine is "trall").  Put
  147.     the same name in your CONFIG.SYS following other SET statements near
  148.     the top of your CONFIG.SYS (first 20 lines or so).
  149.         SET HOSTNAME=TRALL.  You must reboot for this to take effect.
  150.   - Your Domain Name - usually the name of your provider, e.g.,
  151.     netcom.com
  152.  
  153. * Page 3: (Server Info)
  154.   - All of this information is optional.  Entering it correctly will
  155.     make it easier to use the related applications.  Your provider
  156.     should supply anything you use here.
  157.  
  158. * Page 4: (Modem Info)
  159.   - Modem Type - I don't mess with this, but if you don't understand
  160.     the commands for your modem and you can find it in the list, go
  161.     ahead and select it. (See below)
  162.   - Com Port - Get this right.  Note that if you use anything above
  163.     com2 you need to define it in CONFIG.SYS with a COM.SYS statement.
  164.   - Speed (Baud) - This misnamed field is referring to what is
  165.     actually called the DTE speed - the data transfer rate between
  166.     the com port and the modem.  In general, the higher, the better.
  167.     But the standard com support (COM.SYS) currently supports no
  168.     higher than 57600.  If you seem to be having problems communicating
  169.     with the modem, drop this to 9600 to ensure that this is not the
  170.     cause.
  171.   - Data Bits - Leave at 8.
  172.   - Parity - Leave at NONE.
  173.   - Prefix - Leave at ATDT (unless you don't have tone dialing; then
  174.     use ATDP).
  175.   - Mode - Leave at Dial
  176.   - Initialization Strings - If your modem type was not in the list
  177.     at the top of the page, see below.
  178.  
  179. Modem Init Strings
  180.  
  181. There is also a file titled MODEMIAK.ZIP in OS2USER library 20 that
  182. contains an updated and expanded list of modems and init strings that
  183. can be used with the dialer.
  184.  
  185. Another option is to use the initiation strings suggested for use in
  186. the IBM Dialer.  You can view these by using your editor and loading
  187. the file MODEM.LST that resides in x:\TCPIP\ETC.
  188.  
  189. The reason there are 2 init.  strings is that some modems require a
  190. delay between a reset and any other commands.  Typically the first
  191. command is to reset to factory defaults; then the other string is used
  192. to make any changes needed from those defaults.  In practice, most
  193. modems work fine with just one string (which can be quite long), and
  194. this avoids the 2 second delay that is inserted between the 2 strings.
  195.  
  196. If you cannot find a string(s) that work, I recommend you try this (in 
  197. Init. string 1; leave Init. string 2 blank):
  198.  
  199.    AT&FM1E1S0=0&C1&D2
  200.  
  201. Not all of these commands are available on every modem; if you 
  202. get ERROR when you dial (as a response from the modem), start removing 
  203. stuff until you don't.
  204.  
  205.  &F    reset to factory defaults (check your modem manual to see if
  206.        there is a different command for this; if there are several,
  207.        use the one for asynchronous communication with RTS/CTS
  208.        (hardware) flow control)
  209.  M1    speaker on (usually a default)
  210.  E1    echo on (so you can see the commands being sent to the modem,
  211.        including the dial string)
  212.  S0=0  no auto-answer
  213.  &C1   signal true carrier-detect
  214.  &D2   hang-up when DTR drops (this is how slip/ppp makes the modem
  215.        break the connection) 
  216.  
  217. ESTABLISHING THE INTERNET CONNECTION
  218.  
  219. Then to establish your PPP connection, select the NAME of the
  220. connection and choose DIAL.  You will then see the initialization of
  221. the modem, the dialing, the logging in, and you should see messages in
  222. the Status Window reporting the remote IP address, VJ compression
  223. enabled, and that the default route address has been assigned.  Do
  224. not be concerned if you see a couple of "fcs" error notices.  
  225.  
  226.   The final line will be
  227.  
  228.        "[PPP] Enter Ctrl-C or Ctrl-Break to End Session"
  229.  
  230. When you see the above messages, then the connection is complete and 
  231. you can envoke any of the internet applications. You must leave the
  232. dialer running while you have the PPP connection active. You may want
  233. to minimize the dialer after the connection is established.
  234.  
  235. The first thing you should do after connecting to the internet is   |
  236. envoke "Retrieve Software Updates" and download "Base Update for    |
  237. TCP/IP (PN71501).  (This is NOT required for users of WARP Connect).|
  238. This will allow the full functions of the IBM WebExporer 1.03.      |
  239. No other CSD's or TCP/IP updates are required.                      | 
  240.  
  241.   PROBLEM SOLVING
  242.  
  243. * After clicking on the Dial icon, it switches to Hang-up and then
  244.   immediately switches back to Dial - quitting immediately.
  245.   - Make sure there are no spaces in your userid or password; you
  246.     can substitute "\s" for any spaces.
  247.   - Your com port is not defined to OS/2.  On ISA bus machines,
  248.     COM1 and COM2 are the only ones defined by default.  If you use
  249.     COM3 or 4, you need to add a COM.SYS statement to config.sys (and
  250.     reboot).
  251.     - Make sure the Netmask (on page 2 of the dialer settings) is not
  252.     255.255.255.255 - I consider it best to leave this field totally
  253.     blank.
  254.   - Your com port is still held by some other program (another com
  255.     or fax program).  You must exit that program before dialing.
  256.   - Anyone using the original red spine Warp (for Windows) and
  257.     communications apps should have at least fix pack 5 installed.
  258.  
  259. * The dialer does not appear to talk to the modem and, after one
  260.   minute, terminates with a failure.  On some hardware combinations
  261.   there appears to be a flow control problem on the com port.
  262.   Issuing the following command before dialing may help:
  263.   MODE.COM COMn:IDSR=ON,ODSR=OFF,OCTS=OFF,DTR=ON,RTS=HS,BUFFER=ON
  264.  
  265. * [io_event] Unsupported protocol (xxxx) received.
  266.   The remote server is trying to setup additional communications
  267.   protocols (such as IPX) that ppp.exe does not support.  This is just
  268.   an informational message.  Ppp.exe will reject that protocol; this
  269.   will not cause a problem unless the server insists on that protocol
  270.   being supported.
  271.  
  272. * [io_event] Unsupported protocol (2080) received.
  273.   This is a special case of the previous item.  The 2080 is definitely
  274.   not a ppp protocol - it happens to be a couple of ASCII characters
  275.   typically used to format text (non-ppp) messages.  In other words,
  276.   the server is not yet in ppp mode (but OS/2 is).
  277.  
  278.   This usually means that either:
  279.  
  280.   - you didn't get correctly logged in (from the server's viewpoint),
  281.     and it is sending you error messages, but ppp.exe is expecting
  282.     formatted ppp messages at this point
  283.  
  284.   - you did get logged in, but the server is sending a few more
  285.     text messages, such as:
  286.      Ok, you're on
  287.      Let me get my ppp code fired up
  288.      Hold on a sec
  289.      Ok, it's up
  290.      Have a good day
  291.  
  292.   If you want to eliminate this error, you have to find out what the
  293.   messages are.  In the first case (bad login), correcting the login
  294.   should suffice.  In the second, you'll need a fancier Login Sequence
  295.   (not a blank or NONE LS).  One way to determine what is being sent
  296.   is to put an intentional error in your LS: after the last line to be
  297.   sent to the server add a line with "xxxyyy".  This won't match, so
  298.   the Status window will display all messages received.  If it wasn't
  299.   indicating a login error, replace the xxxyyy with the last part of
  300.   the last such message.  In the example above, the last line in your
  301.   Login Sequence should contain:
  302.      good\sday
  303.  
  304. * Invalid FCS - Bad phone line or modem, or, more likely, ppp.exe has
  305.   entered ppp mode while the remote system is still sending text
  306.   messages.  The latter can often be corrected by improvising a better
  307.   Login Sequence.  But don't do anything at all if you just get a few
  308.   of these messages at the start of the connection.  If they continue
  309.   throughout your session, you should try to correct the problem -
  310.   usually a phone or modem problem.
  311.  
  312.   - getting a better serial card (with a buffered uart)
  313.   - running the com port at a lower speed ("baud" on page 4)
  314.   - replacing the serial cable
  315.   - getting a better phone connection
  316.   - using a better initialization string for the modem
  317.   - suppressing modem compression (such as V.42bis)
  318.   - replacing the modem
  319.   - replacing com.sys with the shareware sio.sys (or vice versa). SIO 
  320.     is available from CIS in OS2BVEN library 4 as SIOxxx.ZIP or from 
  321.     most OS2 BBB's.
  322.  
  323.