Installation
From MoCa Development Wiki
Contents |
Requirements
- Computer with at least 3 gigabytes of available hard drive space and 512 megabytes of RAM
- Smartphone with Android 1.6 or later
- Internet connection
- WiFi or a data plan for the phone
- Basic keyboarding skills and English proficiency
Server Software
Server Operating System
Installation
We recommend Ubuntu Linux 10.04 for Sana servers. This version is a Long Term Support (LTS) release, meaning it will be maintained for several years. Sana will run on any flavor of Ubuntu, but users new to GNU/Linux may find the Desktop Edition most comfortable. Experienced users should consider the Server Edition, which includes no graphical interface by default. These instructions rely on command line tools only.
Follow the instructions on the Ubuntu website to prepare your operating system installation media. This may involve burning a CD image to a blank CD, creating a special USB key, using a virtual machine, or ordering media for postal delivery. Install the operating system using the method appropriate to the installation medium you have selected, such as booting from an installation CD.
Terminal
For the rest of this installation process, you will use the GNU/Linux Command Line Interface (CLI), also known as the Terminal. You can access this through your graphical system menu on the Desktop Edition or simply by logging into the Server Edition. You should see a window or screen with a prompt similar to the following:
user@hostname:~$
Type commands as shown at this prompt. The commands "sudo" and "sudoedit" run or edit the commands or files that follow them using administrative (root) privileges. Note that when you are prompted for a password, it will not appear on screen when you type it. Type it anyway and press enter, and the Terminal will accept your input.
Editor
The default editor on Ubuntu is called GNU Nano. It will be run through the "sudoedit" command unless you specify a different editor. Use your arrow keys to navigate through files, and refer to the commands at the bottom of the editor screen. The "^" character means to hold down the "Ctrl" key and press the key that follows. For example, hold down "Ctrl" and press "o" (and then press "Enter") to save a file.
Sana Backend
Enable Repositories
Point your editor to your repository list to enable the Sana repository by running this command at the Terminal prompt:
sudoedit /etc/apt/sources.list
Scroll to the bottom of the file by hitting PgDn or Ctrl-V repeatedly. Type the following lines exactly as shown, including spaces and slashes.
deb http://archive.canonical.com/ubuntu lucid partner deb http://www.sanamobile.org/packages/ubuntu/ sana/
Save the file and exit the editor.
Install Software
Run the following two commands at the Terminal prompt to retrieve package information from the Sana repository and install the server software.
sudo aptitude update
sudo aptitude install sana
Enter "yes" when prompted to accept the unsigned Sana packages. Since package signing is not yet implemented and due to other security concerns, you should not set up or run a Sana server using a Local Area Network or Internet Service Provider you do not trust.
You will be prompted to accept a license from Sun Microsystems that covers some of the required Java packages. Read the license, scrolling down with the arrow keys. You must accept the agreement to continue by using the left/right arrow key and then pressing "Enter."
Configure Sana
When the Sana package is installed, run the following command to configure it.
sanashell init
This will guide you through the process of creating and linking databases, setting MDS options, and configuring OpenMRS. Press "Enter" without typing any other text to leave an option blank for now, but all steps are required for full functionality. You must complete the OpenMRS initial setup before you continue. When you have initialized OpenMRS, enter the next command to install the modules.
sanashell ca
Configure OpenMRS
After installing modules, refresh your browser window or enter the following command to reload OpenMRS and go to the administration page.
sanashell co
It may take OpenMRS several minutes to initialize the newly installed modules. Follow the directions at OpenMRS Configuration to complete the server setup.
Client Software
Follow the directions at Client Installation.
