Confluence 6 協同編輯問題解決


協同編輯是 Synchrony 提供的,用於在編輯的時候實時同步。在一般的情況下,這個進程是不需要 Confluence 的管理員進行手動管理的。

這個頁面將會幫助你 Confluence 安裝實例中 Synchrony 出現的問題進行問題解決。

第一步

檢查 Synchrony  是否在運行

為了檢查 Synchrony 是否在運行,進入  > 基本配置(General Configuration)  >  協同編輯(Collaborative editing)

請注意:如果你正在運行的 Confluence 數據中心模式,那么這個頁面將僅能告訴你如果當前連接到 Confluence 節點的的 Synchrony  的運行狀態。你可能需要第三方的監控工具來幫助你監控你的 Synchrony 集群。

檢查你可以編輯的頁面

如果在你對頁面進行編輯的時候看到了錯誤,但是 Synchrony  又是運行的,那么應該是你瀏覽器有某些東西阻止你連接到 Synchrony 。

最常見的問題是反向代理的錯誤配置。請查看頁面尾部的有關代理配置的問題解決或者進入 Administering Collaborative Editing 頁面找到有關可能的代理和 SSL 配置。

 

檢查日志

你可以在 <home-directory>/logs/atlassian-confluence.log 中找到有關 Confluence 應用的日志。Synchrony  有關的日志你可以在 <home-directory>/logs/atlassian-synchrony.log 中找到。

重啟 Synchrony

進入  > 基本配置(General Configuration)>  協同編輯(Collaborative editing)然后選擇 重啟 Synchrony(Restart Synchrony)。

檢查 8091 端口是否可用

在默認的情況下 Synchrony 運行在 8091 端口。如果這個端口已經被其他的應用占用的話,你可以使用 synchrony.port 系統屬性來將端口修改到其他未被占用的端口。

(如果你使用的是 Confluence 6.0.3 或者早期的版本,你需要使用 reza.port 來替代 synchrony.port。)

請查看 Configuring System Properties 頁面來找到如何對這些內容進行修改。

針對 Confluence 數據中心模式,運行 Synchrony 的方式有所不同。請 Configuring Synchrony for Data Center 頁面中獲得有關配置的信息。

反向代理(Reverse proxy)問題

如果你已經配置了方向代理,但是不能編輯頁面,你可以對下面的一些配置進行檢查:

  • 進入 installation-directory>/econf/server.xml 然后檢查連接器的目錄。確定你已經正確的配置了值 <protocol> 和 <proxyName>。請參考下面的示例來獲得更多的信息。
  • HTTP 連接需要在 <installation-directory>/conf/server.xml 文件中進行配置,盡管你已經配置了 SSL 或者使用了 AJP 連接器。Synchrony 健康檢查程序將會使用 HTTP 端口進行檢查。可選的,如果你不希望包含 http 連接器,你可以使用 synchrony.proxy.healthcheck.disabled 系統屬性來禁用健康檢查。
  • 如果你正在使用 Apache,請確定你正在使用的是 Apache 2.4 (需要 WebSockets 的支持)同時所有需要的模塊都已經被啟用了(mod-proxymod_rewriteproxy_wstunnel)。
  • 如果你正在使用的是 Apache 同時希望直接連接 Synchrony,在你的屬性配置文件中,請確定你已經包含了 /synchrony 同時 Confluence 和 Synchrony 的順序和路徑是正確的。請參考下面的指南示例來獲得更多信息。

請參考 Administering Collaborative Editing 來找到更多有關可能的反向代理和 SSL 配置,然后請參考下面的鏈接來找到更多有關 Synchrony  在反向代理中的配置。如果你想直接連接 Synchrony  的話:

正向代理(Forward proxy)問題

如果你正在使用的是正向代理或者外部代理,你需要添加 IP 到 Synchrony 到你的監聽器中來確定你的配置能夠穿透代理。 See Troubleshooting Collaborative Editing for more info.

在默認的情況下,IP 地址為 127.0.0.1 或者是 synchrony.host 中的系統屬性配置,如果你在 Confluence 中自定義了 hostname 或者 IP 地址來 Synchrony 的話。

Websocket 問題

協同編輯最好是在 WebSocket  連接下進行配置。如果其中一個方面因為超時而不能建立連接,或者代理服務器的防火牆不允許 WebSocket 連接。那么編輯器將會嘗試通過一個 XML HTTP 請求(XHR)進行連接。

你可以使用 http://websocket.org/echo.html 來進行快速的 HTML5 WebSocket 測試服務器的響應。

SSL 問題

Synchrony 不能接受直接的 HTTPS  連接,所以你需要下你的方向代理或者負載均衡配置 SSL。如果你使用的是 Tomcat,但是你沒有使用方向代理,那么你需要在你的 Tomcat 上配置 SSL。

內存問題

如果你遇到了 Synchrony 有關內存溢出,你可以修改 Synchrony 使用的 heap 大小,這個配置定義在 synchrony.memory.max 系統屬性中。

如果你使用的是 Confluence 6.3 或者早期的版本,你將需要使用 reza.memory.max 來替換 synchrony.memory.max。

請參考 Configuring System Properties 頁面中的內容來找到如何對這個進行修改。

針對 Confluence 數據中心使用的 Synchrony  的方法與服務器環境下使用的方法有所不同。請參考 Configuring Synchrony for Data Center 頁面中的內容來獲得有關的更多信息。

多 Synchrony 進程

如果你在編輯的時候立馬就在編輯上顯示了錯誤,但是 Confluence 報告的是 Synchrony 是運行的,你需要檢查只有一個 Synchrony  實例正在運行。

如果你有多個 Synchrony 進程正在運行,停止 Confluence,殺死掉多余的 Synchrony 進程后重啟 Confluence。

你可以通過每次都使用 stop-confluence.sh / stop-confluence.bat 來停止 Confluence,避免使用關閉 Tomcat 窗口的方式來停止 Confluence。

不兼容的瀏覽器擴展

有時候,第三方的一些瀏覽器插件將會對編輯器造成影響,例如 Grammarly,有時候也會導致協同編輯的功能不能正確的使用。請參考 Confluence Collaborative Editing blocks Grammarly Extension 頁面中的內容來找到如何在你的站點中禁用 Grammarly 。

防火牆或者防病毒干擾

我們也遇到了一些有關防火牆或者防病毒軟件阻止服務器的一些訪問,這個將會導致編輯器出現一些莫名其妙的錯誤。你需要將 Confluence 添加到你的白名單或者信任的 URL 中,如果你遇到了防火牆相關的一些問題的話。請參考 Weird Page or Editor Behaviors with Kaspersky Internet Security 頁面中的內容來獲得有關的一些信息。

太多人同時在編輯

系統並不強制限制可以使用編輯器的用戶的數量,但是我們建議你保持不要超過 12 個用戶同時使用編輯器進行編輯。官方可能后期限制可以同時使用編輯器的用戶的數量,如果官方覺得這個限制是有意義,並且是必要的話。

 

https://www.cwiki.us/display/CONF6ZH/Troubleshooting+Collaborative+Editing


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM