Fetch and install VHFFS

You can install VHFFS from source or using our Debian packages, depending on your current mood or system ;-)

Install VHFFS from source

To get the source of VHFFS 4.6, in a terminal window type:

wget http://download.tuxfamily.org/vhffs4/releases/4.6.0/vhffs-4.6.0.tar.gz

Uncompress it:

tar xzf vhffs-4.6.0.tar.gz

Then cd into vhffs-4.6.0:

cd vhffs-4.6.0

If you fetched the source code from Git, you have to build all autogenerated autotool files which are obviously not included in the repository. This is accomplished by installing the bootstrap's dependencies then by running the bootstrap script.

apt-get install autoconf automake gettext libglib2.0-dev
./bootstrap.sh

There is some dependencies, here is what you'll need to build VHFFS:

apt-get install gcc gettext make

Then, run the classical autotool command line:

./configure
make
make install

Nonetheless, there is also runtime dependencies for the VHFFS base, which are much more numerous than build dependencies:

apt-get install libdbd-pg-perl libmime-lite-perl libcrypt-gpg-perl libcrypt-passwdmd5-perl libemail-valid-perl libconfig-general-perl liblockfile-simple-perl libquota-perl libintl-xs-perl

If the VHFFS base is correctly installed as well as dependencies, you will have something like that:

# /usr/lib/vhffs/bots/user.pl 
DBI connect('database=vhffs;host=localhost;port=5432','vhffs',...) failed: could not connect to server: Connection refused
        Is the server running on host "localhost" (::1) and accepting
        TCP/IP connections on port 5432?
could not connect to server: Connection refused
        is the server running on host "localhost" (127.0.0.1) and accepting
        TCP/IP connections on port 5432? at /usr/share/vhffs/api/Vhffs.pm line 154

It does nothing and fail because nothing is configured yet, but this means that the VHFFS base can be compiled and run by perl.

Install VHFFS base using APT

Add the following in your /etc/apt/sources.list :

deb http://downloads.tuxfamily.org/vhffs4/releases/debian/ stable main

Then :

apt-get update

FIXME: errr, install only common and API

apt-get install vhffs*

Debian packages have the required dependencies set correctly, so you don't need to manually install other packages.

Install Perl dependencies

The documentation will tell you the necessary Perl dependencies each step as debian package names. But if you are not using Debian, you can play with our dependencies check script to pre-install all necessary dependencies.

You can check the dependencies with the script vhffs-test-dependencies located in the root of the VHFFS source tree.

./vhffs-test-dependencies --verify=all

You can then install missing packages:

If you are still missing perl modules packages, if you are using Debian, look for them with:

apt-cache search "name module perl"
apt-get install "exact name debian package"

Else or if you cannot find them, you can run the script:

./vhffs-test-dependencies --verify=all --install

This script will try to install them from CPAN.

If CPAN is not configured yet, you can do this with: perl -MCPAN -e shell

doc/installationguide/basic-install.txt · Last modified: 2016/10/03 22:40 by gradator
Recent changes RSS feed Creative Commons License Donate Minima Template by Wikidesign Driven by DokuWiki