This page describes how to install and configure the frontend VCL web code components including the web server prerequisites and frontend VCL web code. It also describes how to add local web accounts, configure LDAP authentication, and set the timezone correctly.
Your web server should meet the following criteria before installing the frontend VCL code:
Apache HTTP Server v1.3 or v2.x with SSL enabled - while VCL may run under another webserver capable of running PHP code, it has only been tested to work with Apache HTTP Server
PHP 5
php modules that should be installed (depending on your Linux distro, some of these may be compiled in to php instead of being a separate module):
If you are running RedHat or CentOS, these can be installed with
yum install httpd mod_ssl php-gd php-mcrypt php-mysql php-xml php-xmlrpc php-ldap
If you will be using a self-signed certificate for SSL, this is a great HOWTO explaining how to set that up on CentOS.
useful to have the server set up to be able to send debugging emails
php-mcrypt requires libmcrypt and mcrypt libraries as dependencies. These may need to be installed first.
If you haven't already done so, download and extract a copy of the release. There is a link to it on our download page.
copy the “web” directory to a location somewhere under the web root of your web server:
cp -r web/ /var/www/html/vcl
copy/rename secrets-default.php to secrets.php
modify vcl/.ht-inc/secrets.php
run the genkeys.sh script from within vcl/.ht-inc and give it $pemkey from secrets.php as the passphrase (3 times, copy/paste is a good idea here)
copy/rename conf-default.php to conf.php
modify vcl/.ht-inc/conf.php to match your site - COOKIEDOMAIN needs to be the domain name your web server is using, or left blank if you are accessing it by IP only. You really need to modify every entry in the “Things in this section must be modified” part of the file.
NOTICE JpGraph 2.x is no longer available. JpGraph 3.x is released under a dual license. QPL 1.0 (Qt Free Licensee). Free for non-commercial, open-source or educational use (JpGraph Professional License for commercial use). If you are planning to use this for commercial use and don't want to pay for JpGraph, you can safely skip this step with the only side effect of not being able to display a few graphs on the statistics page. Download JpGraph from http://www.aditus.nu/jpgraph/jpdownload.php
make the .ht-inc/maintenance directory writable by the web server user - i.e. if the httpd process is running as user ‘apache’ run ‘chown apache .ht-inc/maintenance’
open the testsetup.php page in a web browser
debug any issues reported by testsetup.php
now, open the index.php page in your browser
select Local Account and use ‘admin’ as the user and ‘adminVc1passw0rd’ as the password
**Now would be a good time to change the password from the default by going to User Preferences
click the “Management Nodes” link
enter the hostname and IP of your management node
click Add
fill in these additional required fields:
optionally, fill in these unrequired fields:
click “Confirm Management Node”
click Submit
click the “Management Nodes” link
select “Edit Management Node Grouping”
click Submit
select the checkbox for your management node
click Submit
Further steps if using only VMWare
Next Step: Management Node Installation
Additional local accounts can now be added using the backend code. After you have finished the backend install, run
vcld -setup
select vcl base module option and follow the prompts.
instructions on Adding LDAP Authentication have been moved to a separate page