Update from OpenOlat 10.x.x/11.x.x to the newest OpenOlat 12.y.y

This guide has been designed with our setupguide (PostgreSQL and MySQL) in mind. You should think about the data to backup if you didn't use those guides.

Assumptions

• User is openolat
• Homedirectory is /home/openolat
• Datadirectory is ~/olatdata
• Working directory is ~/webapp (which is a symlink to ~/openolat_10xx or ~/openolat_11xx)
• Logfile directory ~/logs

Upgrade

Preparation

1. Stop Tomcat (~/stop)
2. Backup
   • your olatdata
   • make a database dump
3. Extract OpenOlat.war in the home-location ~/openolat_12yy (unzip -d ~/openolat_12yy PATH/TO/openolat_12yy.war)
4. remove link from last version to webapp (rm ~/webapp)
5. create symlink from new version to webapp (ln -s ~/openolat_12yy ~/webapp)
6. If you have a custom theme, take care of updating it (~/olatdata/customizing/themes/*)

Upgrade

1. Start tomcat (~/start) and look at
   • catalina.out (tail -f ~/logs/catalina.out)
   • olat.log (tail -f ~/logs/olat.log)
   • First startup might take a while because some stuff is updated.
   • Do NOT shutdown until OpenOLAT did the initial startup!
2. Let everybody know you just updated to the newest version of OpenOLAT 12.y.y (twitter, facebook etc)
3. Have a drink and celebrate, but do so responsibly! ;-)