Web server setup
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 4 or 5
- php modules that should be installed:
- php-mcrypt
- php-mysql
- php-xmlrpc
- php-gd
- php-xml
- useful to have the server set up to be able to send debugging emails
Installing VCL Frontend Web Code
- checkout web code somewhere under the web root of your web server:
Code Block |
---|
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
- download jpgraph from http://www.aditus.nu/jpgraph/jpdownload.php
- if you are using PHP5, download the 2.x series, extract it, and copy the src directory from it to vcl/.ht-inc/jpgraph
- if you are using PHP4, download the 1.x series, extract it, and copy the src directory from it to vcl/.ht-inc/jpgraph.old
- 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"
- 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 go to the URL you set up; 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
- 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"
- click the 'Add' button
- fill in Hostname, IP Address, 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
- 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