# Copyright (C) 2001 Cyberdude47
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License
# as published by the Free Software Foundation; either version 2
# of the License, or (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
ADSL4Linux README <http://www.adsl4linux.nl>
Versie: 0.66
Deze README bestaat uit de volgende onderdelen:
1 INSTALLATIE
1.1 Voor de Installatie
1.2 Installatie ADSL4Linux
1.3 Handmatig kopieeren
2 MENU OPTIES
2.1 Nieuw Installatie
2.2 Wijzigen Gegevens
2.3 Tools
3 GEBRUIK
3.1 Inloggen
3.2 Uitloggen
4 TOOLS
4.1 Modem
4.2 Pingscript
4.3 Firewall
5 PROBLEMEN
Voetnoot
-------------------------------------------------------------------------------
1 INSTALLATIE
1.1 Voor de Installatie:
Deze installatie neemt aan dat het modem goed geinstalleerd is en
functioneert.
Er moet een ethernetkaart geinstalleerd zijn die werkt. Deze moet op
IP adres 10.0.0.100 met subnetmask 255.255.255.0 ingesteld zijn.
Het modem moet te pingen zijn, controleer dit met 'ping 10.0.0.138'.
1.2 Installatie ADSL4Linux
Zet de bestanden ADSL4Linux-?.??.tar.gz en install.sh in dezelfde directory
(bv. in /home/user).
Log in als root of tik in 'su' en daarna het root wachtwoord.
(Doe eventueel 'mv install.sh.txt install.sh'; dit hernoemt het bestand.)
Doe 'chmod +x install.sh' om het bestand uitvoerbaar te maken (chmod 700
voor grotere veiligheid).
Aangezien dit project in de kinderschoenen staat adviseren wij om de volgende
bestanden te backuppen:
/etc/ppp/pap-secrets
/etc/ppp/chap-secrets
/etc/ppp/options
Doe nu './install.sh' of voor oudere versies van *nix 'sh install.sh'.
Kies voor menuoptie 1 om de installatie te beginnen.
De installatie zal maar enkele minuten duren, waarna direct gebruik gemaakt
kan worden van het ADSL internet.
Houdt uw MXStream gegevens bij de hand om alle gegevens correct in te voeren.
1.3 Handmatig kopieren:
Tijdens de installatie zal gevraagd worden of U de bestanden zelf wilt
kopieren naar de juiste locatie(s).
Als U hiertoe besluit, moet U de volgende bestanden copieren uit de
"./ADSL4Linux" directory.
/files/options.adsl => /etc/ppp/options.adsl
/files/chap-secrets => /etc/ppp/chap-secrets
/files/pap-secrets => /etc/ppp/pap-secrets
/files/mxstream-secrets => /etc/ppp/mxstream-secrets
/files/adsllogin => /usr/sbin/adsllogin
/files/adlslogout => /usr/sbin/adsllogout
mxstream.pl => /etc/ppp/mxstream.pl
pptp => /usr/sbin/pptp
pptp_callmgr => /usr/sbin/pptp_callmgr
Dit zijn de benodigde bestanden om volledig automatisch in te loggen!
De overige bestanden (pingscript, rc.firewall, firewall.ipchains,
firewall.iptables) zijn handige 'tools' waarmee U de verbinding openhoudt
of de PC beschermt tegen aanvallen van buitenaf.
-------------------------------------------------------------------------------
2 MENUOPTIES
2.1 Nieuwe Installatie
Als het tar.gz bestand nog niet uitgepakt is, dan kan men met deze optie
het bestand uitpakken en de installatie starten.
ADSL4Linux zal om de gebruikersgegevens vragen van uw Internet Service
Provider.
Hierna volgt de keuze om de tijdens de installatie aangemaakte bestanden
te kopieren naar de juiste locatie. U kunt dit ook handmatig doen (zie 1.3)
2.2 Wijzigen gegevens
U wilt alleen maar de bestaande gegevens updaten van uw ADSL verbinding.
2.3 Tools
Zie "4 TOOLS".
-------------------------------------------------------------------------------
3 GEBRUIK
3.1 Inloggen:
Het inloggen is makkelijk. Tik in "adsllogin" als root, en als het script
helemaal klaar is, dan kunt U met CTRL-D uitloggen. De verbinding blijft
open staan.
Als het allemaal werkt hoeft er niet eens naar 'start.mxstream.nl' gesurft te
worden.
Indien U een Extra abonnement heeft kunt U ook "adsllogin pc#" doen, waarbij
# staat voor het nummer van de pc die U wilt laten inloggen. Als U geen
nummer meegeeft, dan logt deze in als pc1.
(Het bericht "Discarding out of order" is te negeren, de verbinding moet het
desondanks dit bericht gewoon werken.)
3.2 Uitloggen:
Uitloggen is ook makkelijk. Doe "adsllogout" en het modem logt uit.
-------------------------------------------------------------------------------
4 TOOLS
De tools reset modeminstellingen, pingscript en rc.firewall kunt U gebruiken
mocht U dit willen. Standaard word de firewall niet geinstalleerd.
4.1 Modem
Dit is een tool om het modem de juiste instellingen te geven.
Voor het gebruik van het adsl modem voldoet de fabrieksinstelling van het modem niet,
op de door KPN meegeleverde CD staat een eenvoudig programmatje voor windows dat het
modem van de juiste instellingen voorziet. Helaas echter voor de linuxgebruikers is er
alleen met de mac en windows gebruikers rekening gehouden.
Op het internet zijn programma's te vinden om de instellingen onder linux in het modem
te kunnen zetten. Om het te kunnen gebruiken heb je de Expect perl module nodig die
opzich weer een tweetal andere perl modules vereist.
IO::Stty perl module
IO::Tty perl module
Expect perl module
mxs_home modem config scriptje
De modemtool installeert deze modules en het modem config scriptje, waarna met het commando
"/usr/sbin/mxs_home" de juiste instellingen in het modem worden gezet.
Indien de instelling op een later tijdstip moeten worden ververst is het commando
"/usr/sbin/mxs_home" voldoende om dit te laten plaatsvinden.
4.2 Pingscript:
Het pingscript wordt aan de cron deamon toegewezen. Hierdoor wordt om de
5 minuten een beetje dataverkeer gegenereerd, om te controleren of de
verbinding nog 'up' is.
4.3 Firewall:
LET OP deze bestanden worden alleen aangemaakt als u kiest voor de installatie
van de firewall in het menu!!! (onder menuoptie [3 tools] en daarna
[3 firewall]).
De firewall (ipchains of iptables) wordt automatisch ingevuld voor uw
configuratie. U dient dan wel ingelogd en on-line te zijn,
zodat alle netwerk parameters de juiste waarde hebben.
Verder verzoeken wij U het bestand te bekijken op onjuistheden.
Ook willen we melden dat de bestanden niet wordt gekopieerd, ook al lijkt
dit wel zo. De locatie is namelijk voor iedere distributie anders.
U moet deze 3 bestanden hebben om de firewall werkend te krijgen:
./files/rc.firewall
./files/firewall.ipchains
./files/firewall.iptables
Het rc.firewall bestand is het bestand waarmee U de firewall het beste kunt
opstarten.
Tenzij U weet dat U support heeft voor ipchains of iptables, start dan
bijbehorende firewall op.
-------------------------------------------------------------------------------
5 PROBLEMEN
Indien U een probleem tegenkomt, bekijk dan de logfile:
/var/log/adsl4linux.log
De "error" die er als volgt uitziet:
Warning: discarding out of order
kan genegeerd worden. Deze is onschadelijk en de verbinding moet gewoon
werken.
Ook kunt U kijken onder de menuoptie tools in de installatie,
of deze los uitvoeren door in de directory ADSL4Linux het programma
tools.sh uit te voeren.
Hier staat onder andere een optie in om het modem de juiste instellingen
te geven. Vaak werkt het modem wel onder Windows(TM), maar niet onder Linux,
door een onjuiste instelling. U kunt dit ook handmatig aanpassen,
lees hiervoor het bijgesloten bestand "modemREADME.txt".
Bij zowel de automatische als de handmatige manier van instellen word er
echter wel vanuit gegaan dat U het modem kunt pingen. Is dit niet het geval,
dan verwijzen we U naar onze FAQ.
RedHat schijnt het erg moeilijk te hebben met pptp. Mochten er problemen
zijn, probeer dan de route tabel te bekijken 'route -n'.
Let ook op de DNS Servers.
De LCP echo's in de logfiles zijn normaal. Dit valt te verhelpen door de
pppd te updaten naar pppd 2.4.1b1 of hoger. Soms wil echter ook helpen
de 'debug' uit het bestand /etc/ppp/options.adsl te halen.
Als er echt een probleem is waar U niet uitkomt, houdt dan de logfile in de
buurt als U besluit contact op te nemen met ons.
U kunt met uw vragen terecht op ons forum op de website:
http://www.adsl4linux.nl
-------------------------------------------------------------------------------
Voetnoot:
De makers van deze installatie en daaraan gerelateerde bestanden kunnen
niet verantwoordelijk gehouden worden voor welke schade dan ook.
GEBRUIKEN OP EIGEN RISICO.
PPTP source code zit bij de installatie inbegrepen.
Bugs naar: <cyberdude47@hotmail.com>
Wij zijn op geen manier ge-associeerd met KPN, Planet Internet, XS4All,
World-Online, Euronet, HCCNet, Demon of Sonera.
).
