Mac OS X Installer Guide

The GNUmed client

The 'client" is the piece that allows any of multiple computers (including Macs running Tiger or above) to connect to a shareable GNUmed "server" database.

Presently, two methods are supported to download and run GNUmed clients on the Mac:

1. Simplest: from a Mac OS X disk image
2. Advanced: using the MacPorts software management system

These are further described below. Optional packages below can extend the functionality of GNUmed clients.

Mac OS X disk image (simplest):

Download the most recent (at the time of this writing) 0.5.0 disk image:

• accept the default options
• drag the provided application bundle to the Applications shortcut, and run from there

Once you have made it to the login window, proceed to the User Guide section Logging in.

Tech notes:

1. If you wish to permit other "Users" of your machine to use this same GNUmed application, you will need to edit its Macintosh Finder "Get info" box "Details" and set the Others permission to "Read & Write".
2. The GNUmed log-in dialog will, by default, point to the public database (userid = pw = "any-doc"). It must be noted that on account of server and location limitations, latencies of 30-60 seconds in responsiveness can be expected.
3. To open this package and edit its /client/gnumed.config file to (for example) enable login to alternative GNUmed servers does require preparedness to use the Apple control-click contextual menu, and the manual editing of the text file gm-from-cvs.config. This is entirely within the ability of mid-level users.
4. This package is also suitable for mobile use (from USB). Caveat while this form of the client is being run, its internally-written logs do get auto-copied into the directory /User/currentUserName/gnumed/logs/. These logs should, of course, be deleted from guest machines.

MacPorts method (advanced)

This is described on its own wiki page, MacPorts. This makes it also easy, for any interested, to download and run from CVS.

Optional packages:

• Osirix 2.7.x viewer for DICOM medical images for people who need to be able to view cath lab CD, x-ray-images, echocardiography loops. Obtain from Osirix site (not Sourceforge) and install into the Mac's Applications folder.

• Twain-Sane for Macs connected to a SANE-compatible network scanner.

The GNUmed server software

For developers wishing to install on the Mac, we recommend that you install PostgreSQL from Postgresqlformac.com for which there are a few known PostgresqlForMacIssues.

Bootstrapping the server onto a Mac requires that

• the user have sudo access and this will depend on already having enabled the Mac's root user account (per IssuesMac)
• the user then proceeds to "GNUmed backend installation" at InstallerGuideHome.

It is, of course, possible to use a database running on GNU/Linux or MS Windows as well.