Difference between revisions of "SOLO JATOS server"

From Solowiki
Jump to navigation Jump to search
(Added password reset)
 
(5 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
* SOLO JATOS server GUI: [https://jatos.services.universiteitleiden.nl/ jatos.services.universiteitleiden.nl] <p>'''NOTE: The JATOS GUI can only be accessed from inside the Leiden University intranet, see below.'''</p>
 
* SOLO JATOS server GUI: [https://jatos.services.universiteitleiden.nl/ jatos.services.universiteitleiden.nl] <p>'''NOTE: The JATOS GUI can only be accessed from inside the Leiden University intranet, see below.'''</p>
  
This wiki will be serve as the repository for documentation about the SOLO JATOS server. General knowledge items regarding to [[JATOS]], OpenSesame & OSWeb, jsPsych, etc. will also be added.   
+
This wiki will be serve as the repository for documentation about the SOLO JATOS server. General knowledge items regarding to [[JATOS]], OpenSesame & [[OSWeb]], jsPsych, etc. will also be added.   
  
 
== SOLO JATOS Server Access and Usage ==  
 
== SOLO JATOS Server Access and Usage ==  
Line 50: Line 50:
 
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 [https://helpdesk.universiteitleiden.nl/tas/public/ssp/content/detail/knowledgeitem?unid=d898a649-9ea5-436a-a85d-90d38eefa583 ISSC Helpdesk]. Note that the RDP service is subject to approval by the ISSC and may not be available to everyone.
 
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 [https://helpdesk.universiteitleiden.nl/tas/public/ssp/content/detail/knowledgeitem?unid=d898a649-9ea5-436a-a85d-90d38eefa583 ISSC Helpdesk]. Note that the RDP service is subject to approval by the ISSC and may not be available to everyone.
  
=== Troubleshooting ===
+
== Troubleshooting ==
 
If you cannot access the JATOS GUI, double-check the following:
 
If you cannot access the JATOS GUI, double-check the following:
* Make sure you are navigating to the secure site (include the https): https://remote.campus.leidenuniv.nl/.
+
* If you are getting a '''403 Bad Gateway''' error, you are not on the university network. See above.
* 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 [https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security 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.'''
  
 
== Technical Support ==
 
== Technical Support ==
Line 76: Line 78:
 
== Typical OpenSesame & OSWeb Workflow ==
 
== Typical OpenSesame & OSWeb Workflow ==
  
[https://osdoc.cogsci.nl/manual/osweb/ OpenSesame] is a free and open-source program for developing interactive experiments, and is already in use by various researchers at the FSW. Its latest version includes the [https://osdoc.cogsci.nl/manual/osweb/ OSWeb] plug-in, which allows its experiments to be exported for use with JATOS—albeit with some important caveats. OSWeb does not support all OpenSesame features, and the customary Python-based in-line scripts must be replaced with their JavaScript-based counterparts. Please see the OSWeb [https://osdoc.cogsci.nl/manual/osweb/ documentation] for more information.
+
[https://osdoc.cogsci.nl/manual/osweb/ OpenSesame] is a free and open-source program for developing interactive experiments, and is already in use by various researchers at the FSW. Its latest version includes the [[OSWeb]] plug-in, which allows its experiments to be exported for use with JATOS—albeit with some important caveats. OSWeb does not support all OpenSesame features, and the customary Python-based in-line scripts must be replaced with their JavaScript-based counterparts. Please see the OSWeb [https://osdoc.cogsci.nl/manual/osweb/ documentation] for more information.
  
 
The full OpenSesame to JATOS workflow is explained in great detail in this [https://www.youtube.com/watch?v=-DHAX_EyKlE&list=PLR-r0edywujcBzCPZGQTmZhUSlg8qaR7h YouTube playlist]. Additionally, the OpenSesame website features a very active [https://forum.cogsci.nl/ forum] where enquiries about OSWeb and OpenSesame itself can be posted and browsed through.
 
The full OpenSesame to JATOS workflow is explained in great detail in this [https://www.youtube.com/watch?v=-DHAX_EyKlE&list=PLR-r0edywujcBzCPZGQTmZhUSlg8qaR7h YouTube playlist]. Additionally, the OpenSesame website features a very active [https://forum.cogsci.nl/ forum] where enquiries about OSWeb and OpenSesame itself can be posted and browsed through.
Line 92: Line 94:
 
#* Once the study is online, double-check everything, and distribute it when ready.
 
#* Once the study is online, double-check everything, and distribute it when ready.
 
# '''Finishing up:'''
 
# '''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 contact lab-support to announce that they can be deleted.
+
#* 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.
  
 
== JATOS Alternatives ==
 
== JATOS Alternatives ==
Line 99: Line 101:
 
* [[Pavlovia]] ([https://pavlovia.org/ pavlovia.org])
 
* [[Pavlovia]] ([https://pavlovia.org/ pavlovia.org])
  
Please enquire via: [mailto:labsupport@fsw.leidenuniv.nl labsupport@fsw.leidenuniv.nl].
+
Please see the [[Online studies]] page, or enquire via: [mailto:labsupport@fsw.leidenuniv.nl labsupport@fsw.leidenuniv.nl].
  
 
== JATOS Showcase ==  
 
== JATOS Showcase ==  

Latest revision as of 12:00, 15 June 2020

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:

This wiki will be serve as the repository for documentation about the SOLO JATOS server. General knowledge items regarding to JATOS, OpenSesame & OSWeb, jsPsych, etc. will also be added.

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.

Requesting Access

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 labsupport@fsw.leidenuniv.nl 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:

    [<department>] <main researcher name> - <study name>

    E.g.: [COG] John Doe - Online Study 1.
  • 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.

Password Reset

If you lost your JATOS password, you can request it be reset by mailing labsupport@fsw.leidenuniv.nl.

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.

Citrix

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.

RDP

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.

Troubleshooting

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.

Technical Support

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 labsupport@fsw.leidenuniv.nl 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:

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 privacy@fsw.leidenuniv.nl.

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

OpenSesame is a free and open-source program for developing interactive experiments, and is already in use by various researchers at the FSW. Its latest version includes the OSWeb plug-in, which allows its experiments to be exported for use with JATOS—albeit with some important caveats. OSWeb does not support all OpenSesame features, and the customary Python-based in-line scripts must be replaced with their JavaScript-based counterparts. Please see the OSWeb documentation for more information.

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:

  1. Contact SOLO Lab-support:
    • It is recommended that you contact SOLO lab-support (labsupport@fsw.leidenuniv.nl) 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.
  2. 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.
  3. 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.
  4. 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
  5. Run the study:
    • Once the study is online, double-check everything, and distribute it when ready.
  6. 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.

JATOS Alternatives

SOLO may also be able to provide access and support for the following online research platforms:

Please see the Online studies page, or enquire via: labsupport@fsw.leidenuniv.nl.

JATOS Showcase

Examples showing the various JATOS features (taken from the JATOS site):