GNUmed client and server on openSUSE

Step 1: Adding the Software repository

There is a special GNUmed repository available for openSUSE, with updated packages through the GNUmed team's software repository. While you can certainly use graphical tools to add the up-to-date repositories, it is easy using the command line.

For opensue 11.3 or higher:

• open Applications > Accessories > Terminal
• copy this command: sudo zypper sa http://download.opensuse.org/repositories/home:SebastianHilbert:GNUmed/openSUSE_11.1 MedicalFOSS?
• paste the above command into Terminal, and press "return"
• the system will probably ask for the password

If you are not yet comfortable with command line usage follow this excellent guide on how to add a repository on openSUSE Linux link.

Step 2: GNUmed client installation

This step will install the frontend of GNUmed. You can install it from the command line like this:

• open Applications > Accessories > Terminal
• copy this command: sudo zypper refresh && sudo zypper install gnumed-client
• paste the above command into Terminal, and press "return"

Alternatively, you can follow the guide at http://en.opensuse.org/YaST_Software_Management to learn how to use graphical helper tools.

Step 3: GNUmed server installation

These files are needed if you want GNUmed to be able to store and access data on your local computer. You can skip it if you only want to store and access data on a remote computer with GNUmed server already installed.

You can install it from the command line like this:

• open Applications > Accessories > Terminal
• copy this command:=sudo zypper refresh && sudo zypper install gnumed-servert=
• paste the above command into Terminal, and press "return".

Alternatively, you can follow the guide at [http://en.opensuse.org/YaST_Software_Management to learn how to use graphical helper tools.

Step 4: Preparing PostgreSQL

The database is where GNUmed actually stores your data. First, the PostgreSQL database that comes with your system must be prepared.

4.1 Preparing PostgreSQL/ Setting up database access rights for the local computer

This assumes openSUSE 11.3 running PostgreSQL 8.4. The PostgreSQL configuration files are pg_hba.conf and pg_ident.conf.

• open Applications > Accessories > Terminal
• copy this command: sudo nano /var/lib/postgresql/8.4/main/pg_hba.conf
• paste the above command into Terminal, and press "return"
• add the three lines below, placing them
  • toward the end of the "local" section, meaning after the line " local all postgres ident "
  • but just before the line " local  all  all  ident "

# allow anyone knowing the proper password to
# log into our GNUmed databases
local   samegroup      +gm-logins                    md5

4.2 Read this only if you want to access your GNUmed server from other machines on a network.

• edit /var/lib/postgresql/8.4/main/postgresql.conf and
• set the listen_address parameter to whichever network interfaces you want your GNUmed database to be available on. This is necessary in particular if you want to connect to your server from other machines.

If you want to double check this most important step have a look at the detailed instructions at ConfigurePostgreSQL

Step 5: Creating the database

A so called "bootstrap" script will set up a database for GNUmed inside your PostgreSQL. Beware, this will create a whole new GNUmed database and destroy an existing GNUmed database!

You can create the new database like this:

• open Applications > Accessories > Terminal
• copy this command: sudo gm-bootstrap_server

Read more about the process here link. If you do not want to erase the old GNUmed database but to upgrade from an older version GNUmed Server version read this link

Step 6: GNUmed startup

Choose Applications > Office > Gnumed from the menu or simply type 'gnumed' in a cmd shell.