{excerpt}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.{excerpt}
Your web server should meet the following criteria before installing the frontend VCL code:
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”.
copy the “web” directory to a location somewhere under the web root of your web server:
cp -r web/ /var/www/html/vcl
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)
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. NOTE: There is a misconfiguration in conf.php in VCL 2.1. To correct it, change affiliationid for “Local Account” in the $authMechs array from 4 to
*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
download version 0.4.0 of Dojo Toolkit: http://download.dojotoolkit.org/release-0.4.0/dojo-0.4.0-ajax.tar.gz
download version 1.1.0 of Dojo Toolkit: http://download.dojotoolkit.org/release-1.1.0/dojo-release-1.1.0.tar.gz
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 (most people can skip this step)
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
enter “/etc/vcl/vcl.key” for “End Node SSH Identity Key Files”
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 clicking Submit)
after you've configured your image library and your management node has started checking in, you should be able to make a reservation
There's not currently a tool for this. You will need to add entries directly to the database.
add entry to user table
INSERT INTO user (unityid, firstname, lastname, email, lastupdated) VALUES (‘myusername’, ‘myfirstname’, ‘mylastname’, ‘myemailaddr’, NOW());
find out the id generated for that user
SELECT id, unityid FROM user WHERE unityid = ‘myusername’;
add entry to the localauth table
INSERT INTO localauth (userid, salt, passhash, lastupdated) VALUES (‘place1’, ‘place2’, ‘place3’, NOW())
with place1 = id from step 2 place2 = an 8 char random string place3 = sha1sum( desired password with place2 stuck on the end ) this can be generated under linux like this (using ‘thedog’ as the password and 11111111 as place2): echo -n ‘thedog11111111’ | sha1sum Once a user has been added, the user can go to User Preferences to change his/her password