This is an old revision of the document!


Main Author: Chamindra de Silva Contributors: …

We hope to an executable installer that installs all Sahana components and depandancies soon, however till them please bear with the following manual proceedure below:

Installation Guide

Who Should Read This Guide

This guide is meant for users using the step-by-step installation/configuration, which is the default and recommended method of installing Sahana.

Overview

This Guide describes how to install Sahana Phase2. It is intended for experienced administrators and novices alike. After installation, you can configure users and do other administrative tasks. To install Sahana Phase2, ensure that you have the appropriate Pre-requisites: See Pre-requisites

Pre-requisites

Sahana requires the following to be installed on Windows:

o php 4.3 or later
o MySQL 4.1 or later
o Apache web server 1.3 or later
o latest php4-gd libs

If you already have Apache web server (and php loaded as an Apache Module) and MySQL running, then you have everything you need. In case you don't have the requisites setup, you have two options.

  • Use WAMP which has Apache, MySQL and php pre-configured to work together. See WAMP for Windows if you are using Windows.
  • If you want you could configure Apache, MySQL and php on you own manually.

Installing Sahana on Windows with WAMP

Fortunately a installation package called WAMP installs all the above in one sequence. This guide will explain how to install sahana on windows XP with WAMP

WAMP for Windows

  • Download the latest version of WAMP from here
  • Install and run WAMP by running the downloaded executable. Select all the defaults.

After downloading, start installing WAMP for Windows.

  • Accept the License Agreement and click “Next”

  • You can choose the default installation location and click “Next”

  • Select Start Menu Folder and click “Next”

  • Select Additional Tasks for Auto Start if required and click “Next”

  • Setup is now ready to begin installing WAMP5 on your computer and click “Install”

  • It will start installing WAMP5

  • Select a directory for your Document Root and click “OK”

  • Enter php mail parameter which is the smtp server to be used by php to send e-mails

  • Enter the e-mail address to be used by php to send e-mails

  • Select the default browser

  • If you use any firewall software (ie; Windows Firewall) if prompted please make sure that WAMP services (Apache Web Server, MySQL) are exempted from the blocked list.

  • Click “Finish” to complete the WAMP5 setup wizard and launch WAMP5

Notice:

  • If you use Skype, this may result in a port conflict with Apache web-server included in WAMP. Therefore make sure you re-start Windows to make sure that WAMP services start before Skype (then Skype will go for another free port).

Steps

A WAMP control icon and menu should appear as shown below:

  • Open the WAMP menu to Config files→php.ini to open the php.ini file. Modify the following line from
short_open_tag = Off

to

short_open_tag = On
  • Open the MySQL configuration file by clicking on the WAMP menu item Config files→my.ini. Modify the following line from
default-storage-engine=INNODB

to

default-storage-engine=MYISAM
  • Now download the version of Sahana .zip (e.g. sahana2-0.4.0-stable.zip) from the sourceforge site here
  • Uncompress and extract the Sahana directory from the .zip file
  • Now open the Apache servers www directory by clicking on the WAMP menu item www directory
  • copy the sahana directory into the www directory that was just opened

You need to check if all the relevant dependencies for the Sahana system to be installed are available on your system.

Sahana needs php_gd2 for image manipulations. Please install php_gd2 and restart the webserver.

Sahana needs php-gettext for to support local languages. Please install php_gettext and restart the webserver.

  • Enable the additional PHP extensions required for Sahana (php_gd2 and php_gettext) by clicking on the WAMP menu item PHP extensions→<extension name> where <extension name> is php_gd2 and php_gettext.
Please check if the above extensions are enabled after you clicked them (as it sometimes does not work) 
A small triangle should appear on the left of the extension name when it is enabled. 
Ignore the error box if it appears.

  • Restart the Apache server by clicking on the WAMP menu item Apache→Restart Service
  • Restart the Apache server by clicking on the WAMP menu item MySQL→Restart Service
  • Continue with the Sahana web installer
  • Enter Database configuration details and proceed the installation

  • Setup Sahana configurations by giving “Installation Details, Administrator Account details and Normal User Account details” and click “Write Configuration File”

  • Start Sahana by clicking “Start Sahana”

  • Mozilla Firefox 1.0 or later.
  • Microsoft® Internet Explorer 5.5 or later.

Allowing access from other machines (server installation only)

  • By default for security reasons the WAMP installation prevents other machines from accessing your web server. To allow others to access your Sahana installation open the Apache configuration file from the WAMP menu at Config files→httpd.conf and modify the lines
<Directory "c:/wamp/www">
...
Order Allow, Deny
Deny all
Allow from 127.0.0.1
...
</Directory>

to

<Directory "c:/wamp/www">
...
Order Allow, Deny
Allow all
...
</Directory>
  • Restart the Apache server by clicking on the WAMP menu item Apache→Restart Service
  • Check if it works by accessing your machine from another machines web browser as follows
http://<your IP address>/www/sahana

Navigation
QR Code
QR Code doc:installwamp:english (generated for current page)