File GNUHealth.README.SUSE of Package gnuhealth

Overview Repositories Revisions Requests Users Attributes Meta

File GNUHealth.README.SUSE of Package gnuhealth (Revision 8097afc9e3a37399f4f003b7dd3e69c6)

Currently displaying revision 8097afc9e3a37399f4f003b7dd3e69c6 , Show latest

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. Starting with openSUSE Leap 42.2, it is shipped with the standard distribution. 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.

In GNU Health installation from source, the program gnuhealth_control is used to perform updates, maintenance etc. The openSUSE packages come with a modified gnuhealth_control to distinguish between activities performed by system tools (zypper) and those that safely can be handled by gnuhealth_control. Try it, its save!

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 to set up 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. 
- 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

In case you want to install additional Tryton modules, you need to include the Tryton repository:
zypper ar -f http://download.opensuse.org/repositories/Application:/ERP:/Tryton:/3.8/openSUSE_Leap_42.2 tryton

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://github.com/mbehrle/tryton/blob/wiki/InstallationonopenSUSE.md

-- Axel Braun <axel.braun@gmx.de>  Wed Sep 28 18:35:02 UTC 2016

Places

File GNUHealth.README.SUSE of Package gnuhealth (Revision 8097afc9e3a37399f4f003b7dd3e69c6)

Places