Setting Up a Server

Hi! If you are interested in installing Project Buendia's Ebola medical records tool at a new site, then you are in the right place. This might be in the field or just to try it out. This page will tell you what you need, how to set it up, and design considerations you'll need to think about. First let's look at what you'll need:

one or more Android devices
a server
a local wireless network
power for the above
some work to configure all the above

First you will need to get these things; see Hardware Requirements for details. Then you will need to set them up.

Setting it up

The Server

After setting up the server it all of the following will have been added.

A working OpenMRS system
The CIEL standard concept dictionary
The Project Buendia additions to the standard dictionary
The Project Buendia module

Below are instructions for 4 situations you might be in, whether you are doing a field deployment, or just trying it out.

DEPRECATED clean field deployment

See Setting up an Edison.

Deployment on an Intel NUC

Manual install on Debian on the NUC

First, download the Debian Stretch ISO image. The NUC has an oddball WiFi card in it, so the free firmware doesn't work. The easiest solution to this is to use the version of Debian Stretch that contains the non-free firmware from this page, and hope that Richard Stallman doesn't notice and get angry at you. Here is the direct download link as of 2019-06-14.
Now flash the ISO image onto a USB stick. Balena has made an incredibly simple and friendly open-source flashing utility called Etcher, you should use it! It's here. Installation instructions on the Balena site.
Put the USB stick into the NUC. You'll want a keyboard and HDMI-enabled monitor as well. Choose Install and follow the instructions!
- MUCH MORE COULD BE SAID HERE!
  - Probably good to recommend a separate /home partition
  - Do it headless; choose no window system but yes to ssh server
  - Probably set up a user called Buendia with sudo privileges
Edit the /etc/network/interfaces file. Add:

auto wlp2s0
iface wlp2s0 inet dhcp
    wpa-ssid mywifiname
    wpa-psk mywifipassword

Reboot the server. It should now be on the wifi.
from root, install sudo
Install git
Clone the repo and step into it

git clone https://github.com/projectbuendia/buendia
cd buendia

Do the stuff in script here as follows:
Enable apt to grab packages via https

sudo apt install apt-transport-https

Add deb [trusted=yes] https://projectbuendia.github.io/builds/packages stable main java to /etc/apt/sources.list
install the server

sudo apt update
sudo apt install -y buendia-site-test buendia-server

Use ip addr show to figure out what address the NUC is on on your local network. Go to that address: xx.xx.xx.xx:9000/openmrs. If you see the OpenMRS dashboard page, things probably worked.

Trying it out on a computer (Windows)

See the document Setting up a server: Windows.

Trying it out on a computer (Mac)

See the document Setting up a server: Mac.

Adding Project Buendia compatibility to an existing OpenMRS installation

This is by far the hardest, due to assumptions me make about locations and the OpenMRS Concept dictionary. In order to do this, you should be an experienced OpenMRS Implementer, and familiar with the OpenMRS concept dictionary. Please: