openVULab Web Component Installation Guide
==================
Main Project Site:  http://openvulab.ca
User Manual:        http://wiki.fluidproject.org/display/fluid/Open+Virtual+Usability+Lab
Public Project Demo: http://vulab.yorku.ca


Required Knowledge
------------------

	* Basic FTP Knowledge (Uploading Files)
	* Basic Website Knowledge (what is a subdirectory, am I uploading into the root directory?)
	* Basic File Editing Knowledge (ability to open a .php file and edit plain text settings)
	* Basic Database Experience (Ability to import a .sql file into an existing database, what are database credentials?)
	* Basic Server Administration Knowledge (Ability to install package)


Required Server Packages
------------------------
	
	* PHP 5+
	* MySQL 4+
	* Mencoder (Installation of this is explained below under "Additional Server Setup")


Setting Up Web Interface
------------------------

1. Upload All Files
	* Upload all files in zip file into the root directory of your website.
	
	NOTE: there are options for uploading into a sub-folder of your root directory but this is currently in beta testing! Use at your own risk.
	
2. Configure Database
	* Open admin/config.live.php
	* The first options you will see are for "database configuration", fill in all the information listed. (database name, database user, database password)
	
3. Import Database Schema
	* import the file database.sql into your mysql database
	NOTE: this can be done with phpMyAdmin, but this step's background knowledge is part of the required knowledge for this guide.
	
4. Create First (Admin) User
	* Browse to: http://yourdomain.com/admin/signup.php
	* Fill out the information for the admin user
	* BE SURE TO SELECT 'RESEARCHER' AS YOUR ACCOUNT TYPE
	* You will now be emailed your username and password but you can log in right away.
	* You are now setup with an admin account!
	
	NOTE: The first user is automatically the admin user so don't loose this account info or let it get stolen or taken by the social engineers in your network.
	
	
Additional Server Setup
-----------------------

openVULab requires mencoder (which is part of the MPlayer package) and if you are not comfortable with this please contact your server administrator.

MPlayer Documentation: http://www.mplayerhq.hu/design7/info.html#docs