Installation instructions

 
bispark home page
Download TrackThrough
Download the latest trackthrough_x_x.zip (compressed source) file from http://bispark.com/trackthrough/download.
Unzip trackthrough_x_x.zip file into your webserver's document root.
e.g.: C:\Program Files\Apache Software Foundation\Apache2.2\htdocs or /var/www/html (please check your webserver documentation to find out correct document root path).
If you have configured a virtual host‚ use the appropriate directory to unzip the source.

screenshot of directory structure
Directory structure
After you unzip the source please verify that the installation directory resembles the screenshot.
Please make sure the folder templates_c is writeable for web user.


screenshot of TrackThrough installation page
screenshot of TrackThrough installation success page
Web installation
To install TrackThrough, you need to run install.php from web browser.
  1. Visit the following URL using your favorite browser http://yoursite.com/trackthrough/install.php; this should take you to a page (please check the screen shot) asking to input following details - database name, database server, database user name and database user password.
  2. Input the database particulars.
  3. Input Admin username, Admin password, Admin email address & submit. If everything goes fine, you should see an installation success page (please check the screenshot).
If you had problem using the web installation you may want to try the manual installation procedure explained in the next section.


screenshot of php myadmin

screenshot of config ini page

screenshot of config ini page
Manual installation
  1. Create TrackThrough database
    Create a database (e.g.: ttdb) using phpMyAdmin or any other MySQL client.
    Import the database schema from file ttdb.sql (you can find schema file inside scripts folder).
    e.g.: mysql –udbusername –p –h localhost ttdb < C:\...\your_
    installation_directory\scripts\ttdb.sql
  2. Configure ini file
    Copy the file config.ini.original from installation_directory/scripts to installation_directory /config.ini.
    e.g.: copy   your_installation_directory\scripts\config.ini.original   your_
    installation_directory\config.ini
  3. Edit config.ini to modify the following variables
    Base URL: Web address of for your installation
    (http://yoursite.com/trackthrough)

    Database name: Database source name – ttdb (the one you created above).

    Database server: The MySQL server. It can also include a port number.
    e.g.: hostname:port or a path to a local socket
    e.g.: :/path/to/socket for the localhost
    If the PHP directive mysql.default_host is undefined (default)‚ then the default value is localhost:3306.

    Database username: Default value is the name of the user that owns the server process.

    Database password: Default value is an empty password.


Common error messages
Application is already installed; please remove 'config.ini' file and run this script to reinstall the application
You get this error when TrackThough is already installed. To reinstall the application‚ access the installation URL after removing the config.ini file.
Missing config file in the distribution source
The file config.ini.original is missing from your source.
Please check installation_directory/script folder for the config.ini.original file.
Can't create ini file
The installation directory may not have write/create permission for web user.
Could not connect to MySQL Server
The error indicates incorrect database particulars.
Could not create database. Database already exists
The database you are trying to create already exists. Select YES option for Have you already created a database? and resubmit the values. You may also want to input table prefix if you are sharing the database with other applications.
There is no database by name ..............
The database is not yet created; you can create the database manually and resubmit the page. Alternatively select NO option for Have you already created a database? and resubmit the values.
Missing sql file in the distribution source
You may have not copied the correct installation source.
Invalid config file
You may have not copied the correct installation source.