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

Install 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.
• INSTALL SCHUYLER'S STUFF

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:

• do NOT try this on a live system before trying it on a test system
• BACK UP ALL YOUR DATA FIRST!

TODO: work out if this is possible, and if so how they do it