You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 17
Next »
Prerequisites
Your web server should meet the following criteria before installing the VCL Frontend 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):
- php-gd
- php-json
- php-mcrypt
- php-mysql
- php-openssl
- php-sysvsem
- php-xml
- php-xmlrpc
- 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.
Installing VCL Frontend Web Code
- checkout web code somewhere under the web root of your web server:
svn co https://svn.apache.org/repos/asf/incubator/vcl/trunk/web/ vcl
- modify vcl/.ht-inc/secrets.php
- set $vclhost, $vcldb, $vclusername, and $vclpassword to match your database setup
- create random passwords for $mcryptkey, $mcryptiv, and $pemkey - $mcryptiv must be 8 hex characters
- 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)
- 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
- *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 non-commercial use, 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
- For PHP5, download the 3.x series, extract it, and copy the src directory from it to vcl/.ht-inc/jpgraph
- download version 0.4.0 of Dojo Toolkit: http://download.dojotoolkit.org/release-0.4.0/dojo-0.4.0-ajax.tar.gz
- extract it under the vcl directory and rename "dojo-0.4.0-ajax" to "dojoAjax"
- download version 1.1.0 of Dojo Toolkit: http://download.dojotoolkit.org/release-1.1.0/dojo-release-1.1.0.tar.gz
- extract it under the vcl directory and rename "dojo-release-1.1.0" to "dojo"
- go into the themes directory (vcl/themes) and run "./copydojocss.sh default" to copy parts of dojo's css into the "default" theme
- if you want to be able to edit any of the documentation that comes bundled with the vcl web code, download fckeditor from http://www.fckeditor.net/download
- extract it under the vcl directory
- open a browser and open the testsetup.php page
- 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
- click the "Management Nodes" link
- enter the hostname and IP of your management node
- click Add
- fill in "Install Path" - this is parent directory under which image files will be stored
- 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
- click "Manage Computers"
- select the "Add Single Computer" radio button
- click the Submit
- fill in Hostname, IP Address, owner (admin@Local), RAM, Proc Speed, Network Speed, select "blade" for Type, select "xCAT 1.x Provisioning" for "Provisioning Engine", and click the checkbox under "allcomputers", and "newimages"
Note: if using using vmware, select "virtualmachine" for Type and "VMWare Server Provisioning" for "Provisioning Engine"
- click Confirm Computer
- click Submit (don't worry about the fact that the computer you just added isn't listed)
- after you've configured your image library and your management node has started checking in, you should be able to make a reservations