Page History

...

1. If you haven't already done so, download and extract a copy of the latest release. There is a link to it under the Project Resources section on our wiki home page. Look for "Current version".
2. copy the "web" directory to a location somewhere under the web root of your web server:

   Code Block
   cp -r web/ /var/www/html/vcl

3. copy/rename secrets-default.php to secrets.php
4. 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
5. 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)
6. copy/rename conf-default.php to conf.php
7. 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.**
8. *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
   • For PHP5, download the 3.x series, extract it, and copy the src directory from it to vcl/.ht-inc/jpgraph
9. open a browser and open the testsetup.php page
   • i.e. if you set up your site to be https://my.server.org/vcl/ open https://my.server.org/vcl/testsetup.php
10. debug any issues reported by testsetup.php
11. now, open the index.php page in your browser
12. 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
13. click the "Management Nodes" link
14. enter the hostname and IP of your management node
15. click Add
16. fill in "Install Path" - this is parent directory under which image files will be stored
17. enter "/etc/vcl/vcl.key" for "End Node SSH Identity Key Files"
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

Further steps if using only VMWare

Further steps if using xCAT

1. click "Manage Computers"
2. select the "Add Single Computer" radio button
3. click Submit (UPDATED TO HERE)
4. For vmware:
   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"
5. click Confirm Computer
6. click Submit (don't worry about the fact that the computer you just added isn't listed after clicking Submit)
7. after you've configured your image library and your management node has started checking in, you should be able to make a reservation

...

1. fill in the necessary information in vcl/.ht-inc/conf.php
2. add an entry to the affiliation table and use the id for that entry as 'affiliationid' for your new entry in vcl/.ht-inc/conf.php
3. uncomment the 'require_once(".ht-inc/authmethods/ldapauth.php");' line in in vcl/.ht-inc/conf.php

Setting Time Zone

1. Edit /var/www/html/vcl/.ht-inc/php5extras.php to indicate the correct time zone:
   date_default_timezone_set('America/Los_Angeles');
2. Edit /var/www/html/vcl/.ht-inc/requests.php (line 3301 currently) to indicate the correct time zone (purely cosmetic):
   print "<small>(Pacific Time Zone)</small>";