Installation

The VSPDL is supplied in two different versions:

TAR archive.
RPM package.

To install VSPDL you will need the following:

LINUX system (kernel 2.2.x-2.6.x).
GNU C compiler.
Linux kernel headers/sources of the Linux kernel you are running now.
make-3.74 or above.
binutils-2.7.0 or above.
bash
libc.so.6
libexpat.so.0
libgcc_s.so.1
libm.so.6
libstdc++.so.5

Further, you will need either

gunzip-1.2.4 or above to process TAR archive, or
RPM tool of your choice to process RPM package.


The Virtual Serial Port Driver for LINUX (VSPDL) distribution includes the following:

VSPModule - Linux kernel module that creates Virtual Serial Ports (VSPs) on your system (in lib/* of your distribution).
VSPDaemon - interacts with the VSPModule, facilitates data transfers between the VSPs and the network (in sbin/* of your distribution).
Documentation - current documentation set in HTML format (in man/* of your distribution).
Sample configuration files (in etc/* of your distribution).
VSPModule/VSPDaemon startup scripts ( in bin/vspm, bin/vspd of your distribution).

To install from TAR archive:

Login from console as a superuser (root).
Copy the TAR archive into a temporary directory (i.e. /root/vsptmp):
#mkdir /root/vsptmp
#cp ./vspd-1.00.tar.gz /root/vsptmp
#cd /root/vsptmp
Unpack the TAR archive and go to the destination directory:
#tar xvf ./vspd-1.00.tar.gz -z
#cd ./vspd-1.00-dist
Install the VSPDL into /usr/local/vspd : #./install.sh /usr/local/vspd (the shell script will install all files automatically):
The script will check system dependencies for VSPModule compilation;
The script will then compile the VSPModule;
Finally, the script will install all files into their target location (/usr/local/vspd) and necessary startup shell scripts (vspd and vspm)- into /etc/rc.d/init.d/.

To install from RPM archive:

Login from console as a superuser (root).
Go to the directory containing RPM archive and execute the following command: #rpm --install ./vspd-X.YY-linux.i586.rpm (you can also use any other tool of your choice to install RMP).
RPM subsystem will check package dependencies and let you know if something is missing;
If all dependencies check out successfully an installation directory will be created (normally, /usr/local/vspd-X.YY-dist);
Next, the VSPModule will be compiled and installed into the package installation directory (normally, to /usr/local/vspd);
Finally, the RPM subsystem will check the distribution installation directory and package installation directory to see if both were successfully created.

If the VSPDL installs successfully, you will have the following:

In /etc/rc.d/init.d/vspd and /etc/rc.d/init.d/vspm - standard UNIX startup scripts for VSPDaemon and VSPModule.
In /usr/local/vspd/bin/* - VSPDL services (startup and VSPTty).
In /usr/local/vspd/etc/* - VSPDL configuration files.
In /usr/local/vspd/lib/vspm.ko - VSPModule.
In /usr/local/vspd/sbin/vspd - VSPDaemon.
In /usr/local/vspd/man/* - VSPD documentation.

note_warning-wt

Warning regarding LATEST Linux KERNELS (2.6.x, x>= 13): If your system can't load VSPModule and shows a "module not found" error after VSPDL installation, you have to add a string into /lib/modules/<kernel-name>/modules.dep:

/usr/local/vspd/lib/vspm.ko

and loader will have possibility to load VSPDModule.