GNU Health/Embedded

From Wikibooks, open books for an open world
< GNU Health
Jump to navigation Jump to search
GNU Health embedded on a Raspberry Pi3 and OpenSUSE tumbleweed.

The GNU Health Embedded sub-project ("GNU Health in a Box") focuses on the installation and use of GNU Health in single-board devices.

The use of GNU Health in single board devices such as Raspberry Pi has many advantages (in addition to the low cost) such as the easy deployment, little maintenance and low energy consumption that makes it a candidate for some of the following scenarios :

  • Remote areas without Internet
  • Academic Institutions
  • Domiciliary Units
  • Vector Control
  • Nursing
  • ICU
  • Laboratory stations
  • Personal Health Records

The device is a full server, that has its own database, allowing storing the information locally, without the need of a network. That said, keep in mind that it is a low-resource device, so it's usage must be carefully planned, and it's not suitable for high-demand, heavy load environments, where a regular server would be needed.

Raspberry Pi[edit]

Currently we are working on the Raspberry Pi 3 platform. We offer two images, with slightly different approach.

Development image running openSUSE Tumbleweed[edit]

Tumbleweed is the rolling release of openSUSE. It offers the latest software available, and is tested with openQA. The SD image includes the following functionality (Vanilla Installation):

  • Operating System : OpenSUSE Tumbleweed
  • Linux Kernel 4.14
  • PostgreSQL 10
  • GNU Health server 3.2
  • Secure Shell (SSHD)
  • Desktop Environment : XFCE

The Tumbleweed-Image of GNU Health for the Raspberry Pi 3 comes in a single file, Clonezilla image. Please note that the GNU Health embedded images are not "Live CDs" or other generic installation media. The GNU Health embedded images are working operating systems with modules, users, database engine and GNU Health services pre-installed, and ready to run. They are highly-specific in terms of architecture and hardware.

Getting the Image[edit]

You can get the latest status and download packages on the GNU health main site, under the section "GNU Health Embedded".

http://health.gnu.org/embedded

Main users[edit]

The two main OS users are :

- root : default password "linux" (as in OpenSUSE)

- gnuhealth : The GNU Health admin. Default password "freedom"

The GNU Health Service[edit]

The GNU Health Hospital Management System is active by default. You can execute the following actions, either as root or as the GNU Health administrator (gnuhealth)

  • Start : Boots the instance.
systemctl start gnuhealth
  • Restart : Restart the server.
systemctl restart gnuhealth
  • Stop : Shutdown the GNU Health server.
systemctl stop gnuhealth
  • Status : Check the current status of the sever .
systemctl status gnuhealth


Enabling the Graphical Interface[edit]

GNU Health embedded on a Raspberry Pi3 - XFCE desktop environment on OpenSUSE Tumbleweed

GNU Health embedded can run both in text an graphic mode. In order to save resources, specially memory, the graphical interface is disabled by default. If you want to activate it, you can do so as root.

systemctl start display-manager

Loading the demo database[edit]

GNU Health embedded ships with the demo database postgres dump, so it can be installed locally. To do so, execute the following steps :

1) Login as "gnuhealth" user

2) Run the script "init_gnuhealth_demodb.sh"

cd $HOME
./init_gnuhealth_demodb.sh

This script will reset and create the "health32" database, with the demo GNU Health instance as in the community server. Warning ! This action will delete and recreate the "health32" database !

Stable image running openSUSE Leap 15[edit]

Leap is the stable release of openSUSE, sharing base packages with the SLE-products. Its focus is on stability. The SD image includes the following functionality (Package-based Installation):

  • Operating System : openSUSE Leap 15.0
  • Linux Kernel 4.12
  • PostgreSQL 10
  • GNU Health server 3.2
  • GNU Health Demo Database
  • Secure Shell (SSHD)
  • Desktop Environment : LXQT

The Leap-Image of GNU Health for the Raspberry Pi 3 comes in a single (raw) file. Please note that the GNU Health embedded images are not "Live CDs" or other generic installation media. The GNU Health embedded images are working operating systems with modules, users, database engine and GNU Health services pre-installed, and ready to run. They are highly-specific in terms of architecture and hardware.

Getting the Image[edit]

You can get the latest status and download packages on the GNU health main site, under the section "GNU Health Embedded".

http://health.gnu.org/embedded

(chose the image with download from the AXXITE-Server)

Installation[edit]

The image is a compressed raw image which you can directly copy onto a SD-card. Insert the SD-card into your computer and check which device-node it gets assigned (e.g. using lsblk), say this is /dev/sdX. Use the following command to copy the image to the SD-Card:

xzcat gnuhealth32-raspi320180803.img.xz | dd bs=4M of=/dev/sdX iflag=fullblock oflag=direct; sync

User[edit]

The two main OS users are :

- root : default password "linux" (as in openSUSE)

- test : A normal user. Default password "test"

Please note that the keyboard is set to English!

Additional Information[edit]

The Raspi starts in graphical mode, the GNU Health server is started automatically. You can use your the GNU Health Client to log-in to the Demo-Database