home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / igate110.zip / IGATE.INF (.txt) < prev    next >
OS/2 Help File  |  1997-05-06  |  73KB  |  910 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. Welcome to Internet Gate for OS/2┬╖ 
  5.  
  6. Internet Gate (sometimes simply called IGATE) is basically a multiple proxy 
  7. gate and firewall. If set up correctly, it can allow users on a Local Area 
  8. Network (LAN) without Internet access to access the Internet through a single 
  9. machine on the LAN connected to the Internet, either via a dial-up modem / ISDN 
  10. connection or another ethernet card┬╖ 
  11.  
  12. Internet Gate will allow you to use the following: 
  13.  
  14. Email 
  15. World Wide Web 
  16. FTP 
  17. News 
  18. Telnet 
  19. IRC (Internet Relay Chat) 
  20. DNS (Domain Name Server) 
  21.  
  22. Internet Gate can save you money by removing the need to get a separate dial-up 
  23. account, with phoneline and modem for each user that wants access to the 
  24. Internet. Now they can all use the one link, at the same time┬╖ 
  25.  
  26. System Requirements 
  27.  
  28. OS/2 Warp 3 or 4 
  29. IBM Internet Connection for OS/2 
  30. Dialup Internet Access 
  31.  
  32.  
  33. ΓòÉΓòÉΓòÉ 2. Features ΓòÉΓòÉΓòÉ
  34.  
  35. Internet Gate provides the following features: 
  36.  
  37. SOCKS V4 Server 
  38.  
  39. Allows any SOCKS-compatible client application (such as Netscape Navigator) to 
  40. operate fully, thereby allowing full FTP within Netscape Navigator, as well as 
  41. Gopher access, and access to secure servers. 
  42.  
  43. WWW Proxy (HTTP only) 
  44.  
  45. Allows the use of WWW (World Wide Web) browsers such as Netscape Navigator, Web 
  46. Explorer or Mosaic to access the World-Wide Web This release only supports the 
  47. use of HTTP protocol, so browsers should use the SOCKS server for other 
  48. protocols. 
  49.  
  50. FTP proxy 
  51.  
  52. Allows use of FTP client applications that support the username@hostname method 
  53. of firewall traversal Examples of this are WS_FTP, and CuteFTP, as well as 
  54. command-line FTP clients. 
  55.  
  56. Telnet proxy 
  57.  
  58. Allows use of Telnet clients to connect to remote servers. 
  59.  
  60. SMTP proxy 
  61.  
  62. Allows SMTP (Mail) clients (eg Eudora, Pegasus mail, Microsoft Exchange) to 
  63. access an SMTP server to deliver your mail. 
  64.  
  65. POP3 proxy 
  66.  
  67. Allows POP3 clients (eg Eudora, Pegasus mail, Microsoft Exchange) to access 
  68. POP3 servers to read their mail. 
  69.  
  70. NNTP proxy 
  71.  
  72. Allows NNTP clients (eg FreeAgent, Netscape Navigator, News Reader/2) to access 
  73. NNTP servers to read the newsgroups. 
  74.  
  75. IRC (Internet Relay Chat) proxy 
  76.  
  77. Allows IRC clients (eg mIRC or pmIRC) to access an IRC server and join online 
  78. chats. 
  79.  
  80. DNS (Domain Name Server) proxy 
  81.  
  82. Allows your LAN to access the Internet using mnemonic names (such as 
  83. arci01.bo.cnr.it) instead of the cumbersome IP addresses (such as 
  84. 192.167.190.10). Internet Gate incorporates a DNS proxy gateway that will relay 
  85. the DNS requests made by your LAN to a DNS server of your choice on the 
  86. Internet. 
  87.  
  88. You can monitor who is accessing the gateway through the Users page. 
  89.  
  90.  
  91. ΓòÉΓòÉΓòÉ 3. Installation ΓòÉΓòÉΓòÉ
  92.  
  93. The installation procedure is quite simple, just unpack the distribution 
  94. archive in a directory of your choice. Internet gate is already configured with 
  95. the default values and it is ready to be started. 
  96.  
  97. However, before running Internet Gate make sure you have your computers 
  98. configured correctly. 
  99.  
  100. First of all check your local network configuration, make sure that you have 
  101. the TCP/IP protocol installed and running correctly (refer to your TCP/IP 
  102. installation manual for more informations). 
  103.  
  104. While you can use any IP address for your local network, Internet Gate will 
  105. mask your real IP address from the Internet, there are some officially defined 
  106. IP addresses that should be used for networks that are not visible from the 
  107. Internet and/or for testin pourpouses. The suggested address is a class C 
  108. network 10.1.2.xxx. Class C network means that you have up to 253 IP addresses 
  109. for your LAN numbered from 10.1.2.1 to 10.1.2.254. The 10.1.2.0 and 10.1.2.255 
  110. are reserved addresses and must not be used. 
  111.  
  112. Now you should designate the server computer, the one that is directly 
  113. connected to the Internet provider through a leased line or a normal dial-up 
  114. line. Make sure that the other computers can see the server by using your 
  115. TCP/IP's ping utility. 
  116.  
  117. The last thing to do is to connect the server computer to your Internet Service 
  118. Provider. To do so please consult your Internet Service Provider. Make sure 
  119. that the connection is up and running by using the TCP/IP's ping utility or by 
  120. using an internet client (web browser, ftp or telnet) and connect a couple of 
  121. sites. 
  122.  
  123. Now you can start Internet Gate using the icon from the Internet Gate folder, 
  124. or with the following command: 
  125.  
  126. IGATE
  127.  
  128. If you want a folder and a program object for Internet Gate be automatically 
  129. created, you can execute the desktop.cmd file that you should find inside the 
  130. distribution package. 
  131.  
  132. If everything works correctly you should see the list of available proxy 
  133. servers in the Enabled status. If some or all the servers are in the Disabled 
  134. state, then there is something not configured correctly. Most probably you 
  135. already have a server running at the port listed in the Port column. 
  136.  
  137. Now you can test the functionality of the proxy server. Go to one of the other 
  138. computers connected to your network and start a Web browser. 
  139.  
  140. If you are using Netscape Navigator open the 'Network Preferences' dialog from 
  141. the 'Options' pulldown menu. Now click on the 'Proxies' tab. Select the 'Manual 
  142. Proxy Configuration' button then click on the 'View' button. Now enter the 
  143. following informations: 
  144.  
  145. HTTP Proxy: <server IP>         Port: 80
  146. SOCKS Host: <server IP>         Port: 1080
  147.  
  148. Where <server IP> is the IP address of the server computer, for example 
  149. 10.1.2.1. 
  150.  
  151. If you are using Web Explorer open the 'Servers' dialog from the 'Configure' 
  152. pulldown menu. Write your server's IP address in the 'Socks Server' field and 
  153. click the 'Enable Socks Server?' button. 
  154.  
  155. For any other Web browser, please refer to the browser's documentation to 
  156. enable the use of an HTTP and/or SOCKS proxy server. 
  157.  
  158. Now try to connect to a site of your choice. If you click on the 'Users' tab of 
  159. Internet Gate you should see a message like the following: 
  160.  
  161. User on 10.1.2.2 has 2 open connections
  162.  
  163. 10.1.2.2 should be the IP address of the computer you are browsing the net 
  164. from. 
  165.  
  166.  
  167. ΓòÉΓòÉΓòÉ 4. Configuration ΓòÉΓòÉΓòÉ
  168.  
  169. Telnet, FTP, WWW, SOCKS, NNTP 
  170.  
  171. SMTP, POP3, Domain Name Server 
  172.  
  173. IRC 
  174.  
  175.  
  176. ΓòÉΓòÉΓòÉ 4.1. Telnet, FTP, WWW, SOCKS, NNTP ΓòÉΓòÉΓòÉ
  177.  
  178. Click on the 'Settings' tab. 
  179.  
  180. From this page you can configure the Telnet, FTP, WWW (HTTP), SOCKS and NNTP 
  181. servers. Clicking on the small right arrow located on the top-right corner of 
  182. the window enable the other settings pages from which you can configure the 
  183. SMTP (Mail) and POP3, Domain Name and IRC servers. 
  184.  
  185. If you want to disable one or more servers just remove the check mark on the 
  186. left of the server's name. If you already have another server running on the 
  187. same port as one of the Internet Gate servers click on the corresponding 'Port' 
  188. field and change the number to one of your choice. 
  189.  
  190. Remember that the changes made through the 'Settings' pages have effect only if 
  191. you press the 'Save' button. 
  192.  
  193. As you may notice the NNTP server is defined as 'Mapped Link'. When a client 
  194. connects to one of these servers, Internet Gate connect itself to the 
  195. corresponding port on the server defined in the 'Server' field and creates a 
  196. transparent bidirectional pipe between the client and the server. This is 
  197. called Mapped Link because the Internet Gate effectively maps one of it's 
  198. server ports to another server transparently to the client. 
  199.  
  200. You should choose a server for the NNTP (News) mapped link. Your Internet 
  201. Service Provider should have this server available for use. Please contact your 
  202. Internet Service Provider for more informations. 
  203.  
  204. The use of mapped links can be extended to other protocols as well, but when 
  205. possible is preferable to use the SOCKS server. The SOCKS server allows any 
  206. client to connect to any server on any port. The use of the SOCKS server alone 
  207. can make the other servers no more useful, unfortunately there are very few 
  208. clients that can use a SOCKS server. 
  209.  
  210. Using the Telnet gateway 
  211. Using the FTP gateway 
  212. Using the WWW gateway 
  213. Using the SOCKS server 
  214. Using the NNTP gateway 
  215.  
  216.  
  217. ΓòÉΓòÉΓòÉ 4.1.1. Using the Telnet gateway ΓòÉΓòÉΓòÉ
  218.  
  219. There is no way to use a proxy server transparently with the telnet client, 
  220. unless the telnet client can be configured to use a SOCKS server. 
  221.  
  222. If you still want to use the telnet client with Internet Gate, you should first 
  223. connect to Internet Gate with the following command: 
  224.  
  225. telnet 10.1.2.1
  226.  
  227. Where 10.1.2.1 is the address of the computer where Internet Gate is running. 
  228. Now you should see the following message: 
  229.  
  230. Internet Gate>
  231.  
  232. Now type the name of the server you want to connect to and press enter, for 
  233. example: 
  234.  
  235. Internet Gate> arci01.bo.cnr.it
  236.  
  237. After few moments you should see the remote server login screen. 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ 4.1.2. Using the FTP gateway ΓòÉΓòÉΓòÉ
  241.  
  242. Netscape Navigator 
  243.  
  244. Is not possible to use the FTP proxy server with Netscape Navigator. This is a 
  245. known limitation of the FTP protocol implemented by the proxy server. The only 
  246. way to do FTP with Netscape Navigator is by configuring the SOCKS server. 
  247.  
  248. CuteFTP 
  249.  
  250. If you are using CuteFTP open the 'Options' dialog from the 'FTP' -> 'Settings' 
  251. pulldown menu. Click on the 'Firewall' tab. Now enter the IP address of the 
  252. computer where Internet Gate is running in the 'Host' field and the FTP 
  253. server's port number (normally 21) in the 'Port' field. Click on the 'USER 
  254. user@site' radio button and 'Enable firewall access' button. 
  255.  
  256. Command line FTP-client 
  257.  
  258. If you are using a command line version of the FTP client, you should first 
  259. connect to the computer where Internet Gate is running, with a command like the 
  260. following: 
  261.  
  262. ftp 10.1.2.1
  263.  
  264. Where 10.1.2.1 is the IP address of the computer where Internet Gate is 
  265. running. At the user prompt type the user name you want to use on the remote 
  266. FTP site, following by the at (@) sign, followed by the FTP site name, like the 
  267. following: 
  268.  
  269. Username: anonymous@ftp.cdrom.com
  270.  
  271. At the 'Password' prompt type your password on the remote site. 
  272.  
  273.  
  274. ΓòÉΓòÉΓòÉ 4.1.3. Using the WWW gateway ΓòÉΓòÉΓòÉ
  275.  
  276. Netscape Navigator 
  277.  
  278. If you are using Netscape Navigator open the 'Network Preferences' dialog from 
  279. the 'Options' pulldown menu. Now click on the 'Proxies' tab. Select the 'Manual 
  280. Proxy Configuration' button then click on the 'View' button. Now enter the 
  281. following informations: 
  282.  
  283. HTTP Proxy: <server IP>         Port: 80
  284.  
  285. Where <server IP> is the IP address of the server computer, for example 
  286. 100.1.1.1. 
  287.  
  288. Web Explorer 
  289.  
  290. If you are using Web Explorer open the 'Servers' dialog from the 'Configure' 
  291. pulldown menu. Write your server's IP address in the 'Socks Server' field and 
  292. click the 'Enable Socks Server?' button. 
  293.  
  294. For any other Web browser, please refer to the browser's documentation to 
  295. enable the use of an HTTP gateway. 
  296.  
  297.  
  298. ΓòÉΓòÉΓòÉ 4.1.4. Using the SOCKS server ΓòÉΓòÉΓòÉ
  299.  
  300. The SOCKS server allows a client software to request connection only to/from IP 
  301. addresses, therefore your network must provide a DNS (Domain Name Service) 
  302. server to resolve the host names to IP addresses. 
  303.  
  304. Netscape Navigator 
  305.  
  306. If you are using Netscape Navigator open the 'Network Preferences' dialog from 
  307. the 'Options' pulldown menu. Now click on the 'Proxies' tab. Select the 'Manual 
  308. Proxy Configuration' button then click on the 'View' button. Now enter the 
  309. following informations: 
  310.  
  311. SOCKS Host: <server IP>         Port: 1080
  312.  
  313. Where <server IP> is the IP address of the server computer, for example 
  314. 100.1.1.1. 
  315.  
  316. Web Explorer 
  317.  
  318. If you are using Web Explorer open the 'Servers' dialog from the 'Configure' 
  319. pulldown menu. Write your server's IP address in the 'Socks Server' field and 
  320. click the 'Enable Socks Server?' button. 
  321.  
  322. For any other Web browser, please refer to the browser's documentation to 
  323. enable the use of a SOCKS server. 
  324.  
  325.  
  326. ΓòÉΓòÉΓòÉ 4.1.5. Using the NNTP gateway ΓòÉΓòÉΓòÉ
  327.  
  328. There is no way to use a proxy server transparently with a news (NNTP) reader, 
  329. unless the news reader can be configured to use a SOCKS server. 
  330.  
  331. If you still want to use a news reader with Internet Gate, you should configure 
  332. the reader itself with the IP address of the computer where Internet Gate is 
  333. running as it's news server address. 
  334.  
  335. Now you can use your news reader the same way you used it before. Internet Gate 
  336. will map any NNTP command to the NNTP server defined in the 'Settings' tab and 
  337. will report any response to the news reader. 
  338.  
  339. Netscape Navigator 
  340.  
  341. If you are using Netscape Navigator as news reader, open the 'Mail and News 
  342. Preferences' dialog from the 'Options' pulldown menu. Click on the 'Servers' 
  343. tab. 
  344.  
  345. In the 'News (NNTP) Server' field type the IP address of the computer where 
  346. Internet Gate is running. 
  347.  
  348.  
  349. ΓòÉΓòÉΓòÉ 4.2. SMTP, POP3 ΓòÉΓòÉΓòÉ
  350.  
  351. Click on the 'Settings' tab, then click on the small right-arrow located on the 
  352. upper-right corner of the notebook window. 
  353.  
  354. From this page you can configure the SMTP, POP3, and Domain Name servers. 
  355. Clicking on the small right arrow located on the top-right corner of the window 
  356. enable the other settings pages from which you can configure the IRC servers. 
  357.  
  358. If you want to disable one or more servers just remove the check mark on the 
  359. left of the server's name. If you already have another server running on the 
  360. same port as one of the Internet Gate servers click on the corresponding 'Port' 
  361. field and change the number to one of your choice. 
  362.  
  363. Remember that the changes made through the 'Settings' pages have effect only if 
  364. you press the 'Save' button. 
  365.  
  366. As you may notice the SMTP and POP3 servers are defined as 'Mapped Link'. When 
  367. a client connects to one of these servers, Internet Gate connect itself to the 
  368. corresponding port on the server defined in the 'Server' field and creates a 
  369. transparent bidirectional pipe between the client and the server. This is 
  370. called Mapped Link because the Internet Gate effectively maps one of it's 
  371. server ports to another server transparently to the client. 
  372.  
  373. You should choose a server for the SMTP and POP3 mapped links. Your Internet 
  374. Service Provider should have these servers available for use. Please contact 
  375. your Internet Service Provider for more informations. 
  376.  
  377. The use of mapped links can be extended to other protocols as well, but when 
  378. possible is preferable to use the SOCKS server. The SOCKS server allows any 
  379. client to connect to any server on any port. The use of the SOCKS server alone 
  380. can make the other servers no more useful, unfortunately there are very few 
  381. clients that can use a SOCKS server. 
  382.  
  383. Using the SMTP and POP3 gateways 
  384.  
  385.  
  386. ΓòÉΓòÉΓòÉ 4.2.1. Using the SMTP and POP3 gateways ΓòÉΓòÉΓòÉ
  387.  
  388. Netscape Navigator 
  389.  
  390. If you are using Netscape Navigator for your mail handling, open the 'Mail and 
  391. News Preferences' dialog from the 'Options' pulldown menu. Click on the 
  392. 'Servers' tab. 
  393.  
  394. In the 'Outgoing Mail (SMTP) Server' and 'Incoming Mail (POP3) Server' fields 
  395. type the IP address of the computer where Internet Gate is running. In the 
  396. 'POP3 User Name' field type your user name followed by the separator character 
  397. you choose in the 'Settings' tab (default the pound # sign), followed by the 
  398. POP3 server where you have your account. For example: 
  399.  
  400. macca#arcibbs.bo.cnr.it
  401.  
  402. Now click on the 'Identity' tab and fill the 'Your Name' and 'Your Email' 
  403. fields. This is necessary to have your answers going back correctly. 
  404.  
  405.  
  406. ΓòÉΓòÉΓòÉ 4.3. IRC, Domain Name Server ΓòÉΓòÉΓòÉ
  407.  
  408. Click on the 'Settings' tab, then click two times on the small right-arrow 
  409. located on the upper-right corner of the notebook window. 
  410.  
  411. From this page you can configure the IRC server. 
  412.  
  413. If you want to disable one or more servers just remove the check mark on the 
  414. left of the server's name. If you already have another server running on the 
  415. same port as one of the Internet Gate servers click on the corresponding 'Port' 
  416. field and change the number to one of your choice. 
  417.  
  418. Remember that the changes made through the 'Settings' pages have effect only if 
  419. you press the 'Save' button. 
  420.  
  421. As you may notice the IRC server is defined as 'Mapped Link'. When a client 
  422. connects to one of these servers, Internet Gate connect itself to the 
  423. corresponding port on the server defined in the 'Server' field and creates a 
  424. transparent bidirectional pipe between the client and the server. This is 
  425. called Mapped Link because the Internet Gate effectively maps one of it's 
  426. server ports to another server transparently to the client. 
  427.  
  428. You should choose a server for the IRC mapped link. Your Internet Service 
  429. Provider should have this server available for use. Please contact your 
  430. Internet Service Provider for more informations. 
  431.  
  432. The use of mapped links can be extended to other protocols as well, but when 
  433. possible is preferable to use the SOCKS server. The SOCKS server allows any 
  434. client to connect to any server on any port. The use of the SOCKS server alone 
  435. can make the other servers no more useful, unfortunately there are very few 
  436. clients that can use a SOCKS server. 
  437.  
  438. Using the IRC gateway 
  439. Using the DNS proxy 
  440.  
  441.  
  442. ΓòÉΓòÉΓòÉ 4.3.1. Using the IRC gateway ΓòÉΓòÉΓòÉ
  443.  
  444. mIRC 
  445.  
  446. If you are using mIRC as your IRC client, open the mIRC Setup window and click 
  447. on the 'Firewall' tab. Click on the 'Use SOCKS firewall' checkbox and fill in 
  448. the IP address of the OS/2 machine running Internet Gate in the 'Hostname' 
  449. field, and the SOCKS server port number (default to 1080) in the 'Port' field. 
  450. The other fields must be left blank. 
  451.  
  452. Other IRC clients 
  453.  
  454. For any other IRC client you can find and configure the SOCKS server, just like 
  455. mIRC, or you can directly configure the machine where Internet Gate is running 
  456. as the IRC server, the mapped link on Internet Gate should relay the traffic 
  457. between your client and the real IRC server. 
  458.  
  459.  
  460. ΓòÉΓòÉΓòÉ 4.3.2. Using the DNS proxy ΓòÉΓòÉΓòÉ
  461.  
  462. OS/2 Warp 
  463.  
  464. If you are using OS/2 Warp as your client machine, there are two methods to 
  465. configure the DNS entry. First by editing the \tcpip\etc\resolv file. The first 
  466. line of this file should contain your domain name, the second line containts 
  467. the IP address of the OS/2 machine that is running Internet Gate. Example: 
  468.  
  469. iol.it
  470. 194.20.25.13
  471.  
  472. The second method is by using the TCP/IP configuration applet: Open the TCP/IP 
  473. folder and double click on the 'TCP/IP Configuration' icon. Now select the 
  474. 'Host Names' tab. Remove all entries from the 'Nameserver Addresses' listbox by 
  475. clicking on the address and then click the 'Delete' button. Now click on the 
  476. 'Add' button and add the IP address of the OS/2 machine that is running 
  477. Internet Gate. Shutdown OS/2 and at the next restart your system should be 
  478. configured properly. 
  479.  
  480. Windows 95 
  481.  
  482. If you are using Windows 95 as your client machine, you must configure the DNS 
  483. entry for the TCP/IP Network to match the IP address of the OS/2 machine 
  484. running Internet Gate. 
  485.  
  486. Right-click on the 'Network Neighborhood' icon and select 'Properties' from the 
  487. pop-up menu. Click on the 'TCP/IP -> [your LAN card]' entry (where [your LAN 
  488. card] is the name of your LAN adapter) and click on the 'Properties' button. 
  489. Click on the 'DNS Configuration' tab. 
  490.  
  491. Click on the 'Enable DNS' checkbutton and fill-in the 'Host' and 'Domain' field 
  492. to whatever you like. From the 'DNS Server Search Order' remove all the entry 
  493. by clicking on the IP address in the listbox then clicking on the 'Remove' 
  494. button. Now write the IP address of the OS/2 machine running Internet Gate on 
  495. the entry box and click the 'Add' button. 
  496.  
  497. Now close all the configuration windows clicking on the 'Ok' buttons. Now 
  498. shutdown Windows. At the next restart you system should be configured correctly 
  499. to use the Internet Gate DNS. 
  500.  
  501.  
  502. ΓòÉΓòÉΓòÉ 5. Using the Dialer ΓòÉΓòÉΓòÉ
  503.  
  504. Internet Gate has a built-in dialer that can be used to automate the 
  505. connections to your Service Provider. 
  506.  
  507. Auto connect to 
  508.  
  509. If enabled this option allows Internet Gate to automatically initiate a 
  510. connection to your Internet Service Provider, using the informations given in 
  511. the Options and Advanced dialogs, whenever a connection request is received. 
  512. The name you write in the edit box is used only for your reference, to remember 
  513. for which provider you have configured the dialer. It has no other functions. 
  514.  
  515. Number of attempts 
  516.  
  517. This field indicates the number of connection attempts that should be made. 
  518. When the attempt limit is reached, you should shutdown and restart Internet 
  519. Gate in order to be able to connect again to your Service Provider. 
  520.  
  521. Auto disconnect after 
  522.  
  523. If enabled, this option instructs the PPP or SLIP driver to hangup the 
  524. connection when there is no IP traffic for the amount of minutes specified. 
  525. Using this option along with the auto connection feature will result in your 
  526. LAN being connected to your Service Provider only when requested, with an 
  527. obvious save of connection expenses. 
  528.  
  529. Connection status 
  530.  
  531. This window display the current status of the connection. When online to the 
  532. service provider, the amount of time elapsed will be displayed. 
  533.  
  534. Dialing options 
  535. Advanced options 
  536.  
  537.  
  538. ΓòÉΓòÉΓòÉ 5.1. Dialing options ΓòÉΓòÉΓòÉ
  539.  
  540. Username 
  541.  
  542. Spcify the user identification assigned to your account. This information 
  543. should be supplied by the Internet Service Provider. 
  544.  
  545. Password 
  546.  
  547. Specify the password assigned to your account. This information should be 
  548. supplied by the Internet Service Provider. 
  549.  
  550. Phone number 
  551.  
  552. Specify the phone number used to access the destination host or service 
  553. provider's network. Include any long-distance and outside line access codes and 
  554. the area code. 
  555.  
  556. For example, if you normally dial 1 to access your long-distance carrier, the 
  557. phone number might be: 1-800-555-5555. 
  558.  
  559. This information should be supplied by the Internet Service Provider. 
  560.  
  561. Com port 
  562.  
  563. Specify the name of the communications port of your computer to which your 
  564. modem is attached. The default communication port is COM2. 
  565.  
  566. Select the symbol to the right of the field to move through the available 
  567. communications ports. 
  568.  
  569. Speed 
  570.  
  571. Specify the speed of the connection. This may be equal to or less than the 
  572. capacity of your modem.  The default speed is 19200. speed is the 
  573. async-to-modem bit rate (19200 to 115200). 
  574.  
  575. The async card UART (universal asynchronous receiver/transmitter) rate is not 
  576. the same as the modem line rate. If the modem rate and async communications 
  577. port rate are different, then data flow control is used to coordinate the async 
  578. card and the modem; to prevent one from overrunning the other. This is called 
  579. pacing.  Pacing is required for newer modems to use data compression. If the 
  580. two rates are the same, then the modem tries to adjust its rate to that of the 
  581. async communications port. This is called bit rate adjustment. It is 
  582. recommended that you use as high a bit rate as is supported by the hardware. 
  583.  
  584. Select the symbol to the right of the field to move through the available 
  585. speeds. 
  586.  
  587. This information should be supplied by the Internet Service Provider. 
  588.  
  589. Data bits 
  590.  
  591. Specify the number of data bits in each character sent or received. Valid 
  592. values are 5 to 8. The default is 8. 
  593.  
  594. Select the symbol to the right of the field to move through the available 
  595. values. 
  596.  
  597. This information should be supplied by the Internet Service Provider. 
  598.  
  599. Parity 
  600.  
  601. Specify the parity of the connection. A parity bit is appended to a group of 
  602. binary digits to cause the sum of the digits to be either even or odd.  This 
  603. parity bit is used in parity checks and should match the setting of the 
  604. receiving modem. 
  605.  
  606. Valid values are none, even, and odd. The default is NONE. 
  607.  
  608. Select the symbol to the right of the field to move through the available 
  609. values. 
  610.  
  611. This information should be supplied by the Internet Service Provider. 
  612.  
  613. Prefix 
  614.  
  615. Specify the dial prefix for your modem. This is the attention command string 
  616. that is passed to the modem and that precedes the phone number. The default in 
  617. Dial mode is ATDT. The default in Answer mode is ATS0=2S7=30. 
  618.  
  619. This information should be supplied in your modem documentation. 
  620.  
  621. Initialization 
  622.  
  623. Specify the initialization strings for your modem. These are the commands that 
  624. initiates the modem. 
  625.  
  626. This information should be supplied in your modem documentation. 
  627.  
  628. Script 
  629.  
  630. Specify the login sequence that you want to use, if any. You can use a login 
  631. sequence to automate a connection. 
  632.  
  633. To accommodate a variety of connection sequences, this field may contain: 
  634.  
  635. Blank, or no entry. This indicates no login sequence is required beyond the 
  636. physical modem connection. 
  637.  
  638. The name of a REXX connection script (or response file), for example, 
  639. annex.cmd.  This file is executed at connection time to negotiate the modem 
  640. setup, dial the destination host, and log into the host. 
  641.  
  642. Response files can be loosely divided into two groups; ASCII text-based files 
  643. and REXX scripts. 
  644.  
  645. The simpler of the two, the ASCII text-based response file, contains a list of 
  646. send and expect sequences (commands to be sent and responses to be expected). 
  647. This type of response file can be used when all the configuration information 
  648. is static and is supplied by the service provider prior to the user making a 
  649. connection. TCP/IP for OS/2 provides a sample of this type of response file in 
  650. your BIN subdirectory called SAMPLE.RSP. To use this login script, modify the 
  651. file per the instructions in the file, and specify SAMPLE.RSP in the Login 
  652. Script field. 
  653.  
  654. The REXX script allows for a more flexible configuration (at the expense of 
  655. added complexity).  It is applicable in cases where the IP addresses, netmask, 
  656. nameservers, and other information must be configured dynamically at each new 
  657. connection. This type of login script can be used, for example, for a login 
  658. through an Annex-based server. Due to the complexity, use of a REXX script 
  659. requires an understanding of REXX programming. TCP/IP for OS/2 provides a 
  660. sample of this type of response file in your BIN subdirectory called ANNEX.CMD. 
  661. To use this login script, modify the file per the instructions in the file, and 
  662. specify 
  663.  
  664. annex.cmd atdtX-XXX-XXX-XXXX <login id> <password>
  665.  
  666. in the Login Sequence field.  Where X-XXX-XXX-XXXX is the phone number of your 
  667. service provider, <login id> is your login ID, and <password> is your password. 
  668. The extension, .cmd, is required. 
  669.  
  670. Each Service Provider may use a slightly different sequence for establishing a 
  671. connection. You must tailor your Script to match each service provider. 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ 5.2. Advanced options ΓòÉΓòÉΓòÉ
  675.  
  676. Your IP address 
  677.  
  678. Specify the 32-bit dotted decimal notation Internet Protocol (IP) address 
  679. assigned to you. An example of an IP address is: 9.67.43.126. 
  680.  
  681. If you are using SLIP to access a service provider, this information should be 
  682. supplied by the provider. 
  683.  
  684. Remote IP address 
  685.  
  686. Specify the 32-bit dotted decimal notation Internet Protocol (IP) address of 
  687. the destination host to which you want to connect. 
  688.  
  689. If you are using SLIP to access a service provider, this information should be 
  690. supplied by the provider. 
  691.  
  692. Netmask 
  693.  
  694. Specify the 32-bit dotted decimal notation network mask used to indicate which 
  695. portion of your IP address represents the network address and which represents 
  696. the host address. 
  697.  
  698. If you are using a service provider, this information should be supplied by the 
  699. provider. 
  700.  
  701. Domain Nameserver 
  702.  
  703. Specify the 32-bit dotted decimal notation Internet Protocol (IP) address of 
  704. the server that resolves host names to IP addresses. 
  705.  
  706. This information should be supplied by the Internet Service Provider. 
  707.  
  708. Your host name 
  709.  
  710. Specify the symbolic name assigned to your computer. 
  711.  
  712. This information should be supplied by the Internet Service Provider. 
  713.  
  714. Your domain name 
  715.  
  716. Specify the name of the domain in which your computer resides. The domain name 
  717. includes all subdomains and the root domain separated by periods. An example of 
  718. a domain name is: eng.mit.mass.edu 
  719.  
  720. This information should be supplied by the Internet Service Provider. 
  721.  
  722.  
  723. ΓòÉΓòÉΓòÉ 6. Registration and Support Sites ΓòÉΓòÉΓòÉ
  724.  
  725. Internet Gate is not a time-limited program, however without a registration key 
  726. it will only allow 1 user at a time to access the Internet at a time. 
  727.  
  728. You may register with payment for a key that will remove the 1 user limitation. 
  729. Depending on your requirements, you may choose a license that suits. Keys are 
  730. available for the following numbers of concurrent users. 
  731.  
  732. 5 Users 
  733. 10 Users 
  734. 25 Users 
  735. unlimited 
  736.  
  737. A concurrent user means any one machine that is connected to Internet Gate 
  738. using TCP. Internet Gate will only allow connections from different machines up 
  739. to the maximum licensed amount. So if you have a 2 user license, Internet Gate 
  740. will accept connections from only two machines (these could be anywhere - not 
  741. necessarily on your own LAN, if someone is connecting from the Internet) at any 
  742. one time. 
  743.  
  744. To register Internet Gate fill out the following registration form and send it 
  745. along with your payment to the address written below. Please make all checks 
  746. payable to Marco Maccaferri. 
  747.  
  748. You can register Internet Gate 1.10 from one of the following registration 
  749. sites: 
  750.  
  751. Worldwide Credit Card Registrations: 
  752.  
  753. BMT Micro 
  754. PO Box 15016 
  755. Wilmington, NC 28408 
  756. U.S.A. 
  757. http://www.bmtmicro.com 
  758.  
  759. Please see the order.frm file or start the Purchase application for more 
  760. informations about registering with BMT Micro. 
  761.  
  762. Italy and other countries: 
  763.  
  764. Marco Maccaferri 
  765. via Ferrara, 9 
  766. 40139 Bologna, Italy 
  767. BBS: +39-51-6331730 
  768. +39-51-6331746 
  769. Internet: macca@arci02.bo.cnr.it 
  770. Compuserve: 100421,1633 
  771. Web: http://www.execpc.com/~marco/ 
  772.  
  773.  
  774. ΓòÉΓòÉΓòÉ 7. Registration form ΓòÉΓòÉΓòÉ
  775.  
  776. To:  Marco Maccaferri                                    [IG100]
  777.      via Ferrara, 9
  778.      40139 Bologna
  779.      ITALY
  780.  
  781. Your name:  ________________________________________
  782.  
  783. Address:    ________________________________________
  784.  
  785.             ________________________________________
  786.  
  787. Country:    ________________________________________
  788.  
  789. Email address
  790. (optional): ________________________________________
  791.  
  792. Please tick (see the documentation for help and other
  793. currencies):
  794.  
  795. []  Internet Gate 5 Users             Lit.   110.000 or US$   75
  796. []  Internet Gate 10 Users            Lit.   190.000 or US$  125
  797. []  Internet Gate 25 Users            Lit.   260.000 or US$  170
  798. []  Internet Gate Unlimited Users     Lit.   380.000 or US$  250
  799.  
  800. []  foreign cheque surcharge:         Lit.    15.000 or US$   10
  801.  
  802.     Italian residents and EC residents without VAT number,
  803.     please add 19% sales tax
  804.  
  805.                                  Total: ________________________
  806.  
  807. Payment: []  cash (enclosed), Lit. only
  808.          []  Eurocheque (enclosed), add Lit. 15.000 or US$ 10
  809.          []  other cheque (enclosed), add Lit. 15.000 or US$ 10
  810.  
  811. Signature: ____________________________________________
  812.  
  813.  
  814. ΓòÉΓòÉΓòÉ 8. Shareware licence agreement ΓòÉΓòÉΓòÉ
  815.  
  816. This is a licence agreement between you, the end user, and Marco Maccaferri. 
  817. The Internet Gate 1.10 Shareware software and information attached hereto, 
  818. hereafter "IGATE", is the property of Marco Maccaferri. Read the terms and 
  819. conditions of this licence agreement carefully before using the software. If 
  820. you for any reason, whatsoever, cannot accept the conditions in this agreement, 
  821. you are not permitted to use IGATE. 
  822.  
  823. You acknowledge and agree that IGATE is a proprietary product of Marco 
  824. Maccaferri, protected by applicable copyright laws and international treaty 
  825. provisions. You further acknowledge and agree that all rights, title, and 
  826. interest in and to IGATE are and shall remain with Marco Maccaferri. 
  827.  
  828. IGATE may be used for a period of thirty (30) days on a trial basis to allow 
  829. you to determine its suitability for your particular application. After this 
  830. period you MUST register each copy of IGATE that you run simultaneously. Site 
  831. and Group registrations are available, and are dealt with on a case by case 
  832. basis. 
  833.  
  834. Registration entitles you to use IGATE and any future versions of IGATE for as 
  835. long as you wish, subject to any special licensing conditions and/or applicable 
  836. upgrade fees attached to future versions. 
  837.  
  838. In the event that you are in violation of this licence agreement, you agree and 
  839. accept that Marco Maccaferri may cancel your registration and any rights to use 
  840. IGATE that you may have. In the case of a dispute over the licence agreement, 
  841. you further agree and accept to fully reimburse Marco Maccaferri for legal and 
  842. other expenses resulting from the dispute. 
  843.  
  844. IGATE is provided "as is", without warranty of any kind or fitness for a 
  845. particular purpose, either expressed or implied, all of are hereby explicitly 
  846. disclaimed. Marco Maccaferri only guarantees that IGATE will occupy disk space. 
  847.  
  848. Marco Maccaferri's liability resulting from your use or inability to use IGATE 
  849. is limited to the amount that the affected party has paid for it, or in the 
  850. event that IGATE was registered with a third party for payment to Marco 
  851. Maccaferri, liability is limited to the amount that was received by Marco 
  852. Maccaferri from that third party. 
  853.  
  854. Neither Marco Maccaferri nor any of his employees, agents, or other 
  855. representatives are in any way obligated to provide future versions of, or 
  856. support for, IGATE. 
  857.  
  858. You may freely distribute and copy IGATE provided that no fee is charged and 
  859. the IGATE distribution archive contains unmodified copies of the original files 
  860. as produced by Marco Maccaferri. Pay Bulletin Board Systems may, however, 
  861. charge their normal fee provided that no additional charge for IGATE is levied. 
  862. No part of IGATE may be modified, altered, reverse engineered, sold, or 
  863. distributed in any form whatsoever which would involve some sort of trade 
  864. without prior written permission from Marco Maccaferri. 
  865.  
  866. IGATE may not be used in any unlawful or illegal manner. 
  867.  
  868. All Marco Maccaferri products are trademarks or registered trademarks of Marco 
  869. Maccaferri. Other brand and product names are trademarks or registered 
  870. trademarks of their respective holders. 
  871.  
  872. Copyright 1997 Marco Maccaferri; All rights reserved. 
  873.  
  874.  
  875. ΓòÉΓòÉΓòÉ 9. Revision history ΓòÉΓòÉΓòÉ
  876.  
  877. 05/04/1997 
  878.  
  879. Version 1.10 released to the public 
  880.  
  881. The documentation was rewritten in INF format. 
  882.  
  883. Added the IRC proxy gateway. 
  884.  
  885. 05/03/1997 
  886.  
  887. Added the Auto-Dialer option. 
  888.  
  889. The backspace key is now working and offering basic editing capabilities with 
  890. the telnet client. 
  891.  
  892. 05/02/1997 
  893.  
  894. Added the DNS (Domain Name Server) proxy service. 
  895.  
  896. Fixed a bug in the telnet gateway that improperly configured the telnet client 
  897. with the local echo option. 
  898.  
  899. 02/15/1997 
  900.  
  901. Version 1.01 released to the public. 
  902.  
  903. Fixed a bug the POP3 username parsing algorithm that prevented the POP3 gateway 
  904. to work properly. 
  905.  
  906. 02/08/1997 
  907.  
  908. Version 1.00 released to the public. 
  909.  
  910.