GNUHealth for openSUSE
======================

GNUHealth is a free Health and Hospital Information system build on top of Tryton, an OpenSource ERP framework.

This is the openSUSE package for GNUHealth. It was build to simplify the installation and maintenance of a system, to make it useable for 'end-users' as well.

To achieve this goal, the openSUSE package handles some things different than the GNUHealth standard:

1) No installation from source code
GNUHealth has an installation script (gnuhealth_install.sh)that installs the Software from the source code.
It has shown that this can cause a lot of trouble with dependencies (other software packages that are required to run GNUHealth and the Tryton Server), as they may be named slightly different in your Linux-distribution, or are just not listed.

To avoid hassle for each and every end user, openSUSE uses the Open Build Service [1] to create a package where all dependencies are resolved for you.

As a consequence, you install the package 'gnuhealth' with the openSUSE package manager, and the system does the rest for you. See [2] for installation advise.

2) GNUHealth depends on Tryton
Tryton [3] is the technical backend for GNUHealth. Tryton can run as ERP-System on its own. For the reasons explained under 1) , Tryton is build as well as package for openSUSE, following the same philosophy. See [4]for details.

See as well: /usr/share/doc/packages/trytond/tryton-server.README.SUSE on your local installation

3) GNUHealth is build on top of Tryton
Unlike the standard GNUHealth setup, openSUSE treats GNUHealth as add-on (additional modules) to a Tryton standard installation. The implications are:

- The Tryton Server (basis for GNUHealth) runs under the user 'tryton', not under the user 'gnuhealth'
- you can use the openSUSE standard tools to start and stop the server [4]
- you can use the openSUSE package manager (zypper or YaST) to install upgrades. 
- You *SHOULD NOT* use gnuhealth-control to install upgrades! gnuhealth-control forces an installation from source, and by this may break your installation
- all Tryton and GNUHealth modules are installed in the python directory /usr/lib/python/site-packages/trytond

Nevertheless, you can use gnuhealth-control to create database backups, install languages and updates. Make sure the version of gnuhealth_control ends on -openSUSE

You may use the GNUHealth mailing list (health@gnu.org) for remarks or questions.


Digital Signatures
==================

In order to make use of GNUHealth's capabilities to digitally sign documents, you need to create a PGP-key for the user logged in to the operating system.

From the start menu, start the program Kgpg and follow the instructions, it will guide you through the process of key generation. Choose the maximal key length (4096).
Use a passphrase with Capital letters, small letters, numbers and special characters (like %$§ etc) and have at least 12 digits for the passphrase - the more, the better.
Keep the passphrase in a secure location, and take a backup of the PGP keys (located in ~/gnupg - in the live CD this is /home/gnuhealth/.gnupg ).


Have fun and keep the neighborhood well and fit!


[1] https://build.opensuse.org
[2] http://en.wikibooks.org/wiki/GNU_Health/Operating_System-Specific_Notes#OpenSUSE
[3] http://www.tryton.org
[4] https://code.google.com/p/tryton/wiki/InstallationonopenSUSE 


 -- Axel Braun <axel.braun@gmx.de>  Tue, 27 Jan 2015 10:08:00 +0200