This readme file is for setting up Calibro web UI developed by ESRU. It is totally independent of Calibro but requires Calibro in order to work.
1. Install third party WAMP, LAMP or MAMP stack. Development at ESRU has been done using Ampps and xampp. There are no known issues with these stacks so these are recommended with preference given to xampp which has been found better regarding backwards compatibility and stability. If prompted for user name and password for MySQL enter root for username and mysql for password

2. After installing the stack add the following lines to the apache/conf/httpd.conf file
RemoveHandler .html .htm
AddType application/x-httpd-php .php .htm .html

3. To ensure your computer (server) is not world viewable copy the following lines into the file apache/conf/httpd.conf in the text section labelled <Directory /> or equivalent on Linux computers
  Order deny,allow
  Deny from all
  Allow from 127.0.0.0/255.0.0.0 ::1/128
  Allow from your.IP.address.here
  Allow from any.other.IP.addresses
After making this change you may not be able to browse to localhost (although the 127.0.0... line above should allow you to do so) so you may have to explicitly type in your computer’s IP address instead

4. In the php/php.ini file make sure
  file_uploads is set to on
  upload_max_filesize = 32M (or more if you plan to upload bigger projects)

5. Within the ?AMP stack (re)start apache and sql servers to ensure the top three changes are effective.

6. If you were not prompted for username at step 1 then navigate to localhost/phpmyadmin from within an internet browser and create a user with credentials given at step 1

7. Within this distribution you have a folder named Calibro_UI. Copy it to the xampp/htdocs or ampps/www folder or other folder based on whichever stack you installed at step 1

8. There should be an SQL dump file called bpa_admin.sql in the distribution as well. Create an empty database with the same name as the dump file (for bpa_admin.sql create a database called bpa_admin). You may do this by opening a command line interface (CLI) such as DOS prompt on Windows OS or bash shell on Linux/Mac OS. Change directory to ampps/mysql/bin or xampp/mysql/bin and issue the command (remove .exe for Linux/Mac)
  mysql.exe -uroot -pmysql
This should take you to the mysql command line interface, issue the commands
  CREATE DATABASE bpa_admin;
  exit
This takes you back to the bash or DOS CLI

9. Populate this database by issuing the command
  mysql.exe -uroot -pmysql bpa_admin < bpa_admin.sql
(remove .exe for Linux/Mac)

10. On an internet browser navigate to localhost/ which should now have a link to Calibro_UI (or other UI as installed). Click on that link to go to the UI

11. Before this interface will work you need to set up the backend which is done by following instructions provided in the caliserv_backend_readme file