SahanaCamp NYC Day 2 PM session: Deploying Sahana Eden

1. Deploying Sahana Eden
Fran Boon
fran@sahanafoundation.org
SahanaCamp LA 1

2. Agenda
Deployment Options
Hardware Requirements
Skills required
 For Installation/Configuration
 For Customization
SahanaCamp NYC

3. Deployment Options
Host locally in the Host in the Cloud
command center
on a Laptop
Synchronize these 2 together...
SahanaCamp NYC 3

4. Hardware Requirements
Standalone PC
 Windows or Mac
Server
 Virtual Server: 512 Mb RAM, 4 Gb HDD
Cloud
 Amazon EC2 (free tier available for 1 year)
SahanaCamp NYC

5. Architecture
Web Server e.g. Apache
Application Sahana Eden
Web Framework Web2Py
Programming Language Python
Database MySQL or PostgreSQL
Operating System Windows, Linux or Mac
SahanaCamp NYC

6. Installation process
Wizard on Wiki to select correct instructions:
http://eden.sahanafoundation.org/wiki/InstallationGuidelines
End-User Installer for Windows:
 Local hard disk
 Flash drive
SahanaCamp NYC

7. Production Server
Physical/Dedicated Server or Virtual Server
Base OS
 Debian Linux best-supported
Database
 MySQL
 PostgreSQL
Pre-image Installation script
Post-Image Configuration script
SahanaCamp NYC

8. Amazon EC2
Sign-up with credit card
Select Data Center closest to you
 e.g. US East (Virginia)
EBS for free tier
Community AMIs: Debian Squeeze
SSH key (private/public)
Grow Volume if < 3Gb (hardest part)
Normal Server Scripts
SahanaCamp NYC

9. Amazon EC2
SahanaCamp NYC

10. Configuration
eden/models/000_config.py
deployment_settings
 Database
database.db_type = "mysql"
database.host = "10.14.6.3"
 Enable/Disable/Rename Modules
("org", Storage(
name_nice = T("Organizations"),
 Branding
system_name = T("Sahana Eden Emergency Portal")
SahanaCamp NYC

11. Configuration
Security Policy
 1: Simple (default): Global as Reader, Authenticated as Editor
 2: Editor role required for Update/Delete, unless record owned
by session
 3: Apply Controller ACLs
 4: Apply both Controller & Function ACLs
 5: Apply Controller, Function & Table ACLs
 6: Apply Controller, Function, Table ACLs and Entity Realm
 7: Apply Controller, Function, Table ACLs and Entity Realm +
Hierarchy
 8: Apply Controller, Function, Table ACLs, Entity Realm +
Hierarchy and Delegations
SahanaCamp NYC

12. Configuration
 Authentication options
self_registration = True
registration_requires_verification = True
registration_requires_approval = True
 Facebook, Google, LDAP
google_id = "645861.apps.googleusercontent.com"
google_secret = "1EZYxpRV4iMAVvv_pA"
 Workflows
req.use_commit = False
req.generate_req_number = False
SahanaCamp NYC

13. Configuration
 Localization options
deployment_settings.L10n.languages = OrderedDict([
("ar", "‫,)"العربية‬
("zh-cn", " 中文 ( 简体 )"),
("zh-tw", " 中文 ( 繁體 )"),
L10n.date_format = T("%m-%d-%Y")
L10n.decimal_separator = "."
L10n.thousands_separator = ","
SahanaCamp NYC

14. Prepopulate
private/prepopulate
 tasks.cfg
CSVs
 Lookup Lists
 Assessment Templates
 Roles
 Test/Demo Data
Import after Installation
 Same CSVs
SahanaCamp NYC

15. Maintenance
Backups
Upgrades
 /usr/local/bin/clean
 /usr/local/bin/pull
 /usr/local/bin/compile
 Maintenance Mode
 Disable Web Access: Holding Page
 Disable Scheduler
SahanaCamp NYC

16. Development
Customising Sahana Eden
 Python
 JavaScript
 Version Control: Git
 Get changes merged upstream
SahanaCamp NYC

17. Testing
Manual
 Document Test Cases
 Normal Workflows
 Exception Conditions
 Security
Automated
 Selenium (Browser-based)
 Test-friendly code
 Suite of reusable libraries
 Run with different data sets
 Check preconditions directly as faster
SahanaCamp NYC

18. Release Process

19. Summary
Flexible Deployment Options
 Laptop: Windows or Mac
 Server: Linux
 Cloud: Amazon, Linux
Configuration
 Deployment Settings
 Prepopulate CSVs
Customisation
 Development: Python & JavaScript
 Testing
 Release Management
SahanaCamp NYC