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:installportableapp:english [2010/09/12 10:19]
chamindra
doc:installportableapp:english [2010/09/13 09:42] (current)
Line 1: Line 1:
-===== Sahana USB PortableApp User Guide =====+===== Sahana PortableApp User Guide =====
  
 With the PortableApp version of Sahana you can have the entire Sahana system and data on your USB stick. To launch a Sahana instance, all you then have to do is plug in the USB stick into a Windows XP,Vista or Windows 7 machine and start working directly with your instance of Sahana (without having to install it in the machine). If your USB disk is slow (ie less than class 4) then it is recommended to unzip it to a local folder on the harddisk. With the PortableApp version of Sahana you can have the entire Sahana system and data on your USB stick. To launch a Sahana instance, all you then have to do is plug in the USB stick into a Windows XP,Vista or Windows 7 machine and start working directly with your instance of Sahana (without having to install it in the machine). If your USB disk is slow (ie less than class 4) then it is recommended to unzip it to a local folder on the harddisk.
 +
 +[ [[http://www.mediafire.com/file/ozex1pgb8hr5zl9|Download Sahana Agasti Portable 2]] (55Mb) ]
  
  
Line 8: Line 10:
 __Installation to USB__ __Installation to USB__
  
-  - download Portable App version from [[http://www.sourceforge.net/projects/sahana sourceforge]] +  - download Portable App version from [[http://www.mediafire.com/file/ozex1pgb8hr5zl9 here]] [55Mb]
   - get USB version 2.0 "fast" flash drive with at least 200 Mb of space     - get USB version 2.0 "fast" flash drive with at least 200 Mb of space  
   - unzip the downloaded file into the root directory of the USB disk   - unzip the downloaded file into the root directory of the USB disk
Line 16: Line 18:
 __Installation to Harddisk__ __Installation to Harddisk__
  
-  - download Portable App version from [[http://www.sourceforge.net/projects/sahana sourceforge]] +  - download Portable App version from [[http://www.mediafire.com/file/ozex1pgb8hr5zl9 here]] [55Mb]
   - unzip the downloaded file into any directory of the harddisk   - unzip the downloaded file into any directory of the harddisk
   - run sahana.exe from the base of the directory in which you unzipped Sahana   - run sahana.exe from the base of the directory in which you unzipped Sahana
Line 48: Line 50:
  
   * Sahana launches a web server on port 80 and MySQL on 3306. If these ports are currently being utilized by your operating system, Sahana will not be able to start. To check what ports are available click on //Check Available Ports// in the menu and shutdown those respective non-Sahana processes   * Sahana launches a web server on port 80 and MySQL on 3306. If these ports are currently being utilized by your operating system, Sahana will not be able to start. To check what ports are available click on //Check Available Ports// in the menu and shutdown those respective non-Sahana processes
 +  * 
 +  * Check if your windows firewall has not blocked your ports. On Vista and Windows 7, typically you will get a message asking for approval for MySQL and Apache to run on certain ports. Click OK if you get this.
  
   * Skype occupies Apache HTTPS 443 - you may have to shut down Skype before using the Portable Applet version of Sahana   * Skype occupies Apache HTTPS 443 - you may have to shut down Skype before using the Portable Applet version of Sahana
Line 55: Line 59:
 __2) Sahana is too slow__ __2) Sahana is too slow__
  
-  * Sahana needs a fast USB disk (2.0 at least) as it runs off this disk. +  * Sahana needs a fast USB disk (USB 2.0 at and Class 6.0 at least) as it runs off this disk.  
 + 
 +  * If you do not have a fast enough USB disk, copy the folder to the harddisk, run it off there and when you are done and want to move the new data and program in USB, zip up the folder and copy it to the USB. From there you can copy it and unzip it to as many machines as you like.
  
 ===== Portable Developer Environment ===== ===== Portable Developer Environment =====
Line 65: Line 71:
  
 {{:doc:installportableapp:debugger.png|}} {{:doc:installportableapp:debugger.png|}}
 +
 +__Starting the Debugger__
 +
 +Here are the steps to get you started debugging on Sahana. Most of it already pre-configured so you do not have to worry about it.
 +
 +  - Click on //Launch IDE/Debugger// button, which launches Notepad++ on the main sahana index.php
 +  - Click on the debug button on the IDE as shown on the picture above
 +  - Now click on //Debug in Firefox Portable// (or default browser), this will launch Sahana in Debug mode by appending the ?XDEBUG_SESSION_START=xdebug variable that attaches itself to the Notepad++ debugger. You can now step through the code and set breakpoints, watches, etc as required
 +
  
 ===== Configuration ===== ===== Configuration =====
Line 70: Line 85:
 If you portable app is not pre-setup, reset it up using the standard sahana setup process. Click the //Re-Setup Sahana// button in the development menu If you portable app is not pre-setup, reset it up using the standard sahana setup process. Click the //Re-Setup Sahana// button in the development menu
  
-The portable applet software pre-configures the database username to "root" with a database password of "root" - you must enter these values on the configuration screen under the "Create New Database" option as shown.  Then select the "Setup Database" button.  Any other entries will result in an "incorrect database name or password" error:+The portable applet software pre-configures the database username to "root" with a database password of "root" - you must enter these values on the configuration screen under the "Create New Database" option as shown.  Then select the "Setup Database" button.  Any other entries will result in an "incorrect database name or password" error
 + 
 +===== How to test another version of Sahana PHP ===== 
 + 
 +To do this simply copy the directory containing the Sahana source and replace the Sahana folder in 
 + 
 +  PortableApps\SahanaPortable2\www\ 
 +   
 +Now you can access it with the URL 
 + 
 +  http://localhost/Sahana (click on www after this if this is Agasti 0.6/0.9 based) 
 + 
 +You will probably have to resetup the database (default username:root password:root) 
 + 
 +You can have multiple installations and version of Sahana on the portable app. Simply copy it under different name to PortableApps\SahanaPortable2\www\. However you will have to specify the URLs for debugging manually as everything else is configured to the Sahana directory by default. 
 + 
 +===== Further Help and Suggestions ===== 
 +If you need any further help or suggestions for improvement of the portable app please mail the Sahana users mailing list or contact chamindra [at] sahanafoundation.org. However for general Sahana application queries please use the respective mailing list.
  
  

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