Ustaw licznik czasu bezczynności Collabora dla aktywnych widoków dokumentów

Aby zmienić czas, przez jaki otwarty widok Collabora może pozostawać nieaktywny, zanim zostanie przyciemniony i przestanie otrzymywać aktualizacje, dostosuj per_view.idle_timeout_secs. Obecny coolwsd.xmlszablon nadrzędny ustawia ten licznik czasu na poziomie widoku na 900 sekund (15 minut); na przykład ustaw go na 1800 dla 30 minut. Nie jest to licznik czasu wylogowania ani limit czasu, który powoduje rozładowanie bezczynnego dokumentu.

Dowiedz się, który timer zmieniasz

Widok to otwarty widok dokumentu w przeglądarce jednego użytkownika. W demonacie internetowym obsługującym Collabora Online, ustawienie to liczba sekund , po upływie których widok nieaktywnego użytkownika zostaje przyciemniony, a aktualizacje zatrzymane, nawet gdy karta przeglądarki pozostaje aktywna. Szablon źródłowy obecnie ustawia domyślną wartość 900 sekund. Twój pakiet lub usługa zarządzana może nadpisać tę wartość, dlatego sprawdź konfigurację faktycznie używaną w Twoim wdrożeniu.coolwsdper_viewidle_timeout_secs

Pierwszego ustawienia należy użyć, gdy użytkownicy chcą, aby aktywny widok edycji był aktywny dłużej podczas czytania lub wstrzymywania. Drugiego należy użyć tylko wtedy, gdy karty tła są zbyt wcześnie przyciemniane. Trzecie ustawienie to czyszczenie po stronie serwera, gdy dokument nie ma aktywnych widoków; jego zmiana nie zmienia zachowania widoku w przypadku braku aktywności, który pozostaje otwarty. Ustawienia automatycznego zapisywania i bezczynności kontrolują, kiedy modyfikowana treść jest zapisywana, a nie jak długo widok pozostaje aktywny.

Wybierz limit czasu i przygotuj konfigurację

Wybierz czas trwania, który pasuje do Twojego przepływu pracy, a następnie przelicz go na sekundy: 20 minut to 1200, 30 minut to 1800, a 45 minut to 2700. Poniższy przykład używa 30 minut; to tylko przykład, a nie uniwersalne zalecenie. Dłuższe wartości wydłużają żywotność bezczynnych widoków, a także mogą dłużej zachowywać procesy dokumentów i aktywność aktualizacji.

Przed edycją sprawdź, jak zainstalowana jest Collabora. Docker CODE, pakiet Linux, wdrożenie Helm i dostawca hostingu mogą udostępniać konfigurację w różny sposób. Utwórz kopię zapasową aktywnej konfiguracji lub zapisz kopię pliku Compose. Jeśli integracja zarządza serwerem za Ciebie, użyj obsługiwanego przez nią mechanizmu konfiguracji, zamiast edytować tymczasowy system plików kontenera.

Ustaw limit czasu bezczynności dla każdego widoku

Docker CODE z Compose

Dodaj opcję do istniejącej extra_paramswartości usługi Collabora:

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

Jeśli extra_paramszawiera już opcje, dodaj tę opcję do tej samej wartości zamiast definiować klucz dwukrotnie. Zachowaj istniejące ustawienia SSL, proxy i hosta. Obraz Dockera przekazuje --o:opcje do coolwsd; oficjalna dokumentacja CODE Dockera opisuje tę metodę konfiguracji.

Pakiet Linux lub zamontowana konfiguracja XML

Edytuj aktywny coolwsd.xmlplik i zmień wartość w jego istniejącej <per_view>sekcji. Zachowaj otaczającą konfigurację i wszelkie atrybuty w pliku:

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

Nie wklejaj drugiego <per_view>bloku ani nie edytuj szablonu źródłowego coolwsd.xml.intak, jakby był bieżącą konfiguracją. Prawidłowa ścieżka do pliku i właściciel konfiguracji mogą się różnić w zależności od pakietu i wdrożenia.

Zastosuj ustawienie, uruchamiając ponownie lub tworząc ponownie usługę Collabora. W przypadku typowej usługi Compose o nazwie collaborauruchom:

docker compose up -d --force-recreate collabora

Zastąp nazwę usługi nazwą z pliku Compose. W przypadku instalacji pakietu zarządzanej przez systemd, uruchom ponownie usługę po edycji jej aktywnej konfiguracji, na przykład sudo systemctl restart coolwsd. Otwórz dokument ponownie w nowej karcie przeglądarki, aby test użył nowo utworzonego widoku.

Sprawdź zachowanie i rozwiąż problem z wynikiem

1. Otwórz dokument testowy o niskim ryzyku w wybranej karcie przeglądarki i zanotuj czas. Unikaj używania niezapisanej edycji produkcyjnej jako testu limitu czasu.
2. Pozostaw widok bez zmian przez skonfigurowany interwał. Po 1800 sekundach sprawdź, czy widok przyciemnia się i przestaje otrzymywać aktualizacje zgodnie z ustawieniem dla każdego widoku. Nie interpretuj tego stanu wizualnego jako dowodu na wylogowanie użytkownika lub usunięcie dokumentu.
3. Wróć do dokumentu i potwierdź, że zachowanie jest akceptowalne dla Twojego wdrożenia. Następnie przetestuj przypadek oddzielnej karty tła, przełączając się na dłużej niż out_of_focus_timeout_secs, jeśli ten przepływ pracy ma znaczenie.

Po ponownym uruchomieniu niektóre kompilacje logują listę niestandardowych wartości konfiguracyjnych. Jeśli log startowy to pokazuje, poszukaj per_view.idle_timeout_secs: 1800. Jeśli zachowanie nadal odpowiada starej wartości, sprawdź, czy edytowałeś plik lub usługę Compose używaną przez uruchomiony proces, czy zastosowałeś zmianę i czy opcja środowiska lub wiersza poleceń nie nadpisuje pliku XML.

Jeśli dokument znika dopiero po dłuższym okresie bez otwartych widoków, per_document.idle_timeout_secszamiast tego należy go przejrzeć. Jeśli użytkownicy są wylogowywani, sprawdź zasady uwierzytelniania lub sesji platformy hosta. Są to różne warstwy i nie są kontrolowane przez per_view.idle_timeout_secs. Nie skracaj ustawienia usuwania dokumentu tylko po to, aby szybciej przyciemnić widok.

Aby zapoznać się z aktualnymi nazwami ustawień i domyślnymi ustawieniami upstream, zapoznaj się z szablonem konfiguracji Collabora Online . Informacje na temat metody Dockera extra_paramsmożna znaleźć w dokumentacji obrazu CODE Docker . Sprawdź dokładne zachowanie w odniesieniu do uruchomionej wersji i pakietu, ponieważ ustawienia domyślne i dostarczana konfiguracja mogą się różnić.