Skip to content
This repository

MOLGENIS is an collaborative open source project on a mission to generate great software infrastructure for life science research.

Merge pull request #1432 from erwinwinder/master

Fix view submissions for lifelines
latest commit 48a7beed76
bartcharbon bartcharbon authored April 23, 2014
Octocat-spinner-32 doc
Octocat-spinner-32 molgenis-app-omx
Octocat-spinner-32 molgenis-charts bump version 1.0.0 to 1.1.0-SNAPSHOT March 27, 2014
Octocat-spinner-32 molgenis-core-ui
Octocat-spinner-32 molgenis-core
Octocat-spinner-32 molgenis-data-annotators Mov getEntityClass from repository to EntityMetaData April 08, 2014
Octocat-spinner-32 molgenis-data-csv Created TypeCsvRepository April 10, 2014
Octocat-spinner-32 molgenis-data-excel
Octocat-spinner-32 molgenis-data-googlespreadsheet Mov getEntityClass from repository to EntityMetaData April 08, 2014
Octocat-spinner-32 molgenis-data-jpa Implement 'search' query for jpa April 08, 2014
Octocat-spinner-32 molgenis-data-omx Use observablefeatureid, not id April 22, 2014
Octocat-spinner-32 molgenis-data-rest Use typed methods April 14, 2014
Octocat-spinner-32 molgenis-data
Octocat-spinner-32 molgenis-js bump version 1.0.0 to 1.1.0-SNAPSHOT March 27, 2014
Octocat-spinner-32 molgenis-model-registry
Octocat-spinner-32 molgenis-omx-annotators
Octocat-spinner-32 molgenis-omx-biobankconnect Mov getEntityClass from repository to EntityMetaData April 08, 2014
Octocat-spinner-32 molgenis-omx-core remove annotation April 15, 2014
Octocat-spinner-32 molgenis-omx-das 1693 change webapp config to improve maintainability. April 18, 2014
Octocat-spinner-32 molgenis-omx-dataexplorer EntityClass details April 16, 2014
Octocat-spinner-32 molgenis-omx-importer Fix: Exception on data explorer after a failed upload of a data file April 03, 2014
Octocat-spinner-32 molgenis-omx-mobile
Octocat-spinner-32 molgenis-omx-protocolmanager Harmonize categorical/lut April 02, 2014
Octocat-spinner-32 molgenis-omx-protocolviewer Fix view submissions for lifelines April 23, 2014
Octocat-spinner-32 molgenis-r
Octocat-spinner-32 molgenis-search-elasticsearch Fix for github issue #1401 April 22, 2014
Octocat-spinner-32 molgenis-search
Octocat-spinner-32 molgenis-security-core bump version 1.0.0 to 1.1.0-SNAPSHOT March 27, 2014
Octocat-spinner-32 molgenis-security Group information legend is added. The group memberships are shown. April 22, 2014
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.md Update README.md January 27, 2014
Octocat-spinner-32 eclipse-java-molgenis-style.xml
Octocat-spinner-32 eclipse-javascript-molgenis-style.xml
Octocat-spinner-32 pom.xml
README.md

Build Status

Welcome to MOLGENIS

MOLGENIS is an collaborative open source project on a mission to generate great software infrastructure for life science research. Each app in the MOLGENIS family comes with rich data management interface and plug-in integration of analysis tools in R, Java and web services.

The procedure below tells you how to checkout the molgenis project and build one of the example apps.

1. Fork the molgenis repository

Create a fork of the github.com/molgenis/molgenis repository for your own Github account. More information about forking can be found here: https://help.github.com/articles/fork-a-repo

2. Clone your molgenis fork on your local system

Pick a folder for your Git repositories, e.g.:

cd ~/git

Clone your fork to this folder:

git clone https://github.com/<yourname>/molgenis.git

Optionally select stable molgenis version:

git fetch --tags origin
git checkout -b <tag name: see https://github.com/molgenis/molgenis/releases>

3. Install and configure eclipse

Compiling MOLGENIS requires Java 7. MOLGENIS is created with help of Maven and Freemarker. You need a few eclipse plugins to work with those.

Important: get the LATEST version of Eclipse and all plugins mentioned. For example, using Eclipse Juno Release 1 or lower might result in infinite build loops.

Start Eclipse and select a workspace location (e.g. ~/eclipse/workspace - do not pick the ~/git folder).

Now install the plugins. Click: Help -> Eclipse marketplace. Add the following (restart Eclipse when done):

  • maven integration for eclipse
  • Apt M2E connector
  • JBoss Tools (ONLY SELECT THE 'FreeMarker IDE feature' later in the wizard!)
  • testng

4. Import the molgenis project into eclipse

Start Eclipse and select your workspace location (e.g. ~/eclipse/workspace).

Click: File -> Import ... -> Existing Maven Projects.

Set root directory to your git clone folder. E.g. ~/git (this means you can still see the 'molgenis' folder).

Eclipse discovers all molgenis modules (should be all checked).

Click next/okay; eclipse will now import the modules. Also Eclipse will automatically install maven connector plugins when needed (restart follows)

5. Generate the code for the first time

If still open, close the 'Welcome' screen.

Eclipse will automatically build and download jars.

Right mouse 'molgenis' -> Run as -> Maven install.

After generation eclipse will compile automagically.

6. Create mysql database for OMX app

Assumed is that you have installed the latest mysql. Log in via terminal using your root credentials:

mysql -u root -p

Give create a database with permissions to molgenis user:

create database omx;
grant all privileges on omx.* to molgenis@localhost identified by 'molgenis';
flush privileges;

7. Configure the default admin password

Create the directory ~/.molgenis/omx and create a file called molgenis-server.properties in this folder (~ is your home folder)

Add user and database properties to this file, such as this example:

db_user=molgenis
db_password=molgenis
db_uri=jdbc:mysql://localhost/omx
admin.password=admin
user.password=admin

If these properties are not present, the MolgenisDatabasePopulator will fail (RuntimeException). This properties-file should be in your home folder, if the file is not there yet, just create it.

8. Run the OMX app (example)

Right click 'molgenis-app-omx' -> Run as ... -> Maven build ...

In the 'goals' box type in 'jetty:start'

Before running, go the the 'JRE' tab and add the the following VM arguments:

-XX:MaxPermSize=512M
-Xmx2g

This will add memory for the application to use.

Now go back to the previous tab and Choose Run. Jetty will be started.

Open your browser at http://localhost:8080/

You should see the application. Login as 'admin', 'admin' to be able to upload and view data, create users, etc etc.

9. Keep your code up to date

Add the original molgenis repository as a remote location.

cd ~/git/molgenis
git remote add blessed https://github.com/molgenis/molgenis.git

Perform regular updates so the latest changes are merged with your local clone.

git pull blessed master

And push back any merges or commits of your own to your online fork.

git push origin master

10. Troubleshooting

When I try to start an application, the console tells me 'Address already in use'!

Run the Maven target 'jetty:stop'. If that does not help, use your opering systems process manager to kill anything running on port 8080. For example:

kill -9 `lsof -i :8080 -t`
Something went wrong with that request. Please try again.