Personal tools
  • We're Hiring!

You are here: Home → Documentation → Previous versions → OME Server → Installation → Platform-specific → Mac OS X

Mac OS X

Mac OS X 10.3/10.4

Ilya Goldberg (January 2006); Chris Allan (March 2005)

A graphical installation wizard is available for OS X 10.3 and 10.4. This installer will install all pre-requisites for running OME on a bare OS X machine. The software runs natively on PPC and Intel architectuires. Note that the developer tools (XCode) are required. These are available on the CDs/DVDs that came with your Mac, and must be installed before running the OME installer. Since all pre-requisites are automatically installed this is the recommended place to start an OS X installation. The OME code-base can be easily updated to a subsequent release or to CVS.

While it is possible to install the OME system on MacOS X 10.2, it is highly recommended that you upgrade to 10.3. MacOS X 10.3 is a much more complete and modern system than 10.2, and contains much better support for building Unix-based applications. For instructions on installing OME on MacOS X version 10.2, see this document.

N.B.: The OME installation on OS X makes limited use of fink. Our intention is to eliminate this dependency on fink as soon as it practical. It is NOT recommended to use fink for anything other than what is specified in this document. This is especially true for the PostgreSQL installation!

  1. Install the Developer Tools that come with MacOS X 10.3.
  2. Fix the broken mod_perl that comes with the system: 
    curl -O http://perl.apache.org/dist/mod_perl-1.0-current.tar.gz             tar -zxvf mod_perl-1.0-current.tar.gz ; cd mod_perl-1.29             perl Makefile.PL USE_APXS=1 WITH_APXS=/usr/sbin/apxs \             EVERYTHING=1 NO_HTTPD=1             sudo make ; sudo make install
  3. Install libxml2: 
    curl -O http://www.openmicroscopy.org/packages/source/libxml2-2.5.10.tar.gz             tar -zxvf libxml2-2.5.10.tar.gz ; cd libxml2-2.5.10             ./configure             make ; sudo make install
  4. Install libxslt: 
    curl -O http://www.openmicroscopy.org/packages/source/libxslt-1.0.32.tar.gz             tar -zxvf libxslt-1.0.32.tar.gz ; cd libxslt-1.0.32             ./configure             make ; sudo make install
  5. Install expat: 
    curl -O http://www.openmicroscopy.org/packages/source/expat-1.95.7.tar.gz             tar -zxvf expat-1.95.7.tar.gz ; cd expat-1.95.7             ./configure             make ; sudo make install
  6. Install libtiff: 
    curl -O http://www.openmicroscopy.org/packages/source/tiff-v3.5.7-OSX-LZW.tar.gz             tar -zxvf tiff-v3.5.7-OSX-LZW.tar.gz ; cd tiff-v3.5.7-OSX-LZW             ./configure             make ; sudo make install
  7. Download and install Fink. Use Fink to install graphics libraries: 
    sudo apt-get install libpng             sudo apt-get install libjpeg             sudo apt-get install freetype

  8. Create a PostgreSQL system user

    • Using the System Preferences application, create a user account on your system with the Unix (short) name postgres.

    Install PostgreSQL

    From source
    • For those that are comfortable with a source based installation of PostgreSQL, you may use the guide located here (developer.apple.com) to aid you in installing any 7.4 series release from source. This guide also applies to 8 series PostgreSQL releases. OME is supported with any PostgreSQL release from version 7.2.2 onwards on MacOS X.
    From package

    • If you are uncomfortable with a source based installation, and prefer the warmth of a MacOS X .pkg please do the following:

      Download the MacOS X PostgreSQL binaries. Uncompress this tar-ball. Make sure to first read the Installation instructions in Postgres-Install.pdf. Make especially sure to read the update instructions on the second page if you are updating an existing postgres installation. Install the pgsql-7.2.2.pkg and pgsql-startupitem-1.2.pkg install packages. (Just double-click them in the Finder.) Follow the rest of the instructions in Postgres-Install.pdf.

  9. Before you proceed to launch the OME installer, please execute the following unless you already have these elements in your path: 
    (Bash shell assumed for these commands)                          $ export PATH=$PATH:/usr/local/bin:/usr/local/sbin
  10. Lastly, execute the OME installer from the root directory of your OME distribution: 
    sudo perl install.pl

    *** Important *** Please be aware that the installer will detect you have a NIS, LDAP or equivalently backed set of users. On MacOS X it is safe to continue past these warnings without modifying anything.

    It is likely that several of the Perl modules that the install script tries to download and install will fail during the testing phase. This is usually because some of the optional dependencies are not installed by default in MacOS X. These optional dependencies are not utilized by OME, so it is usually safe to ignore any problems during the testing phase, and to have the install script install the Perl modules anyway. For the paranoid and/or curious, you can find the details of the compilation and testing phases for each Perl module in the /var/tmp/OME/install/PerlModuleTask.log file.

Document Actions