Next | Previous | Index


3. Installing WANPIPE Software

WANPIPE for Linux is distributed as a tar archive on a 3.5" diskette or, optionally, can be downloaded from Sangoma's FTP site on the Internet as a gzip'ed tar archive (ftp://www.sangoma.com/pub/linux/wanpipe.tgz). Software is distributed under the Sangoma's Limited Use License Agreement and is not redistributable.

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:

WANPIPE distribution includes System V -style initalization script, allowing bring up and shut down WANPIPE with a single command. If your system uses System V -style bootstrap, the WANPIPE installation script will attempt to install initialization script into appropriate system directories so that WANPIPE will come up automatically on system boot.

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

Next | Previous | Index