JATOS test page
JATOS comes with build in tests (e.g. WebSockets connections and database connection), but they are only accessible for users with admin rights: go to Administration ⇒ Tests and check that all tests are 'OK'.
Downloading a study / exporting a study fails (e.g. in Safari browsers)
Read log files in the browser
In a perfect world, JATOS always works smoothly and, when it doesn't, it describes the problem in an error message. Unfortunately we aren't in a perfect world: every now and then something will go wrong and you might not get any clear error messages, or no message at all. In these (rare) cases, you can look into JATOS' log files (not to be confused with the study log) to try to find what the problem might be. You can see and download all log files in the Administration page => Logs (for security reasons, you must be logged in as a user with admin rights).
- application.log - all JATOS logging
- loader.log - logging during startup with loader
- update.log - logging during updates
Alternatively you can read the log files directly on the server. You'll find your logs in
A file (library, image, ...) included in the HTML fails to load?
There is a common mistake Windows users make that might prevent files from loading: Any URL or file path in a HTML or JS file should only use '/' as a file path separator - even on Windows systems. So it should always be e.g.
<script src="subfolder/myscript.js"></script> and not
Database is corrupted?
If you get an error that reads something like:
Error in custom provider, Configuration error: Configuration error[Cannot connect to database [default]], your database might be corrupted. By default JATOS comes with an H2 database and the H2 database doesn't handle copying its files while running too well.
There are two reasons why this might be the case: you moved your JATOS folder while it was running or you installed JATOS in a synced folder. To prevent this, be sure to always be careful with the following:
- Don't copy or move while JATOS is running - Always stop JATOS (type
./loader.sh stopin your Linux / Mac OS terminal or close the window on Windows) before moving it.
- Don't sync while JATOS is running - As we mentioned in the Installation page, you can run JATOS from pretty much anywhere except from a folder that syncs across devices, like Dropbox or Google Drive. Doing so might lead to database corruption, because while the files might be synced between computers, the running processes aren't. This will lead to havoc and destruction and, in extreme cases, to the implosion of the known Universe. You can find in our blog post a description of an attempt to recover a corrupted database. Didn't work.
Of course, this brings us to an important point: back up your result data (i.e., simply download and save your text files) regularly if you're running a study!