1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
SAHANA AGASTI 2.0 MAYON
Emergency Management Software
Updated: 2010-11-18
Sahana Agasti is a free, open-source emergency preparedness and management
software application written in PHP by members of the Sahana Software
Foundation's developer community.
The mission of the Sahana Agasti project is to facilitate resource management
and communication throughout all phases of emergency management by providing a
turnkey open-source application that is reliable, scalable, extensible, and
usable both by volunteers and by professionals, and which supports the primary
goal of the Sahana Software Foundation: alleviating human suffering and saving
lives.
For more information on the Sahana Agasti project, visit
http://agasti.sahanafoundation.org/ or see the included DEVELOPERS file for
information on becoming a contributing developer.
For information on the Sahana Software Foundation, visit
http://www.sahanafoundation.org/.
INCLUDED DOCUMENTS
------------------
Information for this software can be found in the following included documents:
CHANGELOG - Detailed release notes and version history
DEVELOPERS - Information for software developers
INSTALL - Installation instructions
LICENSE - Licensing information
README - This document
WHAT'S NEW
==========
This is the initial release of the 2.0 series, named Mayon. It is largely a
development release and is NOT INTENDED FOR GENERAL USE.
The following major features are included in this first release:
- Simple installation process
- Minimal front-end UI design
- Rough tool for basic user account creation & administration
- Initial modules for limited Staff, Facility, and Scenario input & management
- Search, filter, and sorting capabilities for Staff data
- Staff export tool
- Extensive, flexible schema to support design & development of future features
- Built using symfony, an extensible web PHP framework, to ease development
For a more complete and detailed list of changes and fixes, including version
history, please see the included CHANGELOG file.
SYSTEM REQUIREMENTS
===================
*** IMPORTANT NOTE: ***
This software has been tested with the following technology stack, though other
platforms, web servers, and database engines may be supported with some
additional work. All documentation for this version of the software, however,
will assume the following setup:
Software
--------
The following software is required to run Sahana Agasti Mayon:
* Ubuntu 9.10 LTS or later (most current 10.04 LTS strongly recommended)
* Apache HTTP Server 2.2.14 or later (most current 2.2 preferred)
* MySQL 5.1.41 or later (most current 5.1 preferred)
* PHP 5.2.12 or later (most current 5.3 strongly recommended)
* APC (The Alternative PHP Cache) 3.1.8 or later
Hardware
--------
The following hardware resources are recommended to run Sahana Agasti Mayon:
* Intel Pentium or AMD Athlon CPU
* minimum of 50 MB available disk space
* minimum 512 MB RAM
INSTALLATION
============
For installation instructions, please see the included INSTALL file.
KNOWN ISSUES AND WORKAROUNDS
============================
IMPORTANT GENERAL NOTE: this is the initial release for the Mayon (2.0) series
of Sahana Agasti. The development team is aware that there are various kinks,
quirks, and that existing functionality and usability is limited. The software
is therefore NOT INTENDED FOR GENERAL USE in its current state.
This list covers some of the known problems (and workarounds, where applicable)
with Agasti 2.0 Mayon, which will be resolved in future releases:
- After submitting the form on the install.php page, it may take up to 5 minutes
to load and redirect to the login screen.
- The "Foo" menu navigation item is a temporary module that exists at the moment
for testing and should not be usedl it will be removed before an official
release.
- Pre-loaded fixtures for staff are not searchable; this is because fixture data
is not currently indexed for searching when populating the schema through the
install process. Any new data entered into the system, however, will be
searchable.
- Sorting a list of Staff by name is currently buggy and may not sort correctly.
- It is currently not possible to add more than one service to a Facility
Group's list of available resources.
- Form validation has not been turned on in some places, so it may be possible
to enter invalid data into the system.
- DEVELOPERS: Some pages are currently stubs for development. Those pages are
marked at the top with a warning and the comment tag:
// PnaODfcm3Kiz4MV4vzbtr4
This random string is greppable for a report of the remaining stubbed pages.
When a developer fleshes out one of these pages the tag should be removed.
If you think you've found a new issue or bug, please refer to the SUPPORT
section of this document for information on what to do next.
SUPPORT
=======
FAQ
---
1. What is Sahana?
The Sahana Software Foundation is a non-profit organization whose goal is to aid
relief efforts in emergency situations through the creation and implementation
of technology. Please visit http://www.sahanafoundation.org/ for more
information.
2. What is Sahana Agasti?
Sahana Agasti is a set of software tools, developed in PHP, for managing
resources in the event of a large-scale emergency. Please visit
http://wiki.sahanafoundation.org/doku.php/agasti:start
3. What does Sahana Agasti do?
The current development release is the foundation for the Mayon series and is
not intended for general use. Although current functionality is limited, Sahana
Agasti Mayon is being actively developed, and this release includes an
installer, basic entry and management tools for emergency staff, facilities,
scenarios, and user accounts, and an extensible schema on top of the symfony web
application framework.
4. What is the difference between Sahana Agasti and Sahana Eden?
Agasti and Eden are both currently active projects approved and supported by the
Sahana Software Foundation; however, they are separate initiatives with
different functionality and goals. Visit http://wiki.sahanafoundation.org/ for
more information.
5. What if I have more questions?
Please use the information below, under Additional Support, to contact the
active volunteer community of the Sahana Software Foundation.
Additional Support
------------------
For the most up-to-date information regarding Sahana Agasti, please visit
http://wiki.sahanafoundation.org/doku.php/agasti:start
Direct support for use or development of Agasti can be found via our active
volunteer community:
1. Email
For user support, please subscribe to the Sahana User list here:
https://lists.sourceforge.net/lists/listinfo/sahana-user
You can also join the Agasti mailing list by going to
https://lists.sourceforge.net/lists/listinfo/sahana-agasti
2. IRC
Sahana Agasti developers are available on FreeNode IRC channels
#sahana and #sahana-agasti.
3. Launchpad
Please visit our Answers page on Launchpad, here:
https://answers.launchpad.net/sahana
LICENSING
=========
For licensing information, please see the included LICENSE file.
Thank you for using Sahana Agasti!
The Sahana Software Foundation
http://www.sahanafoundation.org/
|