Hoe configureert u time-outs voor inactiviteit tijdens Collabora-bewerkingssessies?

Collabora Online heeft verschillende instellingen die lijken op een 'inactiviteitstime-out', maar ze regelen ander gedrag. Als een editor dimt of stopt met updaten terwijl een gebruiker nog aan het werk is, pas dan de inactiviteitsinstelling per weergave aan. Als een document geladen blijft nadat iedereen de editor heeft verlaten, pas dan de time-out per document aan. Als de editor daadwerkelijk de verbinding verbreekt, controleer dan de WebSocket-time-out van de reverse proxy voordat u het inactiviteitsbeleid van Collabora wijzigt.

De huidige configuratiesjabloon voor Collabora Online beschrijft een inactiviteitstime-out van 15 minuten per weergave, een time-out van 5 minuten wanneer het browsertabblad niet actief is en een time-out van één uur voordat een inactief document wordt gesloten. Deze standaardwaarden kunnen per release en pakket verschillen, dus controleer de configuratie die bij uw geïnstalleerde versie wordt geleverd voordat u wijzigingen aanbrengt. De onderstaande waarden hebben betrekking op de huidige sjabloon die voor deze handleiding is gecontroleerd en zijn geen garantie voor elke CODE- of bedrijfsimplementatie.

Kies de instelling op basis van het gewenste gedrag.

Collabora documenteert de betekenissen en standaardwaarden in de huidige coolwsd-configuratiesjabloon en configuratiehandleiding . Een inactiviteitstime-out per weergave is niet hetzelfde als het sluiten van een account of het intrekken van toegang: het dimt de weergave en stopt updates. Een time-out per document beëindigt een inactief documentproces; het is geen timer die een gebruiker die actief aan het bewerken is, zou moeten beëindigen.

Aanbevolen uitgangspunten

• Voorkom dat actieve tabbladen van gebruikers te snel dimmen: verhoog per_view.idle_timeout_secsde standaardwaarde naar een gemeten interval, bijvoorbeeld 1800 seconden (30 minuten). Dit is een praktisch uitgangspunt, geen algemene aanbeveling.
• Geef gebruikers de mogelijkheid om van tabblad te wisselen zonder dat het document ongebruikt blijft: verhoog dit per_view.out_of_focus_timeout_secsafzonderlijk. Verhoog het niet alleen omdat gebruikers inactief zijn in een actief tabblad.
• Verminder het geheugengebruik nadat documenten niet meer worden gebruikt: laat de waarden per weergave ongewijzigd en overweeg een verlaging per_document.idle_timeout_secsnadat u hebt bevestigd dat het document daadwerkelijk inactief is en dat de opslag correct is.
• Een tijdelijke verbinding verbreken: onderzoek de time-out van de WebSocket van de proxy, ingress of load balancer. Het wijzigen van de instelling voor het dimmen per weergave herstelt geen WebSocket die door de proxy wordt verbroken.
• Behoud frequente opslagmomenten: laat de waarden voor inactieve opslag en automatische opslag op hun huidige instellingen staan, tenzij u een aparte reden hebt om ze te wijzigen.

Wijzig de instellingen in coolwsd.xml.

Bij een installatie via een pakket moet u het actieve coolwsd.xmlbestand vinden dat door de draaiende service wordt gebruikt. Veelvoorkomende locaties zijn onder andere /etc/coolwsd/coolwsd.xml, maar paden variëren per distributie en oudere release. Ga er niet vanuit dat het bewerken van een voorbeeldbestand of een ongebruikte gekoppelde kopie de draaiende service wijzigt.

Maak een back-up van het actieve bestand en bewerk vervolgens alleen de relevante waarden onder de bestaande <per_view>secties <per_document>. Dit fragment stelt bijvoorbeeld een time-out in van 30 minuten voor inactieve gebruikers, een time-out van 15 minuten voor tabbladen op de achtergrond en een time-out van twee uur voor het verwijderen van inactieve documenten:

<per_view>
    <idle_timeout_secs>1800</idle_timeout_secs>
    <out_of_focus_timeout_secs>900</out_of_focus_timeout_secs>
</per_view>
<per_document>
    <idle_timeout_secs>7200</idle_timeout_secs>
</per_document>

Dit is een fragment, geen volledige vervangende configuratie. Behoud de attributen, opmerkingen, geneste structuren en andere elementen in het bestand dat bij uw versie is meegeleverd; sommige builds verwachten extra XML-attributen. Als u alleen de dimming wilt wijzigen terwijl het tabblad actief blijft, bewerk dan alleen de waarde voor de inactiviteit per weergave. Het tegelijkertijd verhogen van zowel de waarden per weergave als de waarde voor het afsluiten van het document maakt het lastiger om te achterhalen welke instelling het probleem heeft opgelost.

Valideer de XML met behulp van de configuratietools die uw implementatie ondersteunt en herstart of herlaad Collabora vervolgens met behulp van de methode die voor dat pakket is gedocumenteerd. Controleer de opstartlogboeken op fouten bij het parseren van de configuratie en bevestig dat het actieve proces het beoogde bestand heeft geladen. Een instellingswijziging die niet aanwezig is in het actieve proces heeft geen effect.

Stel dezelfde opties in voor Docker of Kubernetes.

In de Docker-image van Collabora geven beheerders configuratieopties doorgaans door met extra_paramsbehulp van de --o:optiesyntaxis. De volgende waarde in Compose-stijl illustreert dit voorbeeld:

extra_params=--o:per_view.idle_timeout_secs=1800 --o:per_view.out_of_focus_timeout_secs=900 --o:per_document.idle_timeout_secs=7200

Gebruik dit alleen als uw image en deployment chart dit ondersteunen extra_params. Voor Kubernetes, Helm of een door een operator beheerde installatie, plaatst u de opties in het veld voor ondersteunde configuratie van de chart of aangepaste resource in plaats van een gegenereerd containerbestand te bewerken. Wanneer u omgevingsvariabelen wijzigt in Compose, moet u de service opnieuw aanmaken of implementeren, zodat de nieuwe waarden de container bereiken; een gewone herstart kan de bestaande containerconfiguratie hergebruiken.

Stel niet dezelfde optie in op tegenstrijdige plaatsen, zoals zowel in een gekoppeld XML-bestand als in een omgevingsparameter, zonder de prioriteitsregels voor die release te controleren. Controleer na herimplementatie de opstartlogboeken van de container en de actieve configuratie. De broncode van het Collabora-project en de bijbehorende implementatiedocumentatie zijn de juiste naslagwerken wanneer optienamen of containergedrag verschillen.

Controleer de time-outs van de reverse proxy afzonderlijk.

De editor van Collabora gebruikt WebSockets voor continue communicatie met de browser. Een proxy kan een verder geldige WebSocket verbreken, zelfs als de time-outs voor het Collabora-document en de weergave veel langer zijn ingesteld. In dat geval kunnen gebruikers een melding krijgen dat de verbinding is verbroken, dat ze opnieuw verbinding moeten maken, of dat de editor geen updates meer ontvangt, in plaats van een eenvoudig gedimd scherm.

Vergelijk de time-out voor lezen/verzenden van de proxy, eventuele inkomende time-outs of inactiviteitstime-outs van de cloud load balancer, en het beoogde sessiegedrag van Collabora. De time-outs moeten over de gehele route compatibel zijn. De handleiding voor proxy-instellingen van Collabora bevat voorbeelden van WebSocket-proxyconfiguratie en langdurige verbindingen. Pas de richtlijnen toe die specifiek zijn voor uw proxy en release; kopieer geen oud Nginx-blok blindelings naar een andere proxy of een ongerelateerde route.

Een nuttige aanwijzing is het patroon van de fouten. Als gebruikers alleen de inactieve weergave zien dimmen, onderzoek dan de logbestanden per_view. Als alle gebruikers ongeveer op hetzelfde tijdstip de verbinding verbreken, controleer dan de proxy- en loadbalancerlogbestanden op dat tijdstip. Als een document pas wordt gesloten nadat alle deelnemers zijn vertrokken, is de time-out per document relevanter.

Test één time-out tegelijk.

1. Noteer de huidige waarden van de actieve configuratie en vermeld uw Collabora-versie en implementatiemethode.
2. Open een testdocument met twee gebruikers of twee browsersessies, zodat u zowel een actieve als een inactieve weergave kunt bekijken.
3. Wijzig alleen de time-out die overeenkomt met het probleem. Om bijvoorbeeld te voorkomen dat een tabblad gedimd wordt terwijl het scherm stil is, hoeft u per_view.idle_timeout_secsalleen de time-out aan te passen.
4. Start de applicatie opnieuw op of implementeer deze opnieuw via de ondersteunde methode en controleer vervolgens of de nieuwe waarde wordt weergegeven in de actieve configuratie of de opstartlogboeken.
5. Wacht tot na de vorige drempelwaarde. Controleer of het beeld nog steeds dimt, de tweede gebruiker nog steeds updates ontvangt en bewerkingen nog steeds worden opgeslagen.
6. Sluit alle weergaven van het testdocument en controleer of het inactieve document binnen het beoogde bereik wordt ontladen.
7. Controleer de Collabora- en proxylogboeken op WebSocket-sluitingen, XML-parseerfouten, mislukte opslagpogingen of onverwachte procesafsluitingen.

Test de wijziging niet op een niet-opgeslagen productiedocument. Controleer of de gewijzigde bestanden correct worden opgeslagen in de back-end voordat u een inactief documentproces laat ontladen. Als het probleem zich alleen voordoet bij niet-opgeslagen wijzigingen, onderzoek dan fouten met automatisch opslaan en opslag als een afzonderlijk probleem in plaats van de time-out bij elke wijziging te verlengen.

Een balans vinden tussen gebruiksgemak, grondstoffengebruik en betrouwbaarheid.

Langere time-outs per weergave zijn geschikt voor teams die documenten in pauzes bekijken of met meerdere browsertabs werken. Kortere waarden kunnen ervoor zorgen dat inactieve weergaven eerder stoppen met bijwerken, wat de achtergrondactiviteit kan verminderen, maar ze kunnen een lezer die nog steeds naar het document kijkt, storen. De time-out per document is een aparte keuze voor resourcebeheer: door deze te verlengen blijven ongebruikte documenten langer geladen, terwijl een kortere time-out ervoor kan zorgen dat een nieuw document moet worden geladen wanneer een gebruiker terugkeert.

Voor de meeste implementaties volstaat het om zo min mogelijk instellingen aan te passen om het waargenomen gedrag te evenaren. Behoud de opslagintervallen, stel een redelijke inactiviteitsperiode per weergave in voor het team, houd de time-out voor achtergrondtabbladen bewust ingesteld en pas de proxy WebSocket-limieten alleen aan wanneer logboeken of timing wijzen op een probleem op de verbindingslaag. Controleer na upgrades de configuratiesjabloon van de geïnstalleerde versie opnieuw, omdat de standaardinstellingen en ondersteunde instellingen kunnen veranderen.