Upgrades

This page describes how to upgrade from an existing dms+ version to a newer version.

Docker

Upgrading to a newer version of the dms+ application with docker is pretty easy:

All you need to do is to change the release tags of the images for the app and the scanner containers in the docker-compose.yml that you use to start-up the docker containers:

...
services:  

  # OCR utility
  scanner:
      image: dl0pes/dmsocr:1.1.2
      container_name: scanner
      ...

  # webapp
  app:
      image: dl0pes/dmsweb:1.1.2
      container_name: app
      ...

Afterwards you simply need to restart the docker containers with the following script that automatically handles all necessary docker commands for you:

sh ./dms-restart.sh

CAUTION: since the docker containers for the app and the webserver share one and the same docker volume in order to access the PHP files and static resources, these files would normally NOT be updated during startup of these docker containers. Therefore, it is currently necessary to delete the docker volume in between the shutdown and startup of the app and webserver docker containers. The dms-restart.sh script takes care of this. So, if you run the docker-compose commands manually (for whatever reason), please keep in mind to also run docker volume rm {DOCKER_VOLUME_NAME} in between the shutdown and startup

other

HINT: A reliable description for upgrading to a newer version of dms+ without docker cannot be provided yet - mostly because this has not been thoroughly tested. Brave enough users can try out the given explanation in this section. Feedback is welcome :)

Basically you should be able to just download your desired release from the release overview and overwrite your existing LARAVEL_HOME and SCANNER_HOME directories (assuming you haven't renamed those directories they should be named laravel and scanner in the directory you have placed the application).

CAUTION: remember to re-apply any additional changes that you have made to the upgraded files.