Last modified 3 years ago Last modified on 09/10/08 11:27:43

Installing InterMine and required software on a Mac

This is a work in progress, at the moment just some notes and useful links.

Installing subversion

Martin Ott maintains a really useful installer for subversion,  here. This will install svn in /usr/local/bin so make sure that is on your $PATH. To make sure it is installed correctly just try: 

% svn --version

See  this tutorial from RubyRobot for more details.

Installing Tomcat

Tomcat is easy to install by downloading the tar.gz file of the latest release and extracting it, then you can get started almost immediately.

  1. From the  Tomcat website find the latest stable version in the Downloads section, currently 6.0.x. Scroll to 'Binary Distributions', 'Core' and save the tar.gz file.
  2. Extract this file with: 
    % tar -zxvf apache-tomcat-6.0.x
  3. Change into the apache-tomcat-6.0.x, the following directories are of interest:
    • bin - scripts to startup and shutdown tomcat
    • logs - error logs are written here
    • webapps - the directory web applications are deployed to
    • conf - configuration files
  4. Before starting you need to set up a mananger user so you can deploy web applications and we recommend you allocate more RAM to tomcat - see here
  5. Start up tomcat by running: 
    apache-tomcat-6.0.x/bin/startup.sh
    To check tomcat is running try to access localhost:8080 in a web browser, you should see a Tomcat home page. If you don't see the tomcat page check apache-tomcat-6.0.x/catalina.out and apache-tomcat-6.0.x/localhost-<data>.log for error messages and consult the  Tomcat docs

Installing Eclipse

Eclipse is a free, open-source Java editing environment, configuration to open the various code modules in InterMine as Eclipse projects is included in the checkout. You can download the Mac OS X version of Eclipse from  here, either the standard or EE edition will work fine. Just unzip the download and it will work immediately.

See our guide to setting up InterMine in Eclipse: EclipseSetup.

For convenient startup from the Terminal command line you can put eclipse in your $PATH or create a link to it, for example: 

sudo ln -s /Applications/eclipse/eclipse /usr/local/bin/eclipse

Apple have a  guide to Eclipse.