84xto90x


Update from OpenOlat 8.4.x to OpenOlat 9.0.x

When updating from OpenOLAT < 8.2 it is mandatory that you also read the 814xto820 manual and follow the steps from there. If usure, update first to 8.2, then to 8.3, then to 8.4 and then to 9.0

  1. Stop Tomcat
  2. Backup
    • your olatdata, your webapps directory and make a database dump
    • your olat.local.properties file
    • your entire webapps-Directory of OpenOLAT, then delete it
  3. Extract OpenOlat.war in the webapps-location (replace old release)
  4. Run DB-updatescripts
    • manually by executing src/main/resources/database/mysql/alter_8_4_0_to_9_0_0.sql
    • or make sure you have the property auto.upgrade.database=true (recommendet)
  5. Copy your old olat.local.properties file to the new unpacked war (or wherever you have it)
  6. Compare your olat.local.properties with the olat.local.properties.sample and the original olat.properties file
  7. If you have a custom theme copy it over to the new installed release
  8. If you have custom spring configurations, re-apply them on the new code base (do not just copy the old spring files as they might have changed! Use the diff command to compare the old and the new files).
  9. Restart tomcat and look at your console output (e.g. tail -f)
    • First startup might take a while because some stuff is updated.
    • Do NOT shutdown until OpenOLAT did the initial startup!
  10. Let everybody know you just updated to OpenOLAT 9.0 (twitter, facebook etc)
  11. Go get a beer and have fun!