You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 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

  1. 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
  2. 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
  3. 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)
  4. 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
  5. *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
    • 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
  6. 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"
  7. 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"
  8. go into the themes directory (vcl/themes) and run "./copydojocss.sh default" to copy parts of dojo's css into the "default" theme
  9. 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
  10. open a browser and open the testsetup.php page
  11. debug any issues reported by testsetup.php
  12. now, open the index.php page in your browser
  13. select Local Account and use 'admin' as the user and 'adminVc1passw0rd' as the password
  14. click the "Management Nodes" link
  15. enter the hostname and IP of your management node
  16. click Add
  17. fill in "Install Path" - this is parent directory under which image files will be stored
  18. click "Confirm Management Node"
  19. click Submit
  20. click the "Management Nodes" link
  21. select "Edit Management Node Grouping"
  22. click Submit
  23. select the checkbox for your management node
  24. click Submit
  25. click "Manage Computers"
  26. select the "Add Single Computer" radio button
  27. click the Submit
  28. 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"
  29. click Confirm Computer
  30. click Submit (don't worry about the fact that the computer you just added isn't listed)
  31. after you've configured your image library and your management node has started checking in, you should be able to make a reservations
  • No labels