How to set up a mirror of FlyMine

These instructions show you how to set up a local copy of FlyMine. You can release your own copy of the web application to use or you can query it with the Java API. If you would like integrate your own data with FlyMine the procedure is different - follow these instructions.

1. Ensure you have the required software installed and configured - see: prerequisites.

2. Check out the latest release branch code, look for the highest release number in source:branches.

> svn co svn://subversion.flymine.org/branches/flymine_release_8_0_branch/

3. Create PostgreSQL databases requried. The names used here will need to be set in the flymine-webapp.properties file later.

> createdb flymine_xx
> createdb userprofile-flymine_xx

4. Get the latest database dump from: http://www.flymine.org/download/. Load it into the new database:

> zcat database_dump | psql flymine_xx

5. Analyse the database to update Postgres' statistics:

> psql flymine_xx
> set default_statistics_target = 500;
> analyse;

6. Set up properties to release the web application. Copy the example flymine-webapp.properties and build.properties.flymine-webapp files from http://www.flymine.org/download/ to your home directory and edit them to include your own database and tomcat locations and usernames/passwords.

7. Release the web application. In flymine/webapp:

> ant build-db-userprofile
> ant default release-webapp

You only need to run 'build-db-userprofile' the first time you set up a webapp. Use ant remove-webapp if there is already a web application deployed at the specified path:

> ant default remove-webapp release-webapp

When you first deploy the webapp for a new database some summary queries are run, this may take some time but will be faster for later releases. Alternatively you can download the corresponding objectstoresummary.properties file and copy it to flymine/dbmodel/dist. This will allow it to skip the summarise step.