ตั้งค่าตัวจับเวลาการไม่ใช้งานของ Collabora สำหรับมุมมองเอกสารที่ใช้งานอยู่

หากต้องการเปลี่ยนระยะเวลาที่มุมมอง Collabora ที่เปิดอยู่สามารถคงอยู่โดยไม่ใช้งานก่อนที่จะหรี่แสงลงและหยุดรับการอัปเดต ให้ปรับค่า เทมเพลต per_view.idle_timeout_secsต้นทางปัจจุบันcoolwsd.xmlตั้งค่าตัวจับเวลาในระดับมุมมองนี้ไว้ที่ 900 วินาที (15 นาที) ตัวอย่างเช่น ตั้งค่าเป็น 1800 สำหรับ 30 นาที นี่ไม่ใช่ตัวจับเวลาการลงชื่อออกหรือการหมดเวลาที่จะซ่อนเอกสารที่ไม่ได้ใช้งาน

ตรวจสอบว่าคุณกำลังเปลี่ยนตัวจับเวลาตัวไหน

มุมมอง (View)คือมุมมองเอกสารที่เปิดอยู่ในเบราว์เซอร์ของผู้ใช้คนหนึ่ง ในcoolwsdเว็บดีมอนที่ให้บริการ Collabora Online per_viewการตั้งค่า นี้ idle_timeout_secsคือจำนวนวินาทีที่มุมมองของผู้ใช้ที่ไม่ได้ใช้งานจะถูกหรี่แสงลงและหยุดการอัปเดต แม้ว่าแท็บเบราว์เซอร์จะยังคงได้รับการโฟกัสอยู่ก็ตาม เทมเพลตต้นทางในปัจจุบันตั้งค่าเริ่มต้นไว้ที่ 900 วินาที แพ็กเกจหรือบริการจัดการของคุณอาจแทนที่ค่านี้ ดังนั้นโปรดตรวจสอบการกำหนดค่าที่ใช้งานจริงในการใช้งานของคุณ

ใช้การตั้งค่าแรกเมื่อผู้ใช้ต้องการให้มุมมองการแก้ไขที่โฟกัสอยู่คงอยู่เป็นเวลานานขึ้นในขณะที่พวกเขากำลังอ่านหรือหยุดชั่วคราว ใช้การตั้งค่าที่สองเฉพาะในกรณีที่แท็บพื้นหลังจางหายไปเร็วเกินไป การตั้งค่าที่สามคือการล้างข้อมูลฝั่งเซิร์ฟเวอร์หลังจากเอกสารไม่มีมุมมองที่ใช้งานอยู่ การเปลี่ยนแปลงการตั้งค่านี้จะไม่เปลี่ยนแปลงพฤติกรรมการไม่ใช้งานของมุมมองที่ยังคงเปิดอยู่ การตั้งค่าการบันทึกอัตโนมัติและการบันทึกเมื่อไม่ได้ใช้งานจะควบคุมว่าเนื้อหาที่แก้ไขจะถูกบันทึกเมื่อใด ไม่ใช่ระยะเวลาที่มุมมองยังคงใช้งานอยู่

เลือกช่วงเวลาหมดเวลาและเตรียมการตั้งค่า

เลือกช่วงเวลาที่เหมาะสมกับขั้นตอนการทำงานของคุณ จากนั้นแปลงเป็นวินาที: 20 นาทีคือ 1200, 30 นาทีคือ 1800 และ 45 นาทีคือ 2700 ตัวอย่างด้านล่างใช้เวลา 30 นาที ซึ่งเป็นเพียงตัวอย่าง ไม่ใช่คำแนะนำทั่วไป ค่าที่นานกว่าจะทำให้มุมมองที่ไม่ได้ใช้งานคงอยู่ได้นานขึ้น และอาจรักษาการประมวลผลเอกสารและกิจกรรมการอัปเดตได้นานขึ้นด้วย

ก่อนทำการแก้ไข ให้ระบุวิธีการติดตั้ง Collabora ก่อน Docker CODE, แพ็กเกจ Linux, การติดตั้งผ่าน Helm และผู้ให้บริการโฮสติ้ง แต่ละวิธีอาจมีวิธีการกำหนดค่าที่แตกต่างกัน สำรองข้อมูลการกำหนดค่าที่ใช้งานอยู่ หรือบันทึกสำเนาไฟล์ Compose ของคุณไว้ หากมีการผสานรวมระบบจัดการเซิร์ฟเวอร์ให้คุณ ให้ใช้กลไกการกำหนดค่าที่รองรับของระบบนั้น แทนที่จะแก้ไขระบบไฟล์ชั่วคราวของคอนเทนเนอร์

ตั้งค่าระยะเวลาหมดเวลาการไม่ใช้งานต่อการดูแต่ละครั้ง

Docker CODE ร่วมกับ Compose

เพิ่มตัวเลือกให้กับextra_paramsค่าที่มีอยู่สำหรับบริการ Collabora:

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

หากextra_paramsมีตัวเลือกอยู่แล้ว ให้เพิ่มตัวเลือกนี้ต่อท้ายค่าเดิมแทนที่จะกำหนดคีย์ซ้ำสองครั้ง คงการตั้งค่า SSL, proxy และ host ที่มีอยู่เดิมไว้ อิมเมจ 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โปรดดูเอกสารประกอบอิมเมจ Docker ของ CODEตรวจสอบพฤติกรรมที่แน่นอนกับเวอร์ชันและแพ็กเกจที่คุณใช้งาน เนื่องจากค่าเริ่มต้นและการส่งมอบการกำหนดค่าอาจแตกต่างกันไป