1688469470
another fix OBS-URL: https://build.opensuse.org/request/show/436890 OBS-URL: https://build.opensuse.org/package/show/openSUSE:Factory/gnuhealth?expand=0&rev=4
109 lines
5.3 KiB
Plaintext
109 lines
5.3 KiB
Plaintext
GNUHealth for openSUSE
|
|
======================
|
|
|
|
How to get it running (Without reading the instructions)
|
|
========================================================
|
|
|
|
You have already installed the package gnuhealth and found this documentation. Good.
|
|
|
|
1) Log in as root and start the database
|
|
#su
|
|
#systemctl start postgresql
|
|
|
|
2) Change postgres parameters. You need to log in as user postgres, in order to avoid authorisation issues. Assuming we have nano as editor:
|
|
<you are logged in as user 'root'>
|
|
#su postgres
|
|
#nano /var/lib/pgsql/data/pg_hba.conf
|
|
Change the line
|
|
local all all md5
|
|
to
|
|
local all all trust
|
|
Save your input.
|
|
|
|
3) Create a role for 'tryton' in the database (sill as user postgres)
|
|
#psql -c "CREATE USER tryton WITH CREATEDB;"
|
|
|
|
4) exit as user postgres and restart postgres
|
|
#exit
|
|
#systemctl restart postgresql
|
|
|
|
5) Now lets look at /etc/tryton/trytond.conf. Uncomment the line with super_pwd (it is recommended that you set your own password here!
|
|
#nano /etc/tryton/trytond.conf
|
|
uncomment super_pwd
|
|
|
|
6) start gnuhealth/trytond:
|
|
#systemctl start trytond
|
|
|
|
7) Install the tryton client:
|
|
#zypper in tryton
|
|
|
|
8) Open the tryton client:
|
|
#tryton
|
|
go to 'manage profiles' -> add -> name it 'localhost' -> Host: localhost
|
|
-> you should now see a button to create a database
|
|
|
|
DONE.
|
|
Check /usr/share/doc/packages/trytond/tryton-server.README.SUSE for more Information
|
|
|
|
|
|
GNUHealth for openSUSE (a bit more in detail)
|
|
=============================================
|
|
|
|
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
|