Follow these steps to install WANPIPE (tm) software:
1) If you received your distribution on a diskette, insert it into the disk drive, otherwise uncompress downloaded distribution archive using Linux' gunzip utility:
gunzip wanpipe.tgz
This command will create a file named wanpipe.tar. To proceed with the installation you have to be logged in as a superuser (root) and be in the root directory (i.e. '/' , not '/root').
2) Transfer files from the installation media to your system using Linux' tar utility:
tar xf media
where media is a name of your floppy disk drive (usually /dev/fd0 or /dev/fd1), in case of installation from the distribution disk, or a name of the decompressed tar-file you obtained in previous step if you are installing from the downloaded tar archive.
For example, if your uncompressed tar archive is in /home/you directory, use the following command:
tar xf /home/you/wanpipe.tar
3) Change directory to /usr/lib/wanpipe and run WANPIPE installation script:
./install
Follow instructions on the screen. Installation script will perform the folowing functions:
Unfortunately, many Linux distributions use simplified bootstrap procedure and WANPIPE installation script will warn you that automated installation of initialization script is not possible. In this case you will have to add WANPIPE initialization script to your system boot-time initialization script manually. Refer to the next chapter, "Configuring WANPIPE", for detailed information.
Installation script also checks Linux kernel version number. Because Linux kernel modules are version-dependent, you have to recompile them if your kernel version is not the same as the one the modules were compiled against. Answer 'y' when asked if you want modules to be recompiled.
Note that WANPIPE modules also have to be recompiled every time you recompile Linux kernel, e.g. when you change kernel configuration or apply a patch. To recompile WANPIPE modules run ./build script from /usr/lib/wanpipe directory.
If installation was successful then WANPIPE installation script will ask if you want to configure WANPIPE. Refer to the next chapter, "Configuring WANPIPE", for more information.
The following is a list of all files installed and/or created during the WANPIPE installation process.
/usr/lib/wanpipe/README WANPIPE release notes /usr/lib/wanpipe/LICENSE Sangoma's Limited Use License Agreement /usr/lib/wanpipe/MANUAL WANPIPE User's Manual (this file) /usr/lib/wanpipe/install WANPIPE installation script /usr/lib/wanpipe/build WANPIPE build script /usr/lib/wanpipe/configure WANPIPE configuration script /usr/lib/wanpipe/wanpipe WANPIPE master initialization script /usr/lib/wanpipe/ifinit TCP/IP-level initialization script /usr/lib/wanpipe/init/flip FLIP subsystem initialization script /usr/lib/wanpipe/init/sppp SPPP subsystem initialization script /usr/lib/wanpipe/conf/flip FLIP subsystem configuration script /usr/lib/wanpipe/mod/sdla.mod SDLA kernel driver module /usr/lib/wanpipe/mod/flip.mod Frame relay protocol-specific module /usr/lib/wanpipe/mod/sppp.mod Synchronous PPP protocol-specific module /usr/lib/wanpipe/sfm/fr502.sfm S502 frame relay firmware module /usr/lib/wanpipe/sfm/fr508.sfm S508 frame relay firmware module /usr/lib/wanpipe/sfm/ppp502.sfm S502/S503 PPP firmware module /usr/lib/wanpipe/sfm/ppp508.sfm S508 PPP firmware module /usr/lib/wanpipe/sample/* sample configuration files /usr/lib/wanpipe/src/sdla/* SDLA driver source code /usr/lib/wanpipe/src/flip/* FLIP driver source code /usr/lib/wanpipe/src/sppp/* SPPP driver source code /usr/lib/wanpipe/src/include/* Common include files /usr/sbin/sdlald SDLA firmware loader /usr/sbin/flipcfg FLIP configuration utility /usr/sbin/spppcfg SPPP configuration utility /var/log/wanpipe WANPIPE initialization log file /etc/wanpipe.rc WANPIPE meta-configuration file /etc/sdla.conf SDLA configuration file /etc/flip.conf FLIP subsystem configuration file /dev/sdla* SDLA device nodes