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: #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 Wed Sep 28 18:35:02 UTC 2016