Imposta il timer di inattività di Collabora per le visualizzazioni dei documenti attive

Per modificare il tempo di inattività di una vista Collabora aperta prima che si attenui e smetta di ricevere aggiornamenti, è necessario regolare il timer per_view.idle_timeout_secs. Il coolwsd.xmlmodello upstream corrente imposta questo timer a livello di vista a 900 secondi (15 minuti); ad esempio, impostandolo a 1800 si ottengono 30 minuti. Questo non è un timer di disconnessione né il timeout che scarica un documento inattivo.

Assicurati di sapere quale timer stai modificando

Una vista è la visualizzazione di un documento aperta nel browser di un utente. Nel coolwsddemone web che gestisce Collabora Online, l' per_viewimpostazione idle_timeout_secsdefinisce il numero di secondi prima che la vista di un utente inattivo venga oscurata e gli aggiornamenti si interrompano, anche se la scheda del browser rimane attiva. Il modello predefinito attualmente imposta questo valore a 900 secondi. Il pacchetto o il servizio gestito in uso potrebbero sovrascrivere questo valore, quindi è consigliabile verificare la configurazione effettivamente utilizzata dalla propria implementazione.

Utilizzate la prima impostazione quando gli utenti desiderano che la visualizzazione di modifica attiva rimanga tale più a lungo durante la lettura o una pausa. Utilizzate la seconda solo se le schede in background si oscurano troppo presto. La terza impostazione riguarda la pulizia lato server dopo che un documento non ha visualizzazioni attive; la sua modifica non altera il comportamento di inattività di una visualizzazione che rimane aperta. Le impostazioni di salvataggio automatico e di salvataggio inattivo controllano quando viene salvato il contenuto modificato, non per quanto tempo una visualizzazione rimane attiva.

Scegli un timeout e prepara la configurazione

Scegli una durata adatta al tuo flusso di lavoro, quindi convertila in secondi: 20 minuti corrispondono a 1200, 30 minuti a 1800 e 45 minuti a 2700. L'esempio seguente utilizza 30 minuti; si tratta solo di un esempio, non di una raccomandazione universale. Valori più lunghi mantengono le viste inattive attive più a lungo e potrebbero conservare più a lungo anche i processi dei documenti e l'attività di aggiornamento.

Prima di apportare modifiche, verifica come è installato Collabora. Docker CODE, un pacchetto Linux, un'implementazione Helm e un provider di hosting possono esporre la configurazione in modo diverso. Esegui un backup della configurazione attiva o salva una copia del tuo file Compose. Se un'integrazione gestisce il server per te, utilizza il meccanismo di configurazione supportato da tale integrazione anziché modificare il filesystem temporaneo di un container.

Imposta il timeout di inattività per ogni visualizzazione

Codice Docker con Compose

Aggiungi l'opzione al extra_paramsvalore esistente per il servizio Collabora:

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

Se extra_paramscontiene già delle opzioni, aggiungi questa allo stesso valore invece di definire la chiave due volte. Mantieni le impostazioni SSL, proxy e host esistenti. L'immagine Docker passa --o:le opzioni a coolwsd; la documentazione ufficiale di CODE Docker descrive questo metodo di configurazione.

Pacchetto Linux o configurazione XML montata

Modifica il file attivo coolwsd.xmle cambia il valore all'interno della <per_view>sezione esistente. Mantieni la configurazione circostante e tutti gli attributi presenti nel file.

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

Non incollare un secondo <per_view>blocco né modificare il modello sorgente coolwsd.xml.income se fosse la configurazione in esecuzione. Il percorso del file corretto e il proprietario della configurazione possono variare a seconda del pacchetto e della distribuzione.

Applica l'impostazione riavviando o ricreando il servizio Collabora. Per un tipico servizio Compose denominato collabora, esegui:

docker compose up -d --force-recreate collabora

Sostituisci il nome del servizio con quello presente nel tuo file Compose. Per un'installazione di pacchetto gestita da systemd, riavvia il servizio dopo aver modificato la sua configurazione attiva, ad esempio sudo systemctl restart coolwsd. Riapri il documento in una nuova scheda del browser in modo che il test utilizzi una vista appena creata.

Verificare il comportamento e risolvere i problemi relativi al risultato

1. Apri un documento di prova a basso rischio in una scheda del browser attiva e annota l'ora. Evita di utilizzare una modifica di produzione non salvata come test di timeout.
2. Lascia la vista invariata per l'intervallo configurato. Dopo 1800 secondi, verifica se la vista si oscura e smette di ricevere aggiornamenti come descritto dall'impostazione per singola vista. Non interpretare questo stato visivo come prova che l'utente si è disconnesso o che il documento è stato scaricato.
3. Torna al documento e conferma che il comportamento sia accettabile per la tua implementazione. Quindi, testa il caso separato della scheda in background passando da un'interfaccia più lunga di out_of_focus_timeout_secs, se tale flusso di lavoro è rilevante.

Dopo il riavvio, alcune build registrano un elenco di valori di configurazione non predefiniti. Se il log di avvio lo mostra, cerca per_view.idle_timeout_secs: 1800. Se il comportamento corrisponde ancora al vecchio valore, verifica di aver modificato il file o il servizio Compose utilizzato dal processo in esecuzione, di aver applicato la modifica e che un'opzione di ambiente o della riga di comando non stia sovrascrivendo l'XML.

Se un documento scompare solo dopo un lungo periodo senza visualizzazioni aperte, per_document.idle_timeout_secsè necessario esaminarlo. Se gli utenti vengono disconnessi, verificare le policy di autenticazione o di sessione della piattaforma host. Si tratta di livelli diversi e non sono controllati da per_view.idle_timeout_secs. Non ridurre l'impostazione di scaricamento del documento solo per far sì che una visualizzazione si attenui prima.

Per i nomi delle impostazioni correnti e i valori predefiniti a monte, consultare il modello di configurazione di Collabora Online . Per il metodo di Docker extra_params, consultare la documentazione dell'immagine Docker di CODE . Verificare il comportamento esatto con la versione e il pacchetto in esecuzione, poiché i valori predefiniti e la distribuzione della configurazione possono variare.