EnterNet for Linux FAQ
Q: How is EnterNet for Linux sold/distributed?
A: EnterNet for Linux is typically sold and distributed through our resellers, mainly Internet Service Providers and Server vendors.
EnterNet for Linux is NOT available on a per client license basis. If you have need for multi-platform client PPPoE access, or bulk volume purchases, contact Siemens.
Q: How do I start EnterNet for Linux?
A: There is no GUI for EnterNet for Linux. It's started at a command line prompt by running a shell script:
/usr/local/bin/start-pppoe
There are two thing that must be done before the script can be run
the first time.
First you should have edited the shell script, start-pppoe. Following the comments
and making changes as appropriate for accessing your ISP.
Before running the script, /etc/chap-secrets or /etc/pap-secrets has to be edited. You must add the User ID and password assigned to you by your ISP. User ID and password are case sensitive. Which file to edit will depend on the method of authentication (CHAP or PAP) that is supported by your ISP. If it's unknow, it's OKs to add the same userid/password to both files. The format of the information in each file is the same. For example, if your ISP assigned you an userid of "jones" and a password of "mysecret", then the entry you would place in ether file would look like this:
jones * mysecret *
Q: What versions of Linux is EnterNet supported on?
A: EnterNet for Linux is written to work with Linux version 2.0 and 2.2. It has been tested with RedHat Linux version 5.2, 6.0, and 6.1. If you're successful in running it unchanged on previous versions of Linux, please contact Siemens.
Q:Can EnterNet be ported to other Unix platforms?
A: NTS is not distributing the source for EnterNet. If you wish to port it to other platforms, contact Siemens.
Q: Unzipping EnterNet for Linux
A: Infozip's zip and unzip are used for compressing and uncompressing a zip archive. When encryption is needed Infozip's zipcloak is used. The RedHat distribution includes the zip and unzip program but is missing the zipcloak.
Unzip can be found at: http://www.info-zip.org/pub/infozip/
Q: How do I decode files for Linux downloads?
A: A tutorial is provided here.
Q: Current Version and Required Software
A: The current version is 1.300.000, released 2/1/2000.
The current version should work with the 2.0.x Linux kernel or above, however we recommend you upgrade to 2.2 before attempting to run EnterNet PPPoE.
Testing has been completed with RedHat release 5.2 (Linux kernel version 2.0.) and 6.0 and 6.1 (Linux kernel version 2.2.)
PPP daemon required is pppd version 2.3.7 or higher. If not installed on your system, we recommend you use the latest version available of the PPP daemon.
The initial version 1.0 was created very quickly to fill the void. The current product has effectively been rewritten. However the initial version 1.0 has, inappropriately, found its way to many FTP sites around the globe, so please make sure you have received the most current version of "Enternet 100 for Linux" from your ISP.
Q: How do I set up the Linux version?
A: The following instructions apply specifically to Red Hat Linux version 6.0 Kernel version 2.2.5. Some file locations may be different for your particular distribution of Linux. This information may also be applied to similar operating systems.
Q: Installing the EnterNet PPPoE client
A: Extract the contents of the file enternet100-... .zip in a working directory of your choice, using the unzip command.
Example: "unzip enternet100-eval.zip"
You will now have a direcory of the form pppoe-1.300.xxx. Change into that directory replacing xxx with the actual number you saw for the directory name. First read the LICENSE file. If you no not accept the terms of the agreement. Back out of the directory and delete it and the coresponding zip archive. Otherwise follow the instruction provided in the README.
Q: Assigning an Ethernet adapter
A: Before PPPoE will work, you must have a working Ethernet NIC, configured for TCP/IP. Running the ifconfig command will give you a list of available TCP/IP devices. You should see at least two devices listed, one of which should be an Ethernet device (e.g.: eth0), and another of which should be the local loop back device. If you see different results, try the following command to bring the first available Ethernet device up:
ifconfig eth0 0.0.0.0 up
For more information on configuring Ethernet and TCP/IP devices, please refer to Networking HOWTO, available with your Red Hat Linux distribution, or on any of the Linux Documentation Project web sites. If your Ethernet device is enabled, and pppd is configured properly, you should be able to run pppd to establish a connection to the Internet. Running ifconfig should show details for a new device called ppp0. As well, ppp0 should be shown as a host as a default gateway when running route. Important messages are logged to /var/log/messages. For more verbose logging, use the command pppd debug.
Q: Error: "Connection terminated"
A: This usually happens immediately after attempting to log into the PPPoE server. It is usually caused by an incorrect domain name, User ID or Password in /etc/ppp/pap-secrets or /etc/ppp/options. Make sure that all three values are correct. User ID and Password are case sensitive.
Q: The PPPoE connection fails with "Error: No response to PAP authenticate requests" and the syslog includes entries similar to the following:
Dec 1 21:21:47 localhost pppd[647]: pppd 2.3.10 started by root, uid
0
Dec 1 21:21:47 localhost pppd[647]: Using interface ppp0
Dec 1 21:21:47 localhost pppd[647]: Connect: ppp0 <--> /dev/ttyp0
Dec 1 21:22:20 localhost pppd[647]: No response to PAP authenticate-requests
Dec 1 21:22:26 localhost pppd[647]: Connection terminated.
Dec 1 21:22:27 localhost pppd[647]: Hangup (SIGHUP)
Dec 1 21:22:27 localhost pppd[647]: Exit.
A: Update the options file: /etc/ppp/options.pppoe. This update is for use with pre 1.300 releases only.
Q: Does the client depend on libc5, glibc2.0 or glibc2.1?
A: The binaries are generated against RedHat 5.2 using glibc2.0 (pppoed-2.0) and ReadHat 6.0 using gblic2.1 (pppoed-2.2).
Q: How is EnterNet implemented under Linux?
A: EnterNet 100 for Linux is implimented as a daemon, pppoed, running in application address space. It interfaces to the PPP driver found on most Linux systems via a PTY port and uses the raw sockets API (SOCK_RAW or SOCK_PACKET) to gain access to the Ethernet interface that is connected to the ADSL modem. Pppoed impliments RFC-2516 (a.k.a. the PPPoE RFC). To put simply, it deals with the network dialog (discovery state) on the ADSL side for establishing the session. Once established it goes into the session state and performs the translations needed and passes traffic to and from the ethernet infterface to the PPP interface.
Q: Are non-x86-compatible processors covered?
A: No.
Q: Is EnterNet available for BSD?
A: No.
Q: Performance Questions
A: When "Enternet 100 for Linux" version 1.300 is operating with the SYNC option the the CPU usage of pppoed drops to about 25% to %30 of the pre 1.300 versions.
Q: Linux Release Notes