Main Page
From MoCa Development Wiki
Sana System Documentation
Note: Moca has officially changed its name to Sana, a word that means "health" in Spanish and Italian, and "hope" in Tagalo. The following is documentation on installing and using Moca, and for understanding the codebase. See http://www.sanamobile.org for information about initiatives to deploy Moca, and what makes Moca a unique and compelling solution.
Contents |
Introduction
Start with the Overview page for a description of the intended workflow for a Sana deployment. Read about the technical Features of our platform. Then try a Demo for yourself.
Installation
We highly recommend that you the Automatic Installation method to install Sana server software. This method uses packages for Ubuntu 10.04 to put our platform's files where they belong on a server installation, then walks you though a few simple configuration tasks. Only use the Manual Installation method if you are experienced with the platform and have a particular need to do so. Then set up the Android Client so that your phones can communicate with your server.
Administration
See the Administration page for a guide to the technical skills needed to manage a Sana deployment. Also read the Security page as a starting point for good administrative practices.
Development
- List of Development Skills
- Setting up the Basic Tools and Development Environment (Linux, Eclipse, Java, Android)
- Detailed Instructions on How to Download the Source Code for Development (for Android Phone Application, Moca Dispatch Server, OpenMRS modules)
- Defining Your Own Custom Moca Procedures for the Phone App
- Debugging with the Android, MDS, and OpenMRS Error Logs
- Building Sana Ubuntu Packages
- Learn about Android
- Learn about OpenMRS
- Learn about Moca Dispatch Server
For help on technical issues, see the forum on http://groups.google.com/group/moca-users
FAQ
What is Sana, and what can it do?
- Please visit our general website
How do I install Sana?
- Detailed installation instructions are here.
Who are you guys?
Is Sana free?
- Yes, Sana is open source and released under the BSD license. In plain terms, you can download, extend, modify, and customize Sana in any way that you see fit. The BSD license requires attribution only, but it would be a welcome gesture if any improvements are contributed back to the community (this is not required).
What languages does Sana come in?
- English
- Spanish
- Chinese
- Translating Sana into your own language is a straightforward two-step process. First, Android determines which language to display based on the locale that is set on your phone. US phones, for example, would be set to English. In Latin America, Android phones likely have a default locale of Spanish. The first step, then, is to go into your phone's settings menu (not Sana's settings menu) and change the locale to the language that you want to use. The second step is to locate the strings.xml file in the source code for the Android Sana application. Replace those strings in your own language. Save the strings.xml file, and remake another .apk file and reinstall the Sana Android application onto your phone. The interface should now be in your desired language. Please note that the procedures will need to be translated separately. The process is the same as for the strings.xml file.
For a fuller discussion, please see: Translating Android Applications
How can I add functionality to Sana?
- Please feel free to download the source code and improve it. There is also a users group
