Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
doc:installwamp:english [2008/06/02 11:56] richard |
doc:installwamp:english [2010/04/16 21:56] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | Main Author: [[http:// | + | Main Author: [[http:// |
+ | We hope to have an executable installer that installs all Sahana components and dependancies soon, | ||
+ | however until then please bear with the following manual procedure: | ||
- | We hope to an executable installer that installs all Sahana components and depandancies soon, however till them please | + | **If you have any problems, please |
+ | ===== MS Windows Installation Guide ===== | ||
- | ===== Installation | + | === Who Should Read This Guide === |
- | ===== Who Should Read This Guide ===== | + | This guide is meant for users using the step-by-step installation/ |
- | This guide is meant for users using the step-by-step installation/ | + | === Outline === |
+ | We will be creating of a **WAMP** setup, which stands for **W**indows, | ||
- | ===== Overview | + | ===== List of pre-requisites |
- | This Guide describes how to install Sahana Phase2. It is intended for experienced administrators and novices alike. After installation, | + | ==== Server Software ==== |
+ | Sahana requires the following to be installed: | ||
+ | * [[wp> | ||
+ | * including the latest php5-gd library | ||
+ | * [[wp> | ||
+ | * [[wp> | ||
- | ===== Pre-requisites ===== | + | Fortunately a installation package called [[http:// |
- | Sahana requires the following to be installed on Windows: | + | ==== Recommended Browsers ==== |
- | o php 5.0 or later | + | All modern visual browsers that support JavaScript will run Sahana smoothly, such as: |
- | o MySQL 4.1 or later | + | |
- | o Apache web server 1.3 or later | + | |
- | o latest php5-gd libs | + | |
- | If you already have Apache web server | + | * [[wp> |
+ | * Microsoft(r) [[wp> | ||
+ | * [[wp> | ||
+ | * [[wp> | ||
+ | * [[wp> | ||
- | * Use WAMP which has Apache, MySQL and php pre-configured to work together. See WAMP for Windows if you are using Windows. | + | [[wp> |
- | * If you want you could configure Apache, MySQL and php on you own manually. | + | |
+ | ==== Screenshots ==== | ||
+ | ===== WampServer Installation Procedure ===== | ||
+ | * Download **WAMP v1.7.4** from [[http:// | ||
+ | {{ doc: | ||
+ | * If possible, run the executable directly inside your browser. Otherwise save it and then start the installer. You will be greeted by this screen. | ||
+ | {{ doc: | ||
+ | * Accept the License Agreement and click " | ||
+ | {{ doc: | ||
+ | * Choose the installation location (default works fine) and click " | ||
+ | {{ doc: | ||
- | ===== Installing Sahana on Windows with WAMP ===== | + | * Select Start Menu Folder and click " |
+ | {{ doc: | ||
- | Fortunately a installation package called [[http:// | + | * Select Additional Tasks for Auto Start if required and click " |
+ | {{ doc:installwamp:wamp5.jpg }} | ||
- | WAMP for Windows | + | * Setup is now ready to begin installing WAMP5 on your computer. Click " |
+ | {{ doc: | ||
- | * < | + | * At this point, |
- | * **Due to a conflict between Sahana(v0.6.2) and the latest version of WAMP (WampServer 2.0), WAMP v1.7.4 should be used instead. Download from** [[http:// | + | {{ doc:installwamp: |
- | * Install | + | * Select a directory for your Document Root and click " |
+ | {{ doc: | ||
- | After downloading, | + | * Enter php mail parameter which is the smtp server to be used by php to send e-mails === |
+ | {{ doc: | ||
- | {{doc: | ||
- | * Accept the License Agreement and click " | ||
- | {{doc: | ||
- | * You can choose the default installation location and click " | ||
- | {{doc: | ||
- | * Select Start Menu Folder and click " | ||
- | {{doc: | ||
- | * Select Additional Tasks for Auto Start if required and click " | ||
- | {{doc: | ||
- | * Setup is now ready to begin installing WAMP5 on your computer and click " | ||
- | {{doc: | ||
- | * It will start installing WAMP5 | ||
- | {{doc: | ||
- | * Select a directory for your Document Root and click " | ||
- | {{doc: | ||
- | * Enter php mail parameter which is the smtp server to be used by php to send e-mails | ||
- | {{doc: | ||
* Enter the e-mail address to be used by php to send e-mails | * Enter the e-mail address to be used by php to send e-mails | ||
- | {{doc: | + | {{ doc: |
* Select the default browser | * Select the default browser | ||
- | {{doc: | + | {{ doc: |
- | * 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. | + | |
- | {{doc: | + | === Firewall === |
+ | * If you use any firewall software (i.e. [[wp>Windows Firewall]]) if prompted please make sure that WAMP services (Apache Web Server, MySQL) are exempted from the blocked list. | ||
+ | |||
+ | {{ doc: | ||
+ | |||
+ | === Completion === | ||
* Click " | * Click " | ||
- | {{doc: | ||
- | **Notice:** | + | {{ doc:installwamp: |
- | * 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). | + | ==== Troubleshooting ==== |
- | * If after installing sahana useing //WAMP v2// you get the message\\ //LOGSQL Insert Failed: insert into adodb_logsql (created, | + | === Skype Users === |
+ | Skype may result in a port conflict with Apache web-server included in WAMP. Therefore, make sure you re-start Windows to make sure that the WAMP services start before Skype. Skype will go for another free port when it starts. | ||
+ | === adobd_logsql Error === | ||
+ | Try using [[http:// | ||
+ | LOGSQL Insert Failed: insert into adodb_logsql (created, | ||
+ | ===== Server Configuration | ||
- | ===== Steps ===== | + | ==== Accessing WAMP Control Menu ==== |
A WAMP control icon and menu should appear as shown below: | A WAMP control icon and menu should appear as shown below: | ||
Line 95: | Line 113: | ||
{{http:// | {{http:// | ||
- | * Open the WAMP menu to **Config files-> | ||
- | short_open_tag | + | ==== Configuration Files ==== |
- | to | + | |
- | short_open_tag | + | |
- | * Open the MySQL configuration file by clicking on the WAMP menu item **Config files-> | + | === php.ini === |
- | default-storage-engine=INNODB | + | Open the WAMP menu to **'' |
- | to | + | |
- | default-storage-engine=MYISAM | + | |
- | | + | Modify |
- | * Uncompress and extract the Sahana directory from the .zip file | + | === my.ini === |
- | * Now open the Apache servers www directory by clicking | + | Click on the WAMP menu item **'' |
- | * copy the sahana directory into the www directory that was just opened | + | ==== PHP Configuration ==== |
- | * Point your browser | + | Sahana needs php_gd2 for image manipulations and php-gettext for to local languages. These are extensions to the [[wp> |
- | You need to check if all the relevant dependencies for the Sahana system to be installed are available | + | Enable |
- | {{doc: | + | 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. |
- | Sahana needs php_gd2 for image manipulations. Please install php_gd2 and restart the webserver. | + | Then restart the WAMP server. |
- | Sahana | + | ===== Sahana |
- | | + | |
+ | - Extract | ||
+ | - Open WAMP menu item '' | ||
+ | | ||
+ | - Point your browser to '' | ||
- | Please check if the above extensions are enabled after you clicked them (as it sometimes does not work) | + | ==== Sahana web-install walkthrough ==== |
- | A small triangle should appear on the left of the extension name when it is enabled. | + | |
- | Ignore the error box if it appears. | + | |
- | {{doc: | + | The Sahana system will now walk you through the steps required, so that it can talk to the WAMP system that you have just enabled. |
- | * Restart the Apache server by clicking on the WAMP menu item **Apache->Restart Service** | + | ==== Sahana self-check ==== |
- | * Restart the Apache server by clicking on the WAMP menu item **MySQL-> | + | |
- | * Continue with the Sahana | + | Sahana |
- | * Enter Database configuration details and proceed the installation | + | |
+ | {{ doc: | ||
+ | |||
+ | {{ doc: | ||
+ | |||
+ | === Database | ||
+ | |||
+ | Enter the database | ||
{{doc: | {{doc: | ||
- | * Setup Sahana configurations by giving " | ||
- | {{doc: | ||
- | {{doc: | ||
- | {{doc: | ||
- | * Start Sahana | + | === Sahana |
- | {{doc: | + | This step allows you to create the first users of the Sahana instance you are creating. They will allow you to test how things operate from an Administrator' |
+ | Enter " | ||
- | ===== Recommended Browsers ===== | + | {{doc: |
+ | {{doc: | ||
+ | {{doc: | ||
- | * Mozilla Firefox 1.0 or later. | + | === Start Sahana === |
- | * Microsoft® Internet Explorer 5.5 or later. | + | |
+ | Congratualtions. Setup is complete. Start Sahana by clicking "Start Sahana" | ||
+ | {{doc: | ||
- | ===== Allowing access from other machines | + | ===== Allowing access from other machines ===== |
- | | + | Use this section only if you wish to allow multi-user access. |
+ | | ||
+ | |||
+ | To allow others to access your Sahana installation, modify | ||
+ | |||
+ | Modify: | ||
< | < | ||
Line 167: | Line 194: | ||
... | ... | ||
</ | </ | ||
- | to | + | |
+ | to: | ||
< | < | ||
... | ... |