VHFFS use a PostgreSQL server to store all its data.
You have to be root to install successfully vhffs on your system. The install script writes his files in /usr/share/vhffs and /usr/lib/vhffs directories and creates the /etc/vhffs/vhffs.conf file if it doesn't exist.
All versions can be used, we don't need a lot of features from PostgreSQL, we are currently developing under the 8.4 releases.
Your system should have the libnss-pgsql or libnss-sqlite (with a running nss mirror script) library installed. With it, the system can found users on your system through the VHFFS database.
This is a mistake in the PostgreSQL pg_hba.conf file. The pg_hba.conf is used to tell which user can connect on the database. For more informations, please read the PostgreSQL documentation on http://www.postgresql.org.
That's simple :
/etc/vhffs/vhffs.conf), then, modify the open directive in the <panel/> section to no.vhffs.conf and set back the open directive to yes.You are probably using lockfiles and you killed the robot while running. Just delete this lockfile, the robots will run again.
You probably forgot to install a perl-dependency. So, you should see the perl error message on you error log on Apache. This error message tells which perl module is missing. Just install this module by the way you want (cpan or package from your distribution).
Another way to check if your installation contains all necessary perl-modules is to run the vhffs-checkinstall program (/usr/bin/vhffs-checkinstall).
The panel uses the /tmp/ directory to put sessions information. Be sure that Apache can write files in the directory.
There is two methods :
In fact, VHFFS was designed for massive hosting. So, it's very stupid to use the VirtualHost directive, because it forces to reload apache and it imply a little downtime, furthermore httpd startup time depends on the number of configured virtualhosts, which goes to a non scalable way. So, this solution is not the best. We use an apache-module designed for VHFFS called mod-vhost-hash-alias. This module (available on Debian) has to be installed on your webserver(s) and loaded by Apache2. This module work as it :
Website integration on Apache is then totally dynamic and doesn't need a reload or restart.
You can found perl documentation for VHFFS api on your system, by using the perldoc command. For example, the command perldoc Vhffs::Main prints the documentation of the Vhffs::Main module.
You probably have too many connections to your database. You have several solutions :
Another source of error can be a missing perl-module. If you have errors on the same page, you should run the vhffs-checkinstall program (/usr/bin/vhffs-checkinstall).
When you have an hosting service, you can provide a free mail-adress for your users. For example, if you have the hosting service MyHosting with the domain name myhosting.com, you could choose to offer an email adress on this domain for each user. The mailuser module allow this service. So, each user on the platform can create user@myhosting.com mail-adress and declare it as a POPable account or a simple forward. The mailuser module use the mail module, so you have to enable it if you use mailuser.
In fact, you have to create the /data/avatar directory. But this directory must have the rights of the Apache user. On Debian, Apache user is www-data (and this user is in the www-data group). So, you have to run the chown -R /data/avatar to have a /data/avatar writeable for the panel.