SOLO JATOS server
SOLO makes a JATOS instance available at no cost to researchers, and can offer limited technical support in building and running JATOS studies, as well as post-processing the data it generates. This page includes important information specific to this SOLO JATOS server, which can be accessed via:
- SOLO JATOS server GUI: jatos.services.universiteitleiden.nl
NOTE: The JATOS GUI can only be accessed from inside the Leiden University intranet, see below.
SOLO JATOS Server Access and Usage
This document uses the JATOS nomenclature, where people granted access to JATOS through an account created for them by a JATOS Admin, are referred to as Users. These users can log into JATOS to manage their studies and data. In contrast, Participants are people who take part in the studies uploaded to JATOS, but have otherwise no access to the platform. SOLO will function as the admin.
SOLO makes a JATOS server available at no cost to researchers on staff at the Psychology and Pedagogy institutes at the Faculty of Social and Behavioural Sciences at the Leiden University. To request a user account, please send an email to firstname.lastname@example.org and include the following information:
- Full name and email address of main researcher or supervisor, and their research unit (e.g. COG, S&O, GMN, KLIN, etc.).
- Name and description of the study, or studies, that the user(s) intend to run on the server.
- Full name and email of all users that require access to JATOS for the purpose of running the study/studies. Also state each user’s involvement with the aforementioned institutes (BSc/MSc/PhD student, RA, post-doc, etc.).
- Estimated start and end-date of required JATOS access, per user.
Depending on the use-case, demonstrable technical proficiency with the JATOS platform may be a prerequisite for access. The required aptitude can be gained by reading the JATOS documentation, understanding its key concepts, and then building a study and testing it in your own local JATOS server. The measures described in the “GDPR and Data Security” section below will be rendered ineffective if users don’t grasp certain key concepts about how JATOS handles its data.
JATOS Usage Guidelines
When using the SOLO JATOS server, the following rules must be observed:
- Change your JATOS password immediately upon reception.
- Accounts are strictly personal.
- After a new study has been imported or created, change its title so that it complies with the following naming convention:
E.g.: [COG] John Doe - Online Study 1.
[<department>] <main researcher name> - <study name>
- In the comments section of the study properties, add the expected start and end dates of the study.
Note that SOLO will occasionally inspect the server for expired studies, and remove them once it has been verified that they have indeed finished and that the data have been exported.
If you lost your JATOS password, you can request it be reset by mailing email@example.com.
Accessing the JATOS GUI
For security reasons, the JATOS GUI can currently only be accessed from within the Leiden University intranet. Studies, however, can be run by anyone with access to the internet. Attempting to navigate to jatos.services.universiteitleiden.nl from outside the university network will result in a 403 Bad Gateway error.
To access the JATOS GUI, navigate to the server using:
- a virtual browser in the Remote Workplace (i.e. Citrix).
- a browser on your own university PC, accessed via Remote Desktop Protocol (RDP).
- a browser on any ISSC-issued PC or laptop connected to the university network.
The JATOS GUI can be accessed through a virtual browser in Citrix by going to remote.campus.leidenuniv.nl, opening the "Google Chrome via Citrix" application. Note that running a study in the Citrix browser has been observed not to work correctly. Instead, only use the Citrix browser to manage the study, and run it in your native browser. This can be done by generating a General Multiple Worker, copying the link and opening the link in a native browser on your PC. If you are using the lightweight Citrix application (inside your native browser), you can copy to your device by clicking the Citrix icon (top center) and going to the Clipboard.
University staff can remotely gain control of their own personal work PCs using the Remote Desktop Protocol (RDP). Through RDP, the JATOS GUI can be accessed normally. For more information about RDP, please visit refer to the ISSC Helpdesk. Note that the RDP service is subject to approval by the ISSC and may not be available to everyone.
If you cannot access the JATOS GUI, double-check the following:
- If you are getting a 403 Bad Gateway error, you are not on the university network. See above.
- Make sure you are navigating to the secure site (include the https://): https://jatos.services.universiteitleiden.nl. If the https:// is omitted on the first visit, your browser will not find the site.
The latter is due to the HSTS setting of the server. This also holds when accessing studies; as such, it is vitally important to include the https:// part when distributing JATOS links.
Limited technical support for using JATOS, building JATOS-compatible experiments, and post-processing its data output can be provided by SOLO, but only to researchers on staff at the FSW; absolutely not to BSc or MSc students. Please email firstname.lastname@example.org to enquire about support, to express possible future interest in using JATOS, or to discuss alternative arrangements.
For technical support regarding the platforms listed below, information about their interfacing features, and the extent to which your institute has access to them, please contact their respective support units:
- SONA: email@example.com
- Prolific:Please contact you department’s research coordinator.
GDPR and Data Security
All studies conducted using the JATOS server must comply with the relevant regulations and guidelines; including, but not limited to, those regarding GDPR, Informed Consent, etc. In addition, all studies must be officially approved by the concerning authorities—ethical, medical and/or otherwise—before going public. Questions regarding these matters can be sent to firstname.lastname@example.org.
The JATOS server is maintained by the ISSC, and is physically located in The Netherlands. The data are backed-up regularly in an encrypted fashion, and all data are stored in compliance with the security regulations of Leiden University. Both participants and users communicate with the JATOS server exclusively through a secure internet connection (https).
Within JATOS, users only have access to studies that they have explicitly been made are members of. After a study has finished, and SOLO has confirmed that the data have been downloaded and secured, the study and all its data will be removed from the server. Accounts of users that are then no longer members of any other studies will also be removed.
The server is currently running JATOS version 3.5.4, which was the latest stable release version at the time of installation. SOLO and the ISSC will perform updates and/or maintenance to JATOS and/or its dependencies when they see fit, especially with regards to security patches. Users will be informed beforehand about possible downtime, and about expected consequences for ongoing studies.
Typical OpenSesame & OSWeb Workflow
The full OpenSesame to JATOS workflow is explained in great detail in this YouTube playlist. Additionally, the OpenSesame website features a very active forum where enquiries about OSWeb and OpenSesame itself can be posted and browsed through.
The following is a standard workflow for developing and deploying a study on the SOLO JATOS server:
- Contact SOLO Lab-support:
- It is recommended that you contact SOLO lab-support (email@example.com) as soon as possible to announce your intention to use the JATOS server and describe your plans. This way, lab-support can send you relevant information and inform you about issues they might foresee you encountering.
- Build OpenSesame experiment:
- Familiarize yourself with OpenSesame and its OSWeb-plugin. Then build your experiment and test it out in your own browser using the OSWeb test feature.
- Test experiment on local JATOS server:
- Download and install a local JATOS test server, as described here. Read all relevant JATOS documentation, export the OpenSesame experiment for use in JATOS and upload it to your local JATOS server. Test the experiment thoroughly, and pay extra attention to the integrity of the data-saving process and the manner in which you wish to distribute your study once public. Once all functionality has been validated, export your study from the local JATOS server.
- Upload the experiment to the SOLO JATOS server:
- Request your account(s) for the SOLO JATOS server, as described previously, then upload the study you exported from your local JATOS server
- Run the study:
- Once the study is online, double-check everything, and distribute it when ready.
- Finishing up:
- Once data collection has been completed, and the data downloaded and secured, remove the study from the server. When user accounts are no longer needed, please delete them.
SOLO may also be able to provide access and support for the following online research platforms:
Examples showing the various JATOS features (taken from the JATOS site):