Version: Next

Troubleshooting tips

This page describes what to do if you encounter problems when installing or maintaining InterMine. Please feel free to Contact us with any questions you may have.

Error messages#

If you encounter a problem when running a task, try adding the verbose flag:

# add --stacktrace flag to get the complete error message
$ ./gradlew builddb --stacktrace

Logs#

Data warehouse#

When integrating data, the errors are usually in intermine.log in your mine's directory.

Webapp#

When you see an error on the webapp or get a blank page and nothing appears in the webapp log from log4j, it is likely you will be able to find more information on what went wrong in the tomcat logs:

  • tomcat/logs/catalina.out
  • tomcat/logs/localhost.$DATE.logs

It will likely be the log that was modified last.

A good way of looking at the output to these logs in real time is to use the command:

$ tail -f tomcat/logs/$LOGNAME

If you reload the webapp, you will see the error output directly on the screen.

IQL in logs#

If you are having problems with a specific query, you can run it directly in the console. The query is listed in the log files in IQL (InterMine Query Language). To run the query directly, go to $MINE/dmodel and execute this command:

$ ./gradlew runIQLQuery -Pquery='some IQL'

Show all properties#

Note that you can do this in a running web-app to check that it works by visiting the HOST/PATH/showProperties.do URL when logged in as superuser.

Common Errors#

Listed here are some common errors encountered in InterMine and some suggested fixes.

UnsupportedClassVersionError#

java.lang.UnsupportedClassVersionError: org/intermine/task/FileName (Unsupported major.minor version 49.0)

This means that your version of Java is too old. You need at least Java 8 to run InterMine.

can't open datasource#

java.lang.RuntimeException: can't open datasource for {platform=PostgreSQL, datasource.dataSourceName=db.flatmodeunittest, ...

Errors of this type mean there was a problem accessing a database, in this example, db.flatmodeunittest. Either the database specified in the mine.properties file doesn't exist or the server/user/password details in the properties are incorrect.

FATAL: sorry, too many clients already#

org.postgresql.util.PSQLException: Backend start-up failed: FATAL: sorry, too many clients already - for database: db.bio-fulldata-test

This occurs when the number of connections to a database exceeds the maximum configured in the postgres configuration. You need to increase the value of max_connections in the postgresql.conf file and restart postgres. Try 100 connections:

max_connections = 100

If you still experience this problem, restart Postgres.

OutOfMemoryError: Java heap space#

java.lang.OutOfMemoryError: Java heap space

This means that a Java process hasn't been allocated enough memory to function correctly. You can increase the amount of memory by changing the -Xmx property in your GRADLE_OPTS environment variable. We recommend 8G as a minimum, more is often needed during data loading. Your GRADLE_OPTS variable should include the following:

$ echo $GRADLE_OPTS
$ -Xmx8G -Dorg.gradle.daemon=false

Can't find class name ClassName#

Exception caught: java.lang.IllegalArgumentException: Unknown class name Protein in package org.intermine.model.bio

In this example a class named Protein could not be found in the data model. This will usually arise when running a parser and attempting to create an Item for a class that does not exist. Check your SOURCE-NAME_additions.xml files to see if the class is listed. Only the additions files for sources lists on project.xml when ./gradlew builddb was run will be included in the data model.

Can't find keys#

Caused by: java.lang.IllegalArgumentException: Unable to find keys for source protfeatures_source in file protfeatures_source_keys.properties

It is expecting to find some keys to integrate data from that source. Do you have a keys file in the protfeatures/src/main/resources?

Classpath issues#

Classpath issues can generate various errors, for example, a conflict caused by wstx-asl-3.2.4.jar when the XMLOutputFactory created its StreamWriter in PathQueryBinding:

XMLStreamWriter writer = factory.createXMLStreamWriter(sw);

Failed to parse the expression#

If you are using Tomcat with a version > 6 and you see the following error in your log:

Caused by: org.apache.jasper.JasperException: /queryBuilderConstraint.jsp (line: 90, column: 14) "${dec.boolean}" contains invalid expression(s): javax.el.ELException: Failed to parse the expression [${dec.boolean}]

Please add this to your Tomcat startup.sh and catalina.sh scripts:

JAVA_OPTS="$JAVA_OPTS -Dorg.apache.el.parser.SKIP_IDENTIFIER_CHECK=true"
export JAVA_OPTS

See Tomcat for more details.

Session Error#

If you get a session error when you first start up your webapp, update your Tomcat configuration to handle different URLs. See Tomcat.

Client side errors#

Assuming you are using Google Chrome as your browser, press Ctrl+Shift+I to open a Debugger. In there, click on the "Console" tab. If errors are present you should see them in red. If you want to inspect what kind of data are being sent/fetched, click on the Network Tab.

If you are using the List Widgets library (>= 1.2.4), then you can launch a "debug mode" on them. Simply wait for your page to load. Then append #debug to the end of the page URL. You should see buttons on individual widgets allowing you to see a debug trace of events happening.

Keyword Search fails#

There is no extra configuration required to get the search working. The search uses a Lucene index not the postgres database. The Lucene index is created at build-time, and it is the last source build as part of the tutorial.

The search should be very quick, but depending on the machine it's on, the initial search can be quite slow. On the first search, the index is unpacked from the database and loaded into memory which can take up to a minute.

If the search is just failing instantly, check your log files ($TOMCAT/logs). When the index is unpacked from the database, it writes to disk. There may be permissions or space issues.

See Gradle - FAQs for more error messages.