Collabora의 활성 문서 보기용 유휴 타이머 설정

열려 있는 Collabora 뷰가 비활성화된 상태로 유지되다가 비활성화되고 업데이트 수신이 중단되는 시간을 변경하려면 다음 값을 조정하세요 per_view.idle_timeout_secs. 현재 상위 coolwsd.xml템플릿에서는 이 뷰 수준 타이머를 900초(15분)로 설정합니다. 예를 들어 30분으로 설정하려면 1800으로 설정하세요. 이 타이머는 로그아웃 타이머나 유휴 문서 언로드 시간 초과와는 다릅니다.

어떤 타이머를 변경하는지 알아두세요.

뷰 는 사용자가 브라우저에서 열어 놓은 문서의 보기입니다. coolwsdCollabora Online을 제공하는 웹 데몬에서 이 per_view설정 idle_timeout_secs은 비활성 사용자 보기가 흐려지고 업데이트가 중지되기까지의 시간(초)을 나타냅니다. 브라우저 탭에 포커스가 유지되는 동안에도 이 상태가 유지됩니다. 현재 업스트림 템플릿은 기본값으로 900초를 제공합니다. 사용자의 패키지 또는 관리형 서비스에서 이 값을 재정의할 수 있으므로 배포 환경에서 실제로 사용되는 구성을 확인하십시오.

첫 번째 설정은 사용자가 읽거나 일시 중지하는 동안 집중 편집 보기가 더 오래 유지되도록 하려는 경우에 사용합니다. 두 번째 설정은 배경 탭이 너무 빨리 어두워지는 경우에만 사용합니다. 세 번째 설정은 문서에 활성 보기가 없을 때 서버 측에서 수행하는 정리 작업입니다. 이 설정을 변경해도 열려 있는 보기의 비활성 동작은 변경되지 않습니다. 자동 저장 및 유휴 저장 설정은 수정된 콘텐츠가 저장되는 시점을 제어하는 ​​것이지, 보기가 활성 상태로 유지되는 시간을 제어하는 ​​것이 아닙니다.

타임아웃 시간을 선택하고 구성을 준비하세요.

워크플로에 맞는 기간을 선택한 다음 초 단위로 변환하세요. 20분은 1200초, 30분은 1800초, 45분은 2700초입니다. 아래 예시에서는 30분을 사용했지만, 이는 단지 예시일 뿐이며 모든 경우에 적용되는 권장 사항은 아닙니다. 더 긴 값을 사용하면 유휴 보기의 유지 시간이 길어지고 문서 처리 및 업데이트 활동도 더 오래 보존될 수 있습니다.

편집하기 전에 Collabora가 어떻게 설치되었는지 확인하십시오. Docker CODE, Linux 패키지, Helm 배포 및 호스팅 제공업체에 따라 구성에 접근하는 방식이 다를 수 있습니다. 현재 사용 중인 구성을 백업하거나 Compose 파일의 사본을 저장해 두십시오. 통합 도구가 서버를 관리하는 경우 컨테이너의 임시 파일 시스템을 편집하는 대신 통합 도구에서 지원하는 구성 메커니즘을 사용하십시오.

뷰별 유휴 시간 제한을 설정하세요

Compose를 사용한 Docker CODE

extra_paramsCollabora 서비스의 기존 값에 옵션을 추가합니다 .

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

이미 옵션이 있는 경우 extra_params, 키를 두 번 정의하는 대신 동일한 값에 이 옵션을 추가하세요. 기존 SSL, 프록시 및 호스트 설정은 그대로 유지하세요. Docker 이미지는 --o:옵션을 전달합니다 coolwsd. 공식 CODE Docker 문서에서 이 구성 방법을 설명합니다.

Linux 패키지 또는 마운트된 XML 구성

활성화된 coolwsd.xml파일을 편집하고 해당 <per_view>섹션 내의 값을 변경하십시오. 주변의 구성 및 파일에 있는 모든 속성은 그대로 유지하십시오.

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

두 번째 블록을 붙여넣거나 실행 중인 구성인 것처럼 <per_view>소스 템플릿을 편집 하지 마십시오 . 올바른 파일 경로와 구성 소유자는 패키지 및 배포 환경에 따라 다를 수 있습니다.coolwsd.xml.in

Collabora 서비스를 다시 시작하거나 새로 생성하여 설정을 적용하세요. 일반적인 Compose 서비스 이름의 경우 다음 명령 collabora을 실행합니다.

docker compose up -d --force-recreate collabora

Compose 파일에 있는 서비스 이름으로 바꾸세요. systemd로 관리되는 패키지 설치의 경우, 활성 구성을 편집한 후 서비스를 다시 시작하세요(예: ) sudo systemctl restart coolwsd. 새 브라우저 탭에서 문서를 다시 열어 테스트에서 새로 생성된 뷰를 사용하도록 하세요.

동작을 검증하고 결과를 문제 해결하세요

1. 위험도가 낮은 테스트 문서를 브라우저 탭에서 열고 시간을 기록하세요. 저장하지 않은 프로덕션 편집본을 타임아웃 테스트에 사용하지 마세요.
2. 설정된 시간 간격 동안 뷰를 그대로 두십시오. 1800초 후에 뷰 설정에 따라 뷰가 어두워지고 업데이트 수신이 중지되는지 확인하십시오. 이러한 시각적 상태를 사용자가 로그아웃되었거나 문서가 언로드되었다는 증거로 해석해서는 안 됩니다.
3. 문서로 돌아가서 배포 환경에서 동작이 허용 가능한지 확인하십시오. 그런 다음, out_of_focus_timeout_secs워크플로가 중요한 경우 특정 시간 이상 동안 백그라운드 탭을 전환하여 별도의 백그라운드 탭 사례를 테스트하십시오.

재시작 후 일부 빌드에서는 기본값이 아닌 구성 값 목록이 로그에 기록됩니다. 시작 로그에 해당 내용이 표시되면 per_view.idle_timeout_secs: 1800해당 항목을 확인하십시오. 동작이 여전히 이전 값과 일치하는 경우, 실행 중인 프로세스에서 사용하는 파일 또는 Compose 서비스를 편집했는지, 변경 사항을 적용했는지, 그리고 환경 변수 또는 명령줄 옵션이 XML을 재정의하지 않는지 확인하십시오.

문서가 열려 있는 뷰가 없는 상태에서 오랜 시간이 지난 후에야 사라지는 경우, 문제를 검토해 보세요 per_document.idle_timeout_secs. 사용자가 로그아웃되는 경우 호스트 플랫폼의 인증 또는 세션 정책을 확인하십시오. 이러한 사항은 서로 다른 계층에 있으며 에서 제어하지 않습니다 per_view.idle_timeout_secs. 뷰가 더 빨리 어두워지도록 문서 언로드 설정을 단축하지 마십시오.

현재 설정 이름 및 상위 기본값에 대한 자세한 내용은 Collabora Online 구성 템플릿을 참조하십시오 . Docker extra_params방식 에 대한 자세한 내용은 CODE Docker 이미지 문서를 참조하십시오 . 기본값 및 구성 전달 방식은 버전 및 패키징에 따라 다를 수 있으므로 실행 중인 버전 및 패키징에 맞춰 정확한 동작을 확인하십시오.