Auto Reconnection ADSL Wanadoo README
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Version 0.5a
$Revision: 1.10 $
$Date: 2002/11/10 21:10:47 $


Index
~~~~~
I	Contents
II	Installation
III	Compatiblity
IV	IP keeping
V	Other notes I don't know where to put them
VI	Thanks
VII	Licence


I Contents
~~~~~~~~~~

This archive contains several scripts useful to avoid Wanadoo's ADSL
disconnections every 24 hours
They consist of :
ChangeLog	- well let's give a real history to araw ;-)    
README		- a strange file, I don't know its use or even how it got
		there...
araw-down	- a custom script to perform operations after pppd has been
		killed
araw-up 	- a custom script to perform operations before pppd is run
install.sh	- the installation script, you'll have to edit this to fit your
		system
ip-up		- an ip-up script (man 8 pppd for info) which starts the
		connection-is-up checking script.
ip-check	- THE connection-is-up checking script which will automatically
		reconnect if it can't get to ping it's gateway at Wanadoo's.
ppp-at		- a little line launched using the at daemon to make sure the
		pppd is correctly launched.
ppp-go		- a verification script which checks wether pppd has started
		correctly (and hasn't killed itself). 
ppp-kill-at	- the "core" of the IP keeping feature
rc.adsl		- a startup script which configures Alcatel's Speedtouch USB
		with Benoit Papillault's driver
		(http://speedtouch.sourceforge.net) and launches the ppp daemon.
routing-down	- a custom script to perform operations like heavy iptables'ing
		before pppd is killed
routing-up 	- a custom script to perform operations after pppd has be
		started


II Installation
~~~~~~~~~~~~~~~

To install this collection of scripts, just unbunzip2tar this archive
wherever you want. Next you have to edit the install.sh script for the
paths to match those on your system (pppdir, startupdir, rclocal, mrunpath,
mgmt). Finally just launch instal.sh as root. 

The install.sh now has back-up functions, if one file FILENAME previously
existed, it is renamed to FILENAME.old.DATE, where DATE is the output of
"date +%Y%m%d%H%M%S" at the time ths install.sh is run


III Compatibility
~~~~~~~~~~~~~~~~~

I have personnaly successfully used this script to connect to Wanadoo (France).
It was originally written for Slackware 7.1/8.0 systems and hasn't been tested
elsewhere.

It has also been reported to work with:
    - Club Internet's ADSL
    - Wanadoo and Debian 3.0r0


IV IP keeping
~~~~~~~~~~~~~

This feature (disabled by default, check the ip-up file) tries to keep the same
IP for your box even after a dis/reconnection cycle. In fact it will kill -HUP
the ppp daemon. Make sure you have specified "persist" in your options file
(probably /etc/ppp/options or /etc/ppp/peers/adsl). When sent a SIGHUP, pppd
will close the connection and, provided the persist option has been given, it
will reinitiate one, asking the Wanadoo's DHCP for a new IP. The trick is that
Wanadoo's DHCP seems to have 24 hours leases.
This way, killing the pppd every 12 hours will make it reinitiate the
connection and request a new IP, which will be the same as 12 hours ago... Of
course, don't hope to get the same IP back after having had your box shut down
for some time.

This feature is directly copied on an idea of Nicolas Pouillon, which proved to
work.

As of version 0.4, it's the first implementation of this function into araw so
don't be too demanding, it may not work.


V Other notes I don't know where to put them
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Remember the driver of your modem should be correctly installed before trying
to install ARAW, the install.sh file doesn't handle this (harrasing) part
and probably never will...

The provided files are not directly usable... You must use the install.sh script
which will edit and addapt the files to your system (using the information YOU
provided).

This set of scripts relies on quite an old version of the Speedtouch's driver,
but I didn't have the occasion to work on a newer version. This occasion will
probably happen during June/July 2002.

If you have any comments on or modifications to add to this script, well, my
mailbox is not /dev/null yet :-).


VI Thanks
~~~~~~~~~

I would like to thank : 
    * Nicolas Pouillon for his explanation on his ip-keeping feature
    * Mathieu Ruellan for his advice which lead to ARAW v0.5
    * Nicolas Deves for his remarks about bugs in the install.sh script

VII Licence
~~~~~~~~~~~

ARAW si a public domain application.

							Olivier Mehani, 2002
							   <shtrom@ssji.net>
