JATOS Versions Save

Just Another Tool for Online Studies

v3.8.6

1 month ago

If you want to update a JATOS server from version < 3.7.1 read the release information from v3.7.x first.

Try out the new version on cortex.jatos.org.

Changes in 3.8.6

  • Fix (#304) - JATOS 3.8.x stops sending data during a study run once a single request fails without getting any response from the JATOS server (e.g. due to network problems)
  • GUI / Study Links page - Allow editing of a study link's comments

Changes in 3.8.5

  • Added authentication with ORCID (orcid.org) and OpenID Connect (OIDC)
  • Added download button to QR codes of study links
  • Added study link's comments to result metadata (#293)

Changes in 3.8.4

  • Bugfix: Result files stored in the wrong folder (#292)

Changes in 3.8.3

  • Bugfixes
    • Logout not working (#291)
    • Study Results of a specific worker shows results of all workers of that type instead of only one (#289)
  • Administration improvements:
    • Added docs for JATOS with Docker Compose and JATOS in a cluster with Kubernetes
    • Rename JATOS' config file: production.conf to jatos.conf (but production.conf is still allowed)
    • Better support of multi-node setups: set flag jatos.multiNode=true
    • Make migrations and updates multi-node safe
    • Add liveness test: route /ping answers with 'pong'
    • JATOS' tmp folder is now configurable via jatos.tmpPath and JATOS_TMP_PATH
    • Improved Dockerfile: JATOS home folder is now by default /opt/jatos and JATOS' data (study assets, result uploads, study logs) are in /opt/jatos_data
    • Added Tests to GUI's administration page / Tests: test access to all necessary folders (study assets, result uploads, logs, study logs, and tmp folder)

Changes in 3.8.2

  • Bugfixes
    • Result data exported as Plain Text missing line-breaks (#285 )
    • Malformed cookies from older JATOS versions can cause an InternalServerError with some browsers
  • GUI:
    • Use browser's local date-time (instead of server's date-time) at e.g. Start Time or Last Seen in the result pages
    • Study Links, in the setup for the Personal types - add a button group to toggle between visibility of All, Active, Deactivated, and Used study links
  • JATOS API: new endpoint to get the directory structure of a study assets directory in JSON
  • A lot of administration improvements:
    • Abolished server-side cache -> all state is now either in the database or in cookies (easier to run JATOS on multiple nodes)
    • Logs config:
      • Allow to configure the location of the application logs
      • Allow logging to file or stdout
    • production.conf - Equalize property names. Most common names all start with jatos. now, but old-style names are still supported.
    • Abolished use of X-Forwarded-* HTTP headers (X-Forwarded-Proto, X-Forwarded-For, X-Forwarded-Ssl) (easier to run JATOS in complex system layouts)

Changes in 3.8.1

  • Introducing the JATOS API
  • New results export format: JATOS results archive (JRZIP)
  • Formalize the study exchange format: JATOS study archive (JZIP)
  • GUI: Simpler result pages and support of JATOS Result Archives (JRZIP)
  • GUI: Study links page - remove All Workers button
  • jatos.js: Standardize the behavior of empty/null in jatos.studyJsonInput, jatos.componentJsonInput and jatos.batchJsonInput (#277)
  • Fix result data size checking of jatos.submitResultData
  • Fix issue with JATOS on Windows - sometimes loader.bat closes immediately (#265 )

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?

v3.8.5

6 months ago

If you want to update a JATOS server from version < 3.7.1 read the release information from v3.7.x first.

Try out the new version on cortex.jatos.org.

Changes in 3.8.5

  • Added authentication with ORCID (orcid.org) and OpenID Connect (OIDC)
  • Added download button to QR codes of study links
  • Added study link's comments to result metadata (#293)

Changes in 3.8.4

  • Bugfix: Result files stored in the wrong folder (#292)

Changes in 3.8.3

  • Bugfixes
    • Logout not working (#291)
    • Study Results of a specific worker shows results of all workers of that type instead of only one (#289)
  • Administration improvements:
    • Added docs for JATOS with Docker Compose and JATOS in a cluster with Kubernetes
    • Rename JATOS' config file: production.conf to jatos.conf (but production.conf is still allowed)
    • Better support of multi-node setups: set flag jatos.multiNode=true
    • Make migrations and updates multi-node safe
    • Add liveness test: route /ping answers with 'pong'
    • JATOS' tmp folder is now configurable via jatos.tmpPath and JATOS_TMP_PATH
    • Improved Dockerfile: JATOS home folder is now by default /opt/jatos and JATOS' data (study assets, result uploads, study logs) are in /opt/jatos_data
    • Added Tests to GUI's administration page / Tests: test access to all necessary folders (study assets, result uploads, logs, study logs, and tmp folder)

Changes in 3.8.2

  • Bugfixes
    • Result data exported as Plain Text missing line-breaks (#285 )
    • Malformed cookies from older JATOS versions can cause an InternalServerError with some browsers
  • GUI:
    • Use browser's local date-time (instead of server's date-time) at e.g. Start Time or Last Seen in the result pages
    • Study Links, in the setup for the Personal types - add a button group to toggle between visibility of All, Active, Deactivated, and Used study links
  • JATOS API: new endpoint to get the directory structure of a study assets directory in JSON
  • A lot of administration improvements:
    • Abolished server-side cache -> all state is now either in the database or in cookies (easier to run JATOS on multiple nodes)
    • Logs config:
      • Allow to configure the location of the application logs
      • Allow logging to file or stdout
    • production.conf - Equalize property names. Most common names all start with jatos. now, but old-style names are still supported.
    • Abolished use of X-Forwarded-* HTTP headers (X-Forwarded-Proto, X-Forwarded-For, X-Forwarded-Ssl) (easier to run JATOS in complex system layouts)

Changes in 3.8.1

  • Introducing the JATOS API
  • New results export format: JATOS results archive (JRZIP)
  • Formalize the study exchange format: JATOS study archive (JZIP)
  • GUI: Simpler result pages and support of JATOS Result Archives (JRZIP)
  • GUI: Study links page - remove All Workers button
  • jatos.js: Standardize the behavior of empty/null in jatos.studyJsonInput, jatos.componentJsonInput and jatos.batchJsonInput (#277)
  • Fix result data size checking of jatos.submitResultData
  • Fix issue with JATOS on Windows - sometimes loader.bat closes immediately (#265 )

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?

v3.8.5-alpha

6 months ago

This is a alpha release. Do not use.

v3.8.4

10 months ago

If you want to update a JATOS server from version < 3.7.1 read the release information from v3.7.x first.

Try out the new version on cortex.jatos.org.

Changes in 3.8.4

  • Bugfix: Result files stored in the wrong folder (#292)

Changes in 3.8.3

  • Bugfixes
    • Logout not working (#291)
    • Study Results of a specific worker shows results of all workers of that type instead of only one (#289)
  • Administration improvements:
    • Added docs for JATOS with Docker Compose and JATOS in a cluster with Kubernetes
    • Rename JATOS' config file: production.conf to jatos.conf (but production.conf is still allowed)
    • Better support of multi-node setups: set flag jatos.multiNode=true
    • Make migrations and updates multi-node safe
    • Add liveness test: route /ping answers with 'pong'
    • JATOS' tmp folder is now configurable via jatos.tmpPath and JATOS_TMP_PATH
    • Improved Dockerfile: JATOS home folder is now by default /opt/jatos and JATOS' data (study assets, result uploads, study logs) are in /opt/jatos_data
    • Added Tests to GUI's administration page / Tests: test access to all necessary folders (study assets, result uploads, logs, study logs, and tmp folder)

Changes in 3.8.2

  • Bugfixes
    • Result data exported as Plain Text missing line-breaks (#285 )
    • Malformed cookies from older JATOS versions can cause an InternalServerError with some browsers
  • GUI:
    • Use browser's local date-time (instead of server's date-time) at e.g. Start Time or Last Seen in the result pages
    • Study Links, in the setup for the Personal types - add a button group to toggle between visibility of All, Active, Deactivated, and Used study links
  • JATOS API: new endpoint to get the directory structure of a study assets directory in JSON
  • A lot of administration improvements:
    • Abolished server-side cache -> all state is now either in the database or in cookies (easier to run JATOS on multiple nodes)
    • Logs config:
      • Allow to configure the location of the application logs
      • Allow logging to file or stdout
    • production.conf - Equalize property names. Most common names all start with jatos. now, but old-style names are still supported.
    • Abolished use of X-Forwarded-* HTTP headers (X-Forwarded-Proto, X-Forwarded-For, X-Forwarded-Ssl) (easier to run JATOS in complex system layouts)

Changes in 3.8.1

  • Introducing the JATOS API
  • New results export format: JATOS results archive (JRZIP)
  • Formalize the study exchange format: JATOS study archive (JZIP)
  • GUI: Simpler result pages and support of JATOS Result Archives (JRZIP)
  • GUI: Study links page - remove All Workers button
  • jatos.js: Standardize the behavior of empty/null in jatos.studyJsonInput, jatos.componentJsonInput and jatos.batchJsonInput (#277)
  • Fix result data size checking of jatos.submitResultData
  • Fix issue with JATOS on Windows - sometimes loader.bat closes immediately (#265 )

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?

v3.8.3

10 months ago

If you want to update a JATOS server from version < 3.7.1 read the release information from v3.7.x first.

Try out the new version on cortex.jatos.org.

Changes in 3.8.3

  • Bugfixes
    • Logout not working (#291)
    • Study Results of a specific worker shows results of all workers of that type instead of only one (#289)
  • Administration improvements:
    • Added doc for Docker Compose (doc for Kubernetes is coming soon)
    • Rename JATOS' config file: production.conf to jatos.conf (but production.conf is still allowed)
    • Better support of multi-node setups: set flag jatos.multiNode=true
    • Make migrations and updates multi-node safe
    • Add liveness test: route /ping answers with 'pong'
    • JATOS' tmp folder is now configurable via jatos.tmpPath and JATOS_TMP_PATH
    • Improved Dockerfile: JATOS home folder is now by default /opt/jatos and JATOS' data (study assets, result uploads, study logs) are in /opt/jatos_data
    • Added Tests to GUI's administration page / Tests: test access to all necessary folders (study assets, result uploads, logs, study logs, and tmp folder)

Changes in 3.8.2

  • Bugfixes
    • Result data exported as Plain Text missing line-breaks (#285 )
    • Malformed cookies from older JATOS versions can cause an InternalServerError with some browsers
  • GUI:
    • Use browser's local date-time (instead of server's date-time) at e.g. Start Time or Last Seen in the result pages
    • Study Links, in the setup for the Personal types - add a button group to toggle between visibility of All, Active, Deactivated, and Used study links
  • JATOS API: new endpoint to get the directory structure of a study assets directory in JSON
  • A lot of administration improvements:
    • Abolished server-side cache -> all state is now either in the database or in cookies (easier to run JATOS on multiple nodes)
    • Logs config:
      • Allow to configure the location of the application logs
      • Allow logging to file or stdout
    • production.conf - Equalize property names. Most common names all start with jatos. now, but old-style names are still supported.
    • Abolished use of X-Forwarded-* HTTP headers (X-Forwarded-Proto, X-Forwarded-For, X-Forwarded-Ssl) (easier to run JATOS in complex system layouts)

Changes in 3.8.1

  • Introducing the JATOS API
  • New results export format: JATOS results archive (JRZIP)
  • Formalize the study exchange format: JATOS study archive (JZIP)
  • GUI: Simpler result pages and support of JATOS Result Archives (JRZIP)
  • GUI: Study links page - remove All Workers button
  • jatos.js: Standardize the behavior of empty/null in jatos.studyJsonInput, jatos.componentJsonInput and jatos.batchJsonInput (#277)
  • Fix result data size checking of jatos.submitResultData
  • Fix issue with JATOS on Windows - sometimes loader.bat closes immediately (#265 )

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?

v3.8.2

1 year ago

If you want to update a JATOS server from version < 3.7.1 read the release information from v3.7.x first.

Try out the new version on cortex.jatos.org.

Changes in 3.8.2

  • Bugfixes
    • Result data exported as Plain Text missing line-breaks (#285 )
    • Malformed cookies from older JATOS versions can cause an InternalServerError with some browsers
  • GUI:
    • Use browser's local date-time (instead of server's date-time) at e.g. Start Time or Last Seen in the result pages
    • Study Links, in the setup for the Personal types - add a button group to toggle between visibility of All, Active, Deactivated, and Used study links
  • JATOS API: new endpoint to get the directory structure of a study assets directory in JSON
  • A lot of administration improvements:
    • Abolished server-side cache -> all state is now either in the database or in cookies (easier to run JATOS on multiple nodes)
    • Logs config:
      • Allow to configure the location of the application logs
      • Allow logging to file or stdout
    • production.conf - Equalize property names. Most common names all start with jatos. now, but old-style names are still supported.
    • Abolished use of X-Forwarded-* HTTP headers (X-Forwarded-Proto, X-Forwarded-For, X-Forwarded-Ssl) (easier to run JATOS in complex system layouts)

Changes in 3.8.1

  • Introducing the JATOS API
  • New results export format: JATOS results archive (JRZIP)
  • Formalize the study exchange format: JATOS study archive (JZIP)
  • GUI: Simpler result pages and support of JATOS Result Archives (JRZIP)
  • GUI: Study links page - remove All Workers button
  • jatos.js: Standardize the behavior of empty/null in jatos.studyJsonInput, jatos.componentJsonInput and jatos.batchJsonInput (#277)
  • Fix result data size checking of jatos.submitResultData
  • Fix issue with JATOS on Windows - sometimes loader.bat closes immediately (#265 )

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?

v3.8.1

1 year ago

If you want to update a JATOS server from version < 3.7.1 read the release information from v3.7.x first.

Try out the new version on cortex.jatos.org.

Changes in 3.8.1

  • Introducing the JATOS API
  • New results export format: JATOS results archive (JRZIP)
  • Formalize the study exchange format: JATOS study archive (JZIP)
  • GUI: Simpler result pages and support of JATOS Result Archives (JRZIP)
  • GUI: Study links page - remove All Workers button
  • jatos.js: Standardize the behavior of empty/null in jatos.studyJsonInput, jatos.componentJsonInput and jatos.batchJsonInput (#277)
  • Fix result data size checking of jatos.submitResultData
  • Fix issue with JATOS on Windows - sometimes loader.bat closes immediately (#265 )

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?

v3.7.6

1 year ago

If you update a JATOS server from version < 3.7.1

Warning 1: Do not update your JATOS while studies are running. Wait for them until they are finished and then update. Updating while studies are running will break those study runs and result data will probably be lost.

Warning 2: If you are using study links with preview (the ones with ?pre in the URL) - they won't trigger a preview anymore (although they will still work and start the study run). The preview setting moved to the Study Properties.

Info 1: If you are using Nginx with JATOS you might have to change the location directive for Websockets to "/(jatos/testWebSocket|publix/[a-z0-9-]+/(group/join|batch/open))".

Info 2: The update procedure might take longer than usual depending on the number of workers you currently have stored in your JATOS. The time that the update will take is difficult to estimate but to give an example in one instance 65.000 workers took around 90 minutes to update. You can follow the progress in JATOS' log in logs/application.log.

Try out the new version on cortex.jatos.org.

Changes in 3.7.6

  • Bug fix - Result data not shown in GUI in some cases when using the default embedded H2 database (#272)

Changes in 3.7.5

Info: Depending on your database size the JATOS update procedure can take a couple minutes since some database rows have to be updated. You can check the progress in JATOS log logs/application.log.

  • Download of results - fix some issues (e.g. not working in Firefox) by abandoning StreamSaver.js and use browser-fs-access instead
  • Database performance - Optimize queries (a problem with large databases)
  • GUI / study page - Fix display on wide screens (#261)
  • GUI security - Add Content Security Policy (CSP) headers with nonce for all <scripts>
  • Migrate from Google Sign-In to Google Identity (only if enabled - Google Identity is off by default)
  • Migrate from Scala 2.11 to 2.13 and sbt 0.13 to 1.3
  • Docker: use eclipse-temurin:11-jre-ubi9-minimal instead of openjdk:11-jre
  • jatos.js - add jatos.startComponentByTitle (starts the component by specifying its title)

Changes in 3.7.4

  • Introducing Superuser:
    • Next to Admin a user can now be Superuser: Superusers can access all studies as if they are a member of this study. This includes accessing/deleting result data and changing/deleting the study.
    • Since this new user role is pretty powerful it is turned off by default and can be turned on in the production.conf.
  • Admins can now edit users' name and email
  • Users got a new field 'email'
  • Fix 'Allow preview' bug
  • Fix General Single Worker problem
  • Fix exporting result data for JATOS used with an URL base path
  • GUI / Administration / User Manager - Fix sorting in column 'Studies'
  • GUI / Administration / Study Admin - make study assets size, result data size, result file size calculation configurable in production.conf
  • Check for duplicate Component UUIDs while importing a study
  • Bump dependencies
  • Multi-arch Docker images: provide arm64 and amd64 (#256)

Changes in 3.7.3

  • Better LDAP support
    • Allow multiple base DNs
    • Optionally specify an LDAP admin user for user searching
  • Remove webpack bundling for jatos.js

Changes in 3.7.2

  • Fix "TypeError: cannot use 'in' operator ..." in Firefox with some OSWeb studies
  • Add more logging during update for one-time generation of study links
  • Add "Your result upload files path" to local home screen

Changes in 3.7.1

Study Entry page

Misc

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?

v3.8.1-alpha

1 year ago

For testing purpose only

This version includes the JATOS API.

v3.7.5

1 year ago

If you update a JATOS server from version < 3.7.1

Warning 1: Do not update your JATOS while studies are running. Wait for them until they are finished and then update. Updating while studies are running will break those study runs and result data will probably be lost.

Warning 2: If you are using study links with preview (the ones with ?pre in the URL) - they won't trigger a preview anymore (although they will still work and start the study run). The preview setting moved to the Study Properties.

Info 1: If you are using Nginx with JATOS you might have to change the location directive for Websockets to "/(jatos/testWebSocket|publix/[a-z0-9-]+/(group/join|batch/open))".

Info 2: The update procedure might take longer than usual depending on the number of workers you currently have stored in your JATOS. The time that the update will take is difficult to estimate but to give an example in one instance 65.000 workers took around 90 minutes to update. You can follow the progress in JATOS' log in logs/application.log.

Try out the new version on cortex.jatos.org.

Changes in 3.7.5

Info: Depending on your database size the JATOS update procedure can take a couple minutes since some database rows have to be updated. You can check the progress in JATOS log logs/application.log.

  • Download of results - fix some issues (e.g. not working in Firefox) by abandoning StreamSaver.js and use browser-fs-access instead
  • Database performance - Optimize queries (a problem with large databases)
  • GUI / study page - Fix display on wide screens (#261)
  • GUI security - Add Content Security Policy (CSP) headers with nonce for all <scripts>
  • Migrate from Google Sign-In to Google Identity (only if enabled - Google Identity is off by default)
  • Migrate from Scala 2.11 to 2.13 and sbt 0.13 to 1.3
  • Docker: use eclipse-temurin:11-jre-ubi9-minimal instead of openjdk:11-jre
  • jatos.js - add jatos.startComponentByTitle (starts the component by specifying its title)

Changes in 3.7.4

  • Introducing Superuser:
    • Next to Admin a user can now be Superuser: Superusers can access all studies as if they are a member of this study. This includes accessing/deleting result data and changing/deleting the study.
    • Since this new user role is pretty powerful it is turned off by default and can be turned on in the production.conf.
  • Admins can now edit users' name and email
  • Users got a new field 'email'
  • Fix 'Allow preview' bug
  • Fix General Single Worker problem
  • Fix exporting result data for JATOS used with an URL base path
  • GUI / Administration / User Manager - Fix sorting in column 'Studies'
  • GUI / Administration / Study Admin - make study assets size, result data size, result file size calculation configurable in production.conf
  • Check for duplicate Component UUIDs while importing a study
  • Bump dependencies
  • Multi-arch Docker images: provide arm64 and amd64 (#256)

Changes in 3.7.3

  • Better LDAP support
    • Allow multiple base DNs
    • Optionally specify an LDAP admin user for user searching
  • Remove webpack bundling for jatos.js

Changes in 3.7.2

  • Fix "TypeError: cannot use 'in' operator ..." in Firefox with some OSWeb studies
  • Add more logging during update for one-time generation of study links
  • Add "Your result upload files path" to local home screen

Changes in 3.7.1

Study Entry page

Misc

Previous releases: github.com/JATOS/JATOS/releases

Which variant do I need?