Leerlauf-Timer für aktive Dokumentansichten in Collabora einstellen

Um die Zeitspanne zu ändern, die eine geöffnete Collabora-Ansicht im Inaktivitätszustand verharren kann, bevor sie abgedunkelt wird und keine Aktualisierungen mehr empfängt, passen Sie die entsprechende Einstellung an per_view.idle_timeout_secs. Die aktuelle coolwsd.xmlVorlage legt diesen Timer auf Ansichtsebene auf 900 Sekunden (15 Minuten) fest; stellen Sie ihn beispielsweise auf 1800 Sekunden für 30 Minuten ein. Dies ist kein Abmelde-Timer und auch nicht der Timeout, der ein inaktives Dokument entlädt.

Wissen Sie, welchen Timer Sie ändern?

Eine Ansicht ist die vom Benutzer im Browser geöffnete Ansicht eines Dokuments. In coolwsdCollabora Online, dem Web-Daemon, der Collabora Online bereitstellt, gibt diese per_viewEinstellung idle_timeout_secsdie Anzahl der Sekunden an, nach denen die Ansicht eines inaktiven Benutzers abgedunkelt und Aktualisierungen gestoppt werden, selbst wenn der Browser-Tab weiterhin aktiv ist. Die Upstream-Vorlage verwendet standardmäßig 900 Sekunden. Ihr Paket oder verwalteter Dienst kann diesen Wert überschreiben. Überprüfen Sie daher die Konfiguration Ihrer Bereitstellung.

Verwenden Sie die erste Einstellung, wenn die fokussierte Bearbeitungsansicht beim Lesen oder Pausieren länger aktiv bleiben soll. Die zweite Einstellung verwenden Sie nur, wenn Hintergrundregisterkarten zu schnell ausgeblendet werden. Die dritte Einstellung dient der serverseitigen Bereinigung, nachdem ein Dokument keine aktiven Ansichten mehr aufweist; Änderungen daran haben keinen Einfluss auf das Verhalten einer geöffneten Ansicht im Ruhezustand. Die Einstellungen für automatisches Speichern und Speichern im Leerlauf steuern, wann geänderte Inhalte gespeichert werden, nicht wie lange eine Ansicht aktiv bleibt.

Wählen Sie ein Timeout und bereiten Sie die Konfiguration vor.

Wählen Sie eine Dauer, die zu Ihrem Workflow passt, und rechnen Sie diese in Sekunden um: 20 Minuten entsprechen 1200 Sekunden, 30 Minuten 1800 Sekunden und 45 Minuten 2700 Sekunden. Das folgende Beispiel verwendet 30 Minuten; es dient lediglich als Beispiel und ist keine allgemeingültige Empfehlung. Längere Werte sorgen dafür, dass inaktive Ansichten länger erhalten bleiben und Dokumentprozesse sowie Aktualisierungsaktivitäten möglicherweise länger aufrechterhalten werden.

Bevor Sie Änderungen vornehmen, ermitteln Sie, wie Collabora installiert ist. Docker CODE, ein Linux-Paket, eine Helm-Bereitstellung und ein Hosting-Anbieter können die Konfiguration jeweils unterschiedlich bereitstellen. Sichern Sie die aktuelle Konfiguration oder speichern Sie eine Kopie Ihrer Compose-Datei. Wenn eine Integration den Server für Sie verwaltet, verwenden Sie deren unterstützten Konfigurationsmechanismus, anstatt das temporäre Dateisystem eines Containers zu bearbeiten.

Legen Sie das Leerlauf-Timeout pro Ansicht fest

Docker CODE mit Compose

Fügen Sie die Option dem bestehenden extra_paramsWert für den Collabora-Dienst hinzu:

services:
  collabora:
    environment:
      extra_params: "--o:per_view.idle_timeout_secs=1800"

Falls extra_paramsbereits Optionen vorhanden sind, hängen Sie diese an denselben Wert an, anstatt den Schlüssel zweimal zu definieren. Behalten Sie Ihre bestehenden SSL-, Proxy- und Host-Einstellungen bei. Das Docker-Image übergibt --o:Optionen an coolwsd; die offizielle CODE Docker-Dokumentation beschreibt diese Konfigurationsmethode.

Linux-Paket oder eingebundene XML-Konfiguration

Bearbeiten Sie die aktive coolwsd.xmlDatei und ändern Sie den Wert innerhalb des vorhandenen <per_view>Abschnitts. Behalten Sie die umgebende Konfiguration und alle Attribute in Ihrer Datei bei:

<per_view>
  <out_of_focus_timeout_secs>300</out_of_focus_timeout_secs>
  <idle_timeout_secs>1800</idle_timeout_secs>
</per_view>

Fügen Sie keinen zweiten <per_view>Block ein und bearbeiten Sie die Quellvorlage nicht coolwsd.xml.inso, als wäre es die laufende Konfiguration. Der korrekte Dateipfad und der Konfigurationsinhaber können je nach Paket und Bereitstellung variieren.

Die Einstellung kann durch einen Neustart oder eine Neuerstellung des Collabora-Dienstes angewendet werden. Für einen typischen Compose-Dienst mit dem Namen „<Dienstname>“ collaboraführen Sie folgenden Befehl aus:

docker compose up -d --force-recreate collabora

Ersetzen Sie den Dienstnamen durch den Namen in Ihrer Compose-Datei. Bei einer von systemd verwalteten Paketinstallation starten Sie den Dienst nach der Bearbeitung seiner aktiven Konfiguration neu sudo systemctl restart coolwsd. Öffnen Sie das Dokument anschließend in einem neuen Browsertab, damit der Test eine neu erstellte Ansicht verwendet.

Verhalten überprüfen und Ergebnis analysieren

1. Öffnen Sie ein Testdokument mit geringem Risiko in einem separaten Browsertab und notieren Sie die Zeit. Vermeiden Sie es, eine nicht gespeicherte Produktionsversion als Timeout-Test zu verwenden.
2. Lassen Sie die Ansicht für das konfigurierte Intervall unverändert. Überprüfen Sie nach 1800 Sekunden, ob die Ansicht abgedunkelt wird und keine Aktualisierungen mehr empfängt, wie in den Ansichtseinstellungen beschrieben. Interpretieren Sie diesen visuellen Zustand nicht als Beweis dafür, dass der Benutzer abgemeldet oder das Dokument entladen wurde.
3. Kehren Sie zum Dokument zurück und bestätigen Sie, dass das Verhalten für Ihre Bereitstellung akzeptabel ist. Testen Sie anschließend den Fall mit dem separaten Hintergrundtab, indem Sie länger als [Zeitangabe fehlt] wegwechseln out_of_focus_timeout_secs, falls dieser Workflow relevant ist.

Nach einem Neustart protokollieren einige Builds eine Liste nicht standardmäßiger Konfigurationswerte. Falls diese in Ihrem Startprotokoll erscheint, suchen Sie danach per_view.idle_timeout_secs: 1800. Sollte das Verhalten weiterhin dem alten Wert entsprechen, überprüfen Sie, ob Sie die vom laufenden Prozess verwendete Datei oder den Compose-Dienst bearbeitet, die Änderung angewendet und die XML-Konfiguration nicht durch eine Umgebungs- oder Befehlszeilenoption überschrieben haben.

Wenn ein Dokument erst nach längerer Zeit ohne geöffnete Ansichten verschwindet, überprüfen Sie es per_document.idle_timeout_secs. Falls Benutzer abgemeldet werden, prüfen Sie die Authentifizierungs- oder Sitzungsrichtlinien der Host-Plattform. Dies sind unterschiedliche Ebenen und werden nicht von dieser Plattform gesteuert per_view.idle_timeout_secs. Verkürzen Sie die Einstellung zum Entladen von Dokumenten nicht, nur um eine Ansicht schneller auszublenden.

Die aktuellen Einstellungsnamen und Standardwerte finden Sie in der Collabora Online-Konfigurationsvorlageextra_params . Informationen zur Vorgehensweise von Docker finden Sie in der Dokumentation des CODE-Docker-Images . Überprüfen Sie das genaue Verhalten anhand der von Ihnen verwendeten Version und des Pakets, da Standardwerte und Konfigurationsbereitstellung variieren können.