Transcript
Integrated Telecom Express, Inc
ITEX LINUX 2684, PPPoA, PPPoE DRIVERS (ATM) For Kernel 2.4.16 USER GUIDE Rev. 10B
ITeX Confidential 44-060049-10B
1
4/2/02
Release History Revision
Release Date
Change Summary
101
2/28/02
Release for 2.2.7.ITEXPC86.0005
10B
4/2/02
Release for 2.2.7.ITEXPC86.0006
ITeX Confidential 44-060049-10B
2
4/2/02
Driver Introduction The ITeX Apollo 3 ADSL PCI modem is modeled as a Linux ATM card. It comes with a fully functional ATM/ADSL driver, which is distributed as a binary-only application. This allows its use for a wide range of protocols. This guide describes the procedure to install and setup the Apollo 3 ADSL modem with the Linux operating system. It is written to support the Red Hat 7.2 (kernel 2.4.16) version of the operating system. Also included in this user’s guide are the procedures to install and setup various client applications, specifically RFC2648, RFC2364 (PPPoA) and RFC2516 (PPPoE). ITeX Linux driver version for this manual: 2.2.7.ITEXPC86.0006.
ITeX Confidential 44-060049-10B
3
4/2/02
2
Requirements
The following are packages or files provided in the installation CD from ITeX. •
ITeX ATM/ADSL driver for Apollo 3 card (itex1577-2.4.16.o).
•
Linux ATM driver version 0.78 (atm-0.78.tar.gz).
•
PPPoE/PPPoA aware PPP daemon. itexpppoe_for_2.4.16.tar.gz itexpppoa_for_2.4.16.tar.gz
•
PPP over ATM vs. br2684 kernel patch br2684-against2.4.17.diff
•
User space utility brctl-010226.c
•
Modified header files from ITeX atm.h atmdev.h atmppp.h
ITeX Confidential 44-060049-10B
4
4/2/02
3
Building the Kernel 3.1 Untar the new kernel linux-2.4.16 under the directory /usr/src tar xzvf linux-2.4.16.tar.gz 3.2 Change the directory to /usr/src/linux to apply the kernel patch: patch –p1 –s –E < br2684-against2.4.17.diff 3.3 Configuring the Kernel make menuconfig Also set the following options: •
Code Maturity Level Options -
•
Prompt for development and/or incomplete code/drivers [Y]
Networking Options -
Packet Socket [Y] -
•
Packet Socket: mmapped IO [Y]
-
Asynchronous Transfer Mode (ATM) (EXPERIMENTAL) [Y]
-
RFC 1483/2684 Bridged protocols [Y]
Network Device Support -
PPP (Point-to-Point Protocol) Support [Y]
-
PPP Deflate Compression [Y]
-
PPP Over Ethernet (EXPERIMENTAL) [Y]
-
PPP Over ATM (EXPERIMENTAL) [Y]
ITeX Confidential 44-060049-10B
5
4/2/02
3.4 Building the kernel make dep make clean make bzImage make modules make modules_install
ITeX Confidential 44-060049-10B
6
4/2/02
4
Installing the Client Applications
4.1 Installing ATM / br2684 4.1.1 Install the ATM Package tar zxvf atm-0.78.tar.gz cd atm make make install 4.1.2 Copy the following headers files from /usr/src/linux/include/linux to the directory/usr/include/linux atm.h atmdev.h atmbr2684.h 4.1.3 Compile and install the br2684 utility cc -o br2684ctl brctl-010226.c –latm cp br2684ctl /usr/sbin 4.1.4 Copy files to /usr/include/linux The following files – atm.h, atmdev.h and atmppp.h are modified by ITeX. atm.h atmdev.h atmppp.h 4.2 Installing PPPoE User Program Follow the following procedures:
ITeX Confidential 44-060049-10B
7
4/2/02
tar zxvf /your path/ itexpppoe_for_2.4.16.tar.gz cd ppp-2.4.1-pppoe2 ./configure make make install cd pppd/plugins/pppoe make cp pppoe.so /usr/lib/pppd/plugins/. mv /usr/sbin/pppd /usr/sbin/pppd-pppoe 4.3 Installing PPPoA User Program Follow the following procedures: tar zxvf /your path/ itexpppoa_for_2.4.16.tar.gz cd ppp-2.4.0b2 make make install cp pppd/plugins/pppoatm.so /usr/lib/pppd/plugins/. mv /usr/sbin/pppd /usr/sbin/pppd-pppoa Note: Please double check the size of the pppoe.so file in the /usr/lib/pppd/plugins/ should be about 120K when finish the above process, if it is dramatically smaller than that, do the copy one more time. *** Reboot the system to activate the new kernel to be ready for users to install the desired protocol – RFC2684, PPPoE or PPPoA.
ITeX Confidential 44-060049-10B
8
4/2/02
5
Configuring the Client Applications 5.1 To Configure the PPPoE Connection •
Edit the file /etc/ppp/options lock noauth asyncmap 0 name user@domain user user@domain plugin /usr/lib/pppd/plugins/pppoe.so nas0
•
Edit the file /etc/ppp/chap-secrets # Secrets for authentication using CHAP # client server secret IP addresses user@domain * password
•
Edit /etc/ppp/pap-secrets # Secrets for authentication using PAP # client server secret IP addresses user@domain * password
5.2 To Configure PPPoA Connection •
Edit the file /etc/ppp/options lock noauth asyncmap 0 name user@domain user user@domain plugin /usr/lib/pppd/plugins/pppoatm.so 0.35 (Note: 0.35 is an example of the VPI/VCI ATM pair for a provider. Use
ITeX Confidential 44-060049-10B
9
4/2/02
the correct values from your ISP). •
Edit the file /etc/ppp/chap-secrets # Secrets for authentication using CHAP # client server secret IP addresses user@domain * password
•
Edit /etc/ppp/pap-secrets # Secrets for authentication using PAP # client server secret IP addresses user@domain * password
ITeX Confidential 44-060049-10B
10
4/2/02
6
Installing & Running the ITeX Drivers Important note: to switch from one protocol to another you must reboot the system before running the new protocol. Warning: in different systems, executing “/usr/sbin/br2684ctl –b –c 0 –a 0.vpi.vci” command may result in a system message of "nas0 cannot be configured, or cause segmentation fault. To prevent this - do not plug in the DSL cable until “/usr/sbin/br2684ctl –b –c 0 –a 0.vpi.vci” command has been executed.
6.1 To Run RFC2684 Connection •
Load ITeX ATM/ADSL driver module: /sbin/insmod -f /your path/ itex1577-2.4.16.o
•
To connect to your ISP, do the followings:
Note: the numbers in the message are dependent on your ISP. Make sure that /etc/resolv.conf file has been edited correctly, for example, add line “nameserver 192.168.2.1” /usr/sbin/br2684ctl –b –c 0 –a 0.vpi.vci /sbin/ifconfig nas0 up (for static IP) /sbin/ifconfig nas0 192.168.2.123 netmask 255.255.255.0 route add default gw 192.168.2.0 or pump –i nas0 (for dynamic IP) route add default gw 192.168.2.0
ITeX Confidential 44-060049-10B
11
4/2/02
6.2 To Run PPPoE Connection •
Load ITeX ATM/ADSL driver module: Execute /sbin/insmod -f /your path/ itex1577-2.4.16.o
•
To dial-up to ISP, do the followings: Execute /usr/sbin/br2684ctl –b –c 0 –a 0.vpi.vci Execute /sbin/ifconfig nas0 up Execute /usr/sbin/pppd-pppoe
6.3 To Run PPPoA Connection •
Load ITeX ATM/ADSL driver module: /sbin/insmod -f /your path/ itex1577-2.4.16.o
•
To dial in to the ISP, type the following: /usr/sbin/pppd-pppoa
Note: with PPP dial-up connection on, before trying to uninstall ITeX driver, either run the “/usr/sbin/ppp-off” directly or “ppp-off” (under /usr/share/doc/ppp-2.4.1/scripts) in RedHat 7.2 to terminate the PPP link to PPP0, but for the PPPoE users, you need to do one more step to kill the pid of “/usr/sbin/br2684ctl –b –c 0 ….” to make sure the device is not busy and ready to do driver uninstallation.
ITeX Confidential 44-060049-10B
12
4/2/02
