Sie können die Dateivorschau der Kopano WebApp gemäß der dokumentierten Konfiguration aktivieren, ohne ein separates „FileViewer“-Paket installieren zu müssen. MDM hingegen ist ein separates Plugin, das installiert und mit Z-Push verbunden werden muss. Dieser Unterschied ist wichtig: Das WebApp-Administratorhandbuch beschreibt die Vorschau über die Dokumentation ENABLE_FILE_PREVIEWER, während das MDM-Handbuch ein eigenes Paket, eine Konfigurationsdatei und Abhängigkeiten beschreibt. Die Installation des falschen „Dateien“-Add-ons aktiviert die Vorschau nicht.
Dieser Leitfaden richtet sich an Administratoren einer bestehenden Kopano-Webanwendungsinstallation. Die veröffentlichten Handbücher für Kopano-Webanwendungen und MDM sind ältere Dokumentationsversionen. Überprüfen Sie daher vor Änderungen in der Produktionsumgebung, ob die Paketnamen und Einstellungen exakt mit den Versionen Ihrer Webanwendung, PHP, Z-Push und Ihres Betriebssystems übereinstimmen. Die folgenden Schritte erläutern den dokumentierten Pfad und wie Sie diesen sicher überprüfen können.
Meinst du die Dateivorschau oder das Kopano Files-Plugin?
Verwenden Sie die integrierte Dateivorschau, wenn Benutzer unterstützte Dateianhänge in WebApp in der Vorschau anzeigen müssen. Die dokumentierte Administratoroption ist ENABLE_FILE_PREVIEWER[Optionsname einfügen]; sie steuert, ob Benutzern eine Vorschau angeboten wird. Im WebApp-Handbuch wird dies nicht als separates FileViewer-Paket beschrieben, das mit einem Paketmanager installiert wird.
Kopano Files funktioniert anders. Es fügt einen Dateibereich zum Durchsuchen und Verwalten externer Speicherkonten wie WebDAV oder anderer konfigurierter Backends hinzu. Dafür können separate Pakete und eine Backend-Konfiguration erforderlich sein. Wenn Sie Anhänge in der Vorschau anzeigen möchten, beginnen Sie mit den Einstellungen des Vorschauprogramms, nicht mit Kopano Files. Wenn Sie einen freigegebenen Speicher mit der Webanwendung verbinden möchten, folgen Sie der separaten Anleitung zu Files, die am Ende verlinkt ist.
Was leistet MDM und wann ist es sinnvoll?
Das Mobile-Device-Management-Plugin von Kopano stellt Informationen und Aktionen für Mobilgeräte bereit, die über Z-Push mit Kopano synchronisiert werden. Je nach Bereitstellung können Benutzer Gerätedetails anzeigen und Aktionen wie erneutes Synchronisieren, Entfernen, Aktualisieren oder Löschen durchführen. Es ist hilfreich, wenn Benutzer oder Administratoren diese Gerätesteuerung in der Webanwendung benötigen; es ersetzt jedoch nicht Z-Push und richtet die Mobilgerätesynchronisierung nicht selbstständig ein.
Das Kopano MDM-Handbuch nennt Z-Push 2.0 oder höher und PHP-SOAP-Unterstützung als Abhängigkeiten. Läuft Z-Push auf einem anderen Host als die Webanwendung, muss die MDM-Konfiguration auf diesen Z-Push-Server verweisen. Prüfen Sie vor der Installation die Kompatibilität von Z-Push-Endpunkt, installierter PHP-Laufzeitumgebung und Paketen mit Ihrer Umgebung.
Wie aktiviert man die Dateivorschau?
Suchen Sie zunächst die aktive Webanwendung config.phpIhrer Installation. Bei einer paketbasierten Bereitstellung befindet sie sich üblicherweise unter `/etc/webapp/webapp/` /etc/kopano/webapp/, Container und benutzerdefinierte Installationen können die Konfiguration jedoch an einem anderen Ort einbinden. Sichern Sie die Originaldatei, bevor Sie sie bearbeiten, und vermeiden Sie es, eine zweite Definition zu erstellen, falls die Einstellung bereits vorhanden ist.
Suchen Sie in der aktiven Konfiguration nach ENABLE_FILE_PREVIEWER. Das Kopano WebApp-Administratorhandbuch beschreibt true, wie Benutzern die Option angezeigt wird, die Dateivorschau in ihren Einstellungen zu aktivieren, und falsewie diese Option ausgeblendet und die Vorschau für alle Benutzer deaktiviert wird. Zum Beispiel:
define("ENABLE_FILE_PREVIEWER", true);
Existiert die Zeile bereits, ändern Sie ihren Wert, anstatt sie zu duplizieren define(). Die umgebende PHP-Syntax muss beibehalten werden. Falls keine solche Zeile existiert, verwenden Sie die Vorlage oder die Konfigurationsanleitung, die zu Ihrem installierten WebApp-Paket passt, anstatt eine komplette Beispielkonfiguration in die Live-Datei zu kopieren.
Prüfen Sie nach dem Speichern mit dem PHP-Interpreter, der die Webanwendung ausführt, auf PHP-Syntaxfehler. Beispiel: Befindet sich die Konfigurationsdatei im Standardpaketpfad,
php -l /etc/kopano/webapp/config.php
Eine Syntaxprüfung validiert lediglich die PHP-Analyse; sie bestätigt nicht, dass die Einstellung von der laufenden Website geladen wird. Melden Sie sich als Testbenutzer an, öffnen Sie die WebApp-Einstellungen und prüfen Sie, ob die Dateivorschau verfügbar ist. Aktivieren Sie sie, übernehmen Sie die Änderung und öffnen Sie anschließend einen Anhang eines von Ihrer WebApp unterstützten Typs. Falls das Steuerelement fehlt, überprüfen Sie, ob Sie die aktive Konfiguration bearbeitet haben, ob WebApp-Plugins und -Einstellungen verfügbar sind und ob ein Paket-Upgrade oder die Einbindung eines Containers keine andere Konfigurationsdatei bereitstellt.
Wie installiert man das MDM-Plugin?
Verwenden Sie das MDM-Paket, das für dieselbe Kopano WebApp-Version und -Distribution wie der Server erstellt wurde. Das Kopano MDM-Handbuch beschreibt ein Debian-basiertes Paket kopano-webapp-plugins-mdmund ein RPM-Paket für RPM-basierte Distributionen. Das Debian-Installationsmuster ist unten dargestellt; ersetzen Sie den Platzhalter durch die tatsächliche Paketversion, die Sie von Ihrer vertrauenswürdigen, kompatiblen Paketquelle beziehen:
sudo dpkg -i ./kopano-webapp-plugins-mdm_<version>.deb
Geben Sie den Platzhalter in spitzen Klammern nicht wörtlich ein. Falls die Paketinstallation unaufgelöste Abhängigkeiten meldet, verwenden Sie die normale Paketverwaltung Ihrer Distribution, um diese aus vertrauenswürdigen Quellen zu lösen. Stellen Sie anschließend sicher, dass das installierte MDM-Paket und die WebApp-Version kompatibel sind. Vermeiden Sie es, ein beliebiges Paket herunterzuladen oder verschiedene Versionen zu mischen, um eine Abhängigkeit zu erfüllen.
Überprüfen Sie, ob die PHP-SOAP-Erweiterung in der von der Webanwendung verwendeten PHP-Umgebung aktiviert ist. Eine schnelle Überprüfung ist:
php -m | grep -i '^soap$'
Wenn keine Ausgabe erfolgt, installieren und aktivieren Sie die SOAP-Erweiterung, die mit der PHP-Version und der Webserver-Laufzeitumgebung von WebApp kompatibel ist. Die PHP-Prüfung über die Befehlszeile kann von PHP-FPM oder dem PHP-Modul von Apache abweichen. Vergleichen Sie daher die Webserver-Konfiguration, falls der Befehl SOAP anzeigt, MDM aber weiterhin eine fehlende SOAP-Funktion meldet.
Wie sollte die MDM-Serververbindung konfiguriert werden?
Das veröffentlichte MDM-Handbuch speichert seine Einstellungen in /etc/kopano/webapp/config-mdm.php. Sichern Sie die Datei und überprüfen Sie anschließend die dokumentierten Optionen:
PLUGIN_MDM_USER_DEFAULT_ENABLE_MDMsteuert, ob das Plugin standardmäßig für Benutzer aktiviert ist; im Handbuch ist der Standardwert angegeben false.
PLUGIN_MDM_SERVERidentifiziert den Z-Push-Server; der dokumentierte Standardwert ist localhost.
PLUGIN_MDM_SERVER_SSLsollte auf gesetzt werden, truewenn die Verbindung SSL/TLS verwendet; der dokumentierte Standardwert ist false.
Befinden sich WebApp und Z-Push auf unterschiedlichen Hosts, ersetzen Sie die Standardservereinstellung durch den für Ihre Bereitstellung erforderlichen Z-Push-Speicherort. Verwenden Sie das korrekte Protokoll und den korrekten Hostnamen und aktivieren Sie die SSL-Option, wenn der Endpunkt HTTPS verwendet. Stellen Sie den Endpunkt nicht öffentlich bereit, nur damit das Plugin reagiert; er muss über den vorgesehenen Netzwerkpfad und ein gültiges Zertifikat erreichbar sein. Behalten Sie die von der installierten Datei verwendete PHP-Syntax bei.
Die Standardeinstellung ist nicht unbedingt für jede Organisation die richtige Wahl. Sie können Benutzern die Möglichkeit geben, MDM selbst zu aktivieren, oder es standardmäßig aktivieren, sofern Ihre Richtlinien dies zulassen. Wenn Ihre WebApp-Konfiguration Plugins global deaktiviert oder das MDM-Plugin blockiert, beheben Sie diese zentrale Einstellung zuerst. Die Änderung der MDM-spezifischen Standardeinstellung allein überschreibt kein Plugin, das explizit auf WebApp-Ebene deaktiviert ist.
Wie aktiviert man MDM in einem Benutzerkonto?
Nach Installation und Konfiguration des Pakets melden Sie sich bei der Web-App an und öffnen Sie die Einstellungen, anschließend den Tab „Plugins“. Wählen Sie MDM aus und übernehmen Sie die Änderungen. Laut MDM-Handbuch wird die Geräteübersicht in einem separaten MDM-Tab in den Einstellungen angezeigt und enthält Geräteinformationen, die letzte Synchronisierung und eine Geräte-ID. Falls das Plugin nicht aufgeführt ist, überprüfen Sie zunächst, ob die Paketdateien im aktiven Plugin-Verzeichnis der Web-App installiert sind und ob die globalen Plugin-Einstellungen es nicht ausblenden oder deaktivieren.
Testen Sie mit einem Konto, auf dem bereits ein Gerät per Z-Push synchronisiert wird. Ist die Geräteliste leer, prüfen Sie, ob für dieses Konto ein Z-Push-Gerät vorhanden ist, ob die MDM-Servereinstellung auf den korrekten Z-Push-Dienst verweist und ob PHP SOAP für den WebApp-Prozess verfügbar ist. Überprüfen Sie die WebApp- und Z-Push-Protokolle im Zusammenhang mit einer Testanfrage, bevor Sie Änderungen an nicht relevanten Servereinstellungen vornehmen.
Was sollten Sie vor der Anwendung von Wipe oder Remove wissen?
Behandeln Sie die MDM-Aktionen als operative Steuerungselemente und nicht als harmlose Aktualisierungsschaltflächen. Das MDM-Handbuch von Kopano warnt davor, dass die Funktion „Löschen“ alle Daten vom Gerät entfernt, und rät zu besonderer Vorsicht. Testen Sie die Benutzeroberfläche mit einem nicht kritischen Gerät und machen Sie sich mit dem Wiederherstellungsprozess Ihres Unternehmens vertraut, bevor Sie die Funktion „Löschen“ für Benutzer freigeben. Bestätigen Sie die Zielgeräte-ID und den Benutzer, bevor Sie die Funktion ausführen.
Das Entfernen hat ebenfalls Konsequenzen: Laut Handbuch muss der Benutzer nach dem Entfernen eines Geräts aus der Liste das zugehörige Konto auf dem Telefon entfernen und erneut verbinden, damit das Gerät wieder angezeigt wird. „Neu synchronisieren“ fordert eine erneute Synchronisierung an; „Aktualisieren“ aktualisiert die angezeigte Geräteliste. Verwenden Sie „Löschen“ nicht als allgemeine Fehlerbehebungsmaßnahme für ein Gerät, das lediglich langsam synchronisiert.
Wie können Sie beide Merkmale überprüfen?
Prüfen Sie bei der Dateivorschau, ob der Benutzer die Einstellung sehen und aktivieren kann. Öffnen Sie anschließend einen unterstützten Anhang, ohne ihn vorher herunterzuladen. Stellen Sie bei MDM sicher, dass der Testbenutzer die erwarteten Geräteinformationen sieht und die Details der letzten Synchronisierung einem Gerät entsprechen, das bekanntermaßen über Z-Push synchronisiert wird. Testen Sie zunächst Aktionen mit geringerem Risiko wie Aktualisieren oder Neusynchronisieren. Deaktivieren oder beschränken Sie die Funktion „Löschen“ gemäß den Richtlinien Ihres Unternehmens, bis Sie deren Auswirkungen validiert haben.
Falls die Vorschau-Steuerelemente fehlen, überprüfen Sie die Konfiguration der aktiven Webanwendung und die Benutzereinstellungen. Falls MDM fehlt oder keine Geräte anzeigt, überprüfen Sie die Paketkompatibilität, PHP SOAP, den MDM-Konfigurationspfad, den Z-Push-Host und die globalen Plugin-Beschränkungen. Die veröffentlichten Handbücher von Kopano beschreiben die Einstellungsnamen und das Paketmuster, gewährleisten jedoch keine Kompatibilität mit jeder aktuellen Distribution und PHP-Version. Verwenden Sie daher die Paketdokumentation für die jeweilige Serverkonfiguration als endgültige Referenz.
Offizielle Kopano-Referenzen