== Release Process ==

When making a Stable Branch from which to build releases, we need to do these tasks:

Check that all works with a released version of Web2Py

Ensure included files sane:
 * README
 * VERSION
 * CHANGELOG

=== Compress JS & CSS files ===
Browsers default to only downloading 2 files from the same origin at a time, so many files is very slow on high latency links.[[BR]]
We therefore consolidate into fewer, larger files when running in Production mode.

Since GIS is a specialised app which requires many files, it's JS & CSS are loaded separately when required.

The build script is {{{static/scripts/tools/build.sahana.py}}}[[BR]]
There is also a convenience wrapper for Windows to run this & also move results into their respective locations: {{{static/scripts/tools/build.cmd}}}

Our build process is based on the one used by !MapFish (which is built on the one used by !OpenLayers)
 * !MapFish (inc OL): https://trac.mapfish.org/trac/mapfish/wiki/HowToBuild
 * !OpenLayers: http://trac.openlayers.org/wiki/Profiles

=== Clear Database ===
To clear database of test data & reset to defaults:
 * Close Web2Py
 * Start up in shell mode:
{{{
python web2py.py -S sahana -M
}}}
Then run:
{{{
shn_db_clean(db)
}}}
(This function is configured in {{{modules/sahana.py}}})

NB This assumes that all required settings are being generated upon intialisation as per the [wiki:DeveloperGuidelinesSahana3Framework#Settings Framework]

To clear the database of old tables which are no longer being used:
{{{
sqlite3 storage.db
drop table XXXXX;
.quit
}}}

=== Export Application ===
 * Cleanup: http://127.0.0.1:8000/admin/default/cleanup/sahana
 * Pack all: http://127.0.0.1:8000/admin/default/pack/sahana
 * Save as: {{{web2py.app.sahana.rXXX.tar}}}

=== Upload to !LaunchPad ===
 * Register a new release: https://launchpad.net/sahana/sahanapy/+addrelease
 * Add download file

=== Update Wiki !InstallationGuide ===
 * https://trac.sahana3.org/wiki/InstallationGuidelinesWindows
 * https://trac.sahana3.org/wiki/InstallationGuidelinesLinux
 * https://trac.sahana3.org/wiki/InstallationGuidelinesMacOSX

=== Update Demo ===
 * [wiki:DeveloperGuidelinesWeb2PyUpdate Update Web2Py] (if necessary)
 * Start appadmin: /root/web2py_admin.sh
 * Configure SSH Tunnel: http://mdp.cti.depaul.edu/AlterEgo/default/show/143
 * Access via SSH Tunnel: http://127.0.0.1:8001/admin
 * Upload application: http://127.0.0.1:8001/admin/default/site
 * Reboot VPS (free up resources for improved performance)

----
DeveloperGuidelines