Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:installationguide:basic-panel [2011/07/30 22:58]
gradator some help about locales
doc:installationguide:basic-panel [2016/10/03 23:00]
gradator [Install and configure Apache2] 4.5 -> 4.6
Line 7: Line 7:
 The panel needs some more perl modules. They are not required for the VHFFS base, so you only need to install them on the server which is going to host the panel. The panel needs some more perl modules. They are not required for the VHFFS base, so you only need to install them on the server which is going to host the panel.
  
-  apt-get install libhtml-template-perl libhtml-template-expr-perl libcgi-session-perl libauthen-captcha-perl libdatetime-perl libtemplate-perl+  apt-get install libhtml-template-perl libhtml-template-expr-perl libcgi-session-perl libauthen-captcha-perl libdatetime-perl libtemplate-perl libcgi-fast-perl libcaptcha-recaptcha-perl
  
 Then check the panel by doing: Then check the panel by doing:
  
-  perl /​usr/​share/​vhffs/​panel/​panel.pl+  perl /​usr/​share/​vhffs/​panel/​index.pl
  
 If you get an error message like the following, this means that a perl module is missing. If you get an error message like the following, this means that a perl module is missing.
  
-  # /​usr/​share/​vhffs/​panel/​panel.pl +  # /​usr/​share/​vhffs/​panel/​index.pl 
-  Can't locate CGI/​Session.pm in @INC (@INC contains: /etc/perl /​usr/​local/​lib/​perl/​5.10.1 /​usr/​local/​share/​perl/​5.10.1 /​usr/​lib/​perl5 /​usr/​share/​perl5 /​usr/​lib/​perl/​5.10 /​usr/​share/​perl/​5.10 /​usr/​local/​lib/​site_perl .) at /​usr/​share/​vhffs/​panel/​panel.pl line 39. +  Can't locate CGI/​Session.pm in @INC (@INC contains: /etc/perl /​usr/​local/​lib/​perl/​5.10.1 /​usr/​local/​share/​perl/​5.10.1 /​usr/​lib/​perl5 /​usr/​share/​perl5 /​usr/​lib/​perl/​5.10 /​usr/​share/​perl/​5.10 /​usr/​local/​lib/​site_perl .) at /​usr/​share/​vhffs/​panel/​index.pl line 39. 
-  BEGIN failed--compilation aborted at /​usr/​share/​vhffs/​panel/​panel.pl line 39.+  BEGIN failed--compilation aborted at /​usr/​share/​vhffs/​panel/​index.pl line 39.
  
 <note note> <note note>
Line 26: Line 26:
  
   # apt-get install apache2   # apt-get install apache2
-  ~/vhffs-4.3# cp ./​vhffs-doc/​config/​apache/​panelconf /​etc/​apache2/​sites-available/​panel+  ~/vhffs-4.6# cp ./​vhffs-doc/​config/​apache/​panelconf /​etc/​apache2/​sites-available/​panel.conf
  
 then edit the file and adapt it to your needs **/​etc/​apache2/​sites-available/​panel** then edit the file and adapt it to your needs **/​etc/​apache2/​sites-available/​panel**
Line 32: Line 32:
 Once you are ready, run: Once you are ready, run:
  
 +  # a2enmod cgid
   # a2ensite panel   # a2ensite panel
-  # apache2ctl ​graceful+  # apache2ctl ​restart
  
 If everything is working fine, you'll get the following: If everything is working fine, you'll get the following:
Line 41: Line 42:
   0   0
  
 +<note note>
 +The panel also support FastCGI, if you wish to use FastCGI instead of bare CGI you can use the **./​vhffs-doc/​config/​apache/​panelconf-fastcgi** as a template.
 +
 +The panel have a single point entry, which is **/​usr/​share/​vhffs/​panel/​index.pl**,​ meaning you can use any FastCGI backend mechanism.
 +</​note>​
 ==== First VHFFS user ==== ==== First VHFFS user ====
  
Line 59: Line 65:
  
  
-Go to http://​panel.your.host/​subscribe.pl and fill all the fields.+Go to http://​panel.your.host/​?do=subscribe and fill all the fields.
  
 <note warning> <note warning>
-Users created through the panel or any other way offered by VHFFS are going to be unix users. Therefore you must **absolutely not** create a user with the same username of an already existing user on your system. If you do it, you can expect to not be able anymore to log in to your server with the duplicated user. If this is your only user you will lost the only way you had to log in to your server. More, asking your housing provider to reboot the server won't change anything, you'll probably need to physically reach the server to fix your mistake.+Users created through the panel or any other way offered by VHFFS are going to be unix users. Therefore you must **absolutely not** create a user with the same username of an already existing user on your system. If you do so, you can expect to not be able anymore to log in to your server with the duplicated user. If this is your only user you will lost the only way you had to log in to your server. More, asking your housing provider to reboot the server won't change anything, you'll probably need to physically reach the server to fix your mistake.
 </​note>​ </​note>​
  
Line 99: Line 105:
  
 Of course, you can also change the password in the VHFFS database, but playing the "​Where'​s Wally ?" game with the greeting email is fun, isn't it ? Of course, you can also change the password in the VHFFS database, but playing the "​Where'​s Wally ?" game with the greeting email is fun, isn't it ?
 +
 +<note note>
 +Your panel is going to send mails to real users, and this would be good for you if it's working, so don't forget to correctly configure the MTA of the server hosting the VHFFS panel.
 +</​note>​
  
 Next, we need to create the VHFFS user on the system. Next, we need to create the VHFFS user on the system.
   ​   ​
-  # /​usr/​lib/​vhffs/​bots/​user_create.pl +  # /​usr/​lib/​vhffs/​bots/​user.pl 
   # ls /​data/​home/​y/​o/​youruser   # ls /​data/​home/​y/​o/​youruser
   #    # 
Line 125: Line 135:
 If the panel does not switch languages this is probably because necessary locales are not compiled in on your system. If the panel does not switch languages this is probably because necessary locales are not compiled in on your system.
  
-On debian, run+On Debian, run
  
   # dpkg-reconfigure locales   # dpkg-reconfigure locales
   ​   ​
-Then select ​all character sets for each wanted translation.+Then select ​at least the UTF-8 codeset ​for each wanted translation.
  
Recent changes RSS feed Creative Commons License Donate Minima Template by Wikidesign Driven by DokuWiki