Assuming you have Apache, PHP and MySQL installed with the relative modules enabled and configured, proceed with installing Classroombookings following these steps.

1. Log in to MySQL, then create the database and user that will be used by Classroombookings. Don't worry about the tables at the moment - they will be set up later by the application.

   $ mysql -u root -p
   Enter password:
   mysql> CREATE DATABASE crbs;
   mysql> GRANT ALL PRIVILEGES ON crbs.* to 'crbs_user'@'localhost' IDENTIFIED BY 'password';
   

   Make a note of the database name, username and password you set here as you will need these later.

   If you prefer, you can use a MySQL management tool such as phpMyAdmin to complete the above operations.

2. Change to a location in the document root of the web server, eg /var/www or /home/httpd and then extract the archive.

   $ cd /var/www
   $ mkdir classroombookings
   $ cd classroombookings
   $ tar zxvf classroombookings-version.tar.gz
   

3. You will now need to edit several lines in the configuration files:

   • system/application/config/config.php

   • system/application/config/database.php

   config.php

   // Full URL to your installation
   $config['base_url'] = 'http://www.example.com/classroombookings/';
   
   // Empty string if using mod_rewrite in .htaccess
   $config['index_page'] = 'index.php';
   

   database.php

   $db['default']['hostname'] = 'localhost';
   $db['default']['username'] = 'crbs_user';
   $db['default']['password'] = 'password';
   $db['default']['database'] = 'crbs';
   $db['default']['dbdriver'] = 'mysql';
   $db['default']['dbprefix'] = '';
   $db['default']['active_r'] = TRUE;
   $db['default']['pconnect'] = FALSE;
   $db['default']['db_debug'] = TRUE;
   $db['default']['cache_on'] = FALSE;
   

4. Optional: Configure .htaccess for mod_rewrite. All you need to do is change the URL to reflect where Classroombookings is installed with a leading and trailing forward-slash.

   For example, if Classroombookings was installed at http://www.example.com/classroombookings/ then you need to change the RewriteBase to reflect the installation path. If you aren't using a subdirectory, just leave a single forward-slash.

   <IfModule mod_rewrite.c>
   RewriteEngine On
   RewriteBase /classroombookings/
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule ^(.*)$ index.php/$1 [L]
   </IfModule>
   

5. The next step involves applying writable permissions to several directories in your installation to allow Apache to upload files to them (images, CSV files etc).

   $ cd /var/www/classroombookings/
   $ chmod -R 775 webroot/images/roomphotos
   $ chmod -R 775 webroot/images/schoollogo
   $ chmod -R 775 webroot/images/bg
   $ chmod -R 775 system/cache
   $ chmod -R 775 temp
   

   You will probably require root privileges to apply the above permissions. Eg. If you're running Ubuntu, run sudo chmod.

6. Finally, it is time to run the installation script.

   Using a web browser, navigate to the web server where you installed Classroombookings to, Eg. http://www.example.com/classroombookings/. You will be presented with the installation page.

   Figure 2-1. The Classroombookings installation page

   

   Fill in the required information (denoted with a red asterisk next to the field name) and click Install.