Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > Übersicht tags
Integration | Nextcloud konfigurieren
Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des Plugins Integration | Nextcloud. Aktualisieren Sie das hier beschriebene Plugin, um die Dokumentation verwenden zu können.
Integration | Nextcloud synchronisiert die Konfigurationen aller Benutzer über einen zentralen Hintergrund-Task. Als Administrator starten Sie diesen Task, legen Zeitpläne und Grenzen für alle fest und behalten alle Konfigurationen im Blick. Je Benutzer ist nichts einzurichten.
Voraussetzung: Sie sind Mitglied in GRP_agorum.nextcloud_admin_group, siehe Integration | Nextcloud berechtigen. Die Nextcloud ist über HTTPS mit WebDAV- und OCS-API erreichbar.
Synchronisierungs-Task für Nextcloud starten
Nach der Installation von Integration | Nextcloud ist der Synchronisierungs-Task gestoppt. Solange er gestoppt ist, wird nichts synchronisiert, auch nicht von Hand.
Gehen Sie wie folgt vor, um den Task zu starten:
- Öffnen Sie im Hauptmenü Administration > Konfiguration > Nextcloud.
Ergebnis: Das Fenster Nextcloud-Synchronisierung öffnet sich. - Klicken Sie unter Synchronisierungs-Task auf Task starten.
Ergebnis: Der Task ist gestartet und prüft jede Minute, welche Konfigurationen nach den Zeitplänen fällig sind.
Die Anzeige im Fenster aktualisiert sich selbst, spätestens nach 30 Sekunden. Das Fragezeichen oben rechts öffnet die Dokumentation zu Integration | Nextcloud in einem neuen Tab.
| Anzeige | Bedeutung |
|---|---|
| Status | Gestoppt, gestartet und wartend oder gestartet und synchronisiert gerade |
| Synchronisierungen | wie viele Synchronisierungen laufen und wie viele warten |
| Nächster Differential-Scan, Nächster Full-Scan | Zeitpunkte der nächsten Läufe |
| Letzte Prüfung | wann der Task zuletzt geprüft hat |
Task stoppen verwirft wartende Synchronisierungen; laufende laufen zu Ende. Solange der Task gestoppt ist, meldet eine Synchronisierung von Hand den Anwendern, dass die Nextcloud-Synchronisierung vom Administrator gestoppt ist. Alternativ startet und stoppt das Skript js/task/task-start-stop.js im Projektordner agorum.nextcloud den Task: Setzen Sie darin cancel auf false zum Starten oder true zum Stoppen und führen Sie es aus.
Zeitpläne und Grenzen für die Nextcloud-Synchronisierung festlegen
Die Zeitpläne und Grenzen von Integration | Nextcloud gelten für die Konfigurationen aller Benutzer. Anwender legen keine eigenen Zeitpläne fest; die Uhrzeit des Full-Scans sehen sie in ihrer Einrichtung.
- Öffnen Sie im Hauptmenü Administration > Konfiguration > Nextcloud.
- Stellen Sie unter Zeitpläne und Grenzen die Werte ein.
- Klicken Sie auf Speichern. Die Schaltfläche ist nur aktiv, wenn Sie etwas geändert haben.
Ergebnis: Die Zeitpläne gelten ab der nächsten Prüfung des Tasks, die maximale Dateigröße ab dem nächsten Lauf.
Schließen Sie das Fenster mit ungespeicherten Änderungen, fragt es vorher nach.
| Einstellung | Bedeutung | Vorgabe |
|---|---|---|
| Differential-Scan | Überträgt, was sich seit dem letzten Lauf geändert hat; kann oft laufen. Erkennt Änderungen in agorum core über den Suchindex, in Nextcloud über die Aktivitäten (App Activity), ohne sie über das Änderungsdatum. | alle 15 Minuten |
| Full-Scan | Vergleicht den ganzen Bestand beider Seiten und holt nach, was der Differential-Scan nicht erkannt hat; braucht viel Zeit. | täglich um 23:00 Uhr |
| Gleichzeitige Synchronisierungen | Wie viele Konfigurationen höchstens gleichzeitig synchronisiert werden (1 bis 10). Mehr belastet agorum core und Nextcloud stärker. | 2 |
| Maximale Dateigröße (MB) | Größere Dateien werden in beide Richtungen übersprungen und im Protokoll als Warnung gezeigt. Leer heißt keine Grenze. | keine Grenze |
Die Zeitpläne stellen Sie über Auswahlfelder für Minute, Stunde, Tag, Monat und Wochentag ein oder als Cron-Ausdruck mit fünf Feldern. Darunter steht der nächste Lauf.
Tipp: Lassen Sie den Full-Scan außerhalb der Arbeitszeit laufen. Heben Sie die maximale Dateigröße an, holt der nächste Full-Scan die übersprungenen Dateien nach.
Was der Differential-Scan nicht erkennt
Folgendes überträgt Integration | Nextcloud erst mit dem nächsten Full-Scan:
- Löschungen in Nextcloud, die nicht in den Aktivitäten stehen, etwa weil die App Activity nicht aktiv ist; nur ein vollständig geleerter Ordner einer Regel fällt auch dem Differential-Scan auf
- geänderte und gelöschte Kommentare in Nextcloud und gelöschte Notizen in agorum core
- Dateien in einem Nextcloud-Ordner, der wegen Groß- und Kleinschreibung blockiert war
- Dateien, die wegen der maximalen Dateigröße übersprungen wurden
Eine Synchronisierung von Hand ist immer ein Differential-Scan, außer bei der ersten Synchronisierung einer Konfiguration. Einen Full-Scan außerhalb des Zeitplans können weder Anwender noch Administratoren anstoßen. Sind beide Scans gleichzeitig fällig, läuft nur der Full-Scan.
Zertifikate der Nextcloud prüfen lassen
Integration | Nextcloud prüft bei Verbindungen über HTTPS Zertifikat und Hostname jeder Nextcloud. Scheitert die Prüfung, können sich Anwender in ihrer Einrichtung nicht anmelden.
- Hat die Nextcloud ein selbst signiertes Zertifikat, importieren Sie es in agorum core; wo agorum core das nicht unterstützt, in den Truststore von Java mit anschließendem Neustart.
- Bei einer eigenen Zertifizierungsstelle importieren Sie deren Zertifikat.
- Passt der Hostname nicht, verwenden Anwender die Adresse, auf die das Zertifikat ausgestellt ist.
Geht das nicht, haken Sie im Fenster Nextcloud-Synchronisierung unter Sicherheit die Einstellung Nicht vertrauenswürdige Zertifikate erlauben an und klicken auf Speichern. Ab der nächsten Anfrage werden Zertifikat und Hostname bei keiner Verbindung mehr geprüft. Solange die Einstellung an ist, zeigt das Fenster unter Sicherheit eine Warnung.
Achtung: Wer die Verbindung abfangen kann, kann dann Passwörter und Dateien mitlesen und verändern. Verwenden Sie die Einstellung nur für Tests und schalten Sie sie aus, sobald das Zertifikat importiert ist.
Alle Nextcloud-Konfigurationen anzeigen
Über die Suche Nextcloud-Konfigurationen (Admin) sehen Sie die Konfigurationen aller Benutzer von Integration | Nextcloud mit ihrem Status.
- Öffnen Sie im Hauptmenü Administration > Konfiguration > Nextcloud.
- Klicken Sie auf Alle Konfigurationen anzeigen.
Ergebnis: Das Fenster Objekt-Auswahl zeigt die Suche Nextcloud-Konfigurationen (Admin). Jede Konfiguration erscheint als Karte mit Benutzer, Status, letztem Lauf, Nextcloud-Adresse, Regeln und Richtung. - Grenzen Sie mit den Filtern Status, Konfiguration (aktiv oder inaktiv), Anmeldename, Richtung und Letzter Lauf ein.
Der Status Fehler bedeutet Handlungsbedarf: Eine Regel oder die ganze Konfiguration ist gescheitert, etwa bei der Anmeldung. Bei Warnung meldet eine Regel eine Warnung oder der letzte Lauf wurde abgebrochen. Geändert werden Konfigurationen nicht hier, sondern in der Einrichtung ihres Benutzers.