INSTALLATION. ecomailz Version (donnie)

Transkript

1 INSTALLATION

2 Impressum ecomailz Version: (donnie) Handbuch Version: 02 (21. Dezember 2017) Sprache: DE Ersteller / Urheber: ecodms GmbH c 2017 Salierallee 18a Aachen Deutschland Webseite: info@ecodms.de Telefon: Sitz der Gesellschaft: Aachen Registergericht: Amtsgericht Aachen Geschäftsführung: Dipl.-Betrw. Michael Schmitz Helge Lühmann Wichtige Informationen Dieses von der Firma ecodms GmbH bereitgestellte Benutzerhandbuch ist urheberrechtlich geschützt. Jegliche Verwendung von Texten und Abbildungen, insbesondere des Nachdrucks, die der Übersetzung oder des Einstellens in elektronische Systeme im Ganzen oder in Auszügen bedarf der vorherigen, schriftlichen Genehmigung durch die Firma ecodms GmbH, Salierallee 18 a, Aachen. Auf die etwaige Strafbarkeit urheberrechtswidrigen Handelns wird hingewiesen. KEINE GARANTIE. Alle technischen Angaben und Programmdarstellungen in diesem Benutzerhandbuch wurden mit größter Sorgfalt erarbeitet. Trotzdem sind Fehler nicht ganz auszuschließen. Die Firma ecodms GmbH sieht sich daher gezwungen, darauf hinzuweisen, dass weder eine Garantie, noch die juristische Verantwortung oder irgendeine Haftung für Folgen, die auf fehlerhafte Angaben zurückgehen, übernommen werden kann. Für Verbesserungsvorschläge und Hinweise auf Fehler ist die Autorin dankbar.

3 Inhaltsverzeichnis 3 Inhaltsverzeichnis 1 Systemvoraussetzungen ecomailz-komponente Standard-Installationen Datenverzeichnis Virtuelle Maschinen Network Attached Storage (NAS) ecomailz-webclient Internetbrowser Betriebssysteme MS Office Addin (Outlook) ecomailz Thunderbird Addon ecomailz-plugin für ecodms Windows Wichtige Update Informationen Installation ecomailz-komponente Deinstallation Deinstallation - Grundlagen ecomailz-komponente Linux Distributionen Installation Installation - Grundlagen Editor installieren apt-quellen einrichten ecomailz-komponente Deinstallation ecomailz-komponente NAS: Synology, Docker Synology Installation Installieren & Öffnen von Docker Suchen & Installieren des ecomailz Images Container erstellen Container Einstellungen Mountpfade einrichten Container starten QNAP Installation Installieren & Öffnen von ContainerStation Suchen & Installieren des ecomailz Images Container Einstellungen Mountpfade einrichten Container starten Plugins & Addons Installation Alle BS: ecomailz Thunderbird Addon Windows: MS Office Addin (Outlook)Windows Windows: ecomailz-plugin für ecodms Linux: ecomailz-plugin für ecodms

4 Inhaltsverzeichnis Deinstallation Alle BS: ecomailz Thunderbird Addon Windows: MS Office Adddin (Outlook) Windows: ecomailz-plugin für ecodms Linux: ecomailz-plugin für ecodms

5 1. Systemvoraussetzungen 5 1 Systemvoraussetzungen Bitte beachten Sie vor der Installation unbedingt die Systemvoraussetzungen. Weitere Informationen und Details finden Sie unter ecomailz-komponente Lesen Sie hier die technischen Voraussetzungen für ecomailz Standard-Installationen Betriebssysteme: Windows 10 Windows Server 2012 R2, 2016 Ubuntu LTS (demnächst verfügbar) Debian stretch Systemkern: 64 bit (ecomailz unterstützt die modernen 64-bit-Systeme) Prozessor: mind. 2 Cores oder mind. 2 Prozessoren Arbeitsspeicher: mind. 4 GB Festplattenspeicher: ca. 500 MB für die Komponente zzgl. Speicher für die Archivdaten Datenverzeichnis Das Datenverzeichnis muss auf einer lokalen Festplatte liegen. Netz oder NAS-Laufwerke (Share-Verzeichnisse) werden nicht unterstützt Virtuelle Maschinen Sollte eine virtuelle Maschine eingesetzt werden, muss es sich hierbei unbedingt um eine Hardware Virtual Machine (HVM) handeln. Es werden keine PV unterstützt (Paravirtualization) Network Attached Storage (NAS) ecomailz kann auf einem NAS der Marken QNAP und Synology installiert werden. Das System unterstützt hierbei jene Gerätetypen, die eine Virtualisierung von Containern via Docker erlauben. Nicht alle Modelle der Synology und QNAP Reihe unterstützen Docker. Sollten Sie die aktuellste Version der Synology / QNAP Software installiert haben und Docker nicht vorfinden, gehört das von Ihnen genutzte Modell leider nicht dazu. Die Download Quelle und Installation ist im ecomailz- Installationshandbuch beschrieben. Ein direkter Download der Komponenten über die ecodms Webseite ist daher nicht gegeben. Die Installation von ecomailz erfolgt jeweils über die speziell für die beiden NAS-Systeme bereitgestellten Docker- Images. Bei einem solchen "Image" handelt es sich um eine Vorlage zur Erstellung des entsprechenden ecomailz-containers. Hardware: QNAP & Synology System: Docker Unterstützung (Virtualisierung) Prozessor: X86 Arbeitsspeicher: mind. 4 GB RAM (erforderlich) Eigenschaften: Die QNAP ContainerStation integriert die Virtualisierungstechnologien LXC (Linux Container) und Docker. Sie ermöglicht so die Bedienung mehrerer isolierter Linux-Systeme auf einem QNAP NAS. Bei Synology kann Docker über das Paket-Zentrum installiert werden.

6 1. Systemvoraussetzungen ecomailz-webclient Lesen Sie hier die technischen Voraussetzungen für den ecomailz-webclient Internetbrowser Der ecomailz-webclient läuft in folgenden Internetbrowsern: Google Chrome: ab Version 59 Firefox: ab Version 54 Safari: ab Version Microsoft Edge: ab Version Betriebssysteme In Kombination mit den unterstützten Internetbrowsern kann der ecomailz-webclient unter folgenden Betriebssystemen zum Einsatz kommen: Desktop: Windows 10 Windows Server 2012 R2, 2016 Ubuntu LTS Debian stretch Mobile: ab Android 7.0 ab ios MS Office Addin (Outlook) Lesen Sie hier die technischen Voraussetzungen für das MS Office Addin von ecomailz. Betriebssysteme: Windows 10 Windows Server 2012 R2, 2016 Systemkern: 64 bit Office Versionen: 2010, 2013, 2016 Programme: Microsoft Outlook Information: Das Addin benötigt.net Framework 4 Client Profile 1.4 ecomailz Thunderbird Addon Lesen Sie hier die technischen Voraussetzungen für das ecomailz Thunderbird Addon. Thunderbird Versionen: ab Version Programme: Thunderbird 1.5 ecomailz-plugin für ecodms Lesen Sie hier die technischen Voraussetzungen für das ecomailz-plugin für ecodms. Betriebssysteme: Windows 10 Windows Server 2012 R2, 2016 Ubuntu LTS Debian stretch Systemkern: 64 bit (ecomailz unterstützt die modernen 64-bit-Systeme) ecodms-programme: ecodms Version (eleanor) ab Build & ecodms PDF/A-Drucker Version (eleanor) ab Build Information: Die Vorlesen-Funktion steht im Plugin nicht zur Verfügung.

7 2. Windows 7 2 Windows In diesem Kapitel werden die notwendigen Schritte einer Installation und Deinstallation der verfügbaren ecomailz-komponenten unter Windows beschrieben. Darüber hinaus gibt es hier wichtige Informationen zu den einzelnen Prozessen. 2.1 Wichtige Update Informationen Bitte beachten Sie vor einem Update unbedingt die folgenden Informationen: Sofern Sie den als Standard hinterlegten Ordner für die automatische Datensicherung hinterlegt haben, müssen Sie bei einem Update von einer ecomailz Version, früher als Build 1.0.2, auf eine neuere ecomailz Version, das Backup neu konfigurieren. 2.2 Installation Im Folgenden erfahren Sie wichtige Informationen zur Installation der verfügbaren ecomailz-komponenten. Außerdem werden die Schritte zur Durchführung einer Installation unter Windows beschrieben ecomailz-komponente Mit der ecomailz-installationsdatei können Sie alle notwendigen Basis-Komponenten des Systems installieren. Das Paket richtet das erforderliche Container-Speichersystem und den dazugehörigen Webclient ein. Bitte beachten Sie: ecomailz kann in deutscher und englischer Sprache installiert werden. Die Sprache der Installation ist abhängig von den hinterlegten Spracheinstellungen Ihres Betriebssystems. Diese erkennt das Installationsprogramm automatisch. 1. Wenn es sich bei dieser Installation um ein Update handelt, stoppen Sie bitte zunächst jegliche Verbindungen zu ecomailz. 2. Laden Sie die Datei für den "ecomailz-installer" auf ecodms.de herunter. 3. Sofern es sich bei dieser Datei um eine ZIP-Datei handelt, entpacken Sie diese zunächst. 4. Führen Sie nun die Installationsdatei "...exe" aus. 5. Sollte ecomailz bereits installiert sein, werden Sie vom Installer aufgefordert das Update mit einem Klick auf "Ja" zu bestätigen.

8 2. Windows 8 Abb. (ähnlich) 2.1: ecomailz installieren - Update Information 6. Je nach Systemumgebung zeigt Windows im Laufe der Installation eine Sicherheitsabfrage der "Benutzerkontensteuerung" an. Bestätigen Sie die Meldung, dass das folgende Programm Änderungen an diesem Computer vornehmen darf, mit "Ja". Abb. (ähnlich) 2.2: ecomailz installieren - Sicherheitsabfrage von Windows 7. Der ecomailz-einrichtungsassistent wird gestartet. Klicken Sie im "Willkommens-Fenster" auf "Weiter".

9 2. Windows 9 Abb. (ähnlich) 2.3: ecomailz installieren - Startbildschirm 8. Wählen Sie das Installationsverzeichnis für das ecomailz-system und klicken Sie anschließend auf "Weiter". a) Der vorgeschlagene Ordner kann optional mit einem Klick auf "Durchsuchen" bzw. "..." geändert werden. Abb. (ähnlich) 2.4: ecomailz installieren - Installationsverzeichnis auswählen 9. Wählen Sie das Verzeichnis, in dem ecomailz die archivierten s speichern soll und wählen Sie den Port für die dazugehörige Webanwendung (Webclient). Bestätigen Sie Ihre Eingabe mit einem Klick auf "Weiter". a) Beim Datenverzeichnis handelt sich um den Zielpfad für das Container-Speichersystem. Bei einer Standardinstallation sollte das vorgegebene Verzeichnis nicht geändert werden. Der vorgeschlagene Ordner kann optional mit

10 2. Windows 10 einem Klick auf "Durchsuchen" bzw. "..." geändert werden. b) Bei Bedarf können Sie den vorgeschlagenen Port überschreiben. Der als Standard hinterlegte Port lautet: 8888 Abb. (ähnlich) 2.5: ecomailz installieren - Datenverzeichnis auswählen 10. Lesen Sie die Lizenzbestimmungen aufmerksam durch und bestätigen Sie diese mit einem Häkchen im Feld "Ich akzeptiere die Lizenzvereinbarung". Klicken Sie zum Fortfahren auf "Weiter". Abb. (ähnlich) 2.6: ecomailz installieren - Lizenzbestimmungen (EULA)

11 2. Windows Wählen Sie den Ordner im Startmenü, in dem die Verknüpfungen zur Anwendung erstellt werden sollen. Sie können einen Namen angeben um einen neuen Ordner anzulegen. Klicken Sie zum Fortfahren auf "Weiter". Abb. (ähnlich) 2.7: ecomailz installieren - Verknüpfung im Startmenü 12. ecomailz ist nun bereit zur eigentlichen Installation. Starten Sie diese mit einem Klick auf "Weiter". Der Installationsprozess kann etwas Zeit in Anspruch nehmen. Abb. (ähnlich) 2.8: ecomailz installieren - Bereit zur Installation 13. Die Installation wird durchgeführt. Dieser Vorgang kann etwas dauern.

12 2. Windows 12 Abb. (ähnlich) 2.9: ecomailz installieren - Installationsprozess 14. Die Installation ist nun abgeschlossen. Klicken Sie auf "Abschließen" um den ecomailz-assistenten zu beenden. Abb. (ähnlich) 2.10: ecomailz installieren - Installation abgeschlossen 15. Über Ihren Standard-Internetbrowser wird die Anmeldeseite von ecomailz geladen. Hier können Sie sich anmelden. a) Sofern es sich um die erste Anmeldung nach einer frischen ecomailz-installation handelt, finden Sie die Zugangsdaten vom Super-User (Standard-Benutzer) im ecomailz-handbuch im Kapitel "Zugangsdaten". b) Im ecomailz-handbuch sind darüber hinaus die Einrichtung und Nutzung des Systems beschrieben.

13 2. Windows 13 Abb. (ähnlich) 2.11: ecomailz - Anmeldeseite vom Webclient 2.3 Deinstallation Im Folgenden erfahren Sie wichtige Informationen zur Deinstallation der verfügbaren ecomailz-komponenten. Außerdem werden die Schritte zur Durchführung einer Deinstallation unter Windows beschrieben Deinstallation - Grundlagen Bitte beachten Sie vor einer Deinstallation die folgenden Informationen: 1. Mit der Deinstallation der ecomailz-komponente werden alle gespeicherten Datenbestände unwiderruflich gelöscht. Dieser Vorgang kann nicht mehr rückgängig gemacht werden. a) Eine Wiederherstellung der Daten setzt eine Neuinstallation von ecomailz und das anschließende Einspielen einer sauberen und vollständigen Datensicherung voraus. 2. Achten Sie darauf, dass kein Benutzer mit ecomailz verbunden ist und ggf. installierte Mailclient-Plugins deaktiviert sind ecomailz-komponente Nachfolgend wird die Deinstallation der verfügbaren ecomailz-komponenten unter Windows beschrieben. 1. Beenden Sie bitte zunächst alle ecomailz-verbindungen und stellen Sie sicher, dass kein Benutzer mit dem System arbeitet. 2. Öffnen Sie in der Windows-Systemsteuerung die Oberfläche zur Deinstallation installierter Software ("Programm deinstallieren"). 3. Wählen Sie die Software "ecomailz" mit einem Doppelklick aus der Liste installierter Programme aus. 4. Der Assistent für die Deinstallation wird gestartet. Dieser Vorgang kann etwas dauern. 5. Wählen Sie die Funktion "Alle Komponenten entfernen" aus und bestätigen Sie Ihre Auswahl mit einem Klick auf "Weiter".

14 2. Windows 14 Abb. (ähnlich) 2.12: ecomailz deinstallieren - Startbildschirm 6. ecomailz ist nun bereit für die Deinstallation. Starten Sie diese mit einem Klick auf "Deinstallieren" oder brechen Sie den Vorgang mit einem Klick auf "Abbrechen" ab. a) Bitte beachten Sie, dass mit der Deinstallation der ecomailz-komponente unter Windows der gesamte Datenbestand von ecomailz gelöscht wird. Es werden sowohl die ecomailz-komponente als auch die Container mit allen archivierten Dateien gelöscht. Eine Wiederherstellung der Daten ist anschließend nur noch möglich, wenn Sie vor der Deinstallation ein vollständiges und sauberes Backup erstellt haben. Abb. (ähnlich) 2.13: ecomailz deinstallieren - Wichtige Informationen

15 2. Windows Je nach Systemumgebung öffnet sich nun von Windows eine Sicherheitsabfrage der "Benutzerkontensteuerung". Bestätigen Sie die Meldung, dass das folgende Programm Änderungen an diesem Computer vornehmen darf, mit "Ja". Abb. (ähnlich) 2.14: ecomailz deinstallieren - Sicherheitsabfrage von Windows 8. Die Deinstallation wird ausgeführt. Dieser Vorgang kann etwas dauern. Abb. (ähnlich) 2.15: ecomailz deinstallieren - Deinstallationsprozess 9. Die Deinstallation ist nun abgeschlossen. Die ecomailz-komponente wurde von Ihrem System entfernt. Beenden Sie den Deinstallationsassistenten mit einem Klick auf "Abschließen".

16 2. Windows 16 Abb. (ähnlich) 2.16: ecomailz deinstallieren - Deinstallation abgeschlossen 10. Wenn Sie das System anschließend neu installieren möchten, sollten Sie den Computer zunächst neu starten.

17 3. Linux Distributionen 17 3 Linux Distributionen In diesem Kapitel werden die notwendigen Schritte einer Installation und Deinstallation der verfügbaren ecomailz-komponenten unter den unterstützten Linux Distributionen beschrieben. Darüber hinaus gibt es hier wichtige Informationen zu den einzelnen Prozessen. 3.1 Installation Nachfolgend wird die Installation der verfügbaren ecomailz-komponenten unter Linux-Distributionen beschrieben Installation - Grundlagen Bitte beachten Sie vor der Installation die folgenden Informationen: Erstellen Sie vor einem Update / Upgrade unbedingt ein Backup. Bei einem einfachen Update des gleichen Major-Releases können Sie die Software einfach drüber installieren. Es müssen stets alle Komponenten aktualisiert werden. Bitte beachten Sie, dass die ecomailz Pakete für Ubuntu und Debian ausschließlich für 64 Bit Systeme zur Verfügung stehen Editor installieren Um die ecomailz-komponenten installieren zu können, benötigen Sie einen Editor. Diesen können Sie wie folgt installieren: 1. Öffnen Sie die Konsole (Terminal) und geben Sie zur Installation von "mcedit" folgenden Befehl ein: sudo apt-get install mc 2. Bestätigen Sie den Befehl mit "Enter". 3. Der Editor wird nun auf Ihrem Gerät installiert. a) Hierbei gelten die Hinweise, Informationen, Lizenzbestimmungen und Systemvoraussetzungen des jeweiligen Herstellers apt-quellen einrichten Bevor Sie die ecomailz-komponenten installieren können, müssen Sie zunächst die notwendigen apt-quellen hinterlegen. Gehen Sie wie folgt vor [deinstallation_neustart, update_information, postgresql_informationen, sprache ]. 1. Öffnen Sie Datei "sources.list" zum Editieren mit folgendem Aufruf: sudo mcedit /etc/apt/sources.list a) Alternativ dazu können Sie auch eine eigene sources-liste für die Installation erstellen: sudo mcedit /etc/apt/sources.list.d/ecomailz.list 2. Fügen Sie folgende Zeile (passend zu Ihrem Betriebssystem) am Ende der Datei ein: a) ecomailz-komponente 64bit / Ubuntu LTS

18 3. Linux Distributionen 18 deb / 64bit / Debian Stretch deb / b) ecomailz-plugin für ecodms 64bit / Ubuntu LTS deb / 64bit / Debian Stretch deb / 3. Speichern Sie die Eingabe mit "F2" 4. Schließen Sie den Editor mit "F10" bzw. "ESC" (abhängig vom Betriebssystem) 5. Importieren Sie den "Key" des "ecodms Repositories": wget -O - sudo apt-key add - 6. Bevor Sie die einzelnen Komponenten installieren können, müssen die Paket-Quellen zunächst aktualisiert werden mit sudo apt-get update ecomailz-komponente Mit dieser Installationsdatei kann die Hauptkomponente vom ecomailz archiv installiert werden. 1. Voraussetzung für diese Installation ist, dass die apt-quellen gemäß der Beschreibung aus diesem Handbuch editiert wurden. 2. Öffnen Sie die Konsole. 3. Installation starten mit sudo apt-get install ecomailz 4. Bestätigen Sie die angezeigten Fragen / Warnungen mit JA, indem Sie jeweils ein J eintippen [...]möchten Sie fortfahren?[...] [...]Diese Pakete ohne Überprüfung installieren?[...] a) Dieser Vorgang kann einige Zeit dauern. 5. Lesen Sie die Lizenzbestimmungen aufmerksam durch und bestätigen Sie diese. a) Mit der Tab-Taste auf "OK" springen und mit "Enter" bestätigen 6. Die Installation wird durchgeführt. Dieser Vorgang kann einige Minuten dauern. 3.2 Deinstallation Nachfolgend wird die Deinstallation der verfügbaren ecomailz-komponenten unter Linux-Distributionen beschrieben ecomailz-komponente Nachfolgend ist die Deinstallation von ecomailz unter Linux-Distributionen beschrieben. 1. Öffnen Sie die Konsole. 2. Führen Sie die Deinstallation mit folgendem Befehl aus: sudo apt-get remove ecomailz

19 4. NAS: Synology, Docker 19 4 NAS: Synology, Docker In diesem Kapitel werden die notwendigen Schritte einer Installation und Deinstallation der verfügbaren ecomailz-komponenten auf den unterstützten Network Attached Storages (NAS) und per Docker-Image beschrieben. Darüber hinaus gibt es hier wichtige Informationen zu den einzelnen Prozessen. 4.1 Synology Installation Nachfolgend wird die Installation der verfügbaren ecomailz-komponente auf einem Synology NAS (Network Attached Storage) beschrieben Installieren & Öffnen von Docker Installieren Sie im Paket Zentrum Ihres Synology-Systems die App "Docker" und öffnen Sie anschließend die Anwendung. Abb. (ähnlich) 4.1: Synology - Docker App installieren Suchen & Installieren des ecomailz Images 1. Suchen Sie in der App Docker im Bereich "Registrierung" nach dem ecomailz Image namens "ecomailz/donnie". 2. Installieren Sie anschließend das Paket, indem Sie a) einen rechten Mausklick auf "ecomailz/donnie" machen und b) dann auf "Dieses Bild herunterladen" klicken. c) Sollten Sie bereits eine Installation durchgeführt haben, muss vor einer Neuinstallation das Lokale Abbild von "ecomailz/donnie" gelöscht werden, da "Docker" anderenfalls das lokale Abbild installiert und zwischenzeitliche Aktualisierungen nicht berücksichtigt.

20 4. NAS: Synology, Docker 20 Abb. (ähnlich) 4.2: Synology - ecomailz Image installieren Abb. (ähnlich) 4.3: Synology - ecomailz Image herunterladen Container erstellen Im nächsten Schritt legen Sie den Container mit Hilfe des Assistenten an. 1. Markieren Sie im im Bereich "Abbild" die ecomailz Datei. 2. Klicken Sie nun auf "Starten" Container Einstellungen 1. Im nächsten Schritt vergeben Sie für den Container einen beliebigen Namen. Abb. (ähnlich) 4.4: Synology - Container Name

21 4. NAS: Synology, Docker Klicken Sie auf "Erweiterte Einstellungen". 3. Wechseln Sie in den Reiter "Port Einstellungen". a) Nun können Sie die "Porteinstellungen" vornehmen. Über diesen Port (Standardport: 8888) ist ecomailz im Internetbrowser ansprechbar Abb. (ähnlich) 4.5: Synology - Erweiterte Einstellungen (Port) 4. Wechseln Sie nun in den Reiter "Volume" Mountpfade einrichten 1. Klicken Sie im Reiter "Volume" auf "Ordner hinzufügen". Abb. (ähnlich) 4.6: Synology - Erweiterte Einstellungen - Ordner hinzufügen 2. Wählen Sie nun den Speicherort für Ihre ecomailz-daten auf dem NAS aus.

22 4. NAS: Synology, Docker 22 Abb. (ähnlich) 4.7: Synology - Erweiterte Einstellungen - Speicherort ecomailz-daten 3. Wichtig hierbei ist, dass a) als Mount-Pfad für das Datenverzeichnis "/srv/data" gewählt und b) die Berechtigungen "Lesen / Schreiben" ausgewählt sind und c) die Gruppe "Administratoren" Lese- und Schreibberechtigungen auf die gewählte Freigabe besitzt. d) Um die Sicherungsfunktion von ecomailz nutzen zu können, richten Sie noch ein Verzeichnis für Backup ein. Der Mount-Pfad lautet: /srv/backup i. Das Backup-Verzeichnis sollte getrennt von den eigentlichen ecomailz-daten liegen und entsprechend gesichert werden. Abb. (ähnlich) 4.8: Synology - Erweiterte Einstellungen - Volume Container starten Nach dem erfolgreichen Erstellen des Containers, kann dieser über die Oberfläche "Docker" im Bereich "Container" gestartet werden. 1. ecomailz ist dann über den gewählten Port (hier: 8888; s. Abschnitt "Container Einstellungen") über die Adresse der Diskstation zu erreichen. Weitere Details zur An- und Abmeldung entnehmen Sie bitte dem ecomailz-handbuch. a) Die Anmeldeseite erreichen Sie über den folgenden Link: b) Beispiel bei lokaler Installation mit Standard-Port:

23 4. NAS: Synology, Docker Beim ersten Start kann es einen Moment dauern, bis der Zugriff auf ecomailz zur Verfügung steht. 4.2 QNAP Installation Nachfolgend wird die Installation der verfügbaren ecomailz-komponente auf einem QNAP NAS (Network Attached Storage) beschrieben Installieren & Öffnen von ContainerStation Installieren Sie im AppCenter Ihres QNAP-Systems die App "ContainerStation" und öffnen Sie anschließend die Anwendung. Abb. (ähnlich) 4.9: QNAP - AppCenter - Installation ContainerStation Suchen & Installieren des ecomailz Images 1. Suchen Sie in der App "ContainerStation" unter "Container erstellen" nach dem ecomailz Image namens "ecomailz/- donnie". 2. Installieren Sie anschließend das Paket mit einem Klick auf "Erstellen". a) Sollten Sie bereits eine ältere Installation durchgeführt haben, muss vor einer Neuinstallation das Lokale Abbild von "ecomailz/donnie" gelöscht werden, da "ContainerStation" anderenfalls das lokale Abbild installiert und zwischenzeitliche Aktualisierungen nicht berücksichtigt.

24 4. NAS: Synology, Docker 24 Abb. (ähnlich) 4.10: QNAP - ContainerStation - ecomailz Image Container Einstellungen 1. Im nächsten Schritt vergeben Sie für den Container einen beliebigen Namen. Abb. (ähnlich) 4.11: QNAP - Container Name vergeben 2. Klicken Sie nun auf "Erweitere Einstellungen". 3. Wählen Sie hier den Punkt "Netzwerk" aus. 4. Nun können Sie die "Porteinstellungen" vornehmen. Über diesen Port (Standardport: 8888) ist ecomailz im Internetbrowser ansprechbar. 8888

25 4. NAS: Synology, Docker 25 Abb. (ähnlich) 4.12: QNAP - Portweiterleitung (Standard) Mountpfade einrichten 1. Wählen Sie nun den Bereich "Freigabe". 2. Wählen Sie im Bereich "Freigabe" den Speicherort für Ihre ecomailz-daten auf dem NAS aus (s. Abbildung). 3. Wichtig hierbei ist, dass a) als Mount-Pfad für das Datenverzeichnis "/srv/data" gewählt und b) die Berechtigungen "Lesen / Schreiben" ausgewählt sind und c) die Gruppe "Administratoren" Lese- und Schreibberechtigungen auf die gewählte Freigabe besitzt. d) Um die Sicherungsfunktion von ecomailz nutzen zu können, richten Sie noch ein Verzeichnis für Backup ein. Der Mount-Pfad lautet: /srv/backup i. Das Backup-Verzeichnis sollte getrennt von den eigentlichen ecomailz-daten liegen und entsprechend gesichert werden. Abb. (ähnlich) 4.13: QNAP - Container - Speicherort 4. Klicken Sie auf "Erstellen", um die Einrichtung abzuschließen.

26 4. NAS: Synology, Docker Container starten Nach dem erfolgreichen Erstellen des Containers, kann dieser über die Oberfläche "ContainerStation" gestartet werden. 1. ecomailz ist dann über den gewählten Port (hier: 8888; s. Abschnitt "Container Einstellungen") über die IP-Adresse der QNAP zu erreichen. Weitere Details zur An- und Abmeldung entnehmen Sie bitte dem ecomailz-handbuch. a) Die Anmeldeseite erreichen Sie über den folgenden Link: b) Beispiel bei lokaler Installation mit Standard-Port: 2. Beim ersten Start kann es einen Moment dauern, bis der Zugriff auf ecomailz zur Verfügung steht.

27 5. Plugins & Addons 27 5 Plugins & Addons In diesem Kapitel werden die notwendigen Schritte einer Installation und Deinstallation der verfügbaren ecomailz-plugins und -Addons beschrieben unter allen unterstützten Betriebssystemen. Die Installation und Deinstallation ist bei allen Betriebssystemen ähnlich. 5.1 Installation Im Folgenden erfahren Sie wichtige Informationen zur Installation der verfügbaren ecomailz-plugins und -Addons Alle BS: ecomailz Thunderbird Addon Mit dieser Installationsdatei können Sie das ecomailz Addon für Thunderbird installieren. Das Addon verbindet ecomailz mit Ihrer -Oberfläche. So können Sie den Archivierungsstatus direkt in Thunderbird überwachen und verschiedene Archivierungseinstellungen vornehmen. Information: Dieses ecomailz-addon kann direkt in Thunderbird über den Addon-Manager eingespielt werden. 1. Laden Sie die Datei für das Thunderbird Addon auf ecodms.de herunter. 2. Sofern es sich bei dieser Datei um eine ZIP-Datei handelt, entpacken Sie diese zunächst. 3. Starten Sie Thunderbird. 4. Klicken Sie auf "Menü - Extras - Addons". Abb. (ähnlich) 5.1: ecomailz-thunderbird-addon installieren: Extras -> Addons 5. Wählen Sie nun im "Addons Manager" die Funktion "Add-on aus Datei installieren...".

28 5. Plugins & Addons 28 Abb. (ähnlich) 5.2: ecomailz-thunderbird-addon installieren: Addon aus Datei installieren 6. Wählen Sie die "XPI-Datei" für das "ecomailzthunderbirdaddon..." aus und klicken Sie auf "Öffnen". Abb. (ähnlich) 5.3: ecomailz-thunderbird-addon installieren: Addon auswählen 7. Bestätigen Sie die Sicherheitsabfrage und starten Sie die Installation mit einem Klick auf "Jetzt installieren".

29 5. Plugins & Addons 29 Abb. (ähnlich) 5.4: ecomailz-thunderbird-addon installieren: Sicherheitsfrage 8. Die Installation ist nun abgeschlossen. Um das Addon endgültig zu aktivieren, muss das Programm neu gestartet werden. Klicken Sie hierzu im Addon Manager auf "Jetzt neu starten". Abb. (ähnlich) 5.5: ecomailz-thunderbird-addon installieren: Neu starten 9. Um mit dem ecomailz-addon in Thunderbird arbeiten zu können, müssen Sie dieses zunächst einrichten. a) Klicken Sie hierzu im Addon-Manager beim ecomailz-addon auf "Optionen".

30 5. Plugins & Addons 30 Abb. (ähnlich) 5.6: ecomailz-thunderbird-addon installieren: Optionen 10. Das System fordert Sie auf, die Verbindungsdaten zu ecomailz einzugeben. Sofern es sich um die erste Anmeldung nach einer frischen ecomailz-installation handelt, finden Sie die Zugangsdaten des Standard-Benutzers im ecomailz- Handbuch im Kapitel "Zugangsdaten". Im ecomailz-handbuch sind darüber hinaus die Einrichtung und Nutzung des Systems beschrieben. a) ecomailz Url: Geben Sie hier den Link zu Ihrem ecomailz-system ein. Der Link besteht i.d.r. aus der IP- Adresse der ecomailz-instanz, dem dazugehörigen Port und den angefügten Informationen zur ecomailz-api. Beispiel bei lokaler Installation mit Standard-Port: b) ecomailz Benutzer: Geben Sie den Benutzernamen Ihres ecomailz-profils / Ihrer in ecomailz hinterlegten -Adresse ein. c) ecomailz Passwort: Geben Sie das zum Benutzer passende Passwort ein. d) Mit einem Klick auf den Testen-Button können Sie Ihre Einstellungen überprüfen. e) Bestätigen Sie Ihre Eingaben mit dem Klick auf "OK" um diese zu speichern oder brechen Sie den Vorgang mit "Abbrechen" wieder ab.

31 5. Plugins & Addons 31 Abb. (ähnlich) 5.7: ecomailz-thunderbird-addon installieren: Einstellungen (hier: Verbindungsdaten bei lokaler Installation) Windows: MS Office Addin (Outlook)Windows Mit dieser Datei kann das MS Outlook Addon von ecomailz installiert werden. Nachfolgend ist die Installation unter Windows beschrieben. 1. Beenden Sie zunächst alle laufenden Office-Programme. 2. Laden Sie die Datei für das "ecomailz Outlook Addin" auf ecodms.de herunter. 3. Sofern es sich bei dieser Datei um eine ZIP-Datei handelt, entpacken Sie diese zunächst. 4. Führen Sie nun die Installationsdatei "...exe" aus. 5. Der Installationsassistent wird gestartet. Klicken Sie im "Willkommens-Fenster" auf "Weiter".

32 5. Plugins & Addons 32 Abb. (ähnlich) 5.8: Outlook Addin installieren - Startbildschirm 6. Wählen Sie das Installationsverzeichnis für das Office-Addin und klicken Sie anschließend auf "Weiter". a) Der vorgeschlagene Ordner kann optional mit einem Klick auf "Durchsuchen" bzw. "..." geändert werden. Abb. (ähnlich) 5.9: Outlook Addin installieren - Installationsverzeichnis auswählen 7. Das Office-Addin ist nun bereit zur eigentlichen Installation. Starten Sie diese mit einem Klick auf "Weiter". Der Installationsprozess kann etwas Zeit in Anspruch nehmen.

33 5. Plugins & Addons 33 Abb. (ähnlich) 5.10: Outlook Addin installieren - Installation bestätigen 8. Die Installation wird durchgeführt. Dieser Vorgang kann etwas dauern. Abb. (ähnlich) 5.11: Outlook Addin installieren - Installationsprozess 9. Die Installation ist nun abgeschlossen. Klicken Sie auf "Abschließen" um den Installationsassistenten zu beenden.

34 5. Plugins & Addons 34 Abb. (ähnlich) 5.12: Outlook Addin installieren - Installation abgeschlossen 10. Nun können Sie die MS Office Programme wieder starten. Beim ersten Start von Outlook nach der Addin-Installation fordert das System Sie auf, die Verbindungsdaten zu ecomailz einzugeben. Sofern es sich um die erste Anmeldung nach einer frischen ecomailz-installation handelt, finden Sie die Zugangsdaten des Standard-Benutzers im ecomailz- Handbuch im Kapitel "Zugangsdaten". Im ecomailz-handbuch sind darüber hinaus die Einrichtung und Nutzung des Systems beschrieben. a) ecomailz Url: Geben Sie hier den Link zu Ihrem ecomailz-system ein. Der Link besteht i.d.r. aus der IP- Adresse der ecomailz-instanz, dem dazugehörigen Port und den angefügten Informationen zur ecomailz-api. Beispiel bei lokaler Installation mit Standard-Port: b) ecomailz Benutzer: Geben Sie den Benutzernamen Ihres ecomailz-profils / Ihrer in ecomailz hinterlegten -Adresse ein. c) ecomailz Passwort: Geben Sie das zum Benutzer passende Passwort ein. d) Mit einem Klick auf den Testen-Button können Sie Ihre Einstellungen überprüfen. e) Bestätigen Sie Ihre Eingaben mit dem Klick auf "OK" oder brechen Sie den Vorgang mit "Abbrechen" wieder ab.

35 5. Plugins & Addons 35 Abb. (ähnlich) 5.13: Outlook Addin installieren - Einstellungen vornehmen Windows: ecomailz-plugin für ecodms Mit dieser Datei kann das ecomailz-plugin für den ecodms-client installiert werden. Nachfolgend ist die Installation unter Windows beschrieben. Um das ecomailz-plugin in ecodms nutzen zu können, benötigen Sie eine gültige Lizenz der aktuellen ecodms-vollversion. Außerdem muss der PDF/A-Drucker von ecodms gemäß der offiziellen Systemvoraussetzungen dieses Plugins installiert sein. Die Installation erfolgt clientseitig und nicht serverseitig. Installieren Sie das Plugin lokal an jedem gewünschten Arbeitsplatz. Um das ecomailz-plugin für ecodms zu installieren, gehen Sie wie folgt vor: 1. Schließen Sie alle ecodms-anwendungen an Ihrem Arbeitsplatz und beenden Sie ebenfalls den ecodms Connection Manager. 2. Laden Sie die Datei für das ecodms-plugin auf ecodms.de herunter. 3. Sofern es sich bei dieser Datei um eine ZIP-Datei handelt, entpacken Sie diese zunächst. a) Das ecodms-plugin von ecomailz besteht aus 2 Dateien. i. ecodmsmailzplugin.edp A. Hierbei handelt es sich um das eigentliche Plugin für ecodms. B. Das Plugin ist standardmäßig in englischer Sprache konfiguriert. ii. ecodmsmailzplugin_de.qm A. Hierbei handelt es sich um die deutsche Sprachdatei für das ecodms-plugin.

36 5. Plugins & Addons Kopieren Sie die Plugin-Datei und -bei deutscher Installation / Nutzung- die deutsche Sprachdatei direkt in das Plugin-Verzeichnis vom ecodms Client auf Ihrem Dateisystem. a) Das Verzeichnis namens "plugins" befindet sich im ausgewählten Zielpfad Ihrer ecodms-client-installation. Zum Beispiel: C:\Program Files\ecoDMS GmbH\ecoDMS Client\plugins Abb. (ähnlich) 5.14: ecomailz-ecodms-plugin installieren - Dateien ins ecodms-plugin-verzeichnis kopieren 5. Das Hinzufügen von Dateien in das ecodms-verzeichnis muss mit Administratorrechten erfolgen. Bestätigen Sie die nachfolgende Sicherheitsabfrage von Windows mit einem Klick auf "Fortfahren". Abb. (ähnlich) 5.15: ecomailz-ecodms-plugin installieren - Dateien ins ecodms-verzeichnis kopieren 6. Die Dateien werden nun in das Verzeichnis kopiert. Dieser Vorgang kann etwas dauern. 7. Jetzt können Sie die Verbindung zum ecodms Server über den Connection Manager wiederherstellen.

37 5. Plugins & Addons Starten Sie nun den ecodms Client um mit dem Plugin zu arbeiten. a) Beim Start des ecodms Clients werden Sie im ecomailz-fenster bereits aufgefordert die notwendige Konfiguration vorzunehmen. b) Sie erreichen den Einstellungsdialog darüber hinaus im ecodms Client über den Menüpunkt "Plugins - eco- MAILZ". i. ecomailz URL: Geben Sie hier den Link zu Ihrem ecomailz-system ein. Der Link besteht i.d.r. aus der IP-Adresse der ecomailz-instanz und dem dazugehörigen Port. Beispiel bei lokaler Installation mit Standard-Port: ii. ecomailz Benutzer: Geben Sie den Benutzernamen Ihres ecomailz-profils / Ihrer in ecomailz hinterlegten -Adresse ein. iii. ecomailz Passwort: Geben Sie das zum Benutzer passende Passwort ein. iv. Bestätigen Sie Ihre Eingaben mit dem Klick auf "OK" oder brechen Sie den Vorgang mit "Abbrechen" wieder ab. Abb. (ähnlich) 5.16: ecomailz-ecodms-plugin installieren - Anzeige in ecodms (Aufforderung zur Konfiguration)

38 5. Plugins & Addons 38 Abb. (ähnlich) 5.17: ecomailz-plugin in ecodms - ecomailz Einstellungen (hier: lokale Installation) Linux: ecomailz-plugin für ecodms Mit dieser Installationsdatei kann das ecomailz-plugin für das ecodms Archiv installiert werden. 1. Voraussetzung für diese Installation ist, dass die apt-quellen gemäß der Beschreibung aus diesem Handbuch editiert wurden. a) Die Beschreibung entnehmen Sie bitte dem Kapitel "Linux Distributionen - Installation". 2. Öffnen Sie die Konsole. 3. Installation starten mit sudo apt-get install ecodmsmailzplugin 4. Bestätigen Sie die angezeigten Fragen / Warnungen mit JA, indem Sie jeweils ein J eintippen [...]möchten Sie fortfahren?[...] [...]Diese Pakete ohne Überprüfung installieren?[...] a) Dieser Vorgang kann einige Zeit dauern. 5. Lesen Sie die Lizenzbestimmungen aufmerksam durch und bestätigen Sie diese. Mit der Tab-Taste auf "OK" springen und mit "Enter" bestätigen 6. Die Installation wird durchgeführt. Dieser Vorgang kann einige Minuten dauern. 5.2 Deinstallation Im Folgenden erfahren Sie wichtige Informationen zur Deinstallation der verfügbaren ecomailz-plugins und -Addons Alle BS: ecomailz Thunderbird Addon Nachfolgend ist die Deinstallation vom ecodms Thunderbird Addon unter den unterstützten Betriebssystemen beschrieben. 1. Starten Sie Thunderbird. 2. Klicken Sie auf "Menü - Extras - Addons".

39 5. Plugins & Addons 39 Abb. (ähnlich) 5.18: ecomailz-thunderbird-addon deinstallieren: Extras -> Addons 3. Wählen Sie nun im "Addons Manager" die Erweiterung "ecomailzthunderbirdaddon" aus und klicken Sie dann auf den Button "Entfernen". Abb. (ähnlich) 5.19: ecomailz-thunderbird-addon deinstallieren: Addon deinstallieren 4. Um die Deinstallation abzuschließen und die Funktion endgültig zu entfernen, muss Thunderbird neu gestartet werden. Klicken Sie hierzu auf "Jetzt neu starten".

40 5. Plugins & Addons 40 Abb. (ähnlich) 5.20: ecomailz-thunderbird-addon deinstallieren: Neu starten Windows: MS Office Adddin (Outlook) 1. Öffnen Sie in der Windows-Systemsteuerung die Oberfläche zur Deinstallation installierter Software ("Programm deinstallieren"). 2. Wählen Sie die Software "ecomailzofficeaddin" mit einem Doppelklick aus der Liste installierter Programme aus. 3. Bestätigen Sie die angezeigte Meldung zum Löschen des Programms mit "Ja". Abb. (ähnlich) 5.21: ecomailz Office Addin deinstallieren - Startbildschirm 4. Das Programm wird deinstalliert und von Ihrem Computer entfernt. Dieser Vorgang kann etwas dauern. Abb. (ähnlich) 5.22: ecomailz Office Addin deinstallieren - Deinstallieren

41 5. Plugins & Addons Windows: ecomailz-plugin für ecodms Um das ecomailz-plugin für ecodms an Ihrem Arbeitsplatz zu deinstallieren, gehen Sie wie folgt vor: 1. Schließen Sie alle ecodms-anwendungen an Ihrem Arbeitsplatz und beenden Sie ebenfalls den ecodms Connection Manager. 2. Öffnen Sie das Plugin-Verzeichnis vom ecodms Client auf Ihrem Dateisystem. a) Das Verzeichnis namens "plugins" befindet sich im ausgewählten Zielpfad Ihrer ecodms-client-installation. Zum Beispiel: C:\Program Files\ecoDMS GmbH\ecoDMS Client\plugins 3. Entfernen Sie nun die folgenden Dateien im Plugin-Verzeichnis: a) ecodmsmailzplugin.edp i. Hierbei handelt es sich um das eigentliche Plugin für ecodms. A. Das Plugin ist standardmäßig in englischer Sprache konfiguriert. ii. ecodmsmailzplugin_de.qm A. Hierbei handelt es sich um die deutsche Sprachdatei für das ecodms-plugin. B. Diese Datei befindet sich nur im Verzeichnis, wenn das Plugin in deutscher Sprache installiert wurde. 4. Das Entfernen von Dateien im ecodms-verzeichnis muss mit Administratorrechten erfolgen. Bestätigen Sie die Sicherheitsabfrage von Windows mit einem Klick auf "Fortfahren". 5. Die Dateien werden nun aus dem Verzeichnis entfernt. Dieser Vorgang kann etwas dauern. 6. Jetzt können Sie den Connection Manager wieder starten und die verfügbaren ecodms-programme nutzen Linux: ecomailz-plugin für ecodms Nachfolgend ist die Deinstallation vom ecomailz-plugin für ecodms unter Linux-Distributionen beschrieben. 1. Öffnen Sie die Konsole. 2. Führen Sie die Deinstallation mit folgendem Befehl aus: sudo apt-get remove ecodmsmailzplugin