home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 36 Tips / 36-Tips.zip / osmkdops.txt < prev    next >
Text File  |  1997-04-12  |  18KB  |  440 lines
  1. OSMKDOPS - CONFIGURING THE "DIAL OTHER INTERNET PROVIDERS" DIALER FOR 
  2. ALTERNATE PROVIDERS
  3. 07/11/96
  4. ======================================================================
  5. Configuring the "Dial Other Internet Providers" Dialer for Alternate 
  6. Providers
  7. ======================================================================
  8.  
  9. Please Read Entire Document for Full Explanation of Procedures
  10. --------------------------------------------------------------
  11.  
  12. DESCRIPTION
  13.  
  14. The IBM Internet Connection for OS/2, when used with the default 
  15. service provider, Advantis, provides easy-to-use hard-coded access 
  16. to the Internet through the IBM Internet Dialer.  This document is for 
  17. those who have an alternate service provider and want to use the 
  18. "Dial Other Internet Providers" dialer to access the Internet.
  19.  
  20. This is a detailed document, describing the fields in the Add Entries 
  21. notebook for the dialer and how to correctly add an entry to connect to 
  22. an alternate provider. Also included is a section on common problems 
  23. and their solutions.
  24.  
  25. RESOLUTION
  26.  
  27. What is SLIPPM?
  28. ----------------
  29. SLIPPM is an OS/2 Warp object-oriented application that is designed to 
  30. simplify connecting to a serial line Internet protocol (SLIP) or 
  31. point-to-point (PPP) provider. Basically, a provider makes available a 
  32. connection point for your modem so that you will have access to the
  33. Internet through the provider.
  34.  
  35. SLIPPM saves the settings needed to connect to a provider. When you are 
  36. ready to establish communications, it uses the SLATTACH command to dial
  37. the provider's phone number, and then sends your user ID and password. 
  38. When requested, SLIPPM will send your mail ID and password, and other 
  39. information such as your WWW server, news server, and gopher server.
  40.  
  41. SLIPPM can use a response file (.rsp), a REXX program, or simply a 
  42. wait-for and reply-with script in the login sequence area of the dialer
  43. to handle a static or dynamic SLIP or PPP connection.
  44.  
  45. What Do I Need to Connect?
  46. -----------------------------
  47. To establish a connection to an alternate provider, you will need to 
  48. complete the following fields: 
  49.  
  50. Login Info
  51. ---------
  52. * Name: Enter the name of the provider
  53.  
  54. * Description: Enter an optional description
  55.  
  56. * Login ID: Enter your login ID 
  57.       
  58.   Note: If your provider requires that you put a 'P' or 'S' 
  59.         in front of your login ID so that it will know to 
  60.         go into PPP or SLIP, then do not enter the 'P' or 
  61.         'S' here.  Don't forget that your provider's 
  62.         server may be case-sensitive.
  63.  
  64. * Password: Enter your password
  65.  
  66.   Note: Ensure that your password does not contain any spaces.
  67.         A space is an invalid character and will result in the 
  68.         dialer failing to dial. Again, don't forget that your 
  69.         provider's server may be case-sensitive.
  70.  
  71. * Login Sequence: This is the most important part.
  72.  
  73.   Notes: See section on Forming A Login Sequence. There is no 
  74.          standard way to connect to a provider. This is where we 
  75.          need to determine what the server is expecting for their 
  76.          login. If the provider is using PAP (Password Authentication
  77.          Protocol) or CHAP (Cryptographic Handshake Authentication 
  78.          Protocol), the login sequence must read NONE.
  79.  
  80. * Connection Type: SLIP or PPP
  81.  
  82. * Inactivity Timeout Option: This can be set to hang up after a 
  83.   specified time period or shut off so that the dialer will not hang
  84.   up due to inactivity. Note that this does not mean the server can't 
  85.   terminate the connection due to inactivity.
  86.  
  87. Connect Info
  88. -------------
  89. * Your IP Address: Your IP address
  90.  
  91.   This is where you will enter your IP address if you have a static 
  92.   account. If you have a dynamic account, leave this entry blank. 
  93.   If a provider says that your IP address is X.X.X.X,
  94.   then you have a dynamic connection. Leave the entry blank. Do not 
  95.   enter 0.0.0.0 as your dynamic IP.  
  96.  
  97. * Destination IP Address: The IP address of the provider's server
  98.  
  99.   Enter the IP address of the destination if the dial up is a static 
  100.   connection. Otherwise, leave this entry blank.
  101.  
  102. * Netmask: The provider's netmask
  103.  
  104.   If you have a static dial up connection, enter the provider's
  105.   netmask. For example, 255.255.255.0 is a standard class C network
  106.   and this is the most common netmask.  
  107.  
  108. * MRU Size: Maximum Response Unit
  109.  
  110.   If you are using SLIP, default will be 1006; for PPP the default is 
  111.   1500.
  112.  
  113. * VJ (Van Jacobson) Compression: This is to enable header compression.
  114.  
  115.   This must be on if your provider uses header compression or the 
  116.   connection will fail. Your provider will provide this information.
  117.  
  118. * Domain Nameserver (DNS): The address of your provider's nameserver
  119.  
  120. * Your Host Name: The alias for your system on the Internet
  121.  
  122.   For a dynamic connection, this should be left blank. For a static 
  123.   connection, your dial up host name can be determined from your
  124.   provider.
  125.  
  126. * Your Domain Name: The domain name of your provider
  127.  
  128.   This is usually the second part of your e-mail address (just the 
  129.   domain). For example, your e-mail address is in the format:
  130.   userID @ domain.
  131.  
  132. Server Info
  133. -----------
  134. * Default Servers / Hosts: Define default servers
  135.  
  136.   This is where you can define the default servers you want to connect 
  137.   to when you logon. Here, you define a news server, gopher server 
  138.   and WWW server.
  139.  
  140. * Mail Server Information: Information to connect to your mail 
  141.   server
  142.  
  143.   - Mail Gateway: The name of the provider's SMTP (Simple Mail Transfer 
  144.     Protocol) mail server; can be the same as the POP server.
  145.  
  146.   - POP Mail Server: The name of the provider's POP server
  147.  
  148.   - Reply Domain: This is the second part of your e-mail address (the 
  149.     reply_domain), after the @ sign; for example, userID @ reply_domain.
  150.  
  151.   - Reply (Mail) ID: This is your user ID.  Enter only the first part 
  152.     of your e-mail address without the @ sign.
  153.  
  154.   - POP Login ID: This is your login ID to access the mail server. 
  155.     Usually this is the same as your login ID, but can be different.
  156.  
  157.   - POP Password: This is your password to access the mail server.  
  158.  
  159. Modem Info
  160. -----------
  161. * Modem Type: Select your modem from the list of modems.
  162.  
  163.   Note: If your modem is not listed, select Hayes Compatible.
  164.          The correct modem setting is especially important if different 
  165.          classes of modems are involved in the connection.
  166.  
  167. * Com Port: Select the COM port that your modem is on.
  168.  
  169. * Speed: Select the baud rate that you will connect with.
  170.  
  171.    Note: If you are using a 14400 modem, it is recommended that you 
  172.           set this to 38400. If using a 28800, you'll want to set
  173.           this to 57600.  An Internet connection requires a 
  174.           minimum of a 9600 baud connection.  Also, setting the 
  175.           baud rate higher may make the modem connection fail.
  176.  
  177. * Databits, parity, Prefix: Leave these on their default values.
  178.  
  179. * Init Strings 1 & 2: The init strings that will be passed to the modem 
  180.   before dialing. These can be modified manually if needed.
  181.  
  182. * Call Waiting: Check this if your phone line has call waiting
  183.   to disable it before calling out.
  184.  
  185. Forming a Login Sequence
  186. ---------------------------
  187. Of all the information provided in the Settings notebook, the Login 
  188. Sequence is one of the most important fields to fill in to establish 
  189. an Internet Connection with an alternate provider.  
  190.  
  191. The default is NONE which assumes that the provider is starting a SLIP 
  192. or PPP connection immediately after it passes the user ID and password.
  193. The default can be used for connections that prompt only for user ID 
  194. and password and then start either a dynamic PPP or SLIP or a static 
  195. SLIP. This cannot be used for a dynamic SLIP connection. If your 
  196. provider is using PAP or CHAP, the login sequence must read NONE.
  197.  
  198. You can also specify the path (in lowercase) to a response file or REXX 
  199. program here.  
  200.  
  201. Elements of a Login Sequence
  202. ------------------------------
  203. The SLATTACH command is very important when logging in, because it is 
  204. SLATTACH and not SLIPPM that uses the script or login sequence. It 
  205. supports the following six escape characters that can be used 
  206. in forming a login sequence:
  207.  
  208.   \d   - Forces a 2 second delay. This is useful to provide 
  209.          additional time for servers to handshake before trying to 
  210.          negotiate.
  211.   \n   - Generates a carriage return followed by a line feed
  212.   \r   - Generates a carriage return
  213.   \q   - Toggles to quiet mode
  214.   \s   - Generates a physical space when required
  215.   ^<c> - Sends a control <c>
  216.  
  217. You can also use:
  218.  
  219.   [LOGINID]    - Sends the contents of your login ID field entry
  220.   [PASSWORD]   - Sends the contents of your password field entry
  221.  
  222. If your connection is dynamic SLIP, you will also have to use the 
  223. following in your script:
  224.  
  225.   [$IPADDR]    - Parses the text to get the IP ADDRESS returned
  226.   [$IPDEST]    - Parses the text to get the destination IP 
  227.                  returned
  228.  
  229. Example of How to Obtain Login Sequence Information from the Provider
  230. ---------------------------------------------------------------------
  231. You will need to use a terminal communications program such as 
  232. HyperAccess Lite for OS/2, which comes with the BonusPak, or any 
  233. other application that does VT100 or ANSI terminal emulation. If the 
  234. provider is using PAP or CHAP to authenticate the connection, this type
  235. of login does not apply and will not work.
  236.  
  237. 1. Dial up the provider's Internet dial up number.
  238.  
  239. 2. When you connect, note whether it is necessary to press Enter to get 
  240.    a login prompt or whether it goes to a login prompt right away.
  241.    If you need to press Enter, then you'll need to add a \r to the 
  242.    beginning of your login sequence.
  243.  
  244. 3. Note what the prompts end with as you are logging in. For 
  245.    example, most prompts end with a colon ":" but if you are 
  246.    logging into a UNIX server, the prompts will end with a 
  247.    greater-than sign ">." 
  248.  
  249. 4. Take note of each prompt you see and how you have to satisfy 
  250.    the request.   
  251.  
  252. 5. At the end of the requests, the server will then attempt to 
  253.    start a PPP or SLIP connection. Since you are only using a 
  254.    terminal program to dial in, it will never complete.  Go ahead 
  255.    and hang-up.  
  256.  
  257. 6. Once you have configured the login sequence for a dynamic 
  258.    PPP or SLIP connection or a static SLIP connection, the dialer 
  259.    will automatically fulfill these requests.
  260.  
  261. Example Login Scripts
  262. -----------------------
  263.  
  264. For a dynamic/static PPP connection:
  265. -----------------------------------------------------------------
  266. \d                             -  A 2-second delay
  267. :                              -  Waiting for a colon, for example, 
  268. login:
  269. P[LOGINID]                     -  Passing a "P" then the login ID
  270. :                              -  Waiting for a colon, for example, 
  271. password:
  272. [PASSWORD]                     -  Passing the password 
  273. -------------------------------------------------------------------
  274.  
  275. Another dynamic/static PPP connection:
  276. -----------------------------------------------------------------
  277. \r                             -  A carriage return
  278. :                              -  Waiting for a colon, for example, 
  279. login:
  280. [LOGINID]                      -  Passing a "P" then the login ID
  281. :                              -  Waiting for a colon, for example, 
  282. password:
  283. [PASSWORD]                     -  Passing the password 
  284. >                              -  Waiting for a ">" prompt 
  285. ppp\sdefault                   -  Sends "ppp default"    
  286. -----------------------------------------------------------------
  287.  
  288.  
  289. A dynamic SLIP connection:
  290. ----------------------------------------------------------------
  291. \d                             -  A 2-second delay
  292. :                              -  Waiting for a colon, for example, 
  293. login:
  294. [LOGINID]                      -  Passing the login ID
  295. :                              -  Waiting for a colon, for example, 
  296. password:
  297. [PASSWORD]                     -  Passing the password 
  298. is\s[$IPDEST]\sis\s[$IPADDR]   -  Parsing in the IP addresses
  299. -----------------------------------------------------------------
  300.  
  301. The last line of the dynamic SLIP connection deserves a little more 
  302. explanation; a dynamic SLIP connection is the hardest connection 
  303. to properly configure.   
  304.  
  305. Note: It is required that the server echo back both the user's IP 
  306.       address and the remote/destination IP address. If this does not 
  307.       happen, you will not be able to establish a connection. 
  308.  
  309. This is what the last line is doing:
  310.  
  311. At the end of the login, the server will reply with something like:
  312.  
  313. "The destination address is (X.X.X.X)  Your IP address is (X.X.X.X)"
  314.  
  315. The last line of the login sequence serves to capture only the portions 
  316. of the text that contains the IP addresses you want to configure to, 
  317. and then parse them into the two variables [$IPDEST] and [$IPADDR].
  318. It is looking for an "is" followed by a space; then the destination IP 
  319. address. Then, it ignores a series of spaces and looks for another "is" 
  320. followed by a space, then parses the user's IP address.
  321.  
  322. Common Problems and Their Solutions
  323. -----------------------------------
  324. Question 1
  325. ----------
  326. I try to dial and nothing happens...it changes the icon to hang up, and 
  327. then right back to dial.
  328.  
  329. Answer
  330.  
  331. Either the PPP or SLIP driver cannot start, or there is an invalid 
  332. entry in the settings that was not detected. A common invalid setting 
  333. is the netmask. If you see something like 255.255.255.254, change it to 
  334. 255.255.255.0. Another common problem is placing a physical space in 
  335. the loginid or password. In the dialer, a physical space is an invalid 
  336. character and will result in the dialer failing to parse the 
  337. configuration information and not dial out.  To represent a space, rem
  338. ember to use a "\s."  Otherwise, you should try to initialize the SLIP 
  339. or PPP driver from command line. For more information, type PPP -?, or 
  340. SLIP -? at an OS/2 command prompt. 
  341.   
  342. Examples:  
  343.  
  344.      PPP COM1 57600  should result in:
  345.  
  346. PPP       OS/2 TCP/IP Point-to-Point Protocol Driver
  347. 2.00      Copyright(c) IBM Corp. 1994, 1995
  348.           Revision: 1.17a   29 Mar 1996 14:00:00
  349.  
  350. notice : OS/2 ppp 2.00 Revision: 1.17a started by OS/2, pid 216
  351. info   : Using interface ppp0
  352. info   : Setting line characteristics
  353. info   : Setting com port baud rate to 57600
  354. notice : Linking: ppp0 <--> com1
  355.  
  356. and,
  357.  
  358.       SLIP  should result in:
  359.  
  360. SL/IP      OS/2 TCP/IP Multiple Interface SLIP Drive
  361.     2.00       Copyright(c) IBM Corp. 1993,1994,1995
  362.                Revision: 1.28  20 Oct 1995 13:57:56
  363. Current bit rate is 57600
  364. MON ] SLIP Driver Running.  Exit with Ctrl-C or Ctrl-Break
  365.  
  366. Question 2
  367. ----------
  368. I tried to initialize PPP from command line and got the following 
  369. message: "PPP not supported 
  370. under this stack."
  371.  
  372. Answer
  373.  
  374. You have installed a networking product that has downleveled the MPTS 
  375. (Multi-Protocol Transport Services) on the system.  You need to install 
  376. the MPTS from OS/2 Warp Connect to update the MPTS to support PPP.
  377.  
  378. Question 3
  379. ----------
  380. The PPP driver has started, but I see errors that say "COMW, only 1 of 
  381. 52 bytes written."
  382.  
  383. Answer  
  384.  
  385. Your COM port drivers need to be updated. Updated drivers, with a 
  386. filename of WARPCOM.ZIP, can be obtained from the following sites:
  387.    
  388.       SDM BBS:  (512) 823-0345 in area 3
  389.      INTERNET:  anonymous FTP site testcase.boulder.ibm.com
  390.                 in the /ps/fromibm/os2 directory
  391.  
  392. Question 4
  393. ----------
  394. I attempt to start PPP from command line and I get: "Error 22 during 
  395. DOSDEVIOCTL."
  396.  
  397. Answer
  398.  
  399. This indicates that the IBM TCP/IP protocol is not installed in the 
  400. MPTS configuration for LAN Adapters and Protocols. This protocol must
  401. be installed here even if you are not doing TCP/IP over a LAN.
  402.  
  403. Question 5
  404. ----------
  405. It appears that I have connected to the Internet Provider, but I saw 
  406. "Invalid Protocol 2080" errors during the connection. What does that 
  407. mean?
  408.  
  409. Answer
  410.  
  411. This notice is fine as long as the connection continues. Basically, it 
  412. means that either the server or the client started the IP negotiation 
  413. before the other was ready. If this notice results in losing the 
  414. connection, then reexamine your login sequence.
  415.  
  416. Question 6
  417. ----------
  418. It appears that I have connected to the Internet Provider, but I see 
  419. "Invalid FCS" errors. What does that mean?
  420.  
  421. Answer
  422.  
  423. Basically, "Invalid FCS" equates to a bad packet received by either the 
  424. server or client. FCS stands for Frame Check Sequence. A few of these 
  425. usually implies a dirty phone line. If you are getting many of these, 
  426. examine the COM port drivers used, or the modem initialization used to 
  427. connect to your provider's modem pool. This could also be the result 
  428. of an incorrect login sequence.
  429.  
  430. ______________________________________________________________________
  431. IBM disclaims all warranties, whether express or implied, including 
  432. without limitation, warranties of fitness and merchantability with 
  433. respect to the information in this document. By furnishing this 
  434. document, IBM grants no licenses to any related patents or copyrights.  
  435. Copyright (c) 1994, 1995 IBM Corporation. Any trademarks and product 
  436. or brand names referenced in this document are the property of their 
  437. respective owners. Consult your product manuals for complete trademark 
  438. information. 
  439.  
  440.