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 [2007/11/05 13:17] buddhini |
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 |
- | ===== Installation Guide ===== | + | ===== MS Windows |
- | ===== 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 === | ||
- | ===== Overview ===== | + | We will be creating of a **WAMP** setup, which stands for **W**indows, |
- | This Guide describes how to install Sahana Phase2. It is intended for experienced administrators and novices alike. After installation, | + | ===== List of pre-requisites |
+ | ==== Server Software ==== | ||
- | ===== Pre-requisites ===== | + | Sahana requires the following to be installed: |
- | Sahana | + | * [[wp> |
+ | * including the latest php5-gd library | ||
+ | * [[wp> | ||
+ | * [[wp> | ||
- | o php 4.3 or later | + | Fortunately a installation package called [[http:// |
- | 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. | + | ==== Recommended Browsers ==== |
- | * Use WAMP which has Apache, MySQL and php pre-configured to work together. See WAMP for Windows if you are using Windows. | + | All modern visual browsers that support JavaScript will run Sahana smoothly, such as: |
- | * If you want you could configure Apache, MySQL and php on you own manually. | + | |
+ | * [[wp> | ||
+ | * Microsoft(r) [[wp> | ||
+ | * [[wp> | ||
+ | * [[wp> | ||
+ | * [[wp> | ||
+ | [[wp> | ||
+ | ==== Screenshots ==== | ||
+ | ===== WampServer Installation Procedure ===== | ||
- | ===== Installing | + | * Download **WAMP v1.7.4** from [[http:// |
- | Fortunately a installation package called [[http:// | + | {{ doc:installwamp:downloadwamp.jpg }} |
- | WAMP for Windows | + | * 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: | ||
- | * Download | + | * Accept |
+ | {{ doc:installwamp: | ||
- | * Install | + | * Choose the installation location (default works fine) and click " |
- | After downloading, | + | {{ 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 " | * Select Start Menu Folder and click " | ||
- | {{doc: | + | {{ doc: |
* Select Additional Tasks for Auto Start if required and click " | * Select Additional Tasks for Auto Start if required and click " | ||
- | {{doc: | + | {{ doc: |
- | * Setup is now ready to begin installing WAMP5 on your computer | + | |
- | {{doc: | + | * Setup is now ready to begin installing WAMP5 on your computer. Click " |
- | * It will start installing WAMP5 | + | {{ doc: |
- | {{doc: | + | |
+ | * At this point, the installer | ||
+ | {{ doc: | ||
* Select a directory for your Document Root and click " | * Select a directory for your Document Root and click " | ||
- | {{doc: | + | {{ doc: |
- | * Enter php mail parameter which is the smtp server to be used by php to send e-mails | + | |
- | {{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 ==== |
+ | === 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, | ||
- | ===== Steps ===== | + | ===== Server Configuration |
+ | |||
+ | ==== 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 86: | 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 158: | Line 194: | ||
... | ... | ||
</ | </ | ||
- | to | + | |
+ | to: | ||
< | < | ||
... | ... |