Mac OSX Installation

From Gerris

Revision as of 11:06, 8 November 2007 Zaleski (Talk | contribs) (there are still missing packages !!) ← Previous diff		Revision as of 11:32, 8 November 2007 Zaleski (Talk | contribs) (added a hint to install fink commander) Next diff →
Line 3:		Line 3:
	<ol>		<ol>
-	<li>Install Fink (http://finkproject.org). You will need the Apple development tools installed - this is a free download from http://developer.apple.com/tools/. In our experience this installation works with apple gcc 4.0.1 which is included in this installation.</li>	+	<li>Install Fink (http://finkproject.org). You will need the Apple development tools installed - this is a free download from http://developer.apple.com/tools/.</li>
	<li>Install various dependencies that Gerris requires.		<li>Install various dependencies that Gerris requires.
	<pre>		<pre>
Line 10:		Line 10:
	startup-notification-shlibs		startup-notification-shlibs
	</pre>		</pre>
-	Other packages may also be necessary (pango-..., gtk1...) .	+	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.
	</li>		</li>

---

Revision as of 11:32, 8 November 2007

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. Install Fink (http://finkproject.org). You will need the Apple development tools installed - this is a free download from http://developer.apple.com/tools/.
2. 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.

3. 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).

4. 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
   

5. 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/gerris/lib/pkgconfig" >> ~/.profile
   

6. Check your version of automake. Currently (November 8, 2007) this installation procedure works with automake 1.6.3 which is on your system by default. Delete any more recent packages, for instance packages installed by fink. In the future, more recent packages may be needed.
7. Add the gerris directory to your path (so gts-config works properly).

   echo "export PATH=$PATH:/opt/gerris/bin" >> ~/.profile
   

8. 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
   

9. 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