Confluence 6 協同編輯問題解決

時間 2019-11-12

原文原文鏈接

協同編輯是 Synchrony 提供的，用於在編輯的時候實時同步。在通常的狀況下，這個進程是不須要 Confluence 的管理員進行手動管理的。html

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

第一步

檢查 Synchrony 是否在運行

爲了檢查 Synchrony 是否在運行，進入 > 基本配置（General Configuration） > 協同編輯（Collaborative editing）。apache

請注意：若是你正在運行的 Confluence 數據中心模式，那麼這個頁面將僅能告訴你若是當前鏈接到 Confluence 節點的的 Synchrony 的運行狀態。你可能須要第三方的監控工具來幫助你監控你的 Synchrony 集羣。api

檢查你能夠編輯的頁面

若是在你對頁面進行編輯的時候看到了錯誤，可是 Synchrony 又是運行的，那麼應該是你瀏覽器有某些東西阻止你鏈接到 Synchrony 。瀏覽器

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

檢查日誌

你能夠在 <home-directory>/logs/atlassian-confluence.log 中找到有關 Confluence 應用的日誌。Synchrony 有關的日誌你能夠在 <home-directory>/logs/atlassian-synchrony.log 中找到。websocket

重啓 Synchrony

進入 > 基本配置（General Configuration）> 協同編輯（Collaborative editing）而後選擇 重啓 Synchrony（Restart Synchrony）。app

檢查 8091 端口是否可用

在默認的狀況下 Synchrony 運行在 8091 端口。若是這個端口已經被其餘的應用佔用的話，你可使用 synchrony.port 系統屬性來將端口修改到其餘未被佔用的端口。負載均衡

（若是你使用的是 Confluence 6.0.3 或者早期的版本，你須要使用 reza.port 來替代 synchrony.port。）socket

請查看 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-proxy, mod_rewrite, proxy_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 頁面中的內容來得到有關的一些信息。