GNU Health for Debian
---------------------

The gnuhealth-server package takes care of creating the "gnuhealth" system
user, the "gnuhealth" PostgreSQL role (i.e. database user) and the "gnuhealth"
database, which is initialized and ready to use.
This package introduces a new service (gnuhealth-server), which is a Tryton
server running on a dedicated port (8482).

The gnuhealth-client package provides the `gnuhealth` command, which is a
wrapper around `tryton-client`.
If a config and/or a profiles file wasn't found, it will create new default
files that are configured for a GNU Health (Tryton) server running on the same
machine.
In case the server is not on the same machine, the user will have to change
the server name during the first startup, but port number, database name and
user will already be defaulted in.

The gnuhealth metapackage allows for easy installation of everyting needed to
run a GNU Health instance on a single machine (it installs gnuhealth-server
and gnuhealth-client)


Configuring GNU Health
======================

Note: Instructions including screenshots are available on the project's
wiki page:
  http://en.wikibooks.org/wiki/GNU_Health/Installation

The client can be installed either on the same machine as where you installed
gnuhealth-server, or on a different machine.


Creating a Connection Profile
-----------------------------

Note: this step is only needed if you didn't install gnuhealth-client, as this
package takes care of this automatically the first time you run the
`gnuhealth` command.

Open the Tryton client (run the `tryton-client` command)

Click on Manage profiles, then click on Add. Give your new connection a name
on the left side, and fill the fields on the right side:
* Hostname: localhost (if running the client on the same machine as the server)
  or the IP address/hostname of the machine where you installed gnuhealth-server.
* Port: 8482
The "gnuhealth" database should then automatically appear, as it was created
when installing the gnuhealth-server package.
You will first need to log in as "admin", so enter that in the Username field.

You're now ready to log in!


Logging into the application
----------------------------

Now that you're back at the login screen, you'll notice that the selected
Profile is the one you've just created. Fill in the login form:

    User name: The one you used previously (usually: admin)
    Password: the one entered while installing the gnuhealth-server package.


Installing the default modules
------------------------------

From this point on, you will use the client for mostly every process. Start
with the installation of the basic functionality:

After you've created the database, the system will ask you to create some new
users. You can skip this step for now.

You are then presented with a list of modules that will provide the
functionality you desire. If you don't see the Modules window, navigate to it
on the right side: Administration > Modules > Modules.

Select the health_profile module, and click on Mark for installation

Click on the Action icon (a blue rotated square) and select Perform Pending
Installation/Upgrade

Tryton will automatically select all the dependent modules required for the
installation

Click on Start Upgrade. This process will take a while, depending on the
computer where GNU Health is being installed on. Once it's done, a success
message appears.

Congratulations, you've successfully installed GNU Health!


Installing Extra Modules
------------------------

GNU Health is constantly evolving. The default modules are just a subset to
provide the basic functionality. Depending on your Health center, most probably
you will want to install some of the other modules that come with GNU Health.
Some of the modules that are ready to install are:

* health_history: Generates the patient clinical history reports.
* health_reporting: Statistics on different indicators (diseases, doctor
  assignments, .. ). It also creates different charts
* health_services: Registers all the services done to a patient, in an
  ambulatory or inpatient scenario. It will allow to generate the invoices on
  selected services.

There are many more. Just check on the module list and select those that fit
best your health center.

Congratulations, you have completed the initial installation of GNU Health!


 -- Emilien Klein <emilien+debian@klein.st>  Mon, 20 May 2013 02:04:29 +0200

