Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:installwamp:english [2007/11/05 04:28]
roshan
doc:installwamp:english [2010/04/16 21:56] (current)
Line 1: Line 1:
-Main Author: [[http://www.linux.lk/~chamindra | Chamindra de Silva ]] Contributors: ...+Main Author: [[http://www.linux.lk/~chamindra | Chamindra de Silva ]] Contributors: [[http://www.timmcnamara.co.nz | Tim McNamara ]]
  
 +  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 soonhowever till them please bear with the following manual proceedure below:+**If you have any problems, please email [[support@sahana.lk]] or visit us at http://www.sahana.lk/chat.**
  
-===== Installation Guide =====+===== MS Windows Installation Guide =====
  
-===== Who Should Read This 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. +This guide is meant for users using the step-by-step installation/configuration, which is the default and recommended method of installing Sahana. It is intended for both novices and experienced administrators.
  
 +=== Outline ===
  
-===== Overview =====+We will be creating of a **WAMP** setup, which stands for **W**indows, **A**pache, **M**ySQL and **P**HP. It is a standard and well-used configuration for millions of websites worldwide. You have two choices to installing the pre-requsities. Several applications will install all of these for you. We will be demonstrating the WampServer application in this guide. You are also able to install and configure each of them individually.
  
-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, ensure that you have the appropriate Pre-requisites: See Pre-requisites+===== List of pre-requisites =====
  
 +==== Server Software ====
  
-===== Pre-requisites =====+Sahana requires the following to be installed:
  
-Sahana requires the following to be installed on Windows:+  * [[wp>PHP|PHP 5.0]] or later, which is the programming language used for the application 
 +     * including the latest php5-gd library 
 +  * [[wp>MySQL|MySQL 4.1]] or later, which provides Sahana's database 
 +  * [[wp>Apache_HTTP_Server|Apache web server 1.3]] or later, which will bring the application together via a web broswer
  
-  o php 4.3 or later +Fortunately a installation package called [[http://www.wampserver.com/en/ | WampServer]] installs all the above in one sequence.
-  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 ApacheMySQL 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 smoothlysuch as:
-   * If you want you could configure Apache, MySQL and php on you own manually. +
  
 +  * [[wp>Mozilla Firefox]]
 +  * Microsoft(r) [[wp>Internet Explorer]]
 +  * [[wp>Google Chrome]]
 +  * [[wp>Flock_(web_browser)|Flock]]
 +  * [[wp>Opera_(web_browser)|Opera]]
  
 +[[wp>Lynx]] and other text browsers will 
  
 +==== Screenshots ====
  
 +===== WampServer Installation Procedure =====
  
-===== Installing Sahana on Windows with WAMP =====+    * Download **WAMP v1.7.4** from [[http://sourceforge.net/project/showfiles.php?group_id=116092&package_id=126042&release_id=553584| here]]. Due to a conflict between Sahana(v0.6.2) and the latest version of WAMP (WampServer 2.0), the newest version should be avoided.
  
-Fortunately a installation package called [[http://www.wampserver.com | WAMP]] installs all the above in one sequence. This guide will explain how to install sahana on windows XP with [[http://www.wampserver.com | WAMP]]+{{ 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:installwamp:wamp1.jpg }}
  
-    * Download the latest version of WAMP from [[http://www.wampserver.com/en/download.php | here]]+    * Accept the License Agreement and click "Next" 
 +{{ doc:installwamp:wamp2.jpg }}
  
-    * Install and run WAMP by running the downloaded executable. Select all the defaults. +    * Choose the installation location (default works fine) and click "Next" 
-After downloading, start installing WAMP for Windows.+{{ doc:installwamp:wamp3.jpg }}
  
-{{doc:installwamp:wamp1.jpg|}} 
-    * Accept the License Agreement and click "Next" 
-{{doc:installwamp:wamp2.jpg|}} 
-    * You can choose the default installation location and click "Next" 
-{{doc:installwamp:wamp3.jpg|}} 
     * Select Start Menu Folder and click "Next"     * Select Start Menu Folder and click "Next"
-{{doc:installwamp:wamp4.jpg|}}+{{ doc:installwamp:wamp4.jpg }} 
     * Select Additional Tasks for Auto Start if required and click "Next"     * Select Additional Tasks for Auto Start if required and click "Next"
-{{doc:installwamp:wamp5.jpg|}} +{{ doc:installwamp:wamp5.jpg }} 
-    * Setup is now ready to begin installing WAMP5 on your computer and click "Install" + 
-{{doc:installwamp:wamp6.jpg|}} +    * Setup is now ready to begin installing WAMP5 on your computer. Click "Install" 
-    * It will start installing WAMP5 +{{ doc:installwamp:wamp6.jpg }} 
-{{doc:installwamp:wamp7.jpg|}}+ 
 +    * At this point, the installer will begin to copy files. No user action is required. 
 +{{ doc:installwamp:wamp7.jpg }} 
     * Select a directory for your Document Root and click "OK"     * Select a directory for your Document Root and click "OK"
-{{doc:installwamp:wamp8.jpg|}} +{{ doc:installwamp:wamp8.jpg }} 
-    * Enter php mail parameter which is the smtp server to be used by php to send e-mails + 
-{{doc:installwamp:wamp9.jpg|}}+    * Enter php mail parameter which is the smtp server to be used by php to send e-mails === 
 +{{ doc:installwamp:wamp9.jpg }} 
     * 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:installwamp:wamp10.jpg|}}+{{ doc:installwamp:wamp10.jpg }} 
     * Select the default browser     * Select the default browser
-{{doc:installwamp:wamp11.jpg|}} +{{ doc:installwamp:wamp11.jpg }} 
-    * 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:installwamp:wamp12.jpg|}}+=== 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:installwamp:wamp12.jpg }} 
 + 
 +=== Completion === 
     * Click "Finish" to complete the WAMP5 setup wizard and launch WAMP5     * Click "Finish" to complete the WAMP5 setup wizard and launch WAMP5
-{{doc:installwamp:wamp13.jpg|}} 
  
-Notice:+{{ doc:installwamp:wamp13.jpg }}
  
-       * 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://sourceforge.net/projects/wampserver/ | WAMP v1.7.4]] if, after installing Sahana using WAMP v2 you get the message:
  
 +  LOGSQL Insert Failed: insert into adodb_logsql (created,sql0,sql1,params,tracer,timer) values( NOW(),?,?,?,?,?)
  
-===== 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://www.wampserver.com/en/images/illu_menu.gif}}   {{http://www.wampserver.com/en/images/illu_menu.gif}}  
  
-  * Open the WAMP menu to **Config files->php.ini** to open the php.ini file. Modify the following line from 
  
-  short_open_tag Off +==== Configuration Files ====
-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 +=== php.ini ===
  
-  default-storage-engine=INNODB +Open the WAMP menu to **''Config files->php.ini''** to open the php.ini file.
-to +
-  default-storage-engine=MYISAM+
  
-  Now download the version of Sahana **.zip** (e.g. sahana2-0.4.0-stable.zip) from the sourceforge site [[http://sourceforge.net/project/showfiles.php?group_id=127855|here]]+Modify **''short_open_tag = Off''** to **''short_open_tag On''**
  
-  * Uncompress and extract the Sahana directory from the .zip file+=== my.ini ===
  
-  * Now open the Apache servers www directory by clicking on the WAMP menu item **www directory**+Click on the WAMP menu item **''Config files->my.ini''**. Modify **''default-storage-engine=INNODB''** to **''default-storage-engine=MYISAM''**.
  
-  * copy the sahana directory into the www directory that was just opened+==== PHP Configuration ====
  
-  * Point your browser to http://localhost/sahana/www+Sahana needs php_gd2 for image manipulations and php-gettext for to local languages. These are extensions to the [[wp>PHP]] programming language that you installed with WAMP.
  
-You need to check if all the relevant dependencies for the Sahana system to be installed are available on your system.+Enable the extensions by clicking on the WAMP menu item **PHP extensions-><extension name>** where <extension name> is **php_gd2** and **php_gettext**.
  
-{{doc:installwamp:wamp14.jpg|}}+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 needs php-gettext for to support local languages. Please install php_gettext and restart the webserver. +===== Sahana Installation =====
  
-  * 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+  - Download the version of Sahana **.zip** (e.g. ''0.6.3.zip''from [[https://launchpad.net/sahana-php|LaunchPad]]. 
 +  - Extract the .zip file to where is convienent for you. 
 +  - Open WAMP menu item ''www directory''. You are looking for the Apache server's www directory. 
 +  Include the ''sahana'' directory into the www directory that was created in step 2. 
 +  - Point your browser to ''http://localhost/sahana/www''.
  
-  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:installwamp:fetch.php14ed.jpeg|}}+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->Restart Service** + 
-  * Continue with the Sahana web installer +Sahana will first self-check to see whether it has everything it needs in order to run. If anything went wrong above, you will need to go over the steps again. 
-  * Enter Database configuration details and proceed the installation+ 
 +{{ doc:installwamp:wamp14.jpg }} 
 + 
 +{{ doc:installwamp:fetch.php14ed.jpeg }} 
 + 
 +=== Database Configuration ===  
 + 
 +Enter the database configuration details from your WAMP setup and proceed with the installation.
  
 {{doc:installwamp:wamp16.jpg|}} {{doc:installwamp:wamp16.jpg|}}
-  * Setup Sahana configurations by giving "Installation Details, Administrator Account details and Normal User Account details" and click "Write Configuration File"\\+ 
 +=== Sahana configuration === 
 + 
 +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's point of view and an end user's. 
 + 
 +Enter "Installation Details, Administrator Account details and Normal User Account details" and click "Write Configuration File" 
 {{doc:installwamp:wamp17-1.jpg?600}} {{doc:installwamp:wamp17-1.jpg?600}}
 {{doc:installwamp:wamp17-2.0.jpg?600}} {{doc:installwamp:wamp17-2.0.jpg?600}}
-{{doc:installwamp:wamp17-3.jpg?600}}\\+{{doc:installwamp:wamp17-3.jpg?600}} 
 + 
 +=== Start Sahana ===
  
-  * Start Sahana by clicking "Start Sahana"+Congratualtions. Setup is complete. Start Sahana by clicking "Start Sahana"
  
 {{doc:installwamp:fetch.php19ed.jpeg|}} {{doc:installwamp:fetch.php19ed.jpeg|}}
  
 +===== Allowing access from other machines =====
  
-===== Recommended Browsers =====+   Use this section only if you wish to allow multi-user access. 
 +   Opening your machine to the Internet creates a security risk.
  
-  * Mozilla Firefox 1.0 or later. +To allow others to access your Sahana installation, modify the Apache configuration fileThis is available from the WAMP menu at **Config files->httpd.conf**
-  Microsoft® Internet Explorer 5.5 or later.+
  
- +Modify:
-===== 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">   <Directory "c:/wamp/www">
Line 157: Line 194:
   ...   ...
   </Directory>   </Directory>
-to+ 
 +to
   <Directory "c:/wamp/www">   <Directory "c:/wamp/www">
   ...   ...

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