Edit me

Updating the server instance is equivalent to doing it locally, but make sure that you know what you’re doing; especially if you have paired JATOS with a MySQL database.

To be absolutely safe you can install the new JATOS version and keep the old one untouched. This way you can switch back if something fails. Just remember that only one JATOS can run at the same time.

Note: If you are using a MySQL database and to be on the safe side in case something goes wrong, make a backup of your MySQL database. Dump the database using mysqldump -u yourUserName -p yourDatabaseName > yourDatabaseName.out.

As with updating of a local JATOS installation you can do it automatically or manually.

After updating you can check the new JATOS installation with the test page my-address/jatos/test in the browser. All tests should be OK.

Automatic Updating

This is the easiest way but is only available since JATOS 3.3.5. Then it’s the same as in a local installation.

Manual Updating

You have two ways to update manually: 1) Keep your studies but discard all your result data and batches. 2) Keep everything, including your studies and result data (might not always be possible).

First option: quick and dirty (discarding result data)

You can just follow the update instructions for the local installation. If you use a mySQL database don’t forget to configure it with a clean and new one (not the one from your old JATOS). Do not use the new JATOS with the old MySQL database unless you choose to keep your data, as described below.

Second option: keeping everything

This means that we have to configure the MySQL database or copy the H2 database files.

  1. Stop the old JATOS using ./loader.sh stop
  2. Copy the new JATOS version to your server, e.g. copy it into the same folder where your old JATOS is located. Don’t yet remove the old JATOS instance.
  3. Unzip the new JATOS (unzip jatos-x.x.x-beta.zip)
  4. From the old JATOS installation copy your assets root folder to the new JATOS installation (Note: By default your assets root folder is called study_assets_root and lays in the JATOS folder but you might have changed this.
  5. Database
    • H2 - If you are using the default H2 database: From your the folder of your old JATOS installation copy the folder database to the new JATOS installation. Remember to stop JATOS before copying the folder.
    • MySQL - For MySQL you don’t have to change anything on the database side.
  6. From the old JATOS installation copy the folder study_logs to the new JATOS installation
  7. Configure the new JATOS like the old one - usually it’s enough to copy the production.conf from the old conf folder into the new one
  8. Start the new JATOS using ./loader.sh start
  9. Open JATOS’ test page in a browser /jatos/test and test that everything is OK