Mac OSX Installation

From Gerris

(Difference between revisions)
Jump to: navigation, search
Revision as of 14:40, 17 March 2009
Popinet (Talk | contribs)
(Mac OSX 10.5 bug)
← Previous diff		 Revision as of 16:27, 17 March 2009
Popinet (Talk | contribs)
(Updated OSX installation instructions)
Next diff →
Line 30: Line 30:
</pre> </pre>
</li> </li>
 +
<li>We will install these in /opt/gerris to keep them isolated from the rest of the system. This requires /opt/gerris/lib/pkgconfig to be added to your PKG_CONFIG_PATH. This directory does not exist yet - it will be created in the next step. <li>We will install these in /opt/gerris to keep them isolated from the rest of the system. This requires /opt/gerris/lib/pkgconfig to be added to your PKG_CONFIG_PATH. This directory does not exist yet - it will be created in the next step.
<pre> <pre>
-echo "export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/gerris/lib/pkgconfig" >> ~/.profile+echo "export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/lib/pkgconfig" >> ~/.profile
</pre> </pre>
</li> </li>
 +
<li> Check your version of automake: <li> Check your version of automake:
<pre> <pre>
Line 40: Line 42:
</pre> </pre>
Currently (November 8, 2007) this installation procedure works with automake 1.6.3 which is Currently (November 8, 2007) this installation procedure works with automake 1.6.3 which is
-on your system by default. Delete any more recent automake package: check for instance automake packages installed by fink. In the future, more recent packages may be needed. </li>+on your system by default. Delete any more recent automake package: check for instance automake packages installed by fink. In the futu<li>We need access to the fink executables:
-<li>Add the gerris directory to your path (so gts-config works properly).+<br>
 +<code>% export PATH=/sw/bin:$PATH</code>
 +</li>
 +re, more recent packages may be needed. </li>
 +<li>Add the gerris directory to your path (so gts-config works properly), also add the fink directory.
<pre> <pre>
-echo "export PATH=$PATH:/opt/gerris/bin" >> ~/.profile+echo "export PATH=$PATH:/opt/gerris/bin:/sw/bin" >> ~/.profile
</pre> </pre>
</li> </li>

Revision as of 16:27, 17 March 2009

OS X 10.4 (Intel) Installation

Below are steps that have worked for at least three people, installing Gerris under Mac OS X 10.4 (Intel).

  1. You will need the Apple development tools installed - this is a free download from http://developer.apple.com/tools/.
  2. Check that you have Apple's X11 and the X11 SDK installed. They are not installed by default on a new machine (at least as far as I could figure out). If X11 is not installed, in OS X 10.4 you need to reinstall your system from the DVD (See here). Reinstalling the system will not remove your user files. (For comparison, on my system, the versions were X11 1.1.3 - XFree86 4.4.0 .)
  3. Install Fink (http://finkproject.org).
  4. Install various dependencies that Gerris requires. 
    sudo fink install pkgconfig glib2 glib2-dev glib2-shlibs gtk+2 gtk+2-dev \
                  gtkglext1 startup-notification-dev \
                  startup-notification-shlibs

    Other packages may also be necessary. Look at the error messages during the configuration steps below to see what packages may be missing. Then the best way to resolve the problem may be to install "fink commander". Then search for all the packages that have a name beginning with pango, gtk+, atk1 and install all of them. Trial and error should eventually lead you to a full installation of all the necessary packages.

  5. Install darcs (needed to obtain the latest version of Gerris, GTS, and GfsView - the packaged versions available on the web do not work). Darcs is not available in Fink either.

    1. Download the DMG from http://glozer.net/darcs/, and mount it.
    2. From the DMG, Drag GMP.Framework into /Library/Frameworks.
    3. From the DMG, put the 'darcs' executable wherever you wish (e.g. /usr/local/bin).

  6. From a suitable folder, obtain the latest versions of GTS, Gerris, and GfsView. 
    darcs get http://gfs.sf.net/darcs/gerris/gerris-stable
darcs get http://gts.sf.net/darcs/gts-mainline
darcs get http://gfs.sourceforge.net/darcs/gfsview/gfsview-mainline
  7. We will install these in /opt/gerris to keep them isolated from the rest of the system. This requires /opt/gerris/lib/pkgconfig to be added to your PKG_CONFIG_PATH. This directory does not exist yet - it will be created in the next step. 
    echo "export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/opt/lib/pkgconfig" >> ~/.profile
  8. Check your version of automake: 
    % automake --version

    Currently (November 8, 2007) this installation procedure works with automake 1.6.3 which is on your system by default. Delete any more recent automake package: check for instance automake packages installed by fink. In the futu<li>We need access to the fink executables:
    % export PATH=/sw/bin:$PATH

    9. re, more recent packages may be needed. </li>

  9. Add the gerris directory to your path (so gts-config works properly), also add the fink directory. 
    echo "export PATH=$PATH:/opt/gerris/bin:/sw/bin" >> ~/.profile
  10. Compile and install GTS, Gerris and GfsView. 
    cd gts-mainline
sh autogen.sh --prefix=/opt/gerris
make && make install
cd ../gerris-stable
sh autogen.sh --prefix=/opt/gerris
make && make install
cd ../gfsview-mainline
sh autogen.sh --prefix=/opt/gerris
make && make install
  11. Test your installation. Beware of end of line characters.
  12. You're done !

Optional tools

If we want to generate MPEG movies using ppm2mpeg we will need ffmpeg which is not available in Fink stable, so we must install it manually.

  1. Download the latest SVN snapshot from http://ffmpeg.mplayerhq.hu/ffmpeg-export-snapshot.tar.bz2
  2. Unpack and install it. 
    tar -xvjf ffmpeg-export-snapshot.tar.bz2
cd ffmpeg-export-<insert date here>
./configure --prefix=/opt/gerris
make && make install

Mac OSX 10.5 (Intel) Installation

The following were required to obtain a working Gerris/GfsView installation when compiling from snapshot. The basic sequence is as above, without the autogen.sh lines. A working fink installation is assumed.

  1. (csh etc...) setenv CPPFLAGS -I/sw/include is needed for gsl among others.
  2. (csh etc...) setenv LDFLAGS -L/sw/lib is needed for libprof among others.
  3. GfsView does not compile properly when gerris is compiled with mpi. Two solutions: either --disable-mpi when making gerris, or before configure step in gfsview, SETENV CC mpicc.
  4. OSMesa broken in gfsview configure. Adding -L/usr/X11R6/lib to LDFLAGS changes the configure error message but not Mesa being broken
  5. See also this Mac OSX 10.5 bug

Retrieved from "http://gfs.sourceforge.net/wiki/index.php/Mac_OSX_Installation"
Personal tools
communication