Installation Steps

From PANACeA THIRRA

Revision as of 17:36, 12 January 2011

INSTALLATION STEPS

- Ensure that the system has the Apache webserver is running properly with PHP activated. The postgresql extension for PHP must be installed to allow Apache to access the database server. These components must be working first, before trying to install THIRRA, so that any installation error can be identified more easily.

- Obtain tar ball or pull down via Subversion from Sourceforge

  svn co https://thirra.svn.sourceforge.net/svnroot/thirra thirra 

- Place "thirra" directory from thirra/trunk/ into web server document root

  e.g. /var/www/thirra

- Edit the following database configuration file:

 thirra/app_thirra/config/database.php
 - change $db['default']['database'] = "thirra-samp"; to the correct database.
 - make sure that the database user and password is correct.

- Create and restore database (available separately from Sourceforge or PCDOM) inside PostgreSQL, using either pgsql or PgAdmin3. Ensure that the database schema matches the correct version of THIRRA. There are 2 possible database backups - new clinics and sample database. For instance, thirra-samp-122-121001.psql means it cannot be used for source codes earlier than Build 122. It is usable for newer version to the extent of the newer sample database version.

- Create the required directories (look inside the thirra/docs/directories_required.txt for the latest info.

 - /var/www/synch-THIRRA/in  (deprecate)
 - /var/www/synch-THIRRA/out (deprecate)
 - /var/www/thirra-uploads/patient_pics
 - /var/www/thirra-uploads/case_pics
 - /var/www/thirra-uploads/exports_consult
 - /var/www/thirra-uploads/exports_history
 - /var/www/thirra-uploads/exports_patient
 - /var/www/thirra-uploads/exports_refer
 - /var/www/thirra-uploads/imports_consult
 - /var/www/thirra-uploads/imports_history
 - /var/www/thirra-uploads/imports_patient
 - /var/www/thirra-uploads/imports_refer

- For pdf documents output, download mpdf from http://mpdf.bpm1.com/

- Unzip and move, renaming the whole mpdf directory to /var/www/mpdf so that all THIRRA installations can use this single copy. - Make a symbolic to the directory of mpdf

 ln -s /var/www/mpdf /var/www/thirra/mpdf

- Copy /var/www/mpdf/mpdf.php to /var/www/thirra/codeigniter/system/libraries - Edit this file changing

 if (!defined('_MPDF_PATH')) define('_MPDF_PATH', dirname(preg_replace('/\\\\/','/',__FILE__)) . '/');
 if (!defined('_MPDF_PATH')) define('_MPDF_PATH', 'mpdf/'); // To adapt to CodeIgniter

- Change ownership of the whole "thirra" directory to web server user

- To launch THIRRA use the following URL in browser that supports XHTML:

 http://[appropriate_domain_name]/thirra/