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 a non-Apple Python framework e.g. MacPython?

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.9.3 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/password = "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. Enabling login to alternative GNUmed servers (and other configurational change) from the Mac OS GUI will require to open the GNUmed application (right-mouse or Ctrl click "Show package Contents) and edit its /client/gnumed.conf and gm-from-vcs.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/. Such logs should of course be deleted from guest machines.

non-Apple Python frameworks e.g. MacPorts method (advanced)

This is described on our wiki page MacPorts. We have no better way for Mac users to download and test release candidates, and to run GNUmed on a Mac on a production basis.

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.

  • FreeDiams an Open Source medication prescription software

The GNUmed server software

For users or developers wishing to install a local database on the Mac, we recommend that you install PostgreSQL from EnterpriseDB. See the wiki page Postgres On Mac.

Bootstrapping the server onto a Mac requires that
  • the user have sudo access and this may, depending on the Mac OS version, require to have enabled the Mac's root user account (per IssuesMac)
  • the user then proceeds to "GNUmed backend installation".

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

Helpful Articles about Mac OS

Topic revision: 01 Aug 2011, JamesBusser
This site is powered by the TWiki collaboration platformCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback
Powered by Olark