In unregelmäßigen Abständen werden neue Updates für ecoDMS veröffentlicht. Betreibt man seine Serverinstallation in einem Docker Container, ist die Aktualisierung nicht ganz ohne. Folgend werden alles notwendigen Schritte beschrieben.
Voraussetzungen
- Installiertes ecoDMS Docker Image (18.09-01)
- Qnap QTS 4.4.1
Kurzanleitung
- INBOX leeren
- ecoDMS Lizenz deaktivieren
- Komplettsicherung der ecoDMS Daten
- Docker Container stoppen
- Docker Container und lokales Image löschen
- Installation des aktuellen ecoDMS Docker Images
- bei der Update-Installation ist zwingend darauf zu achten, das den Mountpfaden die bereits existierenden Ordner auf dem NAS zugewiesen werden
- Aktualisierung aller installierten Komponenten
- ecoDMS Server
- ecoDMS Client
- ecoDMS Drucker
- Plugins (Office, Thunderbird etc.)
- ecoDMS Lizenz aktivieren
Container-Update
- Inbox von ecoDMS leeren (erspart Probleme, falls das Backup auf einem anderen System wiederhergestellt werden soll)
- alle Verbindungen von anderen Benutzern trennen
- Backup über den Client anlegen (im ecoDMS Client –> Optionen – Einstellungen – Einstellungen – Sicherung)
- oder
- manuelles Backup anlegen (Datei „create“ im Backupordner der Installation anlegen, Backup startet automatisch und löscht Datei „create“ wieder)
- prüfen ob Backup im Backupverzeichnis angelegt wurde (zip Datei)
- Lizenz von ecoDMS deaktivieren (im ecoDMS Client –> Optionen – Einstellungen – Einstellungen – Lizenz – Lizenz aktivieren / deaktivieren)
- in meinen Fall kam beim Versuch die Lizenz zu deaktivieren die Fehlermeldung: „Im Ablauf des SSL-Protokolls ist ein Fehler aufgetreten.“ Hier bleibt dann nur die Deaktivierung über den ecoDMS Support. Eine Erklärung zu diesem Fehler wollte man mir nicht geben.
Deaktivierung über den ecoDMS Support: Antrag
- Docker-Container von ecoDMS über die Container Station der Qnap stoppen
- Falls nicht mehr genau klar ist, welche Verzeichnisse bei der Erstinstallation von ecoDMS eingerichtet wurden, sollte man sich diese vor der Löschung des Containers notieren. Dazu klickt man auf die Bezeichnung des Docker Images (1) und gelangt so zu den Einstellungen. Unter Settings gelangt man zu den Advanced Settings, wo man die Speicherpfade der Shared Folders nachschauen kann.
- löschen des ecoDMS Containers (1) und des lokalen Images (2)
- Nicht die Datenordner löschen, nur den Container aus der Container Station!
Installation ecoDMS
Installation Docker Image
- in der Container Station der Qnap geben wir beim Menüpunkt Create im Suchfeld den Begriff ecodms ein.
- ein Klick auf die Lupe zeigt alle gefunden Images an (unter Docker Hub)
- Erscheinen die Suchergebnisse unter Local, wurden nicht alle lokalen Images von ecoDMS gelöscht. Damit wird bei der neuen Installation nicht die aktuellste Version verwendet.
- Über Install starten wir die Installation.
Container Einstellungen
- Im Fenster Create Container können jetzt ein beliebiger Name, sowie die zuzuteilenden Ressourcen der NAS vergeben werden.
- ggf. Command ergänzen:
/opt/ecodms/ecodmsserver/run.sh
- anschließend auf Advanced Settings klicken
- In den Netzwerkeinstellungen werden die Standardports eingetragen:
- Zugriff über Connection Manager
Host: 17001 – Container: 17001 - Zugriff auf Datenbank
Host: 17002 – Container: 17002 - Zugriff auf Weboberfläche
Host: 17004 – Container: 8080 - Zugriff über API
Host 17005 – Container: 8180
Mountpfade einrichten
- Jetzt werden die Datenordner der NAS eingebunden. Sie werden „gemountet“.
- Mit einem Klick auf Create wird eine Zusammenfassung der Einstellungen angezeigt.
- Ein weiterer Klick erstellt das Docker Image.
Update aller Anwendungen
- Im Anschluss sind noch alle restlichen Anwendungen und eventuellen Plugins zu aktualisieren, welche sich im Downloadbereich der jeweiligen Version befinden:
- ecoDMS Client
- ecoDMS PDF/A Drucker
- Thunderbird Erweiterung
- Open/LibreOffice Addon
- MS Office Plugin
Sollten mehrere Dienste auf der NAS eingesetzt werden die schon den Webport 8080 verwenden, empfiehlt sich eine Änderung des Standardports. (z.B. 8082)
Aktivierung der Lizenz
Im letzten Schritt wird die Lizenz von ecoDMS wieder aktiviert. (im ecoDMS Client –> Optionen – Einstellungen – Einstellungen – Lizenz – Lizenz aktivieren / deaktivieren)
Datenwiederherstellung (Restore)
- sollten die Daten nicht wie erhofft übernommen worden sein und eine komplette Neuinstallation notwendig werden, könnt ihr das Backup leicht wiederherstellen
- dies ist ein Auszug aus der Textdatei howto-Backup-restore.txt, die sich im Backup-Ordner von ecodms befindet
Datenwiederherstellung (Restore)
Stellen Sie sicher, dass keine Benutzer mit dem ecoDMS Server verbunden sind / arbeiten. a) Beenden Sie hierzu alle mit dem ecoDMS Server verbundenen Connection-Manager. b) Überprüfen und schließen Sie auch alle ggf. anderen bestehenden Verbindungen zum Server.
Stoppen Sie den ecoDMS Container, sofern dieser noch läuft.
Öffnen Sie in der „File Station“ im ecoDMS Datenverzeichnis den Ordner „restore“.
Kopieren Sie das Backup (erstellt mit “OneClick Backup” oder “ecoDMSBackupConsole”) in den Ordner “restore”
Benennen Sie die Backup Datei in „restore.zip“ um. a) Beachten Sie hierbei unbedingt die Schreibweise (Kleinschreibung).
Starten Sie den ecoDMS Container.
Die Datenwiederherstellung wird durchgeführt. a) Dieser Prozess kann einige Zeit dauern. b) Nach erfolgreicher Durchführung wird die Datei “restore.zip” in “restore-processed.zip” umbenannt. i. Sollte ein Fehler auftreten, wandelt das System die Datei in “restore-failed.zip” um.
Stellen Sie sicher, dass keine Benutzer mit dem ecoDMS Server verbunden sind / arbeiten. a) Beenden Sie hierzu alle mit dem ecoDMS Server verbundenen Connection-Manager. b) Überprüfen und schließen Sie auch alle ggf. anderen bestehenden Verbindungen zum Server.
Stoppen Sie den ecoDMS Container, sofern dieser noch läuft.
Öffnen Sie in der „File Station“ im ecoDMS Datenverzeichnis den Ordner „restore“.
Kopieren Sie das Backup (erstellt mit “OneClick Backup” oder “ecoDMSBackupConsole”) in den Ordner “restore”
Benennen Sie die Backup Datei in „restore.zip“ um. a) Beachten Sie hierbei unbedingt die Schreibweise (Kleinschreibung).
Starten Sie den ecoDMS Container.
Die Datenwiederherstellung wird durchgeführt. a) Dieser Prozess kann einige Zeit dauern. b) Nach erfolgreicher Durchführung wird die Datei “restore.zip” in “restore-processed.zip” umbenannt. i. Sollte ein Fehler auftreten, wandelt das System die Datei in “restore-failed.zip” um.
Probleme
- sollte nach dem Update trotz aktivierter Lizenz immer noch ein Hinweis auf eine abgelaufene Lizenz oder die Verwendung der Community Edition erscheinen, dann einfach den Client schließen und im Connection Manager die Verbindung trennen und neu herstellen, das sollte das Problem lösen
Quellen
- ecoDMS Download alter Versionen
- ecoDMS Installationshandbuch
- ecoDMS Client Handbuch