Return-Path: Received: from www1.netcom.com (www1.netcom.com [206.217.29.10]) by ixmail4.ix.netcom.com (8.7.5/SMI-4.1/Netcom) id OAA02387; Sun, 7 Sep 1997 14:36:56 -0700 (PDT) Received: by www1.netcom.com (8.7.5/SMI-4.1/Netcom) id OAA05871; Sun, 7 Sep 1997 14:36:53 -0700 (PDT) Date: Sun, 7 Sep 1997 14:36:53 -0700 (PDT) From: www@www1.netcom.com ((Web Server)) Message-Id: <199709072136.OAA05871@www1.netcom.com> Reply-to: support@ix.netcom.com To: mihalis@ix.netcom.com Subject: Your WebTech Support Query The following message sent by: http://www1.netcom.com/bin/webtech Please do not reply to this message ------------------------------------------------------------------ How to Configure Linux with a NETCOMplete Account NETCOM has versions of the NETCOMplete software which will run on Windows 3.x, Windows 95 and Macintosh machines. We do not support NETCOMplete on the Linux platform. This document is the only support available in configuring Linux with a NETCOM Account. We cannot provide assistance with using Linux, including telephone support. For more information, go to the newsgroups: comp.os.linux.misc comp.os.linux.networking netcom.netcruiser.tech For more information about alternate dialing programs, please see this web page: http://www.webster-image.com/iis/PCsHelpPage/ph-connect.html#top You may also obtain information from the Linux PPP HOWTO: http://www.spade.com/linux/howto/PPP-HOWTO.html This document provides all of the necessary information needed to configure Slackware Linux 3.2 pppd to connect with a NETCOMplete account. This information has also been verified to work with Slackware 3.0. We cannot guarantee that these intructions will work with any other distribution of Linux. Note: Several scripts are included in this document. They will need to be copied as is onto the Linux system. I. REQUIRED PROGRAMS In order to establish a PPP connection, Linux needs support for TCP/IP and PPP in the kernel. Most Slackware pre-compiled kernels with Network support already have this feature. If the kernel does not have this support, however, re-compile the kernel. Consult the Linux documentation for assistance with this step. A working version of pppd and chat is also required. This comes with Linux. If using kernel 1.3.21 or greater, however, obtain version 2.2.0 of pppd. It is available via FTP from: ftp://sunsite.unc.edu/pub/Linux/system/network/serial/ppp/ppp-2.2.0f .tar.gz Both pppd and chat should be placed in the /usr/sbin directory. II. CREATE SCRIPTS AND CONFIGURATION FILES Create the following four files: Filename Perms Ownership Path of file ppp-on 755 root.root /usr/sbin/ppp-on chat-netcom 640 root.root /etc/ppp/chat-netcom options 640 root.root /etc/ppp/options ppp-off 755 root.root /usr/sbin/ppp-off resolv.conf: 644 root.root /etc/resolv.conf The first file that must be created is ppp-on. This is used to actually establish the connection. Below is a sample script: ---- Cut Here ---- #!/bin/sh /usr/sbin/pppd /dev/cua2 38400 \ connect "/usr/sbin/chat -f /etc/ppp/chat-netcom" \ defaultroute modem crtscts lock ---- Cut Here ---- Depending upon which COM port the modem is on, the above script may need to be edited. Please refer to the following chart: /dev/cua0 = COM1 /dev/cua2 = COM3 /dev/cua1 = COM2 /dev/cua3 = COM4 Note: The highest speed for a COM port is 38400 bps. In order to refer to a higher speed, edit the following file: /etc/rc.d/rc.serial This file must have the "spd_hi" or "spd_vhi" option when configuring the COM port on which the modem is connected to. More information requiring this step may be found in your Linux documentation. The second file that must be created is chat-netcom. This is the configuration file that contains the initialization string of the modem, the telephone number, username and password. Below is a sample chat-netcom file: ---- Cut Here ---- ABORT BUSY ABORT 'NO CARRIER' '' ATZ OK AT+FCLASS=0 OK AT&F&C1&D2 OK ATDT261-4700 CONNECT '' login: us,ppp,userID Password: your-passwd 'PPP session' '' ---- Cut Here ---- Note: The string "us,ppp" (without the quotes) must be inserted in front of the username in the login: field. Without this prefix, Linux will be unable to establish a PPP connection. Edit any other entries as necessary. Be aware that we can not be responsible for any errors that occur due to using the above script. The third file is called options. Under most circumstances, this file does not need to be modified from its original form: ---- Cut Here ---- domain ix.netcom.com ipcp-accept-local ipcp-accept-remote noipdefault ---- Cut Here ---- The fourth file to create is ppp-off. This is used to terminate the connection. Below is a sample script: ---- Cut Here ---- #!/bin/sh DEVICE=ppp0 # # If the ppp0 pid file is present then the program is running. Stop it. if [ -r /var/run/$DEVICE.pid ]; then kill -INT `cat /var/run/$DEVICE.pid` # # If unsuccessful, ensure that the pid file is removed. # if [ ! "$?" = "0" ]; then echo "removing stale $DEVICE pid file." rm -f /var/run/$DEVICE.pid exit 1 fi # # Success. Terminate with proper status. # echo "$DEVICE link terminated" exit 0 fi # # The link is not active # echo "$DEVICE link is not active" exit 1 ---- Cut Here ---- The final file to create is resolv.conf. This is used to configure DNS lookups. Below is a sample resolv.conf: ---- Cut Here ---- domain netcom.com nameserver 199.182.120.203 nameserver 199.182.120.202 ---- Cut Here ---- At this point, Linux is configured to access a NETCOM Account. Login as root and run the ppp-on script to establish the connection. When finished with your PPP session, run the ppp-off script.