Installation Instructions for VSBT Rev 2.02
STEP A – PREPARATION
A.1 Download one of the installation packages (provided in tar and zip formats) from the VSBT website (http://www.vsbt.net/downloads/).
A.2 Uncompress the installation package into the directory where you want to install VSBT.
STEP B – THE MYSQL DATABASE
B.1 Create a MySQL database. You can do this by running the ‘mysql’ command from the command line or you can use phpMyAdmin (highly recommended as an administration tool for MySQL – http://www.phpmyadmin.net).
B.2 Create the database tables using the SQL commands in the ‘VSBT.sql’ file included in the installation directory. You can either do this using the ‘mysql’ command from the command line, or using phpMyAdmin (highly recommended).
B.3 Create the first user in the Users table. Once again, we recommend that you use phpMyAdmin to do this. Make sure that this user is Active (Status=’Active’) and an Admin (Admin=’Y'). Record the username for this user – you’ll need it again in Step C.
STEP C – THE PASSWORD FILE
C.1 Create a password file in a directory outside the HTML tree. For instance, if the VSBT code is installed at ‘/home/httpd/VSBT/html’, you might want to create a directory at ‘/home/httpd/config’. You can create the password file from the command line using the command ‘htpasswd -c nameofmypasswordfile’.
C.2 Make the password file readable and writeable by the Apache user i.e. the user that the Apache daemon is running as.
C.3 Add the first username and password to the password file. You can do this using the command ‘htpasswd -b nameofpasswordfile yourusername yourpassword’ where yourusername is the same username as you used in Step B.
STEP D – THE SITECONFIG FILE
D.1 Move the ’siteconfig.php’ file from the installation directory to a directory outside the HTML tree. For convenience, you might want to put it in the same place as the password file.
D.2 Edit the ’siteconfig.php’ file to include the correct site URL, database login information, and paths to the htpasswd command and the password file. Also edit this file to include project information for this installation.
STEP E – THE HTACCESS FILE
E.1 Return to the main installation directory. Edit the ‘.htaccess’ file to include the path to the configuration directory for your installation (e.g. /home/httpd/VSBT/config) and the path to your password file (e.g. /home/httpd/VSBT/config/passwords).
Your installation of VSBT should now be complete. If you experience any problems with the installation, please let us know at http://www.vsbt.net/contact/
These installation instructions are Copyright © 2006-2009, Addison Robson LLC.
