------------------------------------------------------------------------------
Title: INSTALLATION INSTRUCTIONS FOR PPPLC RELEASE MARKER_PATCHLEVEL
------------------------------------------------------------------------------

1.      Requirements and Notes

1.1.    To make the programs you will require GNU make, perl version 5.

2.      Compilation and Installation

2.1     As non-root run:

        chmod u+w ./Makefile.defs

        (As distributed this file is normally readonly.)

2.2.    As non-root, work your way through ./Makefile.defs changing things as 
        instructed there.

2.3.    As non-root run:

        make

2.4.    As root run:

        make install

2.5.	Still in the same directory, as root run:

	mv /etc/ppp /etc/ppp.`date "+%y%m%d%H%M%S"`
        ln -s `make SHOW=PRGLIBDIR show`/ppp /etc/ppp
	( cd `make SHOW=PRGCFGDIR show`; mv ppplcd.conf ppplcd.conf.`date "+%y%m%d%H%M%S"` )
	cp doc/examples/ppplcd.conf `make SHOW=PRGCFGDIR show`

2.6.	If you run a System V style 'init' (does /etc/init.d exist?) then
	setup the boot-time startup files by running the following as root:

	cp doc/examples/local-ppplc /etc/init.d
	ln -s /etc/init.d/local-ppplc /etc/rc0.d/K01local-ppplc
	ln -s /etc/init.d/local-ppplc /etc/rc6.d/K01local-ppplc
	ln -s /etc/init.d/local-ppplc /etc/rc2.d/S99local-ppplc
	ln -s /etc/init.d/local-ppplc /etc/rc3.d/S99local-ppplc

2.7.	If you are running a 'simple style 'init' (does /etc/rc.local or
	/etc/rc.d/rc.local exist?) then add the following lines to the
	appropriate rc file, adjusting the paths as appropriate in the 
	first three lines:

	PPPLCD=full_path_of_ppplcd
	CONFIG=full_path_of_ppplcd.conf
	LOCKDIR=full_path_of_where_lock_files_are_stored_(see_Makefile.defs)
        echo "Starting ppplcd"
        rm -f $LOCKDIR/ppplcd.*
	if [ ! -x $PPPLCD ]; then
            echo "$PPPLCD: not found"
       	elif [ ! -r $CONFIG ]; then
            echo "$CONFIG: not found"
        else
            $PPPLCD $CONFIG > /dev/null 2>&1
        fi

3.      Configuration

3.1.	After that there is only one more step, and that is review the 
	configuration file you just installed and make changes where 
	appropriate. It is a very well documented config file (unlike the 
	manual page ppplcd.conf(5)).

	Note that if your modem is *NOT* a US Robotics Courier or your
	ISP is *NOT* Demon, then this configuration will require you to
	write chat scripts for your modem or ISP, but that will become
	clearer as you work through the config file. (Please please
	please send any new modem or ISP configuration files you write
	to the author for inclusion in the next release.)

3.2.	If after configuring the config file, you have *NOT* elected to use 
	the name service switcher script included in the distribution, then
	you may skip this step.

	Create /etc/named.conf.inet which should configure named to use
	to Internet root name servers, or your ISP's forwarders, to do
	name lookups for you (or for your local caching named).

	Create /etc/named.conf.local which does *NOT* ask outside your
	own domain or local host for name lookups.

	If /etc/named.conf exists then move it out of the way.

	Run:

	ln -s /etc/named.conf.local /etc/named.conf

3.3.	Consult the manual page for ppplcc(1) for further information on 
	actually connecting.

3.4.	An example crontab entry you may wish to add to root's crontab can be 
	found in ./doc/examples.

4.      Possible Problems

4.1     Compilation Problems

4.2     Runtime Problems

------------------------------------------------------------------------------
$Header: /home/ahuxley/dev/supported/ppplc/doc/RCS/INSTALL,v 1.3 1999/04/26 13:49:57 alexis Exp $
------------------------------------------------------------------------------